std::regex_replace

C++ Reference
Language Concepts Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Regular expressions library
Classes basic_regex (C++11) sub_match (C++11) match_results (C++11) Algorithms regex_match (C++11) regex_search (C++11) regex_replace (C++11) Iterators regex_iterator (C++11) regex_token_iterator (C++11) Exceptions regex_error (C++11) Traits regex_traits (C++11) Constants syntax_option_type (C++11) match_flag_type (C++11) error_type (C++11)

Defined in header <regex>
template< class OutputIterator, class BidirectionalIterator,           class Traits, class CharT,           class STraits, class SAlloc > OutputIterator     regex_replace( OutputIterator out,                    BidirectionalIterator first, BidirectionalIterator last,                    const std::basic_regex<CharT,Traits>& e,                    const std::basic_string<CharT,STraits,SAlloc>& fmt,                    std::regex_constants::match_flag_type flags =                        std::regex_constants::match_default );	(1)	(since C++11)
template< class OutputIterator, class BidirectionalIterator,           class Traits, class CharT > OutputIterator     regex_replace( OutputIterator out,                    BidirectionalIterator first, BidirectionalIterator last,                    const std::basic_regex<CharT,Traits>& e,                    const CharT* fmt,                    std::regex_constants::match_flag_type flags =                        std::regex_constants::match_default );	(2)	(since C++11)
template< class Traits, class CharT,           class STraits, class SAlloc,           class FTraits, class FAlloc > std::basic_string<CharT,STraits,SAlloc>     regex_replace( const std::basic_string<CharT,STraits,SAlloc>& s,                    const std::basic_regex<CharT,Traits>& e,                    const std::basic_string<CharT,FTraits,FAlloc>& fmt,                    std::regex_constants::match_flag_type flags =                        std::regex_constants::match_default );	(3)	(since C++11)
template< class Traits, class CharT,           class STraits, class SAlloc > std::basic_string<CharT,STraits,SAlloc>     regex_replace( const std::basic_string<CharT,STraits,SAlloc>& s,                    const std::basic_regex<CharT,Traits>& e,                    const CharT* fmt,                    std::regex_constants::match_flag_type flags =                        std::regex_constants::match_default );	(4)	(since C++11)
template< class Traits, class CharT,           class STraits, class SAlloc > std::basic_string<CharT>     regex_replace( const CharT* s,                    const std::basic_regex<CharT,Traits>& e,                    const std::basic_string<CharT,STraits,SAlloc>& fmt,                    std::regex_constants::match_flag_type flags =                        std::regex_constants::match_default );	(5)	(since C++11)
template< class Traits, class CharT > std::basic_string<CharT>     regex_replace( const CharT* s,                    const std::basic_regex<CharT,Traits>& e,                    const CharT* fmt,                    std::regex_constants::match_flag_type flags =                        std::regex_constants::match_default );	(6)	(since C++11)

1-2) Constructs a std::regex_iterator object i as if by std::regex_iterator<BidirectionalIterator, CharT, traits> i(first, last, e, flags), and uses i to enumerate through all of the matches m of type std::match_results<BidirectionalIterator> that occur within the sequence [first,last).

3-4) Constructs an empty string result of type std::basic_string<CharT, ST, SA> and calls std::regex_replace(std::back_inserter(result), s.begin(), s.end(), e, fmt, flags).

5-6)Constructs an empty string result of type std::basic_string<CharT> and calls std::regex_replace(std::back_inserter(result), s, s + std::char_traits<CharT>::length(s), e, fmt, flags).

Parameters

out	-	an output iterator with the result
first, last	-	the target character range
m	-	the match results
fmt	-	a regex replacement format string
s	-	a target character std::basic_string
e	-	the std::regex
flags	-	the match flags

Return value

Returns the result containing the replacements.

See also

`

std::regex_constants::match_flag_type

std::basic_regex

std::regex_iterator