unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

locale(1)                        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 environ-
       ment, 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 set-
       tings of the environment variables.

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

         o  Specifying  a keyword name selects the named keyword and the cate-
            gory containing that keyword.

         o  Specifying a category name selects the named category and all key-
            words 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  imple-
                mentation may omit values for some keywords; see OPERANDS.



       -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 cate-
                gory  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 oper-
                ands, 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

       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_MES-
       SAGES, and NLSPATH.

       The LANG, LC_*, and NLSPATH environment variables must specify the cur-
       rent  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  success-
                fully.



       >>0       An error occurred.



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


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE   VALUE   AvailabilitySUNWloc
       CSIEnabled Interface StabilityStandard


SEE ALSO
       localedef(1),  attributes(5),  charmap(5), environ(5), locale(5), stan-
       dards(5)

NOTES
       If LC_CTYPE or keywords in the category LC_CTYPE  are  specified,  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.10                        20 Dec 1996                        locale(1)