.TH "std::regex_token_iterator< _Bi_iter, _Ch_type, _Rx_traits >" 3cxx "Thu Aug 2 2012" "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::regex_token_iterator< _Bi_iter, _Ch_type, _Rx_traits > \- 
.SH SYNOPSIS
.br
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "typedef std::ptrdiff_t \fBdifference_type\fP"
.br
.ti -1c
.RI "typedef \fBstd::forward_iterator_tag\fP \fBiterator_category\fP"
.br
.ti -1c
.RI "typedef const \fBvalue_type\fP * \fBpointer\fP"
.br
.ti -1c
.RI "typedef const \fBvalue_type\fP & \fBreference\fP"
.br
.ti -1c
.RI "typedef \fBbasic_regex\fP< _Ch_type, 
.br
_Rx_traits > \fBregex_type\fP"
.br
.ti -1c
.RI "typedef \fBsub_match\fP< _Bi_iter > \fBvalue_type\fP"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "bool \fBoperator!=\fP (const \fBregex_token_iterator\fP &__rhs)"
.br
.ti -1c
.RI "const \fBvalue_type\fP & \fBoperator*\fP ()"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP & \fBoperator++\fP ()"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP \fBoperator++\fP (int)"
.br
.ti -1c
.RI "const \fBvalue_type\fP * \fBoperator->\fP ()"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP & \fBoperator=\fP (const \fBregex_token_iterator\fP &__rhs)"
.br
.ti -1c
.RI "bool \fBoperator==\fP (const \fBregex_token_iterator\fP &__rhs)"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP ()"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP (_Bi_iter __a, _Bi_iter __b, const \fBregex_type\fP &__re, int __submatch=0, \fBregex_constants::match_flag_type\fP __m=\fBregex_constants::match_default\fP)"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP (_Bi_iter __a, _Bi_iter __b, const \fBregex_type\fP &__re, const \fBstd::vector\fP< int > &__submatches, \fBregex_constants::match_flag_type\fP __m=\fBregex_constants::match_default\fP)"
.br
.ti -1c
.RI "template<std::size_t _Nm> \fBregex_token_iterator\fP (_Bi_iter __a, _Bi_iter __b, const \fBregex_type\fP &__re, const int(&__submatches)[_Nm], \fBregex_constants::match_flag_type\fP __m=\fBregex_constants::match_default\fP)"
.br
.ti -1c
.RI "\fBregex_token_iterator\fP (const \fBregex_token_iterator\fP &__rhs)"
.br
.in -1c
.SH "Detailed Description"
.PP 

.SS "template<typename _Bi_iter, typename _Ch_type = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits = regex_traits<_Ch_type>>class std::regex_token_iterator< _Bi_iter, _Ch_type, _Rx_traits >"
Iterates over submatches in a range (or 'splits' a text string)\&.
.PP
The purpose of this iterator is to enumerate all, or all specified, matches of a regular expression within a text range\&. The dereferenced value of an iterator of this class is a std::tr1::sub_match object\&. 
.PP
Definition at line 2544 of file tr1_impl/regex\&.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::\fBregex_token_iterator\fP ()"

