locale(3pm) [osx man page]

locale(3pm)						 Perl Programmers Reference Guide					       locale(3pm)

NAME

       locale - Perl pragma to use or avoid POSIX locales for built-in operations

SYNOPSIS

	   @x = sort @y;       # Unicode sorting order
	   {
	       use locale;
	       @x = sort @y;   # Locale-defined sorting order
	   }
	   @x = sort @y;       # Unicode sorting order again

DESCRIPTION

       This pragma tells the compiler to enable (or disable) the use of POSIX locales for built-in operations (for example, LC_CTYPE for regular
       expressions, LC_COLLATE for string comparison, and LC_NUMERIC for number formatting).  Each "use locale" or "no locale" affects statements
       to the end of the enclosing BLOCK.

       Starting in Perl 5.16, a hybrid mode for this pragma is available,

	   use locale ':not_characters';

       which enables only the portions of locales that don't affect the character set (that is, all except LC_COLLATE and LC_CTYPE).  This is
       useful when mixing Unicode and locales, including UTF-8 locales.

	   use locale ':not_characters';
	   use open ":locale";		 # Convert I/O to/from Unicode
	   use POSIX qw(locale_h);	 # Import the LC_ALL constant
	   setlocale(LC_ALL, "");	 # Required for the next statement
					 # to take effect
	   printf "%.2f
", 12345.67'	 # Locale-defined formatting
	   @x = sort @y;		 # Unicode-defined sorting order.
					 # (Note that you will get better
					 # results using Unicode::Collate.)

       See perllocale for more detailed information on how Perl supports locales.

perl v5.16.2							    2012-10-11							       locale(3pm)

LOCALE(1)						    BSD General Commands Manual 						 LOCALE(1)

NAME

     locale -- display locale settings

SYNOPSIS

     locale [-a|m]
     locale [-ck] name [...]

DESCRIPTION

     locale displays information about the current locale, or a list of all available locales.

     When locale is run with no arguments, it will display the current source of each locale category.

     When locale is given the name of a category, it acts as if it had been given each keyword in that category.  For each keyword it is given,
     the current value is displayed.

OPTIONS

     -a       Lists all public locales.

     -c name ...
	      Lists the category name before each keyword, unless it is the same category as the previously displayed keyword.

     -k name ...
	      Displays the name of each keyword prior to its value.

     -m       Lists all available public charmaps.  Darwin locales do not support charmaps, so list all CODESETs instead.

OPERANDS

     The following operand is supported:

     name is the name of a keyword or category to display.  A list of all keywords and categories can be shown with the following command:

     locale -ck LC_ALL

ENVIRONMENT

     LANG	  Used as a substitute for any unset LC_* variable.  If LANG is unset, it will act as if set to "C".  If any of LANG or LC_* are
		  set to invalid values, locale acts as if they are all unset.

     LC_ALL	  Will override the setting of all other LC_* variables.

     LC_COLLATE   Sets the locale for the LC_COLLATE category.

     LC_CTYPE	  Sets the locale for the LC_CTYPE category.

     LC_MESSAGES  Sets the locale for the LC_MESSAGES category.

     LC_MONETARY  Sets the locale for the LC_MONETARY category.

     LC_NUMERIC   Sets the locale for the LC_NUMERIC category.

     LC_TIME	  Sets the locale for the LC_TIME category.

SEE ALSO

     localedef(1), localeconv(3), nl_langinfo(3), setlocale(3)

STANDARDS

     The locale utility conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

     locale appeared in Mac OS X 10.4

Darwin								  August 27, 2004							    Darwin