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 the documentation for an old version of Boost. Click here to view this page for the latest version.
PrevUpHomeNext

Function template find_token

boost::algorithm::find_token — Find token algorithm.

Synopsis

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


template<typename RangeT, typename PredicateT> 
  iterator_range< typename range_iterator< RangeT >::type > 
  find_token(RangeT & Input, PredicateT Pred, 
             token_compress_mode_type eCompress = token_compress_off);

Description

Look for a given token in the string. Token is a character that matches the given predicate. If the "token compress mode" is enabled, adjacent tokens are considered to be one match.

[Note] Note

This function provides the strong exception-safety guarantee

Parameters:

Input

A input string.

Pred

An unary predicate to identify a token

eCompress

Enable/Disable compressing of adjacent tokens

Returns:

An iterator_range delimiting the match. Returned iterator is either RangeT::iterator or RangeT::const_iterator, depending on the constness of the input parameter.


PrevUpHomeNext