Function template find_all

Function template find_all_regex

boost::algorithm::find_all_regex — Find all regex algorithm.

Synopsis

// In header: <boost/algorithm/string/regex.hpp>


template<typename SequenceSequenceT, typename RangeT, typename CharT, 
         typename RegexTraitsT> 
  SequenceSequenceT & 
  find_all_regex(SequenceSequenceT & Result, const RangeT & Input, 
                 const basic_regex< CharT, RegexTraitsT > & Rx, 
                 match_flag_type Flags = match_default);

Description

This algorithm finds all substrings matching the give regex in the input.

Each part is copied and added as a new element to the output container. Thus the result container must be able to hold copies of the matches (in a compatible structure like std::string) or a reference to it (e.g. using the iterator range class). Examples of such a container are std::vector<std::string> or std::list<boost::iterator_range<std::string::iterator>>

	Note
Prior content of the result will be overwritten. This function provides the strong exception-safety guarantee

Note

Prior content of the result will be overwritten.

This function provides the strong exception-safety guarantee

Parameters:

`Flags`	Regex options
`Input`	A container which will be searched.
`Result`	A container that can hold copies of references to the substrings.
`Rx`	A regular expression

Returns:

A reference to the result