std::regex_match

From Cppreference

Jump to: navigation, search

Defined in header `<regex>`

template< class BidirectionalIterator, class Alloc, class CharT, class Traits > bool regex_match( BidirectionalIterator first, BidirectionalIterator last, std::match_results<BidirectionalIterator,Alloc>& m, const std::basic_regex<CharT,Traits>& e, std::regex_constants::match_flag_type flags = std::regex_constants::match_default );	(1)	(C++11 feature)

template< class BidirectionalIterator, class CharT, class Traits > bool regex_match( BidirectionalIterator first, BidirectionalIterator last, const std::basic_regex<CharT,Traits>& e, std::regex_constants::match_flag_type flags = std::regex_constants::match_default );	(2)	(C++11 feature)

template< class CharT, class Alloc, class Traits > bool regex_match( const CharT* str, std::match<const CharT*,Alloc>& m, const std::basic_regex<CharT,Traits>& e, std::regex_constants::match_flag_type flags = std::regex_constants::match_default );	(3)	(C++11 feature)

template< class STraits, class SAlloc, class Alloc, class CharT, class Traits > bool regex_match( const std::basic_string<CharT,STraits,SAlloc>& s, std::match_results< typename std::basic_string<CharT,STraits,SAlloc>::const_iterator, Alloc >& m, const std::basic_regex<CharT,Traits>& e, std::regex_constants::match_flag_type flags = std::regex_constants::match_default );	(4)	(C++11 feature)

template< class CharT, class Traits > bool regex_match( const CharT* str, const std::basic_regex<CharT,Traits>& e, std::regex_constants::match_flag_type flags = std::regex_constants::match_default );	(5)	(C++11 feature)

template< class STraits, class SAlloc, class CharT, class Traits > bool regex_match( const std::basic_string<CharT, STraits, SAlloc>& s, const std::basic_regex<CharT,Traits>& e, std::regex_constants::match_flag_type flags = std::regex_constants::match_default );	(6)	(C++11 feature)

1) Determines if there is a match between the regular express e and the target character sequence [first,last). Match results are returned in m.

2) Behaves as (1) above, omitting the match results.

3) Returns std::regex_match(str, str + std::char_traits<charT>::length(str), m, e, flags).

4) Returns std::regex_match(s.begin(), s.end(), m, e, flags).

5) Returns std::regex_match(str, str + std::char_traits<charT>::length(str), e, flags).

6) Returns std::regex_match(s.begin(), s.end(), e, flags).

[edit] Parameters

`first, last`	-	the target character range
`m`	-	the match results
`str`	-	a target character null-terminated C-style string
`s`	-	a target character std::basic_string
`e`	-	the std::regex
`flags`	-	the match flags

[edit] Return value

Returns true if a match exists, false otherwise.