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

Function template join_if
PrevUpHomeNext

Function template join_if

boost::join_if — Conditional join algorithm.

Synopsis

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


template<typename SequenceSequenceT, typename Range1T, typename PredicateT> 
  range_value< SequenceSequenceT >::type 
  join_if(const SequenceSequenceT & Input, const Range1T & Separator, 
          PredicateT Pred);

Description

This algorithm joins all strings in a 'list' into one long string. Segments are concatenated by given separator. Only segments that satisfy the predicate will be added to the result.

[Note] Note

This function provides the strong exception-safety guarantee

Parameters:

Input

A container that holds the input strings. It must be a container-of-containers.

Separator

A string that will separate the joined segments.

Pred

A segment selection predicate

Returns:

Concatenated string.
Copyright © 2002-2004 Pavol Droba

Use, modification and distribution is subject to the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

PrevUpHomeNext