134

I'm looking for the most elegant way to implode a vector of strings into a string. Below is the solution I'm using now:

static std::string& implode(const std::vector<std::string>& elems, char delim, std::string& s)
{
    for (std::vector<std::string>::const_iterator ii = elems.begin(); ii != elems.end(); ++ii)
    {
        s += (*ii);
        if ( ii + 1 != elems.end() ) {
            s += delim;
        }
    }

    return s;
}

static std::string implode(const std::vector<std::string>& elems, char delim)
{
    std::string s;
    return implode(elems, delim, s);
}

Is there any others out there?

3
  • 2
    Why do you call this function implode? Commented Apr 11, 2019 at 20:33
  • 12
    @ColonelPanic, by analogy with PHP's implode() method, which joins array elements and outputs them as a single string. I wonder why are you asking this question:)
    – ezpresso
    Commented Apr 13, 2019 at 0:35
  • 10
    In Python: 'delim.join(elems)'. Sorry, could not resist. C++ still does not have batteries included. :-) Question is 10 years old in 2021 and not a single working and elegant answer (trailing delimiters, excessive runtime, more #include lines that the naive implementation ...) Commented Nov 2, 2021 at 17:51

23 Answers 23

147

Use boost::algorithm::join(..):

#include <boost/algorithm/string/join.hpp>
...
std::string joinedString = boost::algorithm::join(elems, delim);

See also this question.

8
  • 145
    Suggesting to include and link against the massive boost library to create a simple string is absurd.
    – Julian
    Commented Oct 6, 2017 at 21:24
  • 16
    @Julian most projects already do this. I agree that it is absurd that the STL does not include a way to do this already, however. I might also agree that this should not be the top answer, but other answers are clearly available.
    – River Tam
    Commented Nov 24, 2017 at 0:23
  • I concur with @Julian. Boost may be elegant in use but is no way the "most elegant way" in terms of overhead. In this case, it's a workaround to the OP's algorithm and not a resolution to the question itself.
    – Azeroth2b
    Commented Nov 21, 2018 at 13:49
  • 9
    Most Boost libraries are header-only, so there is nothing to link. Some even make their way into the standard.
    – jbruni
    Commented Apr 27, 2019 at 2:25
  • 25
    Not having this basic feature in stdlib is absurd.
    – Kiruahxh
    Commented Mar 19, 2021 at 7:11
48
std::vector<std::string> strings;

const char* const delim = ", ";

std::ostringstream imploded;
std::copy(strings.begin(), strings.end(),
           std::ostream_iterator<std::string>(imploded, delim));

(include <string>, <vector>, <sstream> and <iterator>)

If you want to have a clean end (no trailing delimiter) have a look here

4
  • 15
    keep in mind, though, that it will add extra delimiter (the second parameter to the std::ostream_iterator constructor at the end of the stream. Commented Apr 16, 2011 at 19:38
  • 30
    The point of "implode" is that a delimiter should not be added last. This answer unfortunately adds that delimiter last.
    – Jonny
    Commented Oct 28, 2015 at 1:13
  • And fortunately I need to add the token last as well! Thanks for the solution. Commented Dec 24, 2020 at 1:57
  • 1
    I needed the actual string representation after the implode, so I used imploded.str() to get a std::string. Also, for those who don't want the delimiter as the last part of the string, use the pop_back() method to remove the last character after you convert to std::string. Thank you for the head start!
    – rayryeng
    Commented Jan 16, 2023 at 22:10
35

I like to use this one-liner accumulate (no trailing delimiter):

(std::accumulate defined in <numeric>)

std::accumulate(
    std::next(elems.begin()), 
    elems.end(), 
    elems[0], 
    [](std::string a, std::string b) {
        return a + delimiter + b;
    }
);
2
  • 17
    Be careful when it's empty. Commented Apr 12, 2020 at 4:04
  • 1
    You'll want those to be const std::string & too.
    – OrangeDog
    Commented Jul 17 at 15:48
28

You should use std::ostringstream rather than std::string to build the output (then you can call its str() method at the end to get a string, so your interface need not change, only the temporary s).

From there, you could change to using std::ostream_iterator, like so:

copy(elems.begin(), elems.end(), ostream_iterator<string>(s, delim)); 

But this has two problems:

  1. delim now needs to be a const char*, rather than a single char. No big deal.
  2. std::ostream_iterator writes the delimiter after every single element, including the last. So you'd either need to erase the last one at the end, or write your own version of the iterator which doesn't have this annoyance. It'd be worth doing the latter if you have a lot of code that needs things like this; otherwise the whole mess might be best avoided (i.e. use ostringstream but not ostream_iterator).
1
25

Because I love one-liners (they are very useful for all kinds of weird stuff, as you'll see at the end), here's a solution using std::accumulate and C++11 lambda:

std::accumulate(alist.begin(), alist.end(), std::string(), 
    [](const std::string& a, const std::string& b) -> std::string { 
        return a + (a.length() > 0 ? "," : "") + b; 
    } )

I find this syntax useful with stream operator, where I don't want to have all kinds of weird logic out of scope from the stream operation, just to do a simple string join. Consider for example this return statement from method that formats a string using stream operators (using std;):

return (dynamic_cast<ostringstream&>(ostringstream()
    << "List content: " << endl
    << std::accumulate(alist.begin(), alist.end(), std::string(), 
        [](const std::string& a, const std::string& b) -> std::string { 
            return a + (a.length() > 0 ? "," : "") + b; 
        } ) << endl
    << "Maybe some more stuff" << endl
    )).str();

Update:

As pointed out by @plexando in the comments, the above code suffers from misbehavior when the array starts with empty strings due to the fact that the check for "first run" is missing previous runs that have resulted in no additional characters, and also - it is weird to run a check for "is first run" on all runs (i.e. the code is under-optimized).

The solution for both of these problems is easy if we know for a fact that the list has at least one element. OTOH, if we know for a fact that the list does not have at least one element, then we can shorten the run even more.

I think the resulting code isn't as pretty, so I'm adding it here as The Correct Solution, but I think the discussion above still has merrit:

alist.empty() ? "" : /* leave early if there are no items in the list */
  std::accumulate( /* otherwise, accumulate */
    ++alist.begin(), alist.end(), /* the range 2nd to after-last */
    *alist.begin(), /* and start accumulating with the first item */
    [](auto& a, auto& b) { return a + "," + b; });

Notes:

  • For containers that support direct access to the first element, its probably better to use that for the third argument instead, so alist[0] for vectors.
  • As per the discussion in the comments and chat, the lambda still does some copying. This can be minimized by using this (less pretty) lambda instead: [](auto&& a, auto&& b) -> auto& { a += ','; a += b; return a; }) which (on GCC 10) improves performance by more than x10. Thanks to @Deduplicator for the suggestion. I'm still trying to figure out what is going on here.
17
  • 8
    Don't use accumulate for strings. Most of the other answers are O(n) but accumulate is O(n^2) because it makes a temporary copy of the accumulator before appending each element. And no, move semantics don't help.
    – Oktalist
    Commented Sep 9, 2013 at 20:31
  • 2
    @Oktalist, I'm not sure why you say that - cplusplus.com/reference/numeric/accumulate says "Complexity is linear in the distance between first and last".
    – Guss
    Commented Sep 10, 2013 at 6:43
  • 1
    That's assuming that each individual addition takes constant time. If T has an overloaded operator+ (like string does) or if you provide your own functor then all bets are off. Although I may have been hasty in saying move semantics don't help, they don't solve the problem in the two implementations that I've checked. See my answers to similar questions.
    – Oktalist
    Commented Sep 10, 2013 at 23:43
  • 14
    I did a benchmark, and accumulate was actually faster than an O(n) string stream. Commented Mar 6, 2015 at 22:22
  • 2
    A questionable algorithmic design. You know upfront that a comma needs to be prepended to every element except the first one, then why do you do all those useless runtime checks? In addition to that, your code skips all empty pieces until the first non-empty one, then thereafter, empty pieces are not skipped anymore but appended.
    – plexando
    Commented Oct 29, 2020 at 8:49
20

what about simple stupid solution?

std::string String::join(const std::vector<std::string> &lst, const std::string &delim)
{
    std::string ret;
    for(const auto &s : lst) {
        if(!ret.empty())
            ret += delim;
        ret += s;
    }
    return ret;
}
5
  • I hope the compiler is smart enough to remove the check for the ret to be empty on every iteration.
    – xtofl
    Commented May 5, 2021 at 6:50
  • 2
    @xtofl You're overestimating the cost of that check.
    – c z
    Commented Jan 25, 2022 at 16:06
  • 1
    I'm just following the "Don't pay for what you don't use" rule. You're right in most cases, where lst is not enormous.
    – xtofl
    Commented Jan 26, 2022 at 11:25
  • 2
    Besides the fact that ret.empty() is a trivial check, this is a use case that is perfect for branch predictors, since after the first test it will always evaluate to false. Commented Apr 25, 2022 at 8:25
  • 1
    This will fail if lst contains empty strings as the first elements.
    – rodrigocfd
    Commented Jul 10 at 14:03
20

With fmt you can do.

#include <fmt/format.h>
auto s = fmt::format("{}",fmt::join(elems,delim)); 

But I don't know if join will make it to std::format.

https://godbolt.org/z/P4rj3xeKG

4
  • 1
    At least not in C++20. 😞 Commented Jan 27, 2023 at 2:32
  • 1
    @FranklinYu He is talking about this fmt library, not a standard C++ library
    – paoloose
    Commented Mar 1, 2023 at 22:48
  • 1
    @perrocallcenter I know that. My comment above was referring to the part “if join will make it to std::format”, which was referring to the fact that a big portion of the fmt library has been added to C++20 (i.e. the std::format), but for some reason fmt::join() was left out. “Just use the fmt library” is a simple fix, but it might not be feasible for every team. It would still be useful to have something similar to fmt::join() added to <format>. Commented Mar 3, 2023 at 5:24
  • 1
    @perrocallcenter as FranklinY said, std::format (en.cppreference.com/w/cpp/header/format) and std::print (en.cppreference.com/w/cpp/io/print, C++ 23) are based on fmt library. I was hoping that they also standardize join, but it does no seems to be the case. It seems they only standardized join for views (en.cppreference.com/w/cpp/23).
    – andreas777
    Commented Mar 3, 2023 at 7:34
13
string join(const vector<string>& vec, const char* delim)
{
    stringstream res;
    copy(vec.begin(), vec.end(), ostream_iterator<string>(res, delim));
    return res.str();
}
12

Especially with bigger collections, you want to avoid having to check if youre still adding the first element or not to ensure no trailing separator...

So for the empty or single-element list, there is no iteration at all.

Empty ranges are trivial: return "".

Single element or multi-element can be handled perfectly by accumulate:

auto join = [](const auto &&range, const auto separator) {
    if (range.empty()) return std::string();

    return std::accumulate(
         next(begin(range)), // there is at least 1 element, so OK.
         end(range),

         range[0], // the initial value

         [&separator](auto result, const auto &value) {
             return result + separator + value;
         });
};

Running sample (require C++14): http://cpp.sh/8uspd

4
  • You'd never need to check every time though. Just add the first element outside the loop, and start the loop at the second...
    – Jason C
    Commented May 4, 2021 at 3:07
  • I don't see why you'd add that. There isn't a loop in this function, and accumulate does receive the first element and is told to start at the second...
    – xtofl
    Commented May 5, 2021 at 6:54
  • 1
    What I mean is: "Especially with bigger collections, you want to avoid having to check if youre still adding the first element or not to ensure no trailing separator." -- You can avoid having to check this in the loop method that your statement refers to by pulling the first element out of the loop. Sorry, I was kinda vague; I was commenting on the premise, not on the solution. The solution you provided is perfectly fine.
    – Jason C
    Commented May 5, 2021 at 15:14
  • I share your idea. Related: stackoverflow.com/questions/156650/….
    – xtofl
    Commented May 6, 2021 at 5:48
10

This gets a handy one-liner in C++23:

auto str = std::ranges::fold_left(elems | std::views::join_with(delim), std::string{}, std::plus<>{});
2
  • The need for fold_left is not obvious, you could explain why it's here.
    – Demi-Lune
    Commented Oct 30, 2023 at 12:48
  • 2
    fold_left is the generalized ranges-version of accumulate introduced with C++23. C++20 introduced ranges, but missed out on some crucial parts, such as some algorithm implementations. C++23 added some of them through fold expressions. The ranges library is lazy by design and fold_left is evaluating the view created by join_with. Otherwise you would only get a view, not a string. If you want to learn more about the C++23 fold_* additions, I'd recommend this excellent article by Sy Brand.
    – Carsten
    Commented Nov 1, 2023 at 8:39
7

While I would normally recommend using Boost as per the top answer, I recognise that in some projects that's not desired.

The STL solutions suggested using std::ostream_iterator will not work as intended - it'll append a delimiter at the end.

There is now a way to do this with modern C++ using std::experimental::ostream_joiner:

std::ostringstream outstream;
std::copy(strings.begin(),
          strings.end(),
          std::experimental::make_ostream_joiner(outstream, delimiter.c_str()));
return outstream.str();
2
  • How modern does C++ need to be? I tried this with set(CMAKE_CXX_STANDARD 11) and #include <experimental/iterator>, and got "error: 'std::experimental' has not been declared"
    – sdbbs
    Commented Jun 5, 2023 at 9:32
  • Your compiler needs to support library fundamentals TS v2. At the time of writing, parts of this have been merged into C++17 and C++20, but ostream_joiner is not yet part of any modern standard up to and including C++23. I know it's supported by recent versions of GCC at the very least - you may need to build with -std=gnu++2b.
    – Riot
    Commented Jun 6, 2023 at 10:07
5

Another simple and good solution is using ranges v3. The current version is C++14 or greater, but there are older versions that are C++11 or greater. Unfortunately, C++20 ranges don't have the intersperse function.

The benefits of this approach are:

  • Elegant
  • Easily handle empty strings
  • Handles the last element of the list
  • Efficiency. Because ranges are lazily evaluated.
  • Small and useful library

Functions breakdown(Reference):

  • accumulate = Similar to std::accumulate but arguments are a range and the initial value. There is an optional third argument that is the operator function.
  • filter = Like std::filter, filter the elements that don't fit the predicate.
  • intersperse = The key function! Intersperses a delimiter between range input elements.
#include <iostream>
#include <string>
#include <vector>
#include <range/v3/numeric/accumulate.hpp>
#include <range/v3/view/filter.hpp>
#include <range/v3/view/intersperse.hpp>

int main()
{
    using namespace ranges;
    // Can be any std container
    std::vector<std::string> a{ "Hello", "", "World", "is", "", "a", "program" };
    
    std::string delimiter{", "};
    std::string finalString = 
        accumulate(a | views::filter([](std::string s){return !s.empty();})
                     | views::intersperse(delimiter)
                  , std::string());
    std::cout << finalString << std::endl; // Hello, World, is, a, program
}

Edit: As @Franklin Yu suggested, it's possible only use the std libraries with std::ranges::views::join_with. But unfortunately is only available for c++23. Since we are using c++23 we also can use std::ranges::fold_left instead std::accumulate to create a one line expression. std::ranges::fold_left is the std version of rages v3's rages::accumulate.

#include <iostream>
#include <string>
#include <vector>
#include <ranges>
#include <algorithm>

int main()
{
    // Can be any std container
    std::vector<std::string> a{ "Hello", "", "World", "is", "", "a", "program" };
    
    std::string delimiter{", "};
    
    std::string finalString = 
        std::ranges::fold_left(a | std::views::filter([](std::string s){return !s.empty();})
                                 | std::views::join_with(delimiter)
                              , std::string()
                              , std::plus());
 
    std::cout << finalString << std::endl; // Hello, World, is, a, program
}
2
  • 2
    C++20 do have std::ranges::views::join_with, which might help? Commented Sep 8, 2022 at 15:30
  • @FranklinYu. Yes std::ranges::views::join_with it's the equivalent function but is only available for c++23. Commented Aug 15, 2023 at 11:13
4

A version that uses std::accumulate:

#include <numeric>
#include <iostream>
#include <string>

struct infix {
  std::string sep;
  infix(const std::string& sep) : sep(sep) {}
  std::string operator()(const std::string& lhs, const std::string& rhs) {
    std::string rz(lhs);
    if(!lhs.empty() && !rhs.empty())
      rz += sep;
    rz += rhs;
    return rz;
  }
};

int main() {
  std::string a[] = { "Hello", "World", "is", "a", "program" };
  std::string sum = std::accumulate(a, a+5, std::string(), infix(", "));
  std::cout << sum << "\n";
}
4

A possible solution with ternary operator ?:.

std::string join(const std::vector<std::string> & v, const std::string & delimiter = ", ") {
    std::string result;

    for (size_t i = 0; i < v.size(); ++i) {
        result += (i ? delimiter : "") + v[i]; 
    }

    return result;
}

join({"2", "4", "5"}) will give you 2, 4, 5.

3

Here's what I use, simple and flexible

string joinList(vector<string> arr, string delimiter)
{
    if (arr.empty()) return "";

    string str;
    for (auto i : arr)
        str += i + delimiter;
    str = str.substr(0, str.size() - delimiter.size());
    return str;
}

using:

string a = joinList({ "a", "bbb", "c" }, "!@#");

output:

a!@#bbb!@#c
1
  • You should probably use "for (const auto& i : arr)" so you don't unnecessarily create a copy of each string as you iterate over the vector.
    – Some Guy
    Commented yesterday
3

Here is another one that doesn't add the delimiter after the last element:

std::string concat_strings(const std::vector<std::string> &elements,
                           const std::string &separator)
{       
    if (!elements.empty())
    {
        std::stringstream ss;
        auto it = elements.cbegin();
        while (true)
        {
            ss << *it++;
            if (it != elements.cend())
                ss << separator;
            else
                return ss.str();
        }       
    }
    return "";
2

Using part of this answer to another question gives you a joined this, based on a separator without a trailing comma,

Usage:

std::vector<std::string> input_str = std::vector<std::string>({"a", "b", "c"});
std::string result = string_join(input_str, ",");
printf("%s", result.c_str());
/// a,b,c

Code:

std::string string_join(const std::vector<std::string>& elements, const char* const separator)
{
    switch (elements.size())
    {
        case 0:
            return "";
        case 1:
            return elements[0];
        default:
            std::ostringstream os;
            std::copy(elements.begin(), elements.end() - 1, std::ostream_iterator<std::string>(os, separator));
            os << *elements.rbegin();
            return os.str();
    }
}
2

If you are already using a C++ base library (for commonly used tools), string-processing features are typically included. Besides Boost mentioned above, Abseil provides:

std::vector<std::string> names {"Linus", "Dennis", "Ken"};
std::cout << absl::StrJoin(names, ", ") << std::endl;

Folly provides:

std::vector<std::string> names {"Linus", "Dennis", "Ken"};
std::cout << folly::join(", ", names) << std::endl;

Both give the string "Linus, Dennis, Ken".

0

Slightly long solution, but doesn't use std::ostringstream, and doesn't require a hack to remove the last delimiter.

http://www.ideone.com/hW1M9

And the code:

struct appender
{
  appender(char d, std::string& sd, int ic) : delim(d), dest(sd), count(ic)
  {
    dest.reserve(2048);
  }

  void operator()(std::string const& copy)
  {
    dest.append(copy);
    if (--count)
      dest.append(1, delim);
  }

  char delim;
  mutable std::string& dest;
  mutable int count;
};

void implode(const std::vector<std::string>& elems, char delim, std::string& s)
{
  std::for_each(elems.begin(), elems.end(), appender(delim, s, elems.size()));
}
0

This can be solved using boost

#include <boost/range/adaptor/filtered.hpp>
#include <boost/algorithm/string/join.hpp>
#include <boost/algorithm/algorithm.hpp>

std::vector<std::string> win {"Stack", "", "Overflow"};
const std::string Delimitor{","};

const std::string combined_string = 
                  boost::algorithm::join(win |
                         boost::adaptors::filtered([](const auto &x) {
                                                      return x.size() != 0;
                                                      }), Delimitor);

Output:

combined_string: "Stack,Overflow"
0

I'm using the following approach that works fine in C++17. The function starts checking if the given vector is empty, in which case returns an empty string. If that's not the case, it takes the first element from the vector, then iterates from the second one until the end and appends the separator followed by the vector element.

template <typename T>
std::basic_string<T> Join(std::vector<std::basic_string<T>> vValues,
   std::basic_string<T> strDelim)
{
   std::basic_string<T> strRet;
   typename std::vector<std::basic_string<T>>::iterator it(vValues.begin());
   if (it != vValues.end())  // The vector is not empty
   {
      strRet = *it;
      while (++it != vValues.end()) strRet += strDelim + *it;
   }
   return strRet;
}

Usage example:

std::vector<std::string> v1;
std::vector<std::string> v2 { "Hello" };
std::vector<std::string> v3 { "Str1", "Str2" };
std::cout << "(1): " << Join<char>(v1, ",") << std::endl;
std::cout << "(2): " << Join<char>(v2, "; ") << std::endl;
std::cout << "(3): [" << Join<char>(v3, "] [") << "]" << std::endl;

Output:

(1): 
(2): Hello
(3): [Str1] [Str2]
0

Another std::accumulate solution, as a function, templated, along with error trapping.

Downsides, unsuitable for large sets of strings (potentially O(n^2)), and ugly usage:

join<std::vector<std::string>>(myVec.begin(), myVec.end(), ' ')

Here it is:

template<class T>
std::string join(char delimiter, 
                 typename T::iterator begin,
                 typename T::iterator end) {

    if(begin == end) {
        return std::string();
    }
    if(std::next(begin) == end) {
        return std::string(*begin);
    }
    return std::accumulate(std::next(begin),
                           end, 
                           *begin,
                           [delimiter](const std::string a, 
                                       const std::string b) -> std::string 
                                       {return a + delimiter + b;});
}

Example:

#include <iostream>
#include <numeric>
#include <string>
#include <vector>

// paste join template code here....

int main() {
    std::vector<std::string> vec { "One", "Two", "Three" };
    
    std::cout << "0: " << join<std::vector<std::string>>(' ',vec.begin()+0, vec.end());
    std::cout << std::endl;
    std::cout << "1: " << join<std::vector<std::string>>(' ',vec.begin()+1, vec.end());
    std::cout << std::endl;
    std::cout << "2: " << join<std::vector<std::string>>(' ',vec.begin()+2, vec.end());
    std::cout << std::endl;
    std::cout << "3: " << join<std::vector<std::string>>(' ',vec.begin()+3, vec.end());
    std::cout << std::endl;

    return 0;
}

results in:

0: One Two Three
1: Two Three
2: Three
3: 
0

The solution I have been using for now is to manually iterate over the vector and put the items into an ostringstream. Finally, at the end just return the underlying string in the stream.

#include <iostream>
#include <sstream>
#include <vector>

using namespace std;

string implode(const vector<string> &strs, const string &delim) {
    if (strs.size() == 0) {
        return "";
    }
    ostringstream os;
    for (int i = 0; i < strs.size() - 1; ++i) {
        os << strs.at(i) << delim;
    }
    os << strs.back();
    return os.str();
}

int main(int argc, char const *argv[])
{
    string imploded = implode({"the", "quick", "brown", "fox"}, "---");
    cout << imploded << endl;

    return 0;
}

Results in:

the---quick---brown---fox

Not the answer you're looking for? Browse other questions tagged or ask your own question.