std::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::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

Public Member Functions

Static Public Attributes

Protected Attributes


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 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 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]


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

Generated on Sat Oct 25 05:09:50 2008 for libstdc++ by  doxygen 1.5.6