GNU Info

(gawk.info)I18N Functions

---

Prev: Bitwise Functions Up: Built-in

---

Enter node , (file) or (file)node

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.  Note: 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.