operator==,!=,<,<=,>,>=,<=>(std::sub_match)

 

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::sub_match

成员函数

sub_match::sub_match

sub_match::length

sub_match::strsub_match::operator string_type

sub_match::compare

非成员函数

operator==operator!=operator<<operator<=operator>operator>=operator<=> (直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(C++20)

operator<<

 

定义在头文件 <regex> 中
直接比较
template< class BidirIt > bool operator==( const std::sub_match<BidirIt>& lhs,                  const std::sub_match<BidirIt>& rhs );	(1)	(自 C++11)
template< class BidirIt > bool operator!=( const std::sub_match<BidirIt>& lhs,                  const std::sub_match<BidirIt>& rhs );	(2)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<( const std::sub_match<BidirIt>& lhs,                 const std::sub_match<BidirIt>& rhs );	(3)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<=( const std::sub_match<BidirIt>& lhs,                  const std::sub_match<BidirIt>& rhs );	(4)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>( const std::sub_match<BidirIt>& lhs,                 const std::sub_match<BidirIt>& rhs );	(5)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>=( const std::sub_match<BidirIt>& lhs,                  const std::sub_match<BidirIt>& rhs );	(6)	(自 C++11) (直到 C++20)
template< class BidirIt > /*comp-cat*/ operator<=>( const std::sub_match<BidirIt>& lhs,                           const std::sub_match<BidirIt>& rhs );	(7)	(自 C++20)
std::sub_match 和 std::basic_string
template< class BidirIt, class Traits, class Alloc > bool operator==( const std::sub_match<BidirIt>& sm,                  const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& rhs );	(8)	(自 C++11)
template< class BidirIt, class Traits, class Alloc > bool operator!=( const std::sub_match<BidirIt>& sm,                  const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& st );	(9)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator<( const std::sub_match<BidirIt>& sm,                 const std::basic_string<                     typename std::iterator_traits<BidirIt>::value_type,                     Traits,Alloc>& st );	(10)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator<=( const std::sub_match<BidirIt>& sm,                  const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& st );	(11)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator>( const std::sub_match<BidirIt>& sm,                 const std::basic_string<                     typename std::iterator_traits<BidirIt>::value_type,                     Traits,Alloc>& st );	(12)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator>=( const std::sub_match<BidirIt>& sm,                  const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& st );	(13)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > /*comp-cat*/ operator<=>( const std::sub_match<BidirIt>& sm,                           const std::basic_string<                               typename std::iterator_traits<BidirIt>::value_type,                               Traits,Alloc>& st );	(14)	(自 C++20)
std::basic_string 和 std::sub_match
template< class BidirIt, class Traits, class Alloc > bool operator==( const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& st,                  const std::sub_match<BidirIt>& sm );	(15)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator!=( const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& st,                  const std::sub_match<BidirIt>& sm );	(16)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator<( const std::basic_string<                     typename std::iterator_traits<BidirIt>::value_type,                     Traits,Alloc>& st,                 const std::sub_match<BidirIt>& sm );	(17)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator<=( const std::basic_string<                     typename std::iterator_traits<BidirIt>::value_type,                     Traits,Alloc>& st,                 const std::sub_match<BidirIt>& sm );	(18)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator>( const std::basic_string<                     typename std::iterator_traits<BidirIt>::value_type,                     Traits,Alloc>& st,                 const std::sub_match<BidirIt>& sm );	(19)	(自 C++11) (直到 C++20)
template< class BidirIt, class Traits, class Alloc > bool operator>=( const std::basic_string<                      typename std::iterator_traits<BidirIt>::value_type,                      Traits,Alloc>& st,                  const std::sub_match<BidirIt>& sm );	(20)	(自 C++11) (直到 C++20)
std::sub_match 和 std::iterator_traits<BidirIt>::value_type*
template< class BidirIt > bool operator==( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type* s );	(21)	(自 C++11)
template< class BidirIt > bool operator!=( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type* s );	(22)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<( const std::sub_match<BidirIt>& sm,                 const typename std::iterator_traits<BidirIt>::value_type* s );	(23)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<=( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type* s );	(24)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>( const std::sub_match<BidirIt>& sm,                 const typename std::iterator_traits<BidirIt>::value_type* s );	(25)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>=( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type* s );	(26)	(自 C++11) (直到 C++20)
template< class BidirIt > /*comp-cat*/ operator<=>( const std::sub_match<BidirIt>& sm,                           const typename std::iterator_traits<BidirIt>::value_type* s );	(27)	(自 C++20)
std::iterator_traits<BidirIt>::value_type* 和 std::sub_match
template< class BidirIt > bool operator==( const typename std::iterator_traits<BidirIt>::value_type* s,                  const std::sub_match<BidirIt>& sm );	(28)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator!=( const typename std::iterator_traits<BidirIt>::value_type* s,                  const std::sub_match<BidirIt>& sm );	(29)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<( const typename std::iterator_traits<BidirIt>::value_type* s,                 const std::sub_match<BidirIt>& sm );	(30)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<=( const typename std::iterator_traits<BidirIt>::value_type* s,                  const std::sub_match<BidirIt>& sm );	(31)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>( const typename std::iterator_traits<BidirIt>::value_type* s,                 const std::sub_match<BidirIt>& sm );	(32)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>=( const typename std::iterator_traits<BidirIt>::value_type* s,                  const std::sub_match<BidirIt>& sm );	(33)	(自 C++11) (直到 C++20)
std::sub_match 和 std::iterator_traits<BidirIt>::value_type
template< class BidirIt > bool operator==( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type& ch );	(34)	(自 C++11)
template< class BidirIt > bool operator!=( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type& ch );	(35)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<( const std::sub_match<BidirIt>& sm,                 const typename std::iterator_traits<BidirIt>::value_type& ch );	(36)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<=( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type& ch );	(37)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>( const std::sub_match<BidirIt>& sm,                 const typename std::iterator_traits<BidirIt>::value_type& ch );	(38)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>=( const std::sub_match<BidirIt>& sm,                  const typename std::iterator_traits<BidirIt>::value_type& ch );	(39)	(自 C++11) (直到 C++20)
template< class BidirIt > /*comp-cat*/ operator<=>( const std::sub_match<BidirIt>& sm,                           const typename std::iterator_traits<BidirIt>::value_type& ch );	(40)	(自 C++20)
std::iterator_traits<BidirIt>::value_type 和 std::sub_match
template< class BidirIt > bool operator==( const typename std::iterator_traits<BidirIt>::value_type& ch,                  const std::sub_match<BidirIt>& sm );	(41)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator!=( const typename std::iterator_traits<BidirIt>::value_type& ch,                  const std::sub_match<BidirIt>& sm );	(42)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<( const typename std::iterator_traits<BidirIt>::value_type& ch,                 const std::sub_match<BidirIt>& sm );	(43)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator<=( const typename std::iterator_traits<BidirIt>::value_type& ch,                  const std::sub_match<BidirIt>& sm );	(44)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>( const typename std::iterator_traits<BidirIt>::value_type& ch,                 const std::sub_match<BidirIt>& sm );	(45)	(自 C++11) (直到 C++20)
template< class BidirIt > bool operator>=( const typename std::iterator_traits<BidirIt>::value_type& ch,                  const std::sub_match<BidirIt>& sm );	(46)	(自 C++11) (直到 C++20)

比较 sub_match 与另一个 sub_match、字符串、以 null 结尾的字符序列或字符。

1-7) 通过比较其底层字符序列直接比较两个 sub_match。实现方式类似于 lhs.compare(rhs)。

