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

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

C++ 具名要求

基础
DefaultConstructible CopyAssignable CopyConstructible	MoveAssignable (C++11) MoveConstructible (C++11) Destructible
类型属性
TrivialType (C++11) TriviallyCopyable (C++11)	StandardLayoutType (C++11) PODType
库所属
EqualityComparable LessThanComparable Swappable (C++11) ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11)	Allocator FunctionObject Callable Predicate BinaryPredicate Compare
容器
Container SequenceContainer ContiguousContainer (C++17) ReversibleContainer	AssociativeContainer AllocatorAwareContainer UnorderedAssociativeContainer (C++11)
容器元素
DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11)	EmplaceConstructible (C++11) Erasable (C++11)
迭代器
LegacyIterator LegacyOutputIterator LegacyInputIterator LegacyForwardIterator	LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20)
流 I/O
FormattedInputFunction UnformattedInputFunction	FormattedOutputFunction UnformattedOutputFunction
随机数
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)
其他
CharTraits RegexTraits (C++11) BitmaskType NumericType LiteralType (C++11)	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	Returns: 数位 c 在 I 中表示的值，若字符 c 为底 I 中合法的数位 否则为 -1
u.imbue(loc)	X::locale_type	以 locale loc 感染 u 返回 v 先前使用的 locale ，若存在。
v.getloc()	X::locale_type	返回 v 先前使用的 locale ，若存在。

标准库

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

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