C++ 具名要求：正则表达式特征 (RegexTraits)

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

C++ 具名要求

基础 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 类型属性 ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType 全库范围 BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) Allocator FunctionObject Callable Predicate BinaryPredicate Compare

容器 Container ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   容器元素 DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) 迭代器 LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) 流 I/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction 格式化器 BasicFormatter (C++20) Formatter (C++20)

随机数 SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) 并发 BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) 范围 RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) 多维视图 LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) 其他 CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

正则表达式特征 (RegexTraits) 是一种特征类，它在用作 std::basic_regex 的模板类型形参时，抽象对给定字符类型所需的操作。

要求

给定

• CharT，字符类型
• X，CharT 类型的正则表达式特征 (RegexTraits) 类型
• u，X 类型的对象
• v，const X 类型的对象
• p，const CharT* 类型的值
• I1, I2，输入迭代器
• F1, F2，向前迭代器
• c，const CharT 类型的值
• s，X::string_type 类型的对象
• cs，const X::string_type 类型的对象
• b，bool 类型的值
• I，int 类型的值
• cl，X::char_class_type 类型的对象
• loc，X::locale_type 类型的对象

表达式	返回类型	语义
X::char_type	CharT	用于指代字符类型
X::string_type	std::basic_string<CharT>
X::locale_type		表示此特征类所用本地环境的可复制构造 (CopyConstructible) 类型。
X::char_class_type		表示特定字符分类的位掩码类型 (BitmaskType) 。
X::length(p)	std::size_t	返回：满足 p[i] == 0 的最小 i。复杂度与 i 成线性。
v.translate(c)	X::char_type	返回：一个字符，使得对于任何被认为等价于 c 的字符 d，有 v.translate(c) == v.translate(d)。
v.translate_nocase(c)	X::char_type	返回：一个字符，使得对于任何被认为忽略大小写等价于 c 的字符 C，有 v.translate_nocase(c) == v.translate_nocase(C)。
v.transform(F1, F2)	X::string_type	返回：迭代器范围 [F1, F2) 所代表的字符序列的排序键，使得若字符序列 [G1, G2) 排序于字符序列 [H1, H2) 前，则 v.transform(G1, G2) < v.transform(H1, H2)。
v.transform_primary(F1, F2)	X::string_type	返回：迭代器范围 [F1, F2) 所代表的字符序列的排序键，使得若字符序列 [G1, G2) 在忽略大小写的情况下排序于字符序列 [H1, H2) 前，则 v.transform_primary(G1, G2) < v.transform_primary(H1, H2)。
v.lookup_collatename(F1, F2)	X::string_type	返回： 空字符串，若字符序列不是合法的校排元素 否则为字符序列，表示由迭代器范围 [F1, F2) 所代表的字符序列组成的校排元素
v.lookup_classname(F1, F2, b)	X::char_class_type	转换迭代器范围 [F1, F2) 所指代的字符序列为之后能传递给 isctype 的位掩码类型 (BitmaskType) 值 能将从 lookup_classname 返回的值相互逐位或；结果值表示任一对应字符类中的成员关系 若 b 为 true，则返回的位掩码适于不考虑其大小写匹配字符。 若字符序列不是 X 所辨识的字符类的名称，则返回 ​0​。 返回值应当与序列中字符的大小写无关。
v.isctype(c, cl)	bool	返回：c 是否为 cl 所指代的字符类之一的成员。
v.value(c, I)	int	返回： 数位 c 在底 I 进制中表示的值，若字符 c 为底 I 进制中合法的数位 否则为 -1
u.imbue(loc)	X::locale_type	以本地环境 loc 浸染 u 返回：v 先前使用的本地环境，若存在。
v.getloc()	X::locale_type	返回：v 先前使用的本地环境，若存在。

标准库

下列标准库类满足正则表达式特征 (RegexTraits) ：

template<> class regex_traits<char>; template<> class regex_traits<wchar_t>;		(C++11 起) (C++11 起)