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.

Function template join

boost::algorithm::join — Join algorithm.

Synopsis

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


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

Description

This algorithm joins all strings in a 'list' into one long string. Segments are concatenated by given separator.

	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.

Returns:

Concatenated string.