std::tr1::basic_regex< _Ch_type, _Rx_traits > Class Template Reference
[Regular Expressions]

List of all members.

---

Detailed Description

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>
class std::tr1::basic_regex< _Ch_type, _Rx_traits >

Objects of specializations of this class represent regular expressions constructed from sequences of character type _Ch_type.

Storage for the regular expression is allocated and deallocated as necessary by the member functions of this class.

Definition at line 630 of file tr1/regex.

Public Types

• typedef regex_constants::syntax_option_type flag_type
• typedef _Rx_traits::locale_type locale_type
• typedef _Rx_traits::string_type string_type
• typedef _Ch_type value_type

Public Member Functions

• template<typename _InputIterator> basic_regex & assign (_InputIterator __first, _InputIterator __last, flag_type __flags=regex_constants::ECMAScript)
• template<typename _Ch_typeraits, typename _Allocator> basic_regex & assign (const basic_string< _Ch_type, _Ch_typeraits, _Allocator > &__s, flag_type __f=regex_constants::ECMAScript)
• basic_regex & assign (const _Ch_type *__p, std::size_t __len, flag_type __flags)
• basic_regex & assign (const _Ch_type *__p, flag_type __flags=regex_constants::ECMAScript)
• basic_regex & assign (const basic_regex &__that)
• template<typename _InputIterator> basic_regex (_InputIterator __first, _InputIterator __last, flag_type __f=regex_constants::ECMAScript)
• template<typename _Ch_traits, typename _Ch_alloc> basic_regex (const basic_string< _Ch_type, _Ch_traits, _Ch_alloc > &__s, flag_type __f=regex_constants::ECMAScript)
• basic_regex (const basic_regex &__rhs)
• basic_regex (const _Ch_type *__p, std::size_t __len, flag_type __f)
• basic_regex (const _Ch_type *__p, flag_type __f=regex_constants::ECMAScript)
• basic_regex ()
• flag_type flags () const
• locale_type getloc () const
• locale_type imbue (locale_type __loc)
• unsigned int mark_count () const
• template<typename _Ch_typeraits, typename _Allocator> basic_regex & operator= (const basic_string< _Ch_type, _Ch_typeraits, _Allocator > &__s)
• basic_regex & operator= (const _Ch_type *__p)
• basic_regex & operator= (const basic_regex &__rhs)
• void swap (basic_regex &__rhs)
• ~basic_regex ()

Static Public Attributes

• static const regex_constants::syntax_option_type awk
• static const regex_constants::syntax_option_type basic
• static const regex_constants::syntax_option_type collate
• static const regex_constants::syntax_option_type ECMAScript
• static const regex_constants::syntax_option_type egrep
• static const regex_constants::syntax_option_type extended
• static const regex_constants::syntax_option_type grep
• static const regex_constants::syntax_option_type icase
• static const regex_constants::syntax_option_type nosubs
• static const regex_constants::syntax_option_type optimize

Protected Attributes

• flag_type _M_flags
• unsigned int _M_mark_count
• string_type _M_pattern
• _Rx_traits _M_traits

---

Constructor & Destructor Documentation

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::basic_regex

(

)

[inline]

Constructs a basic regular expression that does not match any character sequence.

Definition at line 666 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::basic_regex	(	const _Ch_type *	__p,
		flag_type	__f = regex_constants::ECMAScript
	)			[inline, explicit]

Constructs a basic regular expression from the sequence [p, p + char_traits<_Ch_type>::length(p)) interpreted according to the flags in f.

Parameters:

	p	A pointer to the start of a C-style null-terminated string containing a regular expression.
	f	Flags indicating the syntax rules and options.

Exceptions:

regex_error

if p is not a valid regular expression.

Definition at line 682 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::basic_regex	(	const _Ch_type *	__p,
		std::size_t	__len,
		flag_type	__f
	)			[inline]

Constructs a basic regular expression from the sequence [p, p + len) interpreted according to the flags in f.

Parameters:

	p	A pointer to the start of a string containing a regular expression.
	len	The length of the string containing the regular expression.
	f	Flags indicating the syntax rules and options.

Exceptions:

regex_error

if p is not a valid regular expression.

Definition at line 698 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::basic_regex

(

const basic_regex< _Ch_type, _Rx_traits > &

__rhs

)

[inline]

Copy-contructs a basic regular expression.

Parameters:

rhs

A regex object.

Definition at line 707 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

template<typename _Ch_traits, typename _Ch_alloc>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::basic_regex	(	const basic_string< _Ch_type, _Ch_traits, _Ch_alloc > &	__s,
		flag_type	__f = regex_constants::ECMAScript
	)			[inline, explicit]

Constructs a basic regular expression from the string interpreted according to the flags in f.

Parameters:

	p	A string containing a regular expression.
	f	Flags indicating the syntax rules and options.

Exceptions:

regex_error

if p is not a valid regular expression.

Definition at line 723 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

template<typename _InputIterator>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::basic_regex	(	_InputIterator	__first,
		_InputIterator	__last,
		flag_type	__f = regex_constants::ECMAScript
	)			[inline]

Constructs a basic regular expression from the range [first, last) interpreted according to the flags in f.

Parameters:

	first	The start of arange containing a valid regular expression.
	last	The end of a range containing a valid regular expression.
	f	The format flags of the regular expression.

