Public Types¶

typedef __iter_traits::difference_type difference_type
typedef _BiIter first_type
The type of the first member. typedef _BiIter iterator
typedef _BiIter second_type
The type of the second member. typedef basic_string< value_type > string_type
typedef __iter_traits::value_type value_type

Public Member Functions¶

int compare (const sub_match &__s) const
Compares this and another matched sequence. difference_type length () const noexcept
Gets the length of the matching sequence. operator string_type () const
Gets the matching sequence as a string. string_type str () const
Gets the matching sequence as a string. constexpr void swap (pair &__p) noexcept(__and_< __is_nothrow_swappable< _BiIter >, __is_nothrow_swappable< _BiIter > >::value)
Swap the first members and then the second members.

int compare (const string_type &__s) const
Compares this sub_match to a string. int compare (const value_type *__s) const
Compares this sub_match to a string.

Public Attributes¶

_BiIter first
The first member. bool matched
_BiIter second
The second member.

Related Symbols¶

(Note that these are not member symbols.)

template<typename _BiIter> bool operator== (const sub_match< _BiIter > &__lhs, const sub_match< _BiIter > &__rhs)
Tests the equivalence of two regular expression submatches. template<typename _BiIter> bool operator!= (const sub_match< _BiIter > &__lhs, const sub_match< _BiIter > &__rhs)
Tests the inequivalence of two regular expression submatches. template<typename _BiIter> bool operator< (const sub_match< _BiIter > &__lhs, const sub_match< _BiIter > &__rhs)
Tests the ordering of two regular expression submatches. template<typename _BiIter> bool operator<= (const sub_match< _BiIter > &__lhs, const sub_match< _BiIter > &__rhs)
Tests the ordering of two regular expression submatches. template<typename _BiIter> bool operator>= (const sub_match< _BiIter > &__lhs, const sub_match< _BiIter > &__rhs)
Tests the ordering of two regular expression submatches. template<typename _BiIter> bool operator> (const sub_match< _BiIter > &__lhs, const sub_match< _BiIter > &__rhs)
Tests the ordering of two regular expression submatches. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator== (const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the equivalence of a string and a regular expression submatch. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator!= (const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the inequivalence of a string and a regular expression submatch. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator< (const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a string and a regular expression submatch. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator> (const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a string and a regular expression submatch. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator>= (const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a string and a regular expression submatch. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator<= (const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a string and a regular expression submatch. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator== (const sub_match< _Bi_iter > &__lhs, const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__rhs)
Tests the equivalence of a regular expression submatch and a string. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator!= (const sub_match< _Bi_iter > &__lhs, const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__rhs)
Tests the inequivalence of a regular expression submatch and a string. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator< (const sub_match< _Bi_iter > &__lhs, const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__rhs)
Tests the ordering of a regular expression submatch and a string. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator> (const sub_match< _Bi_iter > &__lhs, const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__rhs)
Tests the ordering of a regular expression submatch and a string. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator>= (const sub_match< _Bi_iter > &__lhs, const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__rhs)
Tests the ordering of a regular expression submatch and a string. template<typename _Bi_iter, typename _Ch_traits, typename _Ch_alloc> bool operator<= (const sub_match< _Bi_iter > &__lhs, const __sub_match_string< _Bi_iter, _Ch_traits, _Ch_alloc > &__rhs)
Tests the ordering of a regular expression submatch and a string. template<typename _Bi_iter> bool operator== (typename iterator_traits< _Bi_iter >::value_type const *__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the equivalence of a C string and a regular expression submatch. template<typename _Bi_iter> bool operator!= (typename iterator_traits< _Bi_iter >::value_type const *__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the inequivalence of a C string and a regular expression submatch. template<typename _Bi_iter> bool operator< (typename iterator_traits< _Bi_iter >::value_type const *__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a C string and a regular expression submatch. template<typename _Bi_iter> bool operator> (typename iterator_traits< _Bi_iter >::value_type const *__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a C string and a regular expression submatch. template<typename _Bi_iter> bool operator>= (typename iterator_traits< _Bi_iter >::value_type const *__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a C string and a regular expression submatch. template<typename _Bi_iter> bool operator<= (typename iterator_traits< _Bi_iter >::value_type const *__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a C string and a regular expression submatch. template<typename _Bi_iter> bool operator== (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const *__rhs)
Tests the equivalence of a regular expression submatch and a C string. template<typename _Bi_iter> bool operator!= (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const *__rhs)
Tests the inequivalence of a regular expression submatch and a string. template<typename _Bi_iter> bool operator< (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const *__rhs)
Tests the ordering of a regular expression submatch and a C string. template<typename _Bi_iter> bool operator> (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const *__rhs)
Tests the ordering of a regular expression submatch and a C string. template<typename _Bi_iter> bool operator>= (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const *__rhs)
Tests the ordering of a regular expression submatch and a C string. template<typename _Bi_iter> bool operator<= (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const *__rhs)
Tests the ordering of a regular expression submatch and a C string. template<typename _Bi_iter> bool operator== (typename iterator_traits< _Bi_iter >::value_type const &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the equivalence of a character and a regular expression submatch. template<typename _Bi_iter> bool operator!= (typename iterator_traits< _Bi_iter >::value_type const &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the inequivalence of a character and a regular expression submatch. template<typename _Bi_iter> bool operator< (typename iterator_traits< _Bi_iter >::value_type const &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a character and a regular expression submatch. template<typename _Bi_iter> bool operator> (typename iterator_traits< _Bi_iter >::value_type const &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a character and a regular expression submatch. template<typename _Bi_iter> bool operator>= (typename iterator_traits< _Bi_iter >::value_type const &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a character and a regular expression submatch. template<typename _Bi_iter> bool operator<= (typename iterator_traits< _Bi_iter >::value_type const &__lhs, const sub_match< _Bi_iter > &__rhs)
Tests the ordering of a character and a regular expression submatch. template<typename _Bi_iter> bool operator== (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const &__rhs)
Tests the equivalence of a regular expression submatch and a character. template<typename _Bi_iter> bool operator!= (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const &__rhs)
Tests the inequivalence of a regular expression submatch and a character. template<typename _Bi_iter> bool operator< (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const &__rhs)
Tests the ordering of a regular expression submatch and a character. template<typename _Bi_iter> bool operator> (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const &__rhs)
Tests the ordering of a regular expression submatch and a character. template<typename _Bi_iter> bool operator>= (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const &__rhs)
Tests the ordering of a regular expression submatch and a character. template<typename _Bi_iter> bool operator<= (const sub_match< _Bi_iter > &__lhs, typename iterator_traits< _Bi_iter >::value_type const &__rhs)
Tests the ordering of a regular expression submatch and a character. template<typename _Ch_type, typename _Ch_traits, typename _Bi_iter> basic_ostream< _Ch_type, _Ch_traits > & operator<< (basic_ostream< _Ch_type, _Ch_traits > &__os, const sub_match< _Bi_iter > &__m)
Inserts a matched string into an output stream.

constexpr bool operator== (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Two pairs of the same type are equal iff their members are equal. constexpr bool operator== (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Two pairs of the same type are equal iff their members are equal. constexpr bool operator< (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
constexpr bool operator< (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
constexpr bool operator!= (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator== to find the result. constexpr bool operator!= (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator== to find the result. constexpr bool operator> (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator< to find the result. constexpr bool operator> (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator< to find the result. constexpr bool operator<= (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator< to find the result. constexpr bool operator<= (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator< to find the result. constexpr bool operator>= (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator< to find the result. constexpr bool operator>= (const pair< _BiIter, _BiIter > &__x, const pair< _BiIter, _BiIter > &__y)
Uses operator< to find the result. constexpr enable_if< __and_< __is_swappable< _BiIter >, __is_swappable< _BiIter > >::value >::type swap (pair< _BiIter, _BiIter > &__x, pair< _BiIter, _BiIter > &__y) noexcept(noexcept(__x.swap(__y)))
constexpr enable_if< __and_< __is_swappable< _BiIter >, __is_swappable< _BiIter > >::value >::type swap (pair< _BiIter, _BiIter > &__x, pair< _BiIter, _BiIter > &__y) noexcept(noexcept(__x.swap(__y)))

template<typename _BiIter>¶

class std::sub_match< _BiIter >"A sequence of characters matched by a particular marked sub-expression.

An object of this class is essentially a pair of iterators marking a matched subexpression within a regular expression pattern match. Such objects can be converted to and compared with std::basic_string objects of a similar base character type as the pattern matched by the regular expression.

The iterators that make up the pair are the usual half-open interval referencing the actual original pattern matched.

typedef _BiIter std::pair< _BiIter, _BiIter >::first_type [inherited]¶

The type of the first member.

typedef _BiIter std::pair< _BiIter, _BiIter >::second_type [inherited]¶

The type of the second member.

template<typename _BiIter> int std::sub_match< _BiIter >::compare (const string_type & __s) const [inline]¶

Compares this sub_match to a string.

Parameters

Return values

template<typename _BiIter> int std::sub_match< _BiIter >::compare (const sub_match< _BiIter > & __s) const [inline]¶

Compares this and another matched sequence.

Parameters

Return values

Referenced by std::sub_match< const char * >::operator!=(), std::sub_match< const char * >::operator<(), std::sub_match< const char * >::operator<(), std::sub_match< const char * >::operator<(), std::sub_match< const char * >::operator<=(), std::sub_match< const char * >::operator==(), std::sub_match< const char * >::operator==(), std::sub_match< const char * >::operator==(), std::sub_match< const char * >::operator>(), and std::sub_match< const char * >::operator>=().

template<typename _BiIter> int std::sub_match< _BiIter >::compare (const value_type * __s) const [inline]¶

Compares this sub_match to a string.

Parameters

Return values

template<typename _BiIter> difference_type std::sub_match< _BiIter >::length () const [inline], [noexcept]¶

Gets the length of the matching sequence.

template<typename _BiIter> std::sub_match< _BiIter >::operator string_type () const [inline]¶

Gets the matching sequence as a string.

Returns

This is the implicit conversion operator. It is identical to the str() member function except that it will want to pop up in unexpected places and cause a great deal of confusion and cursing from the unwary.

template<typename _BiIter> string_type std::sub_match< _BiIter >::str () const [inline]¶

Gets the matching sequence as a string.

Returns

Referenced by std::sub_match< const char * >::operator string_type().

void std::pair< _BiIter, _BiIter >::swap (pair< _BiIter, _BiIter > & __p) [inline], [constexpr], [noexcept], [inherited]¶

Swap the first members and then the second members.

bool operator!= (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator== to find the result.

bool operator!= (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator== to find the result.

bool operator< (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Defines a lexicographical order for pairs.

For two pairs of the same type, P is ordered before Q if P.first is less than Q.first, or if P.first and Q.first are equivalent (neither is less than the other) and P.second is less than Q.second.

bool operator< (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Defines a lexicographical order for pairs.

For two pairs of the same type, P is ordered before Q if P.first is less than Q.first, or if P.first and Q.first are equivalent (neither is less than the other) and P.second is less than Q.second.

bool operator<= (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator< to find the result.

bool operator<= (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator< to find the result.

bool operator== (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Two pairs of the same type are equal iff their members are equal.

bool operator== (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Two pairs of the same type are equal iff their members are equal.

bool operator> (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator< to find the result.

bool operator> (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator< to find the result.

bool operator>= (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator< to find the result.

bool operator>= (const pair< _BiIter, _BiIter > & __x, const pair< _BiIter, _BiIter > & __y) [related]¶

Uses operator< to find the result.

enable_if< __and_< __is_swappable< _BiIter >, __is_swappable< _BiIter > >::value >::type swap (pair< _BiIter, _BiIter > & __x, pair< _BiIter, _BiIter > & __y) [related]¶

Swap overload for pairs. Calls std::pair::swap().

Note

enable_if< __and_< __is_swappable< _BiIter >, __is_swappable< _BiIter > >::value >::type swap (pair< _BiIter, _BiIter > & __x, pair< _BiIter, _BiIter > & __y) [related]¶

Swap overload for pairs. Calls std::pair::swap().

Note

_BiIter std::pair< _BiIter, _BiIter >::first [inherited]¶

The first member.

_BiIter std::pair< _BiIter, _BiIter >::second [inherited]¶

The second member.