Function regex

Function regex_match

boost::xpressive::regex_match — See if a regex matches a sequence from beginning to end.

Synopsis

// In header: <boost/xpressive/regex_algorithms.hpp>


template<typename BidiIter> 
  bool regex_match(BidiIter begin, BidiIter end, 
                   match_results< BidiIter > & what, 
                   basic_regex< BidiIter > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default);
template<typename BidiIter> 
  bool regex_match(BidiIter begin, BidiIter end, 
                   basic_regex< BidiIter > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default);
template<typename Char> 
  bool regex_match(Char * begin, match_results< Char * > & what, 
                   basic_regex< Char * > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default);
template<typename BidiRange, typename BidiIter> 
  bool regex_match(BidiRange & rng, match_results< BidiIter > & what, 
                   basic_regex< BidiIter > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default, 
                   unspecified = 0);
template<typename BidiRange, typename BidiIter> 
  bool regex_match(BidiRange const & rng, match_results< BidiIter > & what, 
                   basic_regex< BidiIter > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default, 
                   unspecified = 0);
template<typename Char> 
  bool regex_match(Char * begin, basic_regex< Char * > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default);
template<typename BidiRange, typename BidiIter> 
  bool regex_match(BidiRange & rng, basic_regex< BidiIter > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default, 
                   unspecified = 0);
template<typename BidiRange, typename BidiIter> 
  bool regex_match(BidiRange const & rng, basic_regex< BidiIter > const & re, 
                   regex_constants::match_flag_type flags = regex_constants::match_default, 
                   unspecified = 0);

Description

Determines whether there is an exact match between the regular expression re, and all of the sequence [begin, end).

Parameters:

`begin`	The beginning of the sequence.
`end`	The end of the sequence.
`flags`	Optional match flags, used to control how the expression is matched against the sequence. (See `match_flag_type`.)
`re`	The regular expression object to use
`what`	The `match_results` struct into which the sub_matches will be written

Requires:

Type BidiIter meets the requirements of a Bidirectional Iterator (24.1.4).

[begin,end) denotes a valid iterator range.

Returns:

true if a match is found, false otherwise

Throws:

regex_error on stack exhaustion