setlocale.3 (1641B)
1 .TH setlocale 3 2 .SH NAME 3 setlocale - set the current locale 4 .SH SYNOPSIS 5 #include <locale.h> 6 7 char *setlocale(int category, const char *locale); 8 .SH DESCRIPTION 9 The 10 .BR setlocale () 11 function is used to set or query the program's current locale. 12 It can be used to set or query the locale entirely or partially. 13 If 14 .I locale 15 is not NULL, 16 the program's current locale is modified according to the arguments. 17 The argument 18 .I category 19 determines which parts of the program's current locale 20 should be modified. 21 22 .nf 23 Category Governs 24 LC_ALL All of the locale 25 LC_COLLATE String collation 26 LC_CTYPE Character classification 27 LC_MONETARY Formatting of monetary values 28 LC_NUMERIC Formatting of nonmonetary numeric values 29 LC_TIME Formatting of date and time values 30 .fi 31 32 A value of 33 .B C 34 for 35 .I locale 36 specifies the minimum environment for C translation; 37 a value of " " for 38 .I locale 39 specifies the locale-specific native environment. 40 41 At program startup, 42 .BR setlocale (LC_ALL,"C"); 43 is executed. 44 .SH RETURN VALUE 45 A pointer to the string associated with the specified 46 .I category 47 for the new 48 .I locale 49 is returned if it can be honored. 50 A pointer to the string associated with the specified 51 .I category 52 for the current locale is returned if 53 .I locale 54 is NULL. 55 The string returned is such that a subsequent call 56 with that string value and its associated category 57 will restore that part of the program's locale. 58 The string pointed to shall not be modified by the program, 59 but may be overwritten by a subsequent call to the setlocale function. 60 .SH STANDARDS 61 ISO/IEC 9899:1999 Section 7.11.1.1 Paragraph 1,2,3,4,6,7,8 62 .SH SEE ALSO 63 .B locale.h(3)