std::regex_traits<CharT>::isctype

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

正则表达式库

类

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

算法

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

迭代器

regex_iterator (C++11)

regex_token_iterator (C++11)

异常

regex_error (C++11)

特性

regex_traits (C++11)

常量

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

正则表达式语法

修改后的 ECMAScript-262 (C++11)

 

std::regex_traits

成员函数

regex_traits::regex_traits

regex_traits::length

regex_traits::translate

regex_traits::translate_nocase

regex_traits::transform

regex_traits::transform_primary

regex_traits::lookup_collatename

regex_traits::lookup_classname

regex_traits::isctype

regex_traits::value

regex_traits::imbue

regex_traits::getloc

 

bool isctype( CharT c, char_class_type f ) const;

确定字符 c 是否属于由 f标识的字符类，而 f 是由 lookup_classname() 返回的值或几个此类值的按位 OR。

标准库中 std::regex_traits 特化的此函数版本执行以下操作

1) 首先将 f 转换为类型 std::ctype_base::mask 的值 m。

对于 std::ctype 页面 lookup_classname() 中的表中列出的每个类别，如果 f 中对应于该类别的位被设置，则 m 中的对应位也将被设置。

2) 然后尝试通过调用 std::use_facet<std::ctype<CharT>>(getloc()).is(m, c) 在注入的区域设置中对字符进行分类。

• 如果返回 true，则 isctype() 也将返回 true。
• 否则，如果 c 等于 '_'，并且 f 包含调用 lookup_classname() 用于字符类 [:w:] 的结果，则返回 true，否则返回 false。

参数

c	-	要分类的字符
f	-	从一次或多次调用 lookup_classname() 获得的位掩码

返回值

如果 c 被 f 分类，则为 true，否则为 false。

示例

运行此代码

#include <iostream>
#include <regex>
#include <string>
 
int main()
{
    std::regex_traits<char> t;
    std::string str_alnum = "alnum";
    auto a = t.lookup_classname(str_alnum.begin(), str_alnum.end());
    std::string str_w = "w"; // [:w:] is [:alnum:] plus '_'
    auto w = t.lookup_classname(str_w.begin(), str_w.end());
    std::cout << std::boolalpha
              << t.isctype('A', w) << ' ' << t.isctype('A', a) << '\n'
              << t.isctype('_', w) << ' ' << t.isctype('_', a) << '\n'
              << t.isctype(' ', w) << ' ' << t.isctype(' ', a) << '\n';
}

输出

true true
true false
false false

演示 lookup_classname() / isctype() 的自定义正则表达式特征实现

运行此代码

#include <cwctype>
#include <iostream>
#include <locale>
#include <regex>
 
// This custom regex traits uses wctype/iswctype to implement lookup_classname/isctype.
struct wctype_traits : std::regex_traits<wchar_t>
{
    using char_class_type = std::wctype_t;
 
    template<class It>
    char_class_type lookup_classname(It first, It last, bool = false) const
    {
        return std::wctype(std::string(first, last).c_str());
    }
 
    bool isctype(wchar_t c, char_class_type f) const
    {
        return std::iswctype(c, f);
    }
};
 
int main()
{
    std::locale::global(std::locale("ja_JP.utf8"));
    std::wcout.sync_with_stdio(false);
    std::wcout.imbue(std::locale());
 
    std::wsmatch m;
    std::wstring in = L"風の谷のナウシカ";
    // matches all characters (they are classified as alnum)
    std::regex_search(in, m, std::wregex(L"([[:alnum:]]+)"));
    std::wcout << "alnums: " << m[1] << '\n'; // prints "風の谷のナウシカ"
    // matches only the katakana
    std::regex_search(in, m,
                      std::basic_regex<wchar_t, wctype_traits>(L"([[:jkata:]]+)"));
    std::wcout << "katakana: " << m[1] << '\n'; // prints "ナウシカ"
}

输出

alnums: 風の谷のナウシカ
katakana: ナウシカ

缺陷报告

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

DR	应用于	已发布的行为	正确行为
LWG 2018	C++11	m 的值未指定	匹配 lookup_classname() 的最小支持

参见

lookup_classname	按名称获取字符类 (公共成员函数)
do_is [虚拟]	对字符或字符序列进行分类 (std::ctype<CharT> 的虚拟受保护成员函数)
iswctype	根据指定的 LC_CTYPE 类别对宽字符进行分类 (函数)