.TH "std::sub_match< _BiIter >" 3cxx "Tue Jul 2 2019" "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::sub_match< _BiIter >
.SH SYNOPSIS
.br
.PP
.PP
Inherits \fBstd::pair< _BiIter, _BiIter >\fP\&.
.SS "Public Types"

.in +1c
.ti -1c
.RI "using \fB_PCCFP\fP = _PCC<!\fBis_same\fP< _BiIter, _U1 >::value||!\fBis_same\fP< _BiIter, _U2 >::value, _BiIter, _BiIter >"
.br
.ti -1c
.RI "using \fB_PCCP\fP = _PCC< true, _BiIter, _BiIter >"
.br
.ti -1c
.RI "typedef __iter_traits::difference_type \fBdifference_type\fP"
.br
.ti -1c
.RI "typedef _BiIter \fBfirst_type\fP"
.br
.ti -1c
.RI "typedef _BiIter \fBiterator\fP"
.br
.ti -1c
.RI "typedef _BiIter \fBsecond_type\fP"
.br
.RI "\fCfirst_type\fP is the first bound type "
.ti -1c
.RI "typedef \fBstd::basic_string\fP< value_type > \fBstring_type\fP"
.br
.ti -1c
.RI "typedef __iter_traits::value_type \fBvalue_type\fP"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "int \fBcompare\fP (const \fBsub_match\fP &__s) const"
.br
.RI "Compares this and another matched sequence\&. "
.ti -1c
.RI "int \fBcompare\fP (const \fBstring_type\fP &__s) const"
.br
.RI "Compares this sub_match to a string\&. "
.ti -1c
.RI "int \fBcompare\fP (const value_type *__s) const"
.br
.RI "Compares this sub_match to a C-style string\&. "
.ti -1c
.RI "difference_type \fBlength\fP () const"
.br
.ti -1c
.RI "\fBoperator string_type\fP () const"
.br
.RI "Gets the matching sequence as a string\&. "
.ti -1c
.RI "\fBstring_type\fP \fBstr\fP () const"
.br
.RI "Gets the matching sequence as a string\&. "
.ti -1c
.RI "void \fBswap\fP (\fBpair\fP &__p) noexcept(__and_< __is_nothrow_swappable< _BiIter >, __is_nothrow_swappable< _BiIter >>::value)"
.br
.in -1c
.SS "Public Attributes"

.in +1c
.ti -1c
.RI "_BiIter \fBfirst\fP"
.br
.RI "\fCsecond_type\fP is the second bound type "
.ti -1c
.RI "bool \fBmatched\fP"
.br
.ti -1c
.RI "_BiIter \fBsecond\fP"
.br
.RI "\fCfirst\fP is a copy of the first object "
.in -1c
.SH "Detailed Description"
.PP 

.SS "template<typename _BiIter>
.br
class std::sub_match< _BiIter >"
A sequence of characters matched by a particular marked sub-expression\&.
.PP
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\&.
.PP
The iterators that make up the pair are the usual half-open interval referencing the actual original pattern matched\&. 
.PP
Definition at line 864 of file regex\&.h\&.
.SH "Member Typedef Documentation"
.PP 
.SS "using \fBstd::pair\fP< _BiIter , _BiIter  >::\fB_PCCFP\fP =  _PCC<!\fBis_same\fP<_BiIter , _U1>::value || !\fBis_same\fP<_BiIter , _U2>::value, _BiIter , _BiIter >\fC [inherited]\fP"
There is also a templated copy ctor for the \fCpair\fP class itself\&. 
.PP
Definition at line 283 of file stl_pair\&.h\&.
.SS "using \fBstd::pair\fP< _BiIter , _BiIter  >::\fB_PCCP\fP =  _PCC<true, _BiIter , _BiIter >\fC [inherited]\fP"
Two objects may be passed to a \fCpair\fP constructor to be copied\&. 
.PP
Definition at line 252 of file stl_pair\&.h\&.
.SS "typedef _BiIter  \fBstd::pair\fP< _BiIter , _BiIter  >::\fBsecond_type\fP\fC [inherited]\fP"

.PP
\fCfirst_type\fP is the first bound type 
.PP
Definition at line 212 of file stl_pair\&.h\&.
.SH "Member Function Documentation"
.PP 
.SS "template<typename _BiIter> int \fBstd::sub_match\fP< _BiIter >::compare (const \fBsub_match\fP< _BiIter > & __s) const\fC [inline]\fP"

.PP
Compares this and another matched sequence\&. 
.PP
\fBParameters:\fP
.RS 4
\fI__s\fP Another matched sequence to compare to this one\&.
.RE
.PP
\fBReturn values:\fP
.RS 4
\fI<0\fP this matched sequence will collate before \fC__s\fP\&. 
.br
\fI=0\fP this matched sequence is equivalent to \fC__s\fP\&. 
.br
\fI<0\fP this matched sequence will collate after \fC__s\fP\&. 
.RE
.PP

.PP
Definition at line 925 of file regex\&.h\&.
.PP
Referenced by std::operator!=(), std::operator<(), std::operator<=(), std::operator==(), std::operator>(), and std::operator>=()\&.
.SS "template<typename _BiIter> int \fBstd::sub_match\fP< _BiIter >::compare (const \fBstring_type\fP & __s) const\fC [inline]\fP"

.PP
Compares this sub_match to a string\&. 
.PP
\fBParameters:\fP
.RS 4
\fI__s\fP A string to compare to this sub_match\&.
.RE
.PP
\fBReturn values:\fP
.RS 4
\fI<0\fP this matched sequence will collate before \fC__s\fP\&. 
.br
\fI=0\fP this matched sequence is equivalent to \fC__s\fP\&. 
.br
\fI<0\fP this matched sequence will collate after \fC__s\fP\&. 
.RE
.PP

.PP
Definition at line 938 of file regex\&.h\&.
.SS "template<typename _BiIter> int \fBstd::sub_match\fP< _BiIter >::compare (const value_type * __s) const\fC [inline]\fP"

.PP
Compares this sub_match to a C-style string\&. 
.PP
\fBParameters:\fP
.RS 4
\fI__s\fP A C-style string to compare to this sub_match\&.
.RE
.PP
\fBReturn values:\fP
.RS 4
\fI<0\fP this matched sequence will collate before \fC__s\fP\&. 
.br
\fI=0\fP this matched sequence is equivalent to \fC__s\fP\&. 
.br
\fI<0\fP this matched sequence will collate after \fC__s\fP\&. 
.RE
.PP

.PP
Definition at line 951 of file regex\&.h\&.
.SS "template<typename _BiIter> difference_type \fBstd::sub_match\fP< _BiIter >::length () const\fC [inline]\fP"
Gets the length of the matching sequence\&. 
.PP
Definition at line 882 of file regex\&.h\&.
.SS "template<typename _BiIter> \fBstd::sub_match\fP< _BiIter >::operator \fBstring_type\fP () const\fC [inline]\fP"

.PP
Gets the matching sequence as a string\&. 
.PP
\fBReturns:\fP
.RS 4
the matching sequence as a string\&.
.RE
.PP
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\&. 
.PP
Definition at line 895 of file regex\&.h\&.
.SS "template<typename _BiIter> \fBstring_type\fP \fBstd::sub_match\fP< _BiIter >::str () const\fC [inline]\fP"

.PP
Gets the matching sequence as a string\&. 
.PP
\fBReturns:\fP
.RS 4
the matching sequence as a string\&. 
.RE
.PP

.PP
Definition at line 908 of file regex\&.h\&.
.PP
Referenced by std::sub_match< _Bi_iter >::compare(), and std::operator<<()\&.
.SH "Member Data Documentation"
.PP 
.SS "_BiIter  \fBstd::pair\fP< _BiIter , _BiIter  >::first\fC [inherited]\fP"

.PP
\fCsecond_type\fP is the second bound type 
.PP
Definition at line 214 of file stl_pair\&.h\&.
.SS "_BiIter  \fBstd::pair\fP< _BiIter , _BiIter  >::second\fC [inherited]\fP"

.PP
\fCfirst\fP is a copy of the first object 
.PP
Definition at line 215 of file stl_pair\&.h\&.

.SH "Author"
.PP 
Generated automatically by Doxygen for libstdc++ from the source code\&.