gettext, dgettext, dcgettext - translate message
#include <libintl.h> char * gettext (const char * msgid); char * dgettext (const char * domainname, const char * msgid); char * dcgettext (const char * domainname, const char * msgid, int category);
The gettext, dgettext and dcgettext functions attempt to translate a text string into the user's native language, by looking up the translation in a message catalog. The msgid argument identifies the message to be translated. By convention, it is the English version of the message, with non-ASCII characters replaced by ASCII approximations. This choice allows the translators to work with message catalogs, called PO files, that contain both the English and the translated versions of each message, and can be installed using the msgfmt utility. 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 the translation is looked up; it must be a non-empty string. For the gettext function, it is specified through a preceding textdomain call. For the dgettext and dcgettext functions, it is passed as the domainname argument; if this argument is NULL, the domain name specified through a preceding textdomain call is used instead. Translation lookup operates in the context of the current locale. For the gettext and dgettext functions, the LC_MESSAGES locale facet is used. It is determined by a preceding call to the setlocale function. setlocale(LC_ALL,"") initializes the LC_MESSAGES locale based on the first nonempty value of the three environment variables LC_ALL, LC_MESSAGES, LANG; see setlocale(3). For the dcgettext function, the locale facet is determined by the category argument, which should be one of the LC_xxx constants defined in the <locale.h> header, excluding LC_ALL. In both cases, the functions also use the LC_CTYPE locale facet in order to convert the translated message from the translator's codeset to the current locale's codeset, unless overridden by a prior call to the bind_textdomain_codeset function. The message catalog used by the functions is at the pathname dirname/locale/category/domainname.mo. Here dirname is the directory specified through bindtextdomain. Its default is system and configuration dependent; typically it is prefix/share/locale, where prefix is the installation prefix of the package. locale is the name of the current locale facet; the GNU implementation also tries generalizations, such as the language name without the territory name. category is LC_MESSAGES for the gettext and dgettext functions, or the argument passed to the dcgettext function. If the LANGUAGE environment variable is set to a nonempty value, and the locale is not the "C" locale, the value of LANGUAGE is assumed to contain a colon separated list of locale names. The functions will attempt to look up a translation of msgid in each of the locales in turn. This is a GNU extension. In the "C" locale, or if none of the used catalogs contain a translation for msgid, the gettext, dgettext and dcgettext functions return msgid.
If a translation was found in one of the specified catalogs, it is converted to the locale's codeset and returned. The resulting string is statically allocated and must not be modified or freed. Otherwise msgid is returned.
errno is not modified.
The return type ought to be const char *, but is char * to avoid warnings in C code predating ANSI C. When an empty string is used for msgid, the functions may return a nonempty string.
ngettext(3), dngettext(3), dcngettext(3), setlocale(3), textdomain(3), bindtextdomain(3), bind_textdomain_codeset(3), msgfmt(1)
More Linux Commands
gnutls_x509_crt_get_pk_rsa_raw(3) - API function (Man Page)
gnutls_x509_crt_get_pk_rsa_raw.3 - This function will export the RSA public keys parameters found in the given structure. The new parameters will be allocated u
fixproc(1) - Fixes a process by performing the specified act
Fixes a process named proc by performing the specified action. The actions can be check, kill, restart, exist, or fix. The action is specified on the command li
getrpcent(3) - get RPC entry (Library - Linux man page).....
The getrpcent(), getrpcbyname(), and getrpcbynumber() functions each return a pointer to an object with the following structure containing the broken-out fields
du(1) - estimate file space usage - Linux manual page.......
Summarize disk usage of each FILE, recursively for directories. Mandatory arguments to long options are mandatory for short options too. -0, --null end each out
scr_set(3ncurses) - read (write) a curses screen from (to) a
The scr_dump routine dumps the current contents of the virtual screen to the file filename. The scr_restore routine sets the virtual screen to the contents of f
fc-cache(1) - build font information cache files (Man Page)
fc-cache scans the font directories on the system and builds font information cache files for applications using fontconfig for their font handling. If director
XtErrorMsg(3) - high-level error handlers - Linux man page
The XtErrorMsg function has been superceded by XtAppErrorMsg. The XtSetErrorMsgHandler function has been superceded by XtAppSetErrorMsgHandler. The XtSetWarning
mbstowcs(3) - convert a multibyte string to a wide-character
If dest is not NULL, the mbstowcs() function converts the multibyte string src to a wide-character string starting at dest. At most n wide characters are writte
readers.conf(5) - Access control and configuration for nnrpd
readers.conf in pathetc specifies access control for nnrpd(8). It controls who is allowed to connect as a news reader and what theyre allowed to do after they c
XkbSAActionSetCtrls(3) - Sets the ctrls0 through ctrls3 fiel
XkbSAActionSetCtrls.3 - Actions associated with the XkbCtrlsAction structure change the state of the boolean controls. The type field can have any one of the va
sess_id(1ssl) SSL TLS session handling utility (Man Page)...
The sess_id process the encoded version of the SSL session structure and optionally prints out SSL session details (for example the SSL session master key) in h
attron(3ncurses) - curses character and window attribute con
These routines manipulate the current attributes of the named window. The current attributes of a window apply to all characters that are written into the windo