|
textdomain − set domain for future gettext() calls |
#include <libintl.h> char * textdomain (const char * domainname); |
|
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 domainname. The string the function stores internally is a copy of the domainname argument. If domainname is NULL, the function returns the current message domain. |
|
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. |
|
The following error can occur, among others: |
|
ENOMEM |
Not enough memory available. |
|
The return type ought to be const char *, but is char * to avoid warnings in C code predating ANSI C. |
|
gettext(3), ngettext(3), bindtextdomain(3), bind_textdomain_codeset(3) |