| Home | Libraries | People | FAQ | More

## Function template join_if

boost::join_if — Conditional join algorithm.

## Synopsis

    // In header: <boost/algorithm/string/regex.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
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.