Viewing file:  textdomain.3.html (4.75 KB) -rw-r--r--
Select action/file-type:
 (+) | (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
TEXTDOMAIN
TEXTDOMAIN
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
BUGS
SEE ALSO
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 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. |
RETURN VALUE
|
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
|
The following error can occur, among others: |
|
Not enough memory available. |
BUGS
|
The return type ought to be const char *, but is
char * to avoid warnings in C code predating ANSI
C. |
SEE ALSO
|
gettext(3), ngettext(3),
bindtextdomain(3),
bind_textdomain_codeset(3) |
|