Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

setlocale(3) OSS Library Calls Reference Manual
NAME
setlocale - Changes or queries the program’s current locale
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <locale.h>
char *setlocale(
int category,
const char *locale);
PARAMETERS
category Specifies the category of the locale to set or query. The category can be
LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES,
LC_MONETARY, LC_NUMERIC,orLC_TIME.
locale Points to a string that specifies the locale.
DESCRIPTION
The setlocale( ) function sets or queries the appropriate portion of the program’s locale as
specified by the category and locale parameters.
Guardian processes only support the C/POSIX locale. Thus, the setlocale( ) function always
returns "C" for Guardian processes if the arguments category and locale are valid.
The LC_ALL value for the category parameter names the entire locale; the other values name
only a portion of the program locale, as follows:
LC_COLLATE
Affects the behavior of collation functions and regular expressions.
LC_CTYPE Affects the behavior of character classification functions, character conversion
functions, and regular expressions.
LC_MESSAGES
Affects the language used to display application program and utilities messages
(when translations of the messages are available) and the strings expected as
affirmative and negative responses.
LC_MONETARY
Affects the behavior of functions that handle monetary values.
LC_NUMERIC
Affects the radix character for the formatted input/output functions and the string
conversion functions.
LC_TIME Affects the behavior of the time conversion functions.
The behavior of the language information function defined in the nl_langinfo( ) function is also
affected by settings of the category parameter.
The locale parameter points to a character string that identifies the locale that is to be used to set
the category parameter. The locale parameter can either specify the name of a locale, such as
fr_CA.ISO8859-1 or it can specify one of the following:
6−34 Hewlett-Packard Company 527187-017