std::setlocale

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

本地化库

本地环境与刻面
本地环境
has_facet use_facet	locale
刻面类别基类
ctype_base codecvt_base messages_base	time_base money_base
ctype （字符分类）刻面
ctype ctype<char> ctype_byname	codecvt codecvt_byname
（数值）刻面
num_get num_put	numpunct numpunct_byname
（校排）刻面
collate	collate_byname
（时间）刻面
time_get time_put	time_get_byname time_put_byname
（货币）刻面
money_get money_put	moneypunct moneypunct_byname
（消息）刻面
messages	messages_byname

字符分类与转换
字符分类
isspace isblank (C++11) iscntrl	isupper islower isalpha	ispunct isdigit isxdigit	isalnum isprint isgraph

字符转换

toupper

tolower

String and stream conversions

wstring_convert (C++11/17/26*)

wbuffer_convert (C++11/17/26*)

文本编码识别

text_encoding (C++26)

Unicode 转换刻面

codecvt_utf8 (C++11/17/26*)

codecvt_utf16 (C++11/17/26*)

codecvt_utf8_utf16 (C++11/17/26*)

codecvt_mode (C++11/17/26*)

C 库本地环境
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

在标头 <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 <clocale>
#include <cstdio>
#include <ctime>
#include <cwchar>
#include <iterator>
#include <string>
 
int main()
{
    // 制作当前本地环境名称的“深拷贝”
    std::string prev_loc = std::setlocale(LC_ALL, nullptr);
 
    // C 本地环境将为启用 UTF-8 的英文；
    // 小数点将为德文
    // 日期和时间格式将为日文
    if (const char* loc = std::setlocale(LC_ALL, "en_US.UTF-8"))
        std::wprintf(L"新的 LC_ALL 本地环境: %s\n", loc);
    if (const char* loc = std::setlocale(LC_NUMERIC, "de_DE.UTF-8"))
        std::wprintf(L"新的 LC_NUMERIC 本地环境: %s\n", loc);
    if (const char* loc = std::setlocale(LC_TIME, "ja_JP.UTF-8"))
        std::wprintf(L"新的 LC_TIME 本地环境: %s\n", loc);
 
    wchar_t str[100];
    std::time_t t = std::time(NULL);
    std::wcsftime(str, 100, L"%A %c", std::localtime(&t));
    std::wprintf(L"数值: %.2f\n日期: %ls\n", 3.14, str);
 
    // 恢复之前的本地环境。
    if (const char* loc = std::setlocale(LC_ALL, prev_loc.c_str()))
        std::wprintf(L"已恢复 LC_ALL 本地环境: %s\n", loc);
}

可能的输出：

新的 LC_ALL 本地环境: en_US.UTF-8
新的 LC_NUMERIC 本地环境: de_DE.UTF-8
新的 LC_TIME 本地环境: ja_JP.UTF-8
数值: 3,14
日期: 日曜日 2022年11月06日 20時40分59秒
已恢复 LC_ALL 本地环境: C

参阅

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

外部链接

1.	Windows 本地环境名字列表。
2.	Linux 本地环境名字列表。