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, ev-
ery 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.19.8.1 May 2001 TEXTDOMAIN(3)