*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> locale (1)              
Title
Content
Arch
Section
 

locale(1)

Contents


NAME    [Toc]    [Back]

       locale - Displays information about locales

SYNOPSIS    [Toc]    [Back]

       locale [-a  | -m]

       locale [-c] [-k] name...

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       locale:  XCU5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

OPTIONS    [Toc]    [Back]

       Writes  information  about  all  available public locales.
       Writes the  names  of  the  specified  locale  categories.
       Writes  the names and values of specified locale keywords.
       Writes the names of all character map (charmap) files that
       are  available  for  specification to the -f option of the
       localedef command.

OPERANDS    [Toc]    [Back]

       Specifies one or more of the following: A locale category,
       such as LC_TIME A keyword, such as am_pm in a locale category
 The reserved word charmap, which requests the name of
       the character map file used to produce the current locale

              Different  types  of names can be intermixed in any
              order. However, if a single name represents both  a
              locale category name and a keyword name in the current
 locale, results are undefined.

DESCRIPTION    [Toc]    [Back]

       The locale command without any options or arguments writes
       to standard output the names and values of all the current
       locale environment variables, such as LANG and LC_COLLATE.

       The  locale  command  with  the  -a or -m options displays
       information about available locales and character maps  on
       your system.  If the -a option is specified, locale writes
       the names of  all  available  public  locales.  These  are
       locales  that are available to any application.  If the -m
       option is specified, locale writes a list of the names  of
       all  available  character-mapping files.  These values are
       suitable variable  values  for  the  -f  option  with  the
       localedef command.

       The locale command with the name operand displays information
 about locale categories and keywords in  the  current
       locale. For example, the command could display information
       about the decimal_point keyword in the LC_NUMERIC category
       or  information about all keywords in the LC_NUMERIC category.
  The name operand can be either a locale category, a
       keyword from a category, or the keyword charmap.

       The following table shows how the -c and -k options determine
 the level of  information  displayed  by  the  locale
       command with respect to locale keywords:

       Options Set   Information Written to Standard Output
       None          Value  of keyword specified by the name operand or values
 of all keywords in the category  specified  by  the
                     name operand.
       -c            Name  of  category  containing the keyword specified by
                     the name operand or the name of the category  specified
                     by  the name operand, followed by values of locale keywords.

       -k            Names and values of locale keywords.
       -ck           Name of category,  followed  by  names  and  values  of
                     locale keywords.

       Following  are  the  locale categories and the locale keywords
 that you can use in  the  name  operand.  Note  that
       there  are  no keywords that you can specify in the locale
       command for the LC_COLLATE and  LC_CTYPE  categories;  the
       XCU  specification allows vendors to determine whether the
       locale command displays values for keywords in  these  two
       categories.

       Locale Category   Locale Keywords
       LC_COLLATE        None.
       LC_CTYPE          None.
       CHARMAP
                         charmap
                         code_set_name
                         mb_cur_max
                         mb_cur_min

       LC_MESSAGES
                         yesexpr
                         noexpr
                         yesstr
                         nostr

       LC_MONETARY
                         int_curr_symbol
                         currency_symbol
                         mon_decimal_point
                         mon_grouping
                         mon_thousands_sep
                         positive_sign
                         negative_sign
                         int_frac_digits
                         frac_digits
                         p_cs_precedes
                         p_sep_by_space
                         n_cs_precedes
                         n_sep_by_space
                         p_sign_posn
                         n_sign_posn
                         debit_sign
                         credit_sign
                         left_parenthesis
                         right_parenthesis

       LC_NUMERIC
                         decimal_point
                         thousands_sep
                         grouping




       LC_TIME
                         abday
                         abmon
                         alt_digits
                         am_pm
                         d_fmt
                         d_t_fmt
                         day
                         era
                         era_d_fmt
                         era_d_t_fmt
                         era_t_fmt
                         era_year
                         mon
                         t_fmt
                         t_fmt_ampm


