Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  lo-
		cale.

       -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 lo-
		cale 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:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWloc			   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=locale&sektion=1&manpath=SunOS+5.10>

home | help