std::basic_regex(3)

NAME

std::basic_regex

SYNOPSIS

Detailed Description

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

class std::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 617 of file tr1_impl/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::basic_regex< _Ch_type, _Rx_traits >::basic_regex () [inline] Constructs a basic regular expression that does not match any character sequence.

Definition at line 653 of file tr1_impl/regex.

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

std::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 669 of file tr1_impl/regex.

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

std::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 685 of file tr1_impl/regex.

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

std::basic_regex< _Ch_type, _Rx_traits >::basic_regex (const basic_regex< _Ch_type, _Rx_traits > & __rhs) [inline] Copy-constructs a basic regular expression.

Parameters:

rhs A regex object.

Definition at line 694 of file tr1_impl/regex.

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

template<typename _Ch_traits, typename _Ch_alloc> std::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 710 of file tr1_impl/regex.

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

template<typename _InputIterator> std::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 a range 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 728 of file tr1_impl/regex.

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

std::basic_regex< _Ch_type, _Rx_traits >::~basic_regex () [inline] Destroys a basic regular expression.

Definition at line 736 of file tr1_impl/regex.

Member Function Documentation

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

template<typename _InputIterator> basic_regex& std::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 853 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::assign().

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

template<typename _Ch_typeraits, typename _Allocator> basic_regex& std::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 830 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::swap().

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

basic_regex& std::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 814 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::assign().

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

basic_regex& std::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 nullterminated 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 796 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::assign().

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

basic_regex& std::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 775 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::swap().

Referenced by std::basic_regex< _Ch_type, _Rx_traits >::assign(), and
std::basic_regex< _Ch_type, _Rx_traits >::operator=().

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

flag_type std::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 871 of file tr1_impl/regex.

Referenced by std::basic_regex< _Ch_type, _Rx_traits >::operator=().

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

locale_type std::basic_regex< _Ch_type, _Rx_traits >::getloc () const [inline]
Gets the locale currently imbued in the regular expression object.

Definition at line 889 of file tr1_impl/regex.

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

locale_type std::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 881 of file tr1_impl/regex.

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

unsigned int std::basic_regex< _Ch_type, _Rx_traits >::mark_count () const [inline]
Gets the number of marked subexpressions within the regular expression.

Definition at line 863 of file tr1_impl/regex.

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

template<typename _Ch_typeraits, typename _Allocator> basic_regex& std::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 765 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::assign(), and
std::basic_regex< _Ch_type, _Rx_traits >::flags().

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

basic_regex& std::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 754 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::assign(), and
std::basic_regex< _Ch_type, _Rx_traits >::flags().

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

basic_regex& std::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 743 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::assign().

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

void std::basic_regex< _Ch_type, _Rx_traits >::swap (basic_regex< _Ch_type, _Rx_traits > & __rhs) [inline] Swaps the contents of two regular expression objects.

Parameters:

rhs Another regular expression object.

Definition at line 899 of file tr1_impl/regex.

References std::basic_regex< _Ch_type, _Rx_traits >::_M_flags,
std::basic_regex< _Ch_type, _Rx_traits >::_M_mark_count,
std::basic_regex< _Ch_type, _Rx_traits >::_M_pattern, and
std::basic_regex< _Ch_type, _Rx_traits >::_M_traits.

Referenced by std::basic_regex< _Ch_type, _Rx_traits >::assign(), and
std::swap().

Author

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

libstdc++ 31 Dec 2008 std::basic_regex(3)