Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TEXTDOMAIN(3)		   Library Functions Manual		 TEXTDOMAIN(3)

NAME
       textdomain - set	domain for future gettext() calls

SYNOPSIS
       #include	<libintl.h>

       char * textdomain (const	char * domainname);

DESCRIPTION
       The textdomain function sets or retrieves the current message domain.

       A  message  domain  is  a  set of translatable msgid messages. Usually,
       every software package has its own message domain. The domain  name  is
       used to determine the message catalog where a translation is looked up;
       it must be a non-empty string.

       The  current message domain is used by the gettext, ngettext functions,
       and by the dgettext, dcgettext, dngettext and dcngettext	functions when
       called with a NULL domainname argument.

       If domainname is	not NULL, the current message domain is	set to domain-
       name. The string	the function stores internally is a copy  of  the  do-
       mainname	argument.

       If domainname is	NULL, the function returns the current message domain.

RETURN VALUE
       If  successful, the textdomain function returns the current message do-
       main, after possibly changing it. The resulting string is  valid	 until
       the next	textdomain call	and must not be	modified or freed. If a	memory
       allocation failure occurs, it sets errno	to ENOMEM and returns NULL.

ERRORS
       The following error can occur, among others:

       ENOMEM Not enough memory	available.

BUGS
       The  return type	ought to be const char *, but is char *	to avoid warn-
       ings in C code predating	ANSI C.

SEE ALSO
       gettext(3), ngettext(3),	bindtextdomain(3), bind_textdomain_codeset(3)

GNU gettext 0.22.5		   May 2001			 TEXTDOMAIN(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=textdomain&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help