setlocale
| 定义于头文件 <locale.h> |
||
| char* setlocale( int category, const char* locale ); |
||
setlocale 函数安装指定的系统本地环境或其一部分作为新的 C 本地环境。这些修改保持有效，并影响所有依赖本地环境的 C 库函数的执行，直到下一次调用 setlocale。如果 locale 是空指针，setlocale 查询当前的 C 本地环境而不修改它。
目录 |
[编辑] 参数
| category | - | 本地环境类别标识符，LC_xxx 宏之一。可以为空。 |
| locale | - | 系统特定的本地环境标识符。可以是 "" 表示用户首选的本地环境，或者 "C" 表示最小本地环境 |
[编辑] 返回值
指向一个窄字符空终止字符串的指针，该字符串标识应用更改后的 C 本地环境（如果有），或者在失败时为空指针。
返回字符串的副本以及在此调用 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 本地环境名称列表. |
