std::has_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 > bool has_facet( const locale& loc ) throw();		(直到 C++11)
template< class Facet > bool has_facet( const locale& loc ) noexcept;		(自 C++11 起)

检查语言环境 loc 是否实现构面 Facet。

如果 Facet 不是 构面 或它是 volatile 限定的构面，则程序格式错误。

参数

loc

-

要查询的语言环境对象

返回值

如果在语言环境 loc 中安装了构面 Facet，则返回 true，否则返回 false。

备注

如果 Facet 是给定 此处 的标准构面之一，则对于所有语言环境 loc，std::has_facet 必须返回 true。

示例

运行此代码

#include <iostream>
#include <locale>
 
// minimal custom facet
struct myfacet : public std::locale::facet
{
    static std::locale::id id;
};
 
std::locale::id myfacet::id;
 
int main()
{
    // loc is a "C" locale with myfacet added
    std::locale loc(std::locale::classic(), new myfacet);
    std::cout << std::boolalpha
              << "Can loc classify chars? "
              << std::has_facet<std::ctype<char>>(loc) << '\n'
              << "Can loc classify char32_t? "
              << std::has_facet<std::ctype<char32_t>>(loc) << '\n'
              << "Does loc implement myfacet? "
              << std::has_facet<myfacet>(loc) << '\n';
}

输出

Can loc classify chars? true
Can loc classify char32_t? false
Does loc implement myfacet? true

缺陷报告

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

DR	应用于	已发布的行为	正确的行为
LWG 436	C++98	不清楚 Facet 是否可以是 cv 限定的	它可以是 const 限定的，但不能是 volatile 限定的

另请参阅

locale	封装文化差异的多态构面集 (类)
use_facet	从语言环境获取构面 (函数模板)