8-20) 比较 sub_match 与 std::basic_string。实现方式类似于 sm.compare(typename sub_match<BidirIt>::string_type(st.data(), st.size()).

21-33) 比较 sub_match 与以 null 结尾的字符串。实现方式类似于 sm.compare(s)。

34-46) 比较 sub_match 与字符。实现方式类似于 sm.compare(typename sub_match<BidirIt>::string_type(1, ch))。

三元比较运算符（/*comp-cat*/）的返回类型是 std::compare_three_way_result_t<typename std::sub_match<BidirIt>::string_type>>，即 std::char_traits<typename std::iterator_traits<BidirIt>::value_type>::comparison_category（如果此限定标识符有效并表示类型），否则为 std::weak_ordering。如果 /*comp-cat*/ 不是比较类别类型，则程序格式错误。 <、<=、>、>= 和 != 运算符分别从 operator<=> 和 operator== 合成。

(自 C++20)

参数

lhs, rhs, sm	-	要比较的 sub_match
st	-	要比较的 basic_string
s	-	要比较的以 null 结尾的字符串指针
ch	-	要比较的字符

返回值

对于 operator==， (自 C++20 起)true 如果相应的比较根据 std::sub_match::compare() 成立，否则为 false。

对于 operator<=>， static_cast</*comp-cat*/>(/*comp-res*/ <=> 0)，其中 /*comp-res*/ 是上面描述的 std::sub_match::compare() 的结果。

(自 C++20)

注释

如果 BidirIt 的值类型为 char、wchar_t、char8_t, char16_t 或 char32_t，则 operator<=> 的返回类型为 std::strong_ordering。

(自 C++20)

缺陷报告

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

DR	应用于	发布的行为	正确的行为
LWG 3432	C++20	operator<=> 的返回类型不需要是比较类别类型	需要

另请参阅

比较	比较匹配的子序列（如果有） (公共成员函数)