SYNOPSIS

Public Types

typedef std::ptrdiff_t difference_type

typedef std::forward_iterator_tag iterator_category

typedef const value_type * pointer

typedef const value_type & reference

typedef basic_regex< _Ch_type,

_Rx_traits > regex_type"

typedef sub_match< _Bi_iter > value_type

Public Member Functions

regex_token_iterator ()

regex_token_iterator (_Bi_iter __a, _Bi_iter __b, const regex_type &__re, int __submatch=0, regex_constants::match_flag_type __m=regex_constants::match_default)

regex_token_iterator (_Bi_iter __a, _Bi_iter __b, const regex_type &__re, const std::vector< int > &__submatches, regex_constants::match_flag_type __m=regex_constants::match_default)

regex_token_iterator (_Bi_iter __a, _Bi_iter __b, const regex_type &__re, initializer_list< int > __submatches, regex_constants::match_flag_type __m=regex_constants::match_default)

template<std::size_t _Nm> regex_token_iterator (_Bi_iter __a, _Bi_iter __b, const regex_type &__re, const int(&__submatches)[_Nm], regex_constants::match_flag_type __m=regex_constants::match_default)

regex_token_iterator (const regex_token_iterator &__rhs)

bool operator!= (const regex_token_iterator &__rhs) const

const value_type & operator* () const

regex_token_iterator & operator++ ()

regex_token_iterator operator++ (int)

const value_type * operator-> () const

regex_token_iterator & operator= (const regex_token_iterator &__rhs)

bool operator== (const regex_token_iterator &__rhs) const

Detailed Description

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).

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::sub_match object.

Definition at line 2512 of file regex.h.

Constructor & Destructor Documentation

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 ()\fC [inline]\fP

Default constructs a regex_token_iterator. 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.

Definition at line 2530 of file regex.h.

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)\fC [inline]\fP

Constructs a regex_token_iterator...

Parameters:

__a [IN] The start of the text to search.

__b [IN] One-past-the-end of the text to search.

__re [IN] The regular expression to search for.

__submatch [IN] Which submatch to return. There are some special values for this parameter:

  • -1 each enumerated subexpression does NOT match the regular expression (aka field splitting)

  • 0 the entire string matching the subexpression is returned for each match within the text.

  • >0 enumerates only the indicated subexpression from a match within the text.

__m [IN] Policy flags for match rules.

Definition at line 2552 of file regex.h.

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)\fC [inline]\fP

Constructs a regex_token_iterator...

Parameters:

__a [IN] The start of the text to search.

__b [IN] One-past-the-end of the text to search.

__re [IN] The regular expression to search for.

__submatches [IN] A list of subexpressions to return for each regular expression match within the text.

__m [IN] Policy flags for match rules.

Definition at line 2568 of file regex.h.

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, initializer_list< int >__submatches, \fBregex_constants::match_flag_type\fP__m = \fC\fBregex_constants::match_default\fP\fP)\fC [inline]\fP

Constructs a regex_token_iterator...

Parameters:

__a [IN] The start of the text to search.

__b [IN] One-past-the-end of the text to search.

__re [IN] The regular expression to search for.

__submatches [IN] A list of subexpressions to return for each regular expression match within the text.

__m [IN] Policy flags for match rules.

Definition at line 2585 of file regex.h.

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)\fC [inline]\fP

Constructs a regex_token_iterator...

Parameters:

__a [IN] The start of the text to search.

__b [IN] One-past-the-end of the text to search.

__re [IN] The regular expression to search for.

__submatches [IN] A list of subexpressions to return for each regular expression match within the text.

__m [IN] Policy flags for match rules.

Definition at line 2603 of file regex.h.

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)\fC [inline]\fP

Copy constructs a regex_token_iterator.

Parameters:

__rhs [IN] A regex_token_iterator to copy.

Definition at line 2616 of file regex.h.

Member Function Documentation

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) const\fC [inline]\fP

Compares a regex_token_iterator to another for inequality.

Definition at line 2638 of file regex.h.

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* () const\fC [inline]\fP

Dereferences a regex_token_iterator.

Definition at line 2645 of file regex.h.

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++ ()

Increments a regex_token_iterator.

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)\fC [inline]\fP

Postincrements a regex_token_iterator.

Definition at line 2665 of file regex.h.

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-> () const\fC [inline]\fP

Selects a regex_token_iterator member.

Definition at line 2652 of file regex.h.

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)

Assigns a regex_token_iterator to another.

Parameters:

__rhs [IN] A regex_token_iterator to copy.

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) const

Compares a regex_token_iterator to another for equality.

Author

Generated automatically by Doxygen for libstdc++ from the source code.