setlocale
定义于头文件 <locale.h> |
||
char* setlocale( int category, const char* locale ); |
||
setlocale
函数将指定的系统区域设置或其一部分安装为新的 C 区域设置。修改会一直生效,并影响所有区域设置敏感的 C 库函数的执行,直到下一次调用 setlocale
。如果 locale
是一个空指针,setlocale
查询当前的 C 区域设置而不修改它。
目录 |
[编辑] 参数
category | - | 区域设置类别标识符,是 LC_xxx 宏之一。可以为空。 |
locale | - | 系统特定的区域设置标识符。对于用户首选的区域设置可以是 "",对于最小区域设置可以是 "C" |
[编辑] 返回值
指向窄的以 null 结尾的字符串的指针,该字符串标识应用更改后的 C 区域设置(如果有),失败时为 null 指针。
返回字符串的副本以及此 setlocale
调用中使用的类别,可以在程序后面用于将区域设置恢复到此调用结束时的状态。
[编辑] 注意
在程序启动期间,在运行任何用户代码之前,会执行等同于 setlocale(LC_ALL, "C"); 的操作。
尽管返回类型是 char*,但修改指向的字符是未定义行为。
因为 setlocale
修改了影响区域设置相关函数执行的全局状态,所以在一个线程中调用它,而另一个线程正在执行以下任何函数时,是未定义行为:fprintf、isprint、iswdigit、localeconv、tolower、fscanf、ispunct、iswgraph、mblen、toupper、isalnum、isspace、iswlower、mbstowcs、towlower、isalpha、isupper、iswprint、mbtowc、towupper、isblank、iswalnum、iswpunct、setlocale
、wcscoll、iscntrl、iswalpha、iswspace、strcoll、wcstod、isdigit、iswblank、iswupper、strerror、wcstombs、isgraph、iswcntrl、iswxdigit、strtod、wcsxfrm、islower、iswctype、isxdigit。
POSIX 还定义了一个名为 "POSIX" 的区域设置,它始终可访问,并且与默认的最小 "C" 区域设置完全等效。
POSIX 还规定,返回的指针(而不仅仅是指向的字符串的内容)可能会因后续调用 setlocale
而失效。
[编辑] 示例
#include <locale.h> #include <stdio.h> #include <time.h> #include <wchar.h> int main(void) { // the C locale will be UTF-8 enabled English; // decimal dot will be German // date and time formatting will be Japanese setlocale(LC_ALL, "en_US.UTF-8"); setlocale(LC_NUMERIC, "de_DE.utf8"); setlocale(LC_TIME, "ja_JP.utf8"); wchar_t str[100]; time_t t = time(NULL); wcsftime(str, 100, L"%A %c", localtime(&t)); wprintf(L"Number: %.2f\nDate: %ls\n", 3.14, str); }
可能的输出
Number: 3,14 Date: 月曜日 2017年09月25日 13時00分15秒
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- 7.11.1.1 setlocale 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- 7.11.1.1 setlocale 函数 (p: 163-164)
- C11 标准 (ISO/IEC 9899:2011)
- 7.11.1.1 setlocale 函数 (p: 224-225)
- C99 标准 (ISO/IEC 9899:1999)
- 7.11.1.1 setlocale 函数 (p: 205-206)
- C89/C90 标准 (ISO/IEC 9899:1990)
- 4.4.1.1 setlocale 函数
[编辑] 另请参阅
setlocale 的区域设置类别 (宏常量) | |
C++ 文档 关于 setlocale
|
[编辑] 外部链接
1. | Windows 区域设置名称列表. |
2. | Linux 区域设置名称列表. |