IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > gettxt man page

gettxt man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





User Commands                                           gettxt(1)



NAME
     gettxt - retrieve a text string from a message database

SYNOPSIS
     gettxt msgfile : msgnum [dflt_msg]

DESCRIPTION
     gettxt retrieves a text string from a message  file  in  the
     directory  /usr/lib/locale/locale/LC_MESSAGES  .  The direc-
     tory 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 msgfile 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 msgfile. Non-
                     graphic characters must  be  represented  as
                     alphabetic escape sequences.



     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 vari-
     able 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   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!!.




SunOS 5.10          Last change: 20 Dec 1996                    1






User Commands                                           gettxt(1)



EXAMPLES
     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.

ENVIRONMENT VARIABLES
     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  char-
                             acters.  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 infor-
                             mative  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).



FILES
     /usr/lib/locale/C/LC_MESSAGES/*

         default message files created by mkmsgs(1)



SunOS 5.10          Last change: 20 Dec 1996                    2






User Commands                                           gettxt(1)



     /usr/lib/locale/locale/LC_MESSAGES/*

         message  files  for  different  languages   created   by
         mkmsgs(1)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

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


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
































SunOS 5.10          Last change: 20 Dec 1996                    3





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 21:37:08 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5333 hits)
(openSUSE 10.2)

svn man page (5208 hits)
(FreeBSD 6.2)

adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)

CPAN man page (4607 hits)
(Suse Linux 10.1)

ssh man page (4342 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2874 hits)
(Solaris 10 11_06)

netcat man page (2717 hits)
(Suse Linux 10.1)

pprosetup man page (2487 hits)
(Solaris 10 11_06)

startproc man page (2471 hits)
(Suse Linux 10.1)

signal man page (2406 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Mountain Holidays Contact Us :: Through Glass Touch Panel :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum