NAME
libintl.h —
international messaging
SYNOPSIS
#include
<libintl.h>
DESCRIPTION
The <libintl.h> header may define the macro TEXTDOMAINMAX. If defined, it shall have the same value as {TEXTDOMAIN_MAX} in <limits.h>.
The <libintl.h> header shall define the locale_t type as described in <locale.h>.
The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.
char *bindtextdomain(const char *, const char *);
char *bind_textdomain_codeset(const char *, const char *);
char *dcgettext(const char *, const char *, int);
char *dcgettext_l(const char *, const char *, int, locale_t);
char *dcngettext(const char *, const char *, const char *,
unsigned long int, int);
char *dcngettext_l(const char *, const char *, const char *,
unsigned long int, int, locale_t);
char *dgettext(const char *, const char *);
char *dgettext_l(const char *, const char *, locale_t);
char *dngettext(const char *, const char *, const char *,
unsigned long int);
char *dngettext_l(const char *, const char *, const char *,
unsigned long int, locale_t);
char *gettext(const char *);
char *gettext_l(const char *, locale_t);
char *ngettext(const char *, const char *, unsigned long int);
char *ngettext_l(const char *, const char *,
unsigned long int, locale_t);
char *textdomain(const char *);
APPLICATION USAGE
None.
RATIONALE
Some historical implementations defined TEXTDOMAINMAX in this header. This standard instead defines {TEXTDOMAIN_MAX} in <limits.h>. This was done to allow the maximum length of a text domain name to vary depending on the filesystem type used to store message catalogs. Implementations are allowed to continue to define TEXTDOMAINMAX in this header as an extension to the standard (see XSH V2_chap02(3)).
FUTURE DIRECTIONS
None.
SEE ALSO
CHANGE HISTORY
First released in Issue 8.