std::tr1::match_results< _Bi_iter, _Allocator > Class Template Reference
[Regular Expressions]

Inheritance diagram for std::tr1::match_results< _Bi_iter, _Allocator >:

List of all members.

---

Detailed Description

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>
class std::tr1::match_results< _Bi_iter, _Allocator >

A collection of character sequences representing the result of a regular expression match. Storage for the collection is allocated and freed as necessary by the member functions of class template match_results.

This class satisfies the Sequence requirements, with the exception that only the operations defined for a const-qualified Sequence are supported.

The sub_match object stored at index 0 represents sub-expression 0, i.e. the whole match. In this case the sub_match member matched is always true. The sub_match object stored at index n denotes what matched the marked sub-expression n within the matched expression. If the sub-expression n participated in a regular expression match then the sub_match member matched evaluates to true, and members first and second denote the range of characters [first, second) which formed that match. Otherwise matched is false, and members first and second point to the end of the sequence that was searched.

Definition at line 1637 of file tr1/regex.

Public Types

• typedef _Allocator allocator_type
• typedef iterator_traits< _Bi_iter
  >::value_type char_type
• typedef _Base_type::const_iterator const_iterator
• typedef _Allocator::const_reference const_reference
• typedef iterator_traits< _Bi_iter
  >::difference_type difference_type
• typedef const_iterator iterator
• typedef const_reference reference
• typedef _Allocator::size_type size_type
• typedef basic_string< char_type > string_type
• typedef sub_match< _Bi_iter > value_type

Public Member Functions

• const_iterator begin () const
• bool empty () const
• const_iterator end () const
• string_type format (const string_type &__fmt, regex_constants::match_flag_type __flags=regex_constants::format_default) const
• template<typename _Out_iter> _Out_iter format (_Out_iter __out, const string_type &__fmt, regex_constants::match_flag_type __flags=regex_constants::format_default) const
• difference_type length (size_type __sub=0) const
• match_results (const match_results &__rhs)
• match_results (const _Allocator &__a=_Allocator())
• match_results & operator= (const match_results &__rhs)
• const_reference operator[] (size_type __n) const
• difference_type position (size_type __sub=0) const
• const_reference prefix () const
• size_type size () const
• string_type str (size_type __sub=0) const
• const_reference suffix () const
• void swap (match_results &__that)
• ~match_results ()

---

Constructor & Destructor Documentation

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

std::tr1::match_results< _Bi_iter, _Allocator >::match_results

(

const _Allocator &

__a = _Allocator()

)

[inline, explicit]

Constructs a default match_results container.

Definition at line 1663 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

std::tr1::match_results< _Bi_iter, _Allocator >::match_results

(

const match_results< _Bi_iter, _Allocator > &

__rhs

)

[inline]

Copy constructs a match_result.

Definition at line 1670 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

std::tr1::match_results< _Bi_iter, _Allocator >::~match_results

(

)

[inline]

Todo:

Implement this function.

Definition at line 1688 of file tr1/regex.

---

Member Function Documentation

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

const_iterator std::tr1::match_results< _Bi_iter, _Allocator >::begin

(

)

const [inline]

Todo:

Document this function.

Reimplemented from std::vector< std::tr1::sub_match< _Bi_iter >, _Allocator >.

Definition at line 1764 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

bool std::tr1::match_results< _Bi_iter, _Allocator >::empty

(

)

const [inline]

Todo:

Document this function.

Reimplemented from std::vector< std::tr1::sub_match< _Bi_iter >, _Allocator >.

Definition at line 1710 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

const_iterator std::tr1::match_results< _Bi_iter, _Allocator >::end

(

)

const [inline]

Todo:

Document this function.

Reimplemented from std::vector< std::tr1::sub_match< _Bi_iter >, _Allocator >.

Definition at line 1771 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

string_type std::tr1::match_results< _Bi_iter, _Allocator >::format	(	const string_type &	__fmt,
		regex_constants::match_flag_type	__flags = regex_constants::format_default
	)			const

Todo:

Implement this function.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

template<typename _Out_iter>

_Out_iter std::tr1::match_results< _Bi_iter, _Allocator >::format	(	_Out_iter	__out,
		const string_type &	__fmt,
		regex_constants::match_flag_type	__flags = regex_constants::format_default
	)			const [inline]

Todo:

Implement this function.

Definition at line 1780 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

difference_type std::tr1::match_results< _Bi_iter, _Allocator >::length

(

size_type

__sub = 0

)

const [inline]

Gets the length of the indicated submatch.

Parameters:

sub

indicates the submatch.

Definition at line 1719 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

match_results& std::tr1::match_results< _Bi_iter, _Allocator >::operator=

(

const match_results< _Bi_iter, _Allocator > &

__rhs

)

[inline]

Assigns rhs to *this.

Definition at line 1679 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

const_reference std::tr1::match_results< _Bi_iter, _Allocator >::operator[]

(

size_type

__n

)

const [inline]

Todo:

Document this function.

Definition at line 1743 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

difference_type std::tr1::match_results< _Bi_iter, _Allocator >::position

(

size_type

__sub = 0

)

const [inline]

Todo:

Document this function.

Definition at line 1726 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

const_reference std::tr1::match_results< _Bi_iter, _Allocator >::prefix

(

)

const [inline]

Todo:

Document this function.

Definition at line 1750 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

size_type std::tr1::match_results< _Bi_iter, _Allocator >::size

(

)

const [inline]

Todo:

Document this function.

Reimplemented from std::vector< std::tr1::sub_match< _Bi_iter >, _Allocator >.

Definition at line 1696 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

string_type std::tr1::match_results< _Bi_iter, _Allocator >::str

(

size_type

__sub = 0

)

const [inline]

Todo:

Document this function.

Definition at line 1736 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

const_reference std::tr1::match_results< _Bi_iter, _Allocator >::suffix

(

)

const [inline]

Todo:

Document this function.

Definition at line 1757 of file tr1/regex.

template<typename _Bi_iter, typename _Allocator = allocator<sub_match<_Bi_iter> >>

void std::tr1::match_results< _Bi_iter, _Allocator >::swap

(

match_results< _Bi_iter, _Allocator > &

__that

)

[inline]

Todo:

Document this function.

Definition at line 1806 of file tr1/regex.

Referenced by std::tr1::swap().

---

The documentation for this class was generated from the following file:

• tr1/regex

---