std::regex_search

From Cppreference

Jump to: navigation, search

Defined in header `<regex>`

template< class BidirectionalIterator, class Alloc, class CharT, class Traits > bool regex_search( 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 Alloc, class CharT, class Traits > bool regex_search( const CharT* str, 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 );	(2)	(C++11 feature)

template< class STraits, class SAlloc, class Alloc, class CharT, class Traits > bool regex_search( 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 );	(3)	(C++11 feature)

template< class BidirectionalIterator, class CharT, class Traits > bool regex_search( BidirectionalIterator first, BidirectionalIterator last, 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_search( 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_search( 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 some subsequence in the target character sequence [first,last). Match results are returned in m.

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

3) Returns std::regex_search(s.begin(), s.end(), m, e, flags).

4) The same as (1), omitting the match results.

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

6) Returns std::regex_search(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 somewhere in the target sequence, false otherwise.