std::setlocale

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

本地化库

本地环境与平面
locale
use_facet	has_facet
字符分类
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
转换
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
平面类别基类
ctype_base codecvt_base messages_base	time_base money_base
平面类别
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
本地环境限定平面
ctype_byname codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
编码转换平面
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C 本地环境
setlocale localeconv lconv	LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

定义于头文件 <clocale>
char* setlocale( int category, const char* locale);

setlocale 函数安装指定的系统本地环境或其一部分，作为新的 C 本地环境。修改保持效果，并影响所有关乎本地环境的 C 库函数执行，到下次调用 setlocale 为止。若 locale 为空指针，则 setlocale 查询当前 C 本地环境而不修改它。

参数

category	-	本地环境类别标识符， LC_xxx 宏之一。可为 0 。
locale	-	系统限定的本地环境标识符。对于用户偏好的本地环境为 "" ，对于最小本地环境为 "C" 。

返回值

指向窄空终止字符串的指针，它表示应用更改后的 C 本地环境，若存在。或在失败时为空指针。

返回字符串的副本和到 std::setlocale 的此调用中所用的类别，可在程序的后面用来恢复本地环境到此调用结束时的状态。

注意

程序启动过程中，运行任何用户代码前会执行 std::setlocale(LC_ALL, "C"); 的等价代码。

尽管返回类型为 char* ，修改被指向的字符是未定义行为。

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 。

POSIX 亦定义名为 "POSIX" 的本地环境，它始终可访问，并准确等于默认的最小 "C" 本地环境。

POSIX 亦指定后继的 setlocale 调用可以非法化返回的指针，而不仅是被指向的字符串内容。

示例

运行此代码

#include <cstdio>
#include <clocale>
#include <ctime>
#include <cwchar>
 
int main()
{
    // C 本地环境将为启用 UTF-8 的英文；
    // 小数点将为德文
    // 日期和时间格式将为日文
    std::setlocale(LC_ALL, "en_US.UTF-8");
    std::setlocale(LC_NUMERIC, "de_DE.UTF-8");
    std::setlocale(LC_TIME, "ja_JP.UTF-8");
 
    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秒

参阅

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	std::setlocale 所用的本地环境类别 (宏常量)
locale	用以封装文化差异的多态刻面的集合 (类)