View Source: setlocale(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
SETLOCALE
!!!SETLOCALE
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
CONFORMING TO
NOTES
SEE ALSO
----
!!NAME


setlocale - set the current locale.
!!SYNOPSIS


__#include
__ ''category''__, const char *__ ''locale''__);
__
!!DESCRIPTION


The __setlocale()__ function is used to set or query the
program's current locale.


If ''locale'' is not __NULL__, the program's current
locale is modified according to the arguments. The argument
''category'' determines which parts of the program's
current locale should be modified.


__LC_ALL__


for all of the locale.


__LC_COLLATE__


for regular expression matching (it determines the meaning
of range expressions and equivalence classes) and string
collation.


__LC_CTYPE__


for regular expression matching, character classification,
conversion, case-sensitive comparison, and wide character
functions.


__LC_MESSAGES__


for localizable natural-language messages.


__LC_MONETARY__


for monetary formatting.


__LC_NUMERIC__


for number formatting (such as the decimal point and the
thousands separator).


__LC_TIME__


for time and date formatting.


The argument ''locale'' is a pointer to a character
string containing the required setting of ''category''.
Such a string is either a well-known constant like
''setlocale__.


If ''locale'' is ____, each part of the
locale that should be modified is set according to the
environment variables. The details are implementation
dependent. For glibc, first (regardless of ''category''),
the environment variable LC_ALL is inspected, next the
environment variable with the same name as the category
(LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC,
LC_TIME) and finally the environment variable LANG. The
first existing environment variable is used. If its value is
not a valid locale specification, the locale is unchanged,
and __setlocale__ returns NULL.


The locale ____ or ____
is a portable locale; its LC_CTYPE part corresponds to the
7-bit ASCII character set.


A locale name is typically of the form
''language''[[_''territory''][[.''codeset''][[@''modifier''],
where ''language'' is an ISO 639 language code,
''territory'' is an ISO 3166 country code, and
''codeset'' is a character set or encoding identifier
like __ISO-8859-1__ or __UTF-8__. For a list of all
supported locales, try
locale(1).


If ''locale'' is __NULL__, the current locale is only
queried, not modified.


On startup of the main program, the portable
____ locale is selected as default. A
program may be made portable to all locales by calling
__setlocale(LC_ALL, __ after program
initialization, by using the values returned from a
__localeconv()__ call for locale - dependent information,
by using the multi-byte and wide character functions for
text processing if __MB_CUR_MAX __, and by using
__strcoll()__, __wcscoll()__ or __strxfrm()__,
__wcsxfrm()__ to compare strings.
!!RETURN VALUE


A successful call to __setlocale()__ returns an opaque
string that corresponds to the locale set. This string may
be allocated in static storage. The string returned is such
that a subsequent call with that string and its associated
category will restore that part of the process's locale. The
return value is __NULL__ if the request cannot be
honored.
!!CONFORMING TO


ANSI C, POSIX.1
!!NOTES


Linux (that is, GNU libc) supports the portable locales
____ and ____. In the
good old days there used to be support for the European
Latin-1 ____ locale (e.g. in
libc-4.5.21 and libc-4.6.27), and the Russian
____ (more precisely,
__
!!SEE ALSO


locale(1), localedef(1), strcoll(3),
isalpha(3), localeconv(3), strftime(3),
charsets(4), locale(7)
----
40 pages link to setlocale(3):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:24:33 am by "perry"
Edit PageHistory Diff Info LikePages