Exceptions:

regex_error

if p is not a valid regular expression.

Definition at line 741 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

std::tr1::basic_regex< _Ch_type, _Rx_traits >::~basic_regex

(

)

[inline]

Destroys a basic regular expression.

Definition at line 749 of file tr1/regex.

---

Member Function Documentation

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

template<typename _InputIterator>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::assign	(	_InputIterator	__first,
		_InputIterator	__last,
		flag_type	__flags = regex_constants::ECMAScript
	)			[inline]

Assigns a new regular expression to a regex object.

Parameters:

	first	The start of a range containing a valid regular expression.
	last	The end of a range containing a valid regular expression.
	flags	Syntax option flags.

Exceptions:

regex_error

if p does not contain a valid regular expression pattern interpreted according to flags. If regex_error is thrown, *this remains unchanged.

Definition at line 866 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

template<typename _Ch_typeraits, typename _Allocator>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::assign	(	const basic_string< _Ch_type, _Ch_typeraits, _Allocator > &	__s,
		flag_type	__f = regex_constants::ECMAScript
	)			[inline]

Assigns a new regular expression to a regex object from a string containing a regular expression pattern.

Parameters:

	s	A string containing a regular expression pattern.
	flags	Syntax option flags.

Exceptions:

regex_error

if p does not contain a valid regular expression pattern interpreted according to flags. If regex_error is thrown, *this remains unchanged.

Definition at line 843 of file tr1/regex.

References std::swap().

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::assign	(	const _Ch_type *	__p,
		std::size_t	__len,
		flag_type	__flags
	)			[inline]

Assigns a new regular expression to a regex object from a C-style string containing a regular expression pattern.

Parameters:

	p	A pointer to a C-style string containing a regular expression pattern.
	len	The length of the regular expression pattern string.
	flags	Syntax option flags.

Exceptions:

regex_error

if p does not contain a valid regular expression pattern interpreted according to flags. If regex_error is thrown, *this remains unchanged.

Definition at line 827 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::assign	(	const _Ch_type *	__p,
		flag_type	__flags = regex_constants::ECMAScript
	)			[inline]

Assigns a new regular expression to a regex object from a C-style null-terminated string containing a regular expression pattern.

Parameters:

	p	A pointer to a C-style null-terminated string containing a regular expression pattern.
	flags	Syntax option flags.

Exceptions:

regex_error

if p does not contain a valid regular expression pattern interpreted according to flags. If regex_error is thrown, *this remains unchanged.

Definition at line 809 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::assign

(

const basic_regex< _Ch_type, _Rx_traits > &

__that

)

[inline]

the real assignment operator.

Parameters:

that

Another regular expression object.

Definition at line 788 of file tr1/regex.

References std::swap().

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

flag_type std::tr1::basic_regex< _Ch_type, _Rx_traits >::flags

(

)

const [inline]

Gets the flags used to construct the regular expression or in the last call to assign().

Definition at line 884 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

locale_type std::tr1::basic_regex< _Ch_type, _Rx_traits >::getloc

(

)

const [inline]

Gets the locale currently imbued in the regular expression object.

Definition at line 902 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

locale_type std::tr1::basic_regex< _Ch_type, _Rx_traits >::imbue

(

locale_type

__loc

)

[inline]

Imbues the regular expression object with the given locale.

Parameters:

loc

A locale.

Definition at line 894 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

unsigned int std::tr1::basic_regex< _Ch_type, _Rx_traits >::mark_count

(

)

const [inline]

Gets the number of marked subexpressions within the regular expresison.

Definition at line 876 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

template<typename _Ch_typeraits, typename _Allocator>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::operator=

(

const basic_string< _Ch_type, _Ch_typeraits, _Allocator > &

__s

)

[inline]

Replaces a regular expression with a new one constructed from a string.

Parameters:

A

pointer to a string containing a regular expression.

Definition at line 778 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::operator=

(

const _Ch_type *

__p

)

[inline]

Replaces a regular expression with a new one constructed from a C-style null-terminated string.

Parameters:

A

pointer to the start of a null-terminated C-style string containing a regular expression.

Definition at line 767 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

basic_regex& std::tr1::basic_regex< _Ch_type, _Rx_traits >::operator=

(

const basic_regex< _Ch_type, _Rx_traits > &

__rhs

)

[inline]

Assigns one regular expression to another.

Definition at line 756 of file tr1/regex.

template<typename _Ch_type, typename _Rx_traits = regex_traits<_Ch_type>>

void std::tr1::basic_regex< _Ch_type, _Rx_traits >::swap

(

basic_regex< _Ch_type, _Rx_traits > &

__rhs

)

[inline]

Swaps the contents of two regular expression obects.

Parameters:

rhs

Another regular expression object.

Definition at line 912 of file tr1/regex.

References std::tr1::basic_regex< _Ch_type, _Rx_traits >::_M_flags, std::tr1::basic_regex< _Ch_type, _Rx_traits >::_M_mark_count, std::tr1::basic_regex< _Ch_type, _Rx_traits >::_M_pattern, std::tr1::basic_regex< _Ch_type, _Rx_traits >::_M_traits, and std::swap().

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

---

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

• tr1/regex

---