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 2.2.2 The Name Space).

FUTURE DIRECTIONS

None.

SEE ALSO

<locale.h>

XSH gettext, bindtextdomain

CHANGE HISTORY

First released in Issue 8.