SETLOCALE
Section: Linux Programmer's Manual (3)
Updated: April 18, 1993
Index
Return to Main Contents
NAME
setlocale - set the current locale.
SYNOPSIS
#include <locale.h>
char *setlocale(int category, const char * locale);
DESCRIPTION
The
setlocale()
function is used to set or query the program's current locale.
If
locale
is
C or POSIX,
the current locale is set to the portable locale.
If
locale
is
,
the locale is set to the default locale which is selected from the
environment variable
LANG.
On startup of the main program, the portable
C
locale is selected as default.
The argument
category
determines which functions are influenced by the new locale:
- LC_ALL
-
for all of the locale.
- LC_COLLATE
-
for the functions
strcoll() and strxfrm().
- LC_CTYPE
-
for the character classification and conversion routines.
- LC_MONETARY
-
for
localeconv().
- LC_NUMERIC
-
for the decimal character.
- LC_TIME
-
for
strftime().
NULL
if the request cannot not be honored.
This string may be allocated in static storage.
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 and by using
strcoll()
or
strxfrm()
to compare strings.
CONFORMS TO
ANSI C, POSIX.1
Linux supports the portable locales
C and POSIX
and also the European Latin-1
ISO-8859-1
, and Russian
KOI-8
locales.
The
printf()
family of functions may or may not honor the current locale.
SEE ALSO
locale(1), localedef(1), strcoll(3), isalpha(3),
localeconv(3), strftime(3), locale(7)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- CONFORMS TO
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 12:24:01 GMT, March 22, 2025