std::setlocale

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

本地化库

区域设置和面
区域设置
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

字符串和流转换

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()
{
    // Make a "deep copy" of current locale name.
    std::string prev_loc = std::setlocale(LC_ALL, nullptr);
 
    // The C locale will be UTF-8 enabled English,
    // decimal dot will be German,
    // date and time formatting will be Japanese.
    if (const char* loc = std::setlocale(LC_ALL, "en_US.UTF-8"))
        std::wprintf(L"New LC_ALL locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_NUMERIC, "de_DE.UTF-8"))
        std::wprintf(L"New LC_NUMERIC locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_TIME, "ja_JP.UTF-8"))
        std::wprintf(L"New LC_TIME locale: %s\n", loc);
 
    wchar_t buf[100];
    std::time_t t = std::time(nullptr);
    std::wcsftime(buf, std::size(buf), L"%A %c", std::localtime(&t));
    std::wprintf(L"Number: %.2f\nDate: %Ls\n", 3.14, buf);
 
    // Restore the previous locale.
    if (const char* loc = std::setlocale(LC_ALL, prev_loc.c_str()))
        std::wprintf(L"Restorred LC_ALL locale: %s\n", loc);
}

可能的输出

New LC_ALL locale: en_US.UTF-8
New LC_NUMERIC locale: de_DE.UTF-8
New LC_TIME locale: ja_JP.UTF-8
Number: 3,14
Date: 日曜日 2022年11月06日 20時40分59秒
Restorred LC_ALL locale: C

参见

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	区域设置类别，用于 std::setlocale (宏常量)
locale	封装文化差异的多态面集 (类)
C 文档，用于 setlocale

外部链接

1.	Windows 区域设置名称列表.
2.	Linux 区域设置名称列表.