boost.png (6897 bytes) Home Libraries People FAQ More

PrevUpHomeNext

Function template split_regex

boost::algorithm::split_regex — Split regex algorithm.

Synopsis

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

Description

Tokenize expression. This function is equivalent to C strtok. Input sequence is split into tokens, separated by separators. Separator is an every match of the given regex. 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>>

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
Notes: Prior content of the result will be overwritten.

This function provides the strong exception-safety guarantee

Copyright © 2002-2004 Pavol Droba

PrevUpHomeNext