| std::sub_match< _BiIter >(3) | Library Functions Manual | std::sub_match< _BiIter >(3) | 
NAME¶
std::sub_match< _BiIter >
SYNOPSIS¶
Inherits std::pair< _BiIter, _BiIter >.
Public Types¶
using _PCCFP = _PCC<!is_same< _BiIter, _U1
    >::value||!is_same< _BiIter, _U2 >::value, _BiIter, _BiIter
    >
  
  using _PCCP = _PCC< true, _BiIter, _BiIter >
  
  typedef __iter_traits::difference_type difference_type
  
  typedef _BiIter first_type
  
  typedef _BiIter iterator
  
  typedef _BiIter second_type
  
  first_type is the first bound type  typedef
    std::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. 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 C-style string. difference_type length ()
    const
  
  operator string_type () const
  
  Gets the matching sequence as a string. string_type str () const
  
  Gets the matching sequence as a string. void swap (pair
    &__p) noexcept(__and_< __is_nothrow_swappable< _BiIter >,
    __is_nothrow_swappable< _BiIter >>::value)
  
  
Public Attributes¶
_BiIter first
  
  second_type is the second bound type  bool matched
  
  _BiIter second
  
  first is a copy of the first object 
  
Detailed Description¶
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.
Definition at line 864 of file regex.h.
Member Typedef Documentation¶
using std::pair< _BiIter , _BiIter >::_PCCFP = _PCC<!is_same<_BiIter , _U1>::value || !is_same<_BiIter , _U2>::value, _BiIter , _BiIter > [inherited]¶
There is also a templated copy ctor for the pair class itself.
Definition at line 283 of file stl_pair.h.
using std::pair< _BiIter , _BiIter >::_PCCP = _PCC<true, _BiIter , _BiIter > [inherited]¶
Two objects may be passed to a pair constructor to be copied.
Definition at line 252 of file stl_pair.h.
typedef _BiIter std::pair< _BiIter , _BiIter >::second_type [inherited]¶
first_type is the first bound type
Definition at line 212 of file stl_pair.h.
Member Function Documentation¶
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:
=0 this matched sequence is equivalent to __s.
<0 this matched sequence will collate after __s.
Definition at line 925 of file regex.h.
Referenced by std::operator!=(), std::operator<(), std::operator<=(), std::operator==(), std::operator>(), and std::operator>=().
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:
=0 this matched sequence is equivalent to __s.
<0 this matched sequence will collate after __s.
Definition at line 938 of file regex.h.
template<typename _BiIter> int std::sub_match< _BiIter >::compare (const value_type * __s) const [inline]¶
Compares this sub_match to a C-style string.
Parameters:
Return values:
=0 this matched sequence is equivalent to __s.
<0 this matched sequence will collate after __s.
Definition at line 951 of file regex.h.
template<typename _BiIter> difference_type std::sub_match< _BiIter >::length () const [inline]¶
Gets the length of the matching sequence.
Definition at line 882 of file regex.h.
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.
Definition at line 895 of file regex.h.
template<typename _BiIter> string_type std::sub_match< _BiIter >::str () const [inline]¶
Gets the matching sequence as a string.
Returns:
Definition at line 908 of file regex.h.
Referenced by std::sub_match< _Bi_iter >::compare(), and std::operator<<().
Member Data Documentation¶
_BiIter std::pair< _BiIter , _BiIter >::first [inherited]¶
second_type is the second bound type
Definition at line 214 of file stl_pair.h.
Referenced by std::sub_match< _Bi_iter >::length(), std::sub_match< _Bi_iter >::operator string_type(), and std::sub_match< _Bi_iter >::str().
_BiIter std::pair< _BiIter , _BiIter >::second [inherited]¶
first is a copy of the first object
Definition at line 215 of file stl_pair.h.
Referenced by std::sub_match< _Bi_iter >::length(), std::sub_match< _Bi_iter >::operator string_type(), and std::sub_match< _Bi_iter >::str().
Author¶
Generated automatically by Doxygen for libstdc++ from the source code.
| Fri May 24 2024 | libstdc++ |