CppDS.com

C++ 98 11 14 17 20 手册

std::locale

来自cppreference.com
< cpp‎ | locale
定义于头文件 <locale>
class locale;

std::locale 类型对象是不可变平面的不可变索引集。 C++ 输入/输出库的每个流对象与一个 std::locale 对象关联,并用其平面分析及格式化所有数据。另外, locale 对象与每个 std::basic_regex 对象关联。 locale 对象亦可在标准容器和算法中用作进行字符串对照的谓词,而且能被直接访问,以获得或修改其所保有的平面。

C++ 程序中构造的每个 locale 至少保有下列标准平面,但程序可以定义额外特化,或全新的平面,并将它们添加到任何既存的 locale 对象。

受支持平面
std::collate<char> std::collate<wchar_t>
std::ctype<char> std::ctype<wchar_t>
std::codecvt<char,char,mbstate_t>
std::codecvt<char16_t,char,mbstate_t>
std::codecvt<char32_t,char,mbstate_t>
std::codecvt<wchar_t,char,mbstate_t>
std::moneypunct<char>
std::moneypunct<char,true>
std::moneypunct<wchar_t>
std::moneypunct<wchar_t,true>
std::money_get<char> std::money_get<wchar_t>
std::money_put<char> std::money_put<wchar_t>
std::numpunct<char> std::numpunct<wchar_t>
std::num_get<char> std::num_get<wchar_t>
std::num_put<char> std::num_put<wchar_t>
std::time_get<char> std::time_get<wchar_t>
std::time_put<char> std::time_put<wchar_t>
std::messages<char> std::messages<wchar_t>

在内部, locale 对象实现为如同它是一个指向(以 std::locale::id 索引的)的数组的引用计数指针,数组元素为指向平面的引用计数指针:复制 locale 只复制一个指针,并增加几个引用计数。为维护标准 C++ 库线程安全保证(不同对象上的操作始终为线程安全), locale 引用计数和每个平面的引用计数都以线程安全方式更新,类似 std::shared_ptr

成员类型

平面索引类型:每个平面类必须声明或继承此类型的公开静态成员
(类)
所有平面分类的分类:任何分类的每个 facet 都从此类型导出
(类)
category
int
(typedef)

成员对象

none
[静态]
指示无平面类别的 category 类型零值
(公开静态成员常量)
collate
[静态]
category 类型位掩码值
(公开静态成员常量)
ctype
[静态]
category 类型位掩码值
(公开静态成员常量)
monetary
[静态]
category 类型位掩码值
(公开静态成员常量)
numeric
[静态]
category 类型位掩码值
(公开静态成员常量)
time
[静态]
category 类型位掩码值
(公开静态成员常量)
messages
[静态]
category 类型位掩码值
(公开静态成员常量)
all
[静态]
collate | ctype | monetary | numeric | time | messages
(公开静态成员常量)

成员函数

构造新的 locale
(公开成员函数)
析构 locale 和其引用计数变为零的平面
(公开成员函数)
替换 locale
(公开成员函数)
以复制自另一 locale 的编译时鉴别的平面构造 locale
(公开成员函数)
返回 locale 的名称,或若它无名则为 "*"
(公开成员函数)
(C++20 中移除)
locale 对象之间的相等性比较
(公开成员函数)
用此 locale 的 collate 刻面以字典序比较两个字符串
(公开成员函数)
[静态]
更改全局本地环境
(公开静态成员函数)
[静态]
获得到 "C" 本地环境的引用
(公开静态成员函数)

示例

演示本地环境影响的程序(跨平台)的典型前文

#include <iostream>
#include <locale>
 
int main()
{
    std::wcout << "User-preferred locale setting is " << std::locale("").name().c_str() << '\n';
    // 在启动时,全局本地环境是 "C" 本地环境
    std::wcout << 1000.01 << '\n';
    // 以用户偏好的本地环境替换 C++ 本地环境和 C 本地环境
    std::locale::global(std::locale(""));
    // 将来的宽字符输出使用新的全局本地环境
    std::wcout.imbue(std::locale());
    // 再次输出同一数字
    std::wcout << 1000.01 << '\n';
}

可能的输出:

User-preferred locale setting is en_US.UTF8
1000.01
1,000.01

参阅

从本地环境获得一个刻面
(函数模板)
检查本地环境是否实现特定的刻面
(函数模板)
设置本地环境
(std::ios_base 的公开成员函数)
返回当前本地环境
(std::ios_base 的公开成员函数)
关闭