gettxt man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GETTXT(3C)							    GETTXT(3C)

       gettxt - retrieve a text string

       #include <nl_types.h>

       char *gettxt(const char *msgid, const char *dflt_str);

       The  gettxt() function retrieves a text string from a message file. The
       arguments to the function are a	message	 identification	 msgid	and  a
       default string dflt_str to be used if the retrieval fails.

       The  text  strings  are	in  files  created  by the mkmsgs utility (see
       mkmsgs(1))      and	 installed	 in	  directories	    in

       The  directory  locale  can be viewed as the language in which the text
       strings are written. The user can request that messages be displayed in
       a specific language by setting the environment variable LC_MESSAGES. If
       LC_MESSAGES is not set, the environment variable LANG will be used.  If
       LANG   is   not	 set,	the   files  containing	 the  strings  are  in

       The user can also change the language in which the  messages  are  dis‐
       played  by  invoking  the  setlocale(3C)	 function with the appropriate

       If gettxt() fails to retrieve a message in a specific language it  will
       try  to retrieve the same message in U.S. English. On failure, the pro‐
       cessing depends on what the  second  argument  dflt_str	points	to.  A
       pointer	to  the	 second argument is returned if the second argument is
       not the null string. If dflt_str points to the null string,  a  pointer
       to the U.S. English text string "Message not found!!\n" is returned.

       The following depicts the acceptable syntax of msgid for a call to get‐

       <msgid> = <msgfilename>:<msgnumber>

       The first field is used to indicate the file  that  contains  the  text
       strings	and must be limited to 14 characters. These characters must be
       selected from the set of all character values excluding \0  (null)  and
       the  ASCII code for / (slash) and : (colon). The names of message files
       must be the same as the names of files created by mkmsgs and  installed
       in  /usr/lib/locale/locale/LC_MESSAGES/*.  The  numeric field indicates
       the sequence number of the string in the file. The strings are numbered
       from 1 to n where n is the number of strings in the file.

       Upon failure to pass either the correct msgid or a valid message number
       to  gettxt(), a pointer to the text string "Message not	found!!\n"  is

       It is recommended that gettext(3C) be used in place of this function.

       Example 1 Example of gettxt() function.

       In the following example,

	 gettxt("UX:10", "hello world\n")
	 gettxt("UX:10", "")

       UX  is  the  name  of the file that contains the messages and 10 is the
       message number.


	   contains  default message files created by mkmsgs


	   contains message files for different languages created by mkmsgs

       See attributes(5) for descriptions of the following attributes:

       │MT-Level       │ Safe with exceptions │

       exstr(1),  mkmsgs(1),  srchtxt(1),  gettext(3C),	  fmtmsg(3C),	setlo‐
       cale(3C), attributes(5), environ(5)

				 Dec 29, 1996			    GETTXT(3C)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net