locale
index
/usr/local/lib/python2.3/locale.py

Locale support.
 
The module provides low-level access to the C lib's locale APIs
and adds high level number formatting APIs as well as a locale
aliasing engine to complement these.
 
The aliasing engine includes support for many commonly used locale
names and maps them to values suitable for passing to the C lib's
setlocale() function. It also includes default encodings for all
supported locale names.

 
Modules
       
sys

 
Classes
       
exceptions.Exception
Error

 
class Error(exceptions.Exception)
     Methods inherited from exceptions.Exception:
__getitem__(...)
__init__(...)
__str__(...)

 
Functions
       
atof(str, func=<type 'float'>)
Parses a string as a float according to the locale settings.
atoi(str)
Converts a string to an integer according to the locale settings.
bindtextdomain(...)
bindtextdomain(domain, dir) -> string
Bind the C library's domain to dir.
dcgettext(...)
dcgettext(domain, msg, category) -> string
Return translation of msg in domain and category.
dgettext(...)
dgettext(domain, msg) -> string
Return translation of msg in domain.
format(f, val, grouping=0)
Formats a value in the same way that the % formatting would use,
but takes the current locale into account.
Grouping is applied if the third parameter is true.
getdefaultlocale(envvars=('LANGUAGE', 'LC_ALL', 'LC_CTYPE', 'LANG'))
Tries to determine the default locale settings and returns
them as tuple (language code, encoding).
 
According to POSIX, a program which has not called
setlocale(LC_ALL, "") runs using the portable 'C' locale.
Calling setlocale(LC_ALL, "") lets it use the default locale as
defined by the LANG variable. Since we don't want to interfere
with the current locale setting we thus emulate the behavior
in the way described above.
 
To maintain compatibility with other platforms, not only the
LANG variable is tested, but a list of variables given as
envvars parameter. The first found to be defined will be
used. envvars defaults to the search path used in GNU gettext;
it must always contain the variable name 'LANG'.
 
Except for the code 'C', the language code corresponds to RFC
1766.  code and encoding can be None in case the values cannot
be determined.
getlocale(category=0)
Returns the current setting for the given locale category as
tuple (language code, encoding).
 
category may be one of the LC_* value except LC_ALL. It
defaults to LC_CTYPE.
 
Except for the code 'C', the language code corresponds to RFC
1766.  code and encoding can be None in case the values cannot
be determined.
getpreferredencoding(do_setlocale=True)
Return the charset that the user is likely using,
according to the system configuration.
gettext(...)
gettext(msg) -> string
Return translation of msg.
localeconv(...)
() -> dict. Returns numeric and monetary locale-specific parameters.
nl_langinfo(...)
nl_langinfo(key) -> string
Return the value for the locale information associated with key.
normalize(localename)
Returns a normalized locale code for the given locale
name.
 
The returned locale code is formatted for use with
setlocale().
 
If normalization fails, the original name is returned
unchanged.
 
If the given encoding is not known, the function defaults to
the default encoding for the locale code just like setlocale()
does.
resetlocale(category=6)
Sets the locale for category to the default setting.
 
The default setting is determined by calling
getdefaultlocale(). category defaults to LC_ALL.
setlocale(category, locale=None)
Set the locale for the given category.  The locale can be
a string, a locale tuple (language code, encoding), or None.
 
Locale tuples are converted to strings the locale aliasing
engine.  Locale strings are passed directly to the C lib.
 
category may be given as one of the LC_* values.
str(val)
Convert float to integer, taking the locale into account.
strcoll(...)
string,string -> int. Compares two strings according to the locale.
strxfrm(...)
string -> string. Returns a string that behaves for cmp locale-aware.
textdomain(...)
textdomain(domain) -> string
Set the C library's textdmain to domain, returning the new domain.

 
Data
        ABDAY_1 = 131072
ABDAY_2 = 131073
ABDAY_3 = 131074
ABDAY_4 = 131075
ABDAY_5 = 131076
ABDAY_6 = 131077
ABDAY_7 = 131078
ABMON_1 = 131086
ABMON_10 = 131095
ABMON_11 = 131096
ABMON_12 = 131097
ABMON_2 = 131087
ABMON_3 = 131088
ABMON_4 = 131089
ABMON_5 = 131090
ABMON_6 = 131091
ABMON_7 = 131092
ABMON_8 = 131093
ABMON_9 = 131094
ALT_DIGITS = 131119
AM_STR = 131110
CHAR_MAX = 127
CODESET = 14
CRNCYSTR = 262159
DAY_1 = 131079
DAY_2 = 131080
DAY_3 = 131081
DAY_4 = 131082
DAY_5 = 131083
DAY_6 = 131084
DAY_7 = 131085
D_FMT = 131113
D_T_FMT = 131112
ERA = 131116
ERA_D_FMT = 131118
ERA_D_T_FMT = 131120
ERA_T_FMT = 131121
LC_ALL = 6
LC_COLLATE = 3
LC_CTYPE = 0
LC_MESSAGES = 5
LC_MONETARY = 4
LC_NUMERIC = 1
LC_TIME = 2
MON_1 = 131098
MON_10 = 131107
MON_11 = 131108
MON_12 = 131109
MON_2 = 131099
MON_3 = 131100
MON_4 = 131101
MON_5 = 131102
MON_6 = 131103
MON_7 = 131104
MON_8 = 131105
MON_9 = 131106
NOEXPR = 327681
PM_STR = 131111
RADIXCHAR = 65536
THOUSEP = 65537
T_FMT = 131114
T_FMT_AMPM = 131115
YESEXPR = 327680
__all__ = ['setlocale', 'Error', 'localeconv', 'strcoll', 'strxfrm', 'format', 'str', 'atof', 'atoi', 'LC_CTYPE', 'LC_COLLATE', 'LC_TIME', 'LC_MONETARY', 'LC_NUMERIC', 'LC_ALL', 'CHAR_MAX', 'LC_MESSAGES']
encoding_alias = {'437': 'C', '8859': 'ISO8859-1', '88591': 'ISO8859-1', '885915': 'ISO8859-15', 'ajec': 'eucJP', 'ascii': 'ISO8859-1', 'c': 'C', 'en': 'ISO8859-1', 'eucjp': 'eucJP', 'iso-2022-jp': 'JIS7', ...}
locale_alias = {'american': 'en_US.ISO8859-1', 'ar': 'ar_AA.ISO8859-6', 'ar_aa': 'ar_AA.ISO8859-6', 'ar_sa': 'ar_SA.ISO8859-6', 'arabic': 'ar_AA.ISO8859-6', 'bg': 'bg_BG.ISO8859-5', 'bg_bg': 'bg_BG.ISO8859-5', 'bulgarian': 'bg_BG.ISO8859-5', 'c': 'C', 'c-french': 'fr_CA.ISO8859-1', ...}
windows_locale = {1028: 'zh_TW', 1030: 'da_DK', 1031: 'de_DE', 1032: 'el_GR', 1033: 'en_US', 1035: 'fi_FI', 1036: 'fr_FR', 1037: 'iw_IL', 1039: 'is_IS', 1040: 'it_IT', ...}