NAME    [Toc]    [Back]

       textdomain - set domain for future gettext() calls

SYNOPSIS    [Toc]    [Back]

       #include <libintl.h>

       char * textdomain (const char * domainname);

DESCRIPTION    [Toc]    [Back]

       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
       domainname argument.

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

RETURN VALUE    [Toc]    [Back]

       If  successful,	the  textdomain  function  returns the current message
       domain, 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    [Toc]    [Back]

       The following error can occur, among others:

       ENOMEM Not enough memory available.

BUGS    [Toc]    [Back]

       The return type ought to be const char *, but is char * to avoid  warnings
 in C code predating ANSI C.

SEE ALSO    [Toc]    [Back]

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



GNU gettext 0.10.40		   May 2001			 TEXTDOMAIN(3)