Unix/Linux Go Back    

OpenSolaris 2009.06 - man page for gettxt (opensolaris section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

gettxt(1)				  User Commands 				gettxt(1)

       gettxt - retrieve a text string from a message database

       gettxt msgfile : msgnum [dflt_msg]

       gettxt	 retrieves   a	 text	string	 from	a   message   file   in   the	directory
       /usr/lib/locale/locale/LC_MESSAGES . The directory name locale corresponds to the language
       in which the text strings are written; see setlocale(3C).

       msgfile	    Name  of  the  file  in  the directory /usr/lib/locale/locale/LC_MESSAGES  to
		    retrieve msgnum from. The name of msgfile can  be  up  to  14  characters  in
		    length,  but may not contain either \0 (null) or the ASCII code for / (slash)
		    or : (colon).

       msgnum	    Sequence number of the string to retrieve from msgfile. The strings  in  msg-
		    file  are numbered sequentially from 1 to n, where n is the number of strings
		    in the file.

       dflt_msg     Default string to be displayed if gettxt fails to retrieve msgnum  from  msg-
		    file.   Nongraphic	characters  must  be  represented  as  alphabetic  escape

       The text string to be retrieved is in the file msgfile, created by the  mkmsgs(1)  utility
       and installed under the directory /usr/lib/locale/locale/LC_MESSAGES   . You control which
       directory is searched 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 con-
       taining the strings are under the directory /usr/lib/locale/C/LC_MESSAGES .

       If gettxt fails to retrieve a message in the requested language, it will try  to  retrieve
       the  same  message from /usr/lib/locale/C/LC_MESSAGES/ msgfile. If this also fails, and if
       dflt_msg is present and non-null, then it will display the value of dflt_msg; if  dflt_msg
       is not present or is null, then it will display the string Message not found!!.

       Example 1 The environment variables LANG and LC_MESSAGES.

       If  the	environment  variables	LANG or LC_MESSAGES have not been set to other than their
       default values, the following example:

	 example% gettxt UX:10 "hello world\n"

       will try to retrieve the 10th message from /usr/lib/locale/C/UX/msgfile. If the	retrieval
       fails, the message "hello world," followed by a newline, will be displayed.

       See  environ(5)	for  descriptions  of the following environment variables that affect the
       execution of gettxt: LC_CTYPE and LC_MESSAGES.

       LC_CTYPE        Determines how gettxt handles characters. When LC_CTYPE is set to a  valid
		       value,  gettxt  can display and handle text and filenames containing valid
		       characters for that locale. gettxt can display and  handle  Extended  Unix
		       Code  (EUC)  characters	where  any individual character can be 1, 2, or 3
		       bytes wide. gettxt can also handle EUC characters of 1, 2, or more  column
		       widths. In the "C" locale, only characters from ISO 8859-1 are valid.

       LC_MESSAGES     Determines  how	diagnostic  and  informative messages are presented. This
		       includes the language and style of the messages, and the correct  form  of
		       affirmative  and  negative responses.  In the "C" locale, the messages are
		       presented in the default form found in the program itself (in most  cases,
		       U.S. English).


	   default message files created by mkmsgs(1)


	   message files for different languages created by mkmsgs(1)

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

       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWloc			   |
       |CSI			     |Enabled			   |

       exstr(1), mkmsgs(1), srchtxt(1), gettxt(3C), setlocale(3C), attributes(5), environ(5)

SunOS 5.11				   20 Dec 1996					gettxt(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 12:04 AM.