Manual Pages for UNIX Operating System command usage for man locale

User Commands                                           locale(1)



NAME
     locale - get locale-specific information

SYNOPSIS
     locale [-a | -m]


     locale [-ck] name...


DESCRIPTION
     The locale utility  writes  information  about  the  current
     locale  environment,  or all public locales, to the standard
     output. For the purposes of this section, a public locale is
     one provided by the implementation that is accessible to the
     application.


     When locale is invoked without any arguments, it  summarizes
     the  current  locale environment for each locale category as
     determined by the settings of the environment variables.


     When invoked with operands, it writes values that have  been
     assigned  to  the keywords in the locale categories, as fol-
     lows:

         o    Specifying a keyword name selects the named keyword
              and the category containing that keyword.

         o    Specifying  a  category  name  selects  the   named
              category and all keywords in that category.

OPTIONS
     The following options are supported:

     -a    Writes information about all available public locales.
           The  available locales include POSIX, representing the
           POSIX locale.


     -c    Writes the names of selected locale categories. The -c
           option   increases  readability  when  more  than  one
           category is selected (for example, via more  than  one
           keyword name or via a category name). It is valid both
           with and without the -k option.


     -k    Writes the names and values of selected keywords.  The
           implementation  may omit values for some keywords; see
           OPERANDS.




SunOS 5.11          Last change: 20 Dec 1996                    1






User Commands                                           locale(1)



     -m    Writes names of available charmaps; see  localedef(1).


OPERANDS
     The following operand is supported:

     name    The name of a locale category, the name of a keyword
             in  a locale category, or the reserved name charmap.
             The named category or keyword will be  selected  for
             output.  If  a  single name represents both a locale
             category name and a  keyword  name  in  the  current
             locale, the results are unspecified; otherwise, both
             category and keyword names can be specified as  name
             operands, in any sequence.


EXAMPLES
     Example 1 Examples of the locale utility


     In the following examples, the  assumption  is  that  locale
     environment variables are set as follows:


       LANG=locale_x LC_COLLATE=locale_y




     The command locale would result in the following output:


       LANG=locale_x
       LC_CTYPE="locale_x"
       LC_NUMERIC="locale_x"
       LC_TIME="locale_x"
       LC_COLLATE=locale_y
       LC_MONETARY="locale_x"
       LC_MESSAGES="locale_x"
       LC_ALL=




     The command


       LC_ALL=POSIX locale -ck decimal_point







SunOS 5.11          Last change: 20 Dec 1996                    2






User Commands                                           locale(1)



     would produce:


       LC_NUMERIC
       decimal_point="."




     The following command shows  an  application  of  locale  to
     determine whether a user-supplied response is affirmative:


       if printf "%s\n" "$response" | /usr/xpg4/bin/grep -Eq\
               "$(locale yesexpr)"
       then
           affirmative processing goes here
       else
           non-affirmative processing goes here
       fi



ENVIRONMENT VARIABLES
     See  environ(5)  for  the  descriptions  of   LANG,  LC_ALL,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.


     The LANG,  LC_*,  and  NLSPATH  environment  variables  must
     specify  the  current  locale environment to be written out.
     These environment variables will be used if the -a option is
     not specified.

EXIT STATUS
     The following exit values are returned:

     0     All the requested information  was  found  and  output
           successfully.


     >0    An error occurred.


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









SunOS 5.11          Last change: 20 Dec 1996                    3






User Commands                                           locale(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | text/locale                 |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     localedef(1),   attributes(5),    charmap(5),    environ(5),
     locale(5), standards(5)

NOTES
     If LC_CTYPE or keywords in the category LC_CTYPE are  speci-
     fied,  only  the  values  in the range 0x00-0x7f are written
     out.


     If LC_COLLATE or keywords in  the  category  LC_COLLATE  are
     specified, no actual values are written out.






























SunOS 5.11          Last change: 20 Dec 1996                    4