setlocale()

Synopsis:

#include <locale.h>

char * setlocale( int category, 
                  const char * locale );

Since:

BlackBerry 10.0.0

Arguments:

category

The part of the environment that you want to set; one of:

LC_ALL — select the entire locale environment.
LC_COLLATE — select only the collating sequence.
LC_CTYPE — select only the character-handling information.
LC_MESSAGES — specify the language to be used for messages.
LC_MONETARY — select only monetary formatting information.
LC_NUMERIC — select only the numeric-format environment.
LC_TIME — select only the time-related environment.

locale

The locale that you want to use. The following built-in locales are offered:

C (default)
C-TRADITIONAL
POSIX

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The setlocale() function selects a program's locale, according to the specified category and the specified locale.

A locale affects several things:

The collating sequence (the order in which characters compare with one another) used by strcoll() or wcscoll() .
The way certain character-handling functions (such as isalnum() and isalpha() ) operate. The wide-character versions include iswalnum() and iswalpha() .
The decimal-point character used in formatted input/output and string conversion ( printf() , scanf() , and friends).
The format and names used in the string produced by the strftime() and wcsftime() functions.

See the localeconv() function for more information about the locale.

At the start of a program, the default C locale is initialized as if the following call to setlocale() appeared at the start of main() :

(void)setlocale( LC_ALL, "C" );

Returns:

The string associated with the specified category for the new locale, or NULL if an error occurs. This function doesn't change the program's locale when error occurs.

Note: For a NULL pointer of locale, this function returns a pointer to the string associated with the category for the program's current locale. This function doesn't change the program's locale.

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	Yes