Linux Standard Base Specification 1.3
PrevNext

dgettext

Name

dgettext -- perform lookup in message catalog for the current LC_MESSAGES locale

Synopsis

#include <libintl.h>

extern char *dgettext(const char *domainname, const char *msgid);

Description

dgettext is a domain specified version of gettext.

Parameters

domainname

dgettext applies domainname to the currently active LC_MESSAGE locale. This usage is equivalent in syntax and meaning to the textdomain function's application of domainname, except that the selection of the domain in dgettext is valid only for the duration of the call.

msgid

a NULL-terminated string to be matched in the catalogue with respect to a specific domain and the current locale.

Return Value

On success of a msgid query, the translated NULL-terminated string is returned. On error, the original msgid is returned. The length of the string returned is undetermined until dgettext is called.

Errors

dgettext will not modify the errno global variable.

See Also

gettext, dgettext, ngettext, dngettext, dcgettext, dcngettext, textdomain, bindtextdomain, bind_textdomain_codeset

PrevHomeNext
dcngettextUpdngettext