std::use_facet

 

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

 

定义在头文件 <locale> 中
template< class Facet > const Facet& use_facet( const std::locale& loc );

获取由 loc 实现的面引用。

如果 Facet 不是定义包含公共静态成员 id 的面，或它是易变限定的面，则程序格式错误。

参数

loc

-

要查询的区域设置对象

返回值

返回对面的引用。只要任何 std::locale 对象引用该面，此函数返回的引用就有效。

异常

std::bad_cast 如果 std::has_facet<Facet>(loc) == false.

注释

如果在语句结束之后使用从 use_facet 获取的 Facet 对象的引用，则 std::locale 对象不应该是一个临时对象。

// BAD:
auto& f = std::use_facet<std::moneypunct<char, true>>(std::locale{"no_NO.UTF-8"});
foo(f.curr_symbol()); // Error: f internally uses a dangling reference
                      // to a std::locale object that no longer exists.
// GOOD:
auto loc = std::locale{"is_IS.UTF-8"}; // OK: a non-temporary object
auto& f = std::use_facet<std::moneypunct<char, true>>(loc);
foo(f.curr_symbol()); // OK: f internally uses a reference to existing locale object.

示例

显示用户首选区域设置使用的 3 个字母的货币名称。

运行此代码

#include <iostream>
#include <locale>
 
int main()
{
    for (const char* name: {"en_US.UTF-8", "de_DE.UTF-8", "en_GB.UTF-8"})
        std::cout << "Your currency string is "
                  << std::use_facet<std::moneypunct<char, true>>(std::locale{name}).
                     curr_symbol() << '\n';
}

输出

Your currency string is USD
Your currency string is EUR
Your currency string is GBP

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布的行为	正确行为
LWG 31	C++98	返回的引用仍然可用 只要区域设置值本身存在	返回的引用仍然可用，只要 某个区域设置对象引用该面
LWG 38	C++98	Facet 不需要具有直接成员 id	需要
LWG 436	C++98	不清楚 Facet 是否可以是 cv 限定的	可以是常量限定的，但不能是易变限定的

另请参阅

locale	封装文化差异的多态面集 (类)
has_facet	检查区域设置是否实现了特定面 (函数模板)