std::locale::locale

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

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

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

初等数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码识别

text_encoding (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 numeric（数值）刻面 num_get num_put numpunct numpunct_byname collate（校排）刻面 collate collate_byname time（时间）刻面 time_get time_put time_get_byname time_put_byname

monetary（货币）刻面 money_get money_put moneypunct moneypunct_byname messages（消息）刻面 messages messages_byname 字符分类与转换 字符分类 isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph 字符转换 toupper    tolower 字符串与流转换 wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/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

 

std::locale

成员类型

locale::id

locale::facet

成员函数

locale::locale

locale::~locale

locale::operator=

locale::combine

locale::name

locale::encoding (C++26)

locale::operator==locale::operator!= (C++20 前)

locale::operator()

静态成员函数

locale::global

locale::classic

 

	(1)
locale() throw();			(C++11 前)
locale() noexcept;			(C++11 起)
		(2)
locale( const locale& other ) throw();				(C++11 前)
locale( const locale& other ) noexcept;				(C++11 起)
explicit locale( const char* std_name );			(3)
explicit locale( const std::string& std_name );			(4)	(C++11 起)
locale( const locale& other, const char* std_name, category cats );			(5)
locale( const locale& other, const std::string& std_name, category cats );			(6)	(C++11 起)
template< class Facet > locale( const locale& other, Facet* f );			(7)
locale( const locale& other, const locale& one, category cats );			(8)

构造新的本地环境对象。

1) 默认构造函数。构造全局 C++ 本地环境的副本，它是最近用作 std::locale::global 的实参的本地环境，或在未曾调用 std::locale::global 时是 std::locale::classic() 的副本。

2) 复制构造函数。构造 other 的副本。

3) 构造拥有指定 std_name 的系统本地环境（如 "C"、"POSIX"、"en_US.UTF-8" 或 "English_US.1251"）的副本，如果操作系统支持这种本地环境。以此方式构造的本地环境拥有名称。

4) 等价于 locale(std_name.c_str())。

5) 构造 other 的副本，但不包括 cats 实参所鉴别的所有刻面，这些刻面从它们的 std_name 所标识的系统本地环境复制。以此方式构造的本地环境当且仅当 other 拥有名称时拥有名称。

6) 等价于 locale(other, std_name.c_str(), cats)。

7) 构造 other 的副本，不包括 Facet 类型的刻面（典型地从实参类型推导），该刻面从实参 f 安装。如果 f 是空指针，那么构造的本地环境是 other 的完整副本。如果 Facet 不是刻面或者是有 volatile 限定的刻面，那么程序非良构。

如果 f 为空，构造的本地环境的名称与 other 的名称相同。否则构造的本地环境没有名称。

8) 构造 other 的副本，不包括 cats 实参所鉴别的所有刻面，这些刻面从 one 复制。如果 other 和 one 都拥有名称，那么产生的本地环境也拥有名称。

如果 cats 等于 locale::none，那么构造的本地环境只有在 other 有名字时才会有名字。否则构造的本地环境只有在 other 和 one 都有名字时才会有名字。

参数

other	-	要复制的另一本地环境
std_name	-	要使用的系统本地环境名称
f	-	指向要与 other 合并的刻面的指针
cats	-	用于鉴别要与 other 合并的刻面的刻面类别
one	-	接收刻面来源的另一本地环境

异常

3,5) 如果操作系统没有名为 std_name 的本地环境，或 std_name 是空指针，那么就会抛出 std::runtime_error。

4,6) 如果操作系统没有名为 std_name 的本地环境，那么就会抛出 std::runtime_error。

注解

典型地以 f 为第二实参调用重载 (7)，该实参从 new 表达式直接获取：本地环境负责从它自身的析构函数调用匹配的 delete。

示例

运行此代码

#include <codecvt>
#include <iostream>
#include <locale>
 
std::ostream& operator<< (std::ostream& os, const std::locale& loc)
{
    if (loc.name().length() <= 80)
        os << loc.name();
    else
        for (const auto c : loc.name())
            os << c << (c == ';' ? "\n  " : "");
 
    return os << '\n';
}
 
int main()
{
    std::locale l1; 
    std::cout << "经典 \"C\" 本地环境副本的名称: " << l1;
 
    std::locale l2("en_US.UTF-8");
    std::cout << "Unicode 本地环境的名称: " << l2;
 
    std::locale l3(l1, new std::codecvt_utf8<wchar_t>);
    std::cout << "替换 codecvt 的 \"C\" 本地环境的名称: " << l3;
 
    std::locale l4(l1, l2, std::locale::ctype);
    std::cout << "替换 ctype 的 Unicode \"C\" 本地环境的名称:\n  " << l4;
}

可能的输出：

经典 "C" 本地环境副本的名称: C
Unicode 本地环境的名称: en_US.UTF-8
替换 codecvt 的 "C" 本地环境的名称: *
替换 ctype 的 Unicode "C" 本地环境的名称:
  LC_CTYPE=en_US.UTF-8;
  LC_NUMERIC=C;
  LC_TIME=C;
  LC_COLLATE=C;
  LC_MONETARY=C;
  LC_MESSAGES=C;
  LC_PAPER=C;
  LC_NAME=C;
  LC_ADDRESS=C;
  LC_TELEPHONE=C;
  LC_MEASUREMENT=C;
  LC_IDENTIFICATION=C

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 436	C++98	对于重载 (7)，不明确 Facet 是否可以有 cv 限定	可以有 const 限定，但不能有 volatile 限定
LWG 2295	C++98	对于重载 (7)，即使 f 为空，构造的本地环境也没有名称	此时它的名称是 other 的名称

参阅

(析构函数)

析构本地环境和其引用计数变为零的刻面 (公开成员函数)

外部链接

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