.PP
Default constructs a regex_token_iterator\&. \fBTodo\fP
.RS 4
Implement this function\&.
.RE
.PP
.PP
A default-constructed regex_token_iterator is a singular iterator that will compare equal to the one-past-the-end value for any iterator of the same type\&. 
.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::\fBregex_token_iterator\fP (_Bi_iter__a, _Bi_iter__b, const \fBregex_type\fP &__re, int__submatch = \fC0\fP, \fBregex_constants::match_flag_type\fP__m = \fC\fBregex_constants::match_default\fP\fP)"
Constructs a regex_token_iterator\&.\&.\&. 
.PP
\fBParameters:\fP
.RS 4
\fIa\fP [IN] The start of the text to search\&. 
.br
\fIb\fP [IN] One-past-the-end of the text to search\&. 
.br
\fIre\fP [IN] The regular expression to search for\&. 
.br
\fIsubmatch\fP [IN] Which submatch to return\&. There are some special values for this parameter:
.IP "\(bu" 2
-1 each enumerated subexpression does NOT match the regular expression (aka field splitting)
.IP "\(bu" 2
0 the entire string matching the subexpression is returned for each match within the text\&.
.IP "\(bu" 2
>0 enumerates only the indicated subexpression from a match within the text\&. 
.PP
.br
\fIm\fP [IN] Policy flags for match rules\&.
.RE
.PP
\fBTodo\fP
.RS 4
Implement this function\&. 
.PP
Doc me! See doc/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::\fBregex_token_iterator\fP (_Bi_iter__a, _Bi_iter__b, const \fBregex_type\fP &__re, const \fBstd::vector\fP< int > &__submatches, \fBregex_constants::match_flag_type\fP__m = \fC\fBregex_constants::match_default\fP\fP)"
Constructs a regex_token_iterator\&.\&.\&. 
.PP
\fBParameters:\fP
.RS 4
\fIa\fP [IN] The start of the text to search\&. 
.br
\fIb\fP [IN] One-past-the-end of the text to search\&. 
.br
\fIre\fP [IN] The regular expression to search for\&. 
.br
\fIsubmatches\fP [IN] A list of subexpressions to return for each regular expression match within the text\&. 
.br
\fIm\fP [IN] Policy flags for match rules\&.
.RE
.PP
\fBTodo\fP
.RS 4
Implement this function\&. 
.PP
Doc me! See doc/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> template<std::size_t _Nm> \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::\fBregex_token_iterator\fP (_Bi_iter__a, _Bi_iter__b, const \fBregex_type\fP &__re, const int(&)__submatches[_Nm], \fBregex_constants::match_flag_type\fP__m = \fC\fBregex_constants::match_default\fP\fP)"
Constructs a regex_token_iterator\&.\&.\&. 
.PP
\fBParameters:\fP
.RS 4
\fIa\fP [IN] The start of the text to search\&. 
.br
\fIb\fP [IN] One-past-the-end of the text to search\&. 
.br
\fIre\fP [IN] The regular expression to search for\&. 
.br
\fIsubmatches\fP [IN] A list of subexpressions to return for each regular expression match within the text\&. 
.br
\fIm\fP [IN] Policy flags for match rules\&.
.RE
.PP
\fBTodo\fP
.RS 4
Implement this function\&. 
.PP
Doc me! See doc/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::\fBregex_token_iterator\fP (const \fBregex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits > &__rhs)"

.PP
Copy constructs a regex_token_iterator\&. \fBParameters:\fP
.RS 4
\fIrhs\fP [IN] A regex_token_iterator to copy\&. 
.RE
.PP
\fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SH "Member Function Documentation"
.PP 
.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> bool \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator!= (const \fBregex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits > &__rhs)"

.PP
Compares a regex_token_iterator to another for inequality\&. \fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> const \fBvalue_type\fP& \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator* ()"

.PP
Dereferences a regex_token_iterator\&. \fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBregex_token_iterator\fP& \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator++ ()"

.PP
Increments a regex_token_iterator\&. \fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBregex_token_iterator\fP \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator++ (int)"

.PP
Postincrements a regex_token_iterator\&. \fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> const \fBvalue_type\fP* \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator-> ()"

.PP
Selects a regex_token_iterator member\&. \fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> \fBregex_token_iterator\fP& \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator= (const \fBregex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits > &__rhs)"

.PP
Assigns a regex_token_iterator to another\&. \fBParameters:\fP
.RS 4
\fIrhs\fP [IN] A regex_token_iterator to copy\&. 
.RE
.PP
\fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP

.SS "template<typename _Bi_iter , typename _Ch_type  = typename iterator_traits<_Bi_iter>::value_type, typename _Rx_traits  = regex_traits<_Ch_type>> bool \fBstd::regex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits >::operator== (const \fBregex_token_iterator\fP< _Bi_iter, _Ch_type, _Rx_traits > &__rhs)"

.PP
Compares a regex_token_iterator to another for equality\&. \fBTodo\fP
.RS 4
Implement this function\&. 
.RE
.PP


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