EXIT STATUS    [Toc]    [Back]

       Success.  An error occurred.

ERRORS    [Toc]    [Back]

       [Tru64  UNIX]  To review locale diagnostic messages, enter
       the       following        command:        %        dspcat
       /usr/lib/nls/msg/en_US.ISO8859-1/locale.cat | more

EXAMPLES    [Toc]    [Back]

       Assume  that  the  LANG  environment  variable  is  set to
       fr_FR.ISO8859-1 and the LC_MONETARY  environment  variable
       to   fr_CA.ISO8859-1.  The  following  example  shows  the
       results when you enter the locale command without options:
       % locale LANG=fr_FR.ISO8859-1 LC_COLLATE="fr_FR.ISO8859-1"
       LC_CTYPE="fr_FR.ISO8859-1"   LC_MONETARY="fr_CA.ISO8859-1"
       LC_NUMERIC="fr_FR.ISO8859-1"     LC_TIME="fr_FR.ISO8859-1"
       LC_MESSAGES="fr_FR.ISO8859-1" LC_ALL=

              The LC_ALL variable, if set, overrides  the  values
              of  other  variables. For example, if LC_ALL is set
              to en_US.ISO8859-1,  the  setting  implies  LC_COLLATE=en_US.ISO8859-1,
  even if the LC_COLLATE environment
 variable is set  to  another  locale.   The
              following  commands  show  two ways to retrieve the
              value of the decimal_point delimiter for  the  current
  locale: % locale -ck decimal_point LC_NUMERIC
              decimal_point="."  % locale decimal_point .  In the
              following example, the locale command retrieves any
              keywords defined  in  the  CHARMAP,  LC_CTYPE,  and
              LC_COLLATE  categories  of  the POSIX (C) locale: %
              locale  -ck  CHARMAP  LC_CTYPE  LC_COLLATE  CHARMAP
              charmap="ISO8859-1"       code_set_name="ISO8859-1"
              mb_cur_max=1   mb_cur_min=1   LC_COLLATE   LC_CTYPE
              alnum=0x0002 alpha=0x0001 blank=0x0004 cntrl=0x0008
              digit=0x0010 graph=0x0020 lower=0x0040 print=0x0080
              punct=0x0100        space=0x0200       upper=0x0400
              xdigit=0x0800 The following example shows a  possible
  application  of the locale and printf commands
              in a script to determine whether a user response is
              affirmative:

              if  printf  "%s\n"  "$response" | grep -Eq "'locale
              yesexpr'" then
                      <insert    processing    for    affirmative
              response> else
                      <insert  processing for response other than
              affirmative> fi

ENVIRONMENT VARIABLES    [Toc]    [Back]

       The following environment variables affect the behavior of
       the  locale  command:  Provides  a  default  value for the
       locale category variables that are not set  or  null.   If
       set, overrides the values of all locale variables, including
 LANG.  Determines the locale for the interpretation of
       byte sequences as characters (single-byte or multibyte) in
       input operands and files.  Determines the locale  used  to
       find the message catalog for diagnostic messages and other
       text displayed by the command.  Determines the location of
       message catalogs for processing of LC_MESSAGES.

SEE ALSO    [Toc]    [Back]

      
      
       Commands:  localedef(1), printf(1)

       Functions:  setlocale(3)

       Files:  locale(4)

       Others:  i18n_intro(5), l10n_intro(5), standards(5)

       Writing Software for the International Market



                                                        locale(1)
[ Back ]
 Similar pages
Name OS Title
MB_LEN_MAX Linux maximum multibyte length of a character across all locales
readelf Linux Displays information about ELF files.
readelf FreeBSD Displays information about ELF files.
groupinfo OpenBSD displays group information
userinfo OpenBSD displays user information
f Tru64 Displays user information
finger Tru64 Displays user information
pset_info Tru64 Displays processor set information
locale IRIX Perl pragma to use and avoid POSIX locales for built-in operations
show_directory HP-UX Displays attribute information about the specified directory
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service