← Back to branch summary

~ubuntu-branches/ubuntu/wily/cxxtools/wily-proposed

« back to all changes in this revision

Viewing changes to include/cxxtools/join.h

  • Committer: Package Import Robot
  • Author(s): Kari Pahula
  • Date: 2012-04-28 10:30:29 UTC
  • mfrom: (1.1.6)
  • Revision ID: package-import@ubuntu.com-20120428103029-qc8v0sb4yb8h1542
Tags: 2.1-1
* New upstream release (SONAME 8)
  - Removed patch gcc4.7_ftbfs_fix since upstream source is GCC 4.7 safe.
  - Patches iconvstream_size_t_fix, configure.in_fixes and
    arm_gcc4.6_ftbfs_fix removed since they have been implemented in
    upstream source.
* Standards-Version 3.9.3.
* Use dh-autoreconf.

Show diffs side-by-side

added added

removed removed

Lines of Context:
include/cxxtools/join.h
 
1
/*
 
2
 * Copyright (C) 2010 Tommi Maekitalo
 
3
 * 
 
4
 * This library is free software; you can redistribute it and/or
 
5
 * modify it under the terms of the GNU Lesser General Public
 
6
 * License as published by the Free Software Foundation; either
 
7
 * version 2.1 of the License, or (at your option) any later version.
 
8
 * 
 
9
 * As a special exception, you may use this file as part of a free
 
10
 * software library without restriction. Specifically, if other files
 
11
 * instantiate templates or use macros or inline functions from this
 
12
 * file, or you compile this file and link it with other files to
 
13
 * produce an executable, this file does not by itself cause the
 
14
 * resulting executable to be covered by the GNU General Public
 
15
 * License. This exception does not however invalidate any other
 
16
 * reasons why the executable file might be covered by the GNU Library
 
17
 * General Public License.
 
18
 * 
 
19
 * This library is distributed in the hope that it will be useful,
 
20
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 
21
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 
22
 * Lesser General Public License for more details.
 
23
 * 
 
24
 * You should have received a copy of the GNU Lesser General Public
 
25
 * License along with this library; if not, write to the Free Software
 
26
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 
27
 */
 
28
 
 
29
#include <iostream>
 
30
#include <sstream>
 
31
 
 
32
namespace cxxtools
 
33
{
 
34
  /** @brief Joins a list of tokens into a output stream using a delimiter.
 
35
 
 
36
      A list of tokens read from a range is printed to a out stream. The tokens
 
37
      are separated by a token.
 
38
 
 
39
      Example (prints "4, 17, 12"):
 
40
      \code
 
41
        std::vector<unsigned> v;
 
42
        v.push_back(4);
 
43
        v.push_back(17);
 
44
        v.push_back(12);
 
45
        join(v.begin(), v.end(), ", ", std::cout);
 
46
      \endcode
 
47
   */
 
48
  template <typename inputIterator, typename separatorType, typename characterType>
 
49
  void join(inputIterator b, inputIterator e, const separatorType& sep, std::basic_ostream<characterType>& out)
 
50
  {
 
51
    bool first = true;
 
52
    for (inputIterator it = b; it != e; ++it)
 
53
    {
 
54
      if (first)
 
55
        first = false;
 
56
      else
 
57
        out << sep;
 
58
      out << *it;
 
59
    }
 
60
  }
 
61
 
 
62
  /** @brief Joins a list of tokens into a std::string using a delimiter.
 
63
 
 
64
      This function is just like the other join function, but returns the
 
65
      result as a std::string.
 
66
 
 
67
      Example (prints "4, 17, 12"):
 
68
      \code
 
69
        std::vector<unsigned> v;
 
70
        v.push_back(4);
 
71
        v.push_back(17);
 
72
        v.push_back(12);
 
73
        std::cout << join(v.begin(), v.end(), ", ");
 
74
      \endcode
 
75
   */
 
76
  template <typename inputIterator, typename separatorType>
 
77
  std::string join(inputIterator b, inputIterator e, const separatorType& sep)
 
78
  {
 
79
    std::ostringstream ret;
 
80
    join(b, e, sep, ret);
 
81
    return ret.str();
 
82
  }
 
83
 
 
84
}