std::regex_traits<CharT>::isctype

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

正则表达式库

类

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)

正则表达式文法

Modified 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 所标识的字符类，即 lookup_classname() 所返回的值或几个这种值的逐位或的结果。

std::regex_traits 的标准库特化中提供的此函数版本进行下列操作：

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

对于 lookup_classname() 页面中表格列出的每个 std::ctype 分类，如果 f 中设置了该分类对应的位，那么 m 也会设置对应位。

2) 然后试图以浸染的本地环境通过调用 std::use_facet<std::ctype<CharT>>(getloc()).is(m, c) 分类字符。

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

参数

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

返回值

如果 c 以 f 分类就会返回 true，否则返回 false。

示例

运行此代码

#include <iostream>
#include <string>
#include <regex>
 
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:] 是 [:alnum:] 加上 '_'
    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>
 
// 此定制正则表达式特性以 wctype/iswctype 实现 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"風の谷のナウシカ";
    // 匹配所有字符（它们被分类为 alnum ）
    std::regex_search(in, m, std::wregex(L"([[:alnum:]]+)"));
    std::wcout << "alnums：" << m[1] << '\n'; // 打印 "風の谷のナウシカ"
    // 只匹配片假名
    std::regex_search(in, m,
                      std::basic_regex<wchar_t, wctype_traits>(L"([[:jkata:]]+)"));
    std::wcout << "片假名：" << m[1] << '\n'; // 打印 "ナウシカ"
}

输出：

alnum：風の谷のナウシカ
片假名：ナウシカ

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 2018	C++11	未指定 m 的值	与 lookup_classname() 的最低限度支持相匹配

参阅

lookup_classname	以名获得字符类 (公开成员函数)
do_is [虚]	分类字符或字符序列 (std::ctype<CharT> 的虚受保护成员函数)
iswctype	按照指定的 LC_CTYPE 类别分类宽字符 (函数)