9.1.7 Using gawk's String Translation Functions

gawk provides facilities for internationalizing awk programs. These include the functions described in the following list. The description here is purposely brief. See section Internationalization with gawk, for the full story. Optional parameters are enclosed in square brackets ([ and ]):

dcgettext(string [, domain [, category]])

This function returns the translation of string in text domain domain for locale category category. The default value for domain is the current value of TEXTDOMAIN. The default value for category is "LC_MESSAGES".

bindtextdomain(directory [, domain])

This function allows you to specify the directory where gawk will look for message translation files, in case they will not or cannot be placed in the "standard" locations (e.g., during testing). It returns the directory where domain is "bound."

The default domain is the value of TEXTDOMAIN. If directory is the null string (""), then bindtextdomain returns the current binding for the given domain.