.TH "std::sub_match< _BiIter >" 3cxx "Tue Nov 27 2012" "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 "typedef iterator_traits
.br
< _BiIter >::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
.ti -1c
.RI "typedef \fBstd::basic_string\fP
.br
< value_type > \fBstring_type\fP"
.br
.ti -1c
.RI "typedef iterator_traits
.br
< _BiIter >::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
.ti -1c
.RI "int \fBcompare\fP (const \fBstring_type\fP &__s) const "
.br
.ti -1c
.RI "int \fBcompare\fP (const value_type *__s) const "
.br
.ti -1c
.RI "difference_type \fBlength\fP () const "
.br
.ti -1c
.RI "\fBoperator string_type\fP () const "
.br
.ti -1c
.RI "\fBstring_type\fP \fBstr\fP () const "
.br
.ti -1c
.RI "void \fBswap\fP (\fBpair\fP &__p)"
.br
.in -1c
.SS "Public Attributes"

.in +1c
.ti -1c
.RI "_BiIter \fBfirst\fP"
.br
.ti -1c
.RI "bool \fBmatched\fP"
.br
.ti -1c
.RI "_BiIter \fBsecond\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 

.SS "template<typename _BiIter>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 \fBstd::basic_string\fP 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 757 of file regex\&.h\&.
.SH "Member Typedef Documentation"
.PP 
.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 90 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\&. \fBParameters:\fP
.RS 4
\fIs\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 \fCs\fP\&. 
.br
\fI=0\fP this matched sequence is equivalent to \fCs\fP\&. 
.br
\fI<0\fP this matched sequence will collate after \fCs\fP\&. 
.RE
.PP

.PP
Definition at line 818 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 \fBsub_match\fP to a string\&. \fBParameters:\fP
.RS 4
\fIs\fP A string to compare to this \fBsub_match\fP\&.
.RE
.PP
\fBReturn values:\fP
.RS 4
\fI<0\fP this matched sequence will collate before \fCs\fP\&. 
.br
\fI=0\fP this matched sequence is equivalent to \fCs\fP\&. 
.br
\fI<0\fP this matched sequence will collate after \fCs\fP\&. 
.RE
.PP

.PP
Definition at line 831 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 \fBsub_match\fP to a C-style string\&. \fBParameters:\fP
.RS 4
\fIs\fP A C-style string to compare to this \fBsub_match\fP\&.
.RE
.PP
\fBReturn values:\fP
.RS 4
\fI<0\fP this matched sequence will collate before \fCs\fP\&. 
.br
\fI=0\fP this matched sequence is equivalent to \fCs\fP\&. 
.br
\fI<0\fP this matched sequence will collate after \fCs\fP\&. 
.RE
.PP

.PP
Definition at line 844 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 775 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\&. \fBReturns:\fP
.RS 4
the matching sequence as a string\&.
.RE
.PP
This is the implicit conversion operator\&. It is identical to the \fBstr()\fP 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 788 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\&. \fBReturns:\fP
.RS 4
the matching sequence as a string\&. 
.RE
.PP

.PP
Definition at line 801 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 92 of file stl_pair\&.h\&.
.PP
Referenced by std::sub_match< _Bi_iter >::length(), std::sub_match< _Bi_iter >::operator string_type(), and std::sub_match< _Bi_iter >::str()\&.
.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 93 of file stl_pair\&.h\&.
.PP
Referenced by std::sub_match< _Bi_iter >::length(), std::sub_match< _Bi_iter >::operator string_type(), and std::sub_match< _Bi_iter >::str()\&.

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