gawk: I18N Functions

 
 9.1.8 String-Translation Functions
 ----------------------------------
 
 'gawk' provides facilities for internationalizing 'awk' programs.  These
 include the functions described in the following list.  The descriptions
 here are purposely brief.  SeeInternationalization, for the full
 story.  Optional parameters are enclosed in square brackets ([ ]):
 
 'bindtextdomain(DIRECTORY' [',' DOMAIN]')'
      Set the directory in which '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 in
      which 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.
 
 'dcgettext(STRING' [',' DOMAIN [',' CATEGORY] ]')'
      Return 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"'.
 
 'dcngettext(STRING1, STRING2, NUMBER' [',' DOMAIN [',' CATEGORY] ]')'
      Return the plural form used for NUMBER of the translation of
      STRING1 and STRING2 in text domain DOMAIN for locale category
      CATEGORY.  STRING1 is the English singular variant of a message,
      and STRING2 is the English plural variant of the same message.  The
      default value for DOMAIN is the current value of 'TEXTDOMAIN'.  The
      default value for CATEGORY is '"LC_MESSAGES"'.