Boost C++ Libraries 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 Output Iterator

Author: David Abrahams, Jeremy Siek, Thomas Witt
Organization: Boost Consulting, Indiana University Open Systems Lab, University of Hanover Institute for Transport Railway Operation and Construction
Date: 2006-09-11
Copyright: Copyright David Abrahams, Jeremy Siek, and Thomas Witt 2003.
abstract: The function output iterator adaptor makes it easier to create custom output iterators. The adaptor takes a unary function and creates a model of Output Iterator. Each item assigned to the output iterator is passed as an argument to the unary function. The motivation for this iterator is that creating a conforming output iterator is non-trivial, particularly because the proper implementation usually requires a proxy object.

Table of Contents

function_output_iterator requirements

UnaryFunction must be Assignable and Copy Constructible.

function_output_iterator models

function_output_iterator is a model of the Writable and Incrementable Iterator concepts.

function_output_iterator operations

explicit function_output_iterator(const UnaryFunction& f = UnaryFunction());

Effects:Constructs an instance of function_output_iterator with m_f constructed from f.


Returns:An object r of unspecified type such that r = t is equivalent to m_f(t) for all t.

function_output_iterator& operator++();


function_output_iterator& operator++(int);



struct string_appender
    string_appender(std::string& s)
        : m_str(&s)

    void operator()(const std::string& x) const
        *m_str += x;

    std::string* m_str;

int main(int, char*[])
  std::vector<std::string> x;
  x.push_back(" ");

  std::string s = "";
  std::copy(x.begin(), x.end(),

  std::cout << s << std::endl;

  return 0;