*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> textdomain (3)              



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)
[ Back ]
 Similar pages
Name OS Title
stg FreeBSD driver for Future Domain based SCSI controllers
sea OpenBSD Seagate/Future Domain ISA SCSI adapter card
vroom IRIX slot car racing in the future
portal HP-UX a "window to the future" for applications
jail FreeBSD imprison current process and future decendants
jail_attach FreeBSD imprison current process and future decendants
DXmSvnGetTreePosition Tru64 Retrieves (returns) the position of the display window for future use.
wakeupat IRIX request that system power back on at a future time
opieinfo FreeBSD Extract sequence number and seed for future OPIE challenges.
getdomainname Linux get/set domain name
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service