Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is an old version of boost. Click here for the latest version's documentation home page.
PrevUpHomeNext

Function replace_regex_copy

boost::algorithm::replace_regex_copy — Replace regex algorithm.

Synopsis

template<typename OutputIteratorT, typename RangeT, typename CharT, 
typename RegexTraitsT, typename FormatStringTraitsT, 
typename FormatStringAllocatorT> 
OutputIteratorT 
replace_regex_copy(OutputIteratorT Output, const RangeT & Input, 
const basic_regex< CharT, RegexTraitsT > & Rx, 
const std::basic_string< CharT, FormatStringTraitsT, FormatStringAllocatorT > & Format, 
match_flag_type Flags = match_default|format_default);
template<typename SequenceT, typename CharT, typename RegexTraitsT, 
typename FormatStringTraitsT, typename FormatStringAllocatorT> 
SequenceT replace_regex_copy(const SequenceT & Input, 
const basic_regex< CharT, RegexTraitsT > & Rx, 
const std::basic_string< CharT, FormatStringTraitsT, FormatStringAllocatorT > & Format, 
match_flag_type Flags = match_default|format_default);

Description

Search for a substring matching given regex and format it with the specified format. The result is a modified copy of the input. It is returned as a sequence or copied to the output iterator.

Parameters

Flags

Regex options

Format

Regex format definition

Input

An input string

Output

An output iterator to which the result will be copied

Rx

A regular expression

Returns: An output iterator pointing just after the last inserted character or a modified copy of the input
Notes: The second variant of this function provides the strong exception-safety guarantee

Copyright 2002-2004 Pavol Droba

PrevUpHomeNext