std::setlocale
来自cppreference.com
 |
该页由英文版wiki使用Google Translate机器翻译而来。
该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里. |
| 在头文件 <clocale> 中定义
|
||
| char* setlocale( int category, const char* locale); |
||
setlocale功能安装指定的系统区域设置或部分作为新的C语言环境。的修改仍然有效，并影响到执行的所有语言环境敏感的C库函数，直到下一次调用setlocale。 locale是一个空指针，setlocale查询当前的C语言环境，而无需修改原文：
The
setlocale function installs the specified system locale or its portion as the new C locale. The modifications remain in effect and influences the execution of all locale-sensitive C library functions until the next call to setlocale. If locale is a null pointer, setlocale queries the current C locale without modifying it.目录 |
[编辑] 参数
| category | - | 宏之一。可能是空的 |
| locale | - | 系统特定的区域设置标识符。 ""为用户首选的语言环境或的最小的语言环境。"C"功能安装指定的系统区域设置或修改的部分作为新的C语言环境。留在效果和影响所有语言环境敏感的C库函数的执行
原文： system-specific locale identifier. Can be "" for the user-preferred locale or "C" for the minimal locale |
[编辑] 返回值
指针指向一个狭窄的空结束的字符串识别应用变更后的C语言环境，如果有的话，则返回null指针故障
原文：
Pointer to a narrow null-terminated string identifying the C locale after applying the changes, if any, or null pointer on failure.
[编辑] 注释
在程序启动时，相当于std::setlocale(LC_ALL, "C");任何用户代码运行之前执行.
原文：
During program startup, the equivalent of std::setlocale(LC_ALL, "C"); is executed before any user code is run.
虽然返回类型是char*，修改所指向的字符是不确定的行为.
原文：
Although the return type is char*, modifying the pointed-to characters is undefined behavior.
，因为
setlocale修改全球状态，影响执行的语言环境相关的功能，它是不确定的行为从一个线程来调用它，而另一个线程正在执行以下功能：std::fprintf，std::isprint，std::iswdigit，std::localeconv，std::tolower，std::fscanf，std::ispunct，std::iswgraph，std::mblen， std::toupper，std::isalnum，std::isspace，std::iswlower，std::mbstowcs，std::towlower，std::isalpha，std::isupper，std::iswprint，std::mbtowc，std::towupper，std::isblank，std::iswalnum，std::iswpunct，std::setlocale，std::wcscoll，std::iscntrl，std::iswalpha，std::iswspace，std::strcoll，std::wcstod，std::isdigit，std::iswblank，std::iswupper，std::strerror， std::wcstombs，std::isgraph，std::iswcntrl，std::iswxdigit，std::strtod，std::wcsxfrm，std::islower，std::iswctype，std::isxdigit.原文：
Because
setlocale modifies global state which affects execution of locale-dependent functions, it is undefined behavior to call it from one thread, while another thread is executing any of the following functions: std::fprintf, std::isprint, std::iswdigit, std::localeconv, std::tolower, std::fscanf, std::ispunct, std::iswgraph, std::mblen, std::toupper, std::isalnum, std::isspace, std::iswlower, std::mbstowcs, std::towlower, std::isalpha, std::isupper, std::iswprint, std::mbtowc, std::towupper, std::isblank, std::iswalnum, std::iswpunct, std::setlocale, std::wcscoll, std::iscntrl, std::iswalpha, std::iswspace, std::strcoll, std::wcstod, std::isdigit, std::iswblank, std::iswupper, std::strerror, std::wcstombs, std::isgraph, std::iswcntrl, std::iswxdigit, std::strtod, std::wcsxfrm, std::islower, std::iswctype, std::isxdigit.[编辑] 示例
#include <cstdio> #include <clocale> #include <ctime> #include <cwchar> int main() { // the C locale will be UTF-8 enabled English; // decimal dot will be German // date and time formatting will be Japanese std::setlocale(LC_ALL, "en_US.UTF-8"); std::setlocale(LC_NUMERIC, "de_DE"); std::setlocale(LC_TIME, "ja_JP"); wchar_t str[100]; std::time_t t = std::time(NULL); std::wcsftime(str, 100, L"%A %c", std::localtime(&t)); std::wprintf(L"Number: %.2f\nDate: %Ls\n", 3.14, str); }
输出：
Number: 3,14 Date: 月曜日 2011年12月19日 18時04分40秒
[编辑] 另请参阅
| std::setlocale的语言环境类别 原文： locale categories for std::setlocale （常量宏） | |
| 多态的文化差异方面的封装 原文： set of polymorphic facets that encapsulate cultural differences （类） | |
| C documentation for setlocale
| |
