scc

 1.TH setlocale 3 scc\-VERSION
 2.SH NAME
 3setlocale - query or modify the program's current locale
 4.SH SYNOPSIS
 5#include <locale.h>
 6
 7char *setlocale(int category, const char *locale);
 8.SH DESCRIPTION
 9The
10.BR setlocale ()
11function allows querying and changing the active locale of the program,
12either in full or in part.
13When
14.I locale
15is not NULL,
16the program locale is updated according to the given arguments.
17The
18.I category
19argument selects which aspect of the locale to modify:
20
21.nf
22Category   	Governs
23LC_ALL     	All of the locale
24LC_COLLATE 	String collation
25LC_CTYPE   	Character classification
26LC_MONETARY	Formatting of monetary values
27LC_NUMERIC 	Formatting of nonmonetary numeric values
28LC_TIME    	Formatting of date and time values
29.fi
30
31A
32.I locale
33value of
34.B C
35selects the minimal environment for C programs;
36a value of
37.B ""
38selects the native environment of the host system.
39
40At program startup, the locale behaves as if
41.BR setlocale (LC_ALL,"C")
42had been called.
43.SH RETURN VALUE
44On success, a pointer to a string identifying the locale
45associated with the specified
46.I category
47is returned.
48If
49.I locale
50is NULL, the string describes the current locale for that category.
51A subsequent call to
52.B setlocale
53with this string and category will restore that locale.
54The returned string must not be modified by the program;
55it may be overwritten by the next call to
56.BR setlocale .
57.SH STANDARDS
58ISO/IEC 9899:1999 Section 7.11.1.1 Paragraph 1,2,3,4,6,7,8
59.SH SEE ALSO
60.B locale.h(3)