gettext(3)


NAME

   gettext, dgettext, dcgettext - translate message

SYNOPSIS

   #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);

DESCRIPTION

   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.

RETURN VALUE

   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.

ERRORS

   errno is not modified.

BUGS

   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.

SEE ALSO

   ngettext(3),  dngettext(3), dcngettext(3), setlocale(3), textdomain(3),
   bindtextdomain(3), bind_textdomain_codeset(3), msgfmt(1)





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.