頭文件

#include <boost/function_output_iterator.hpp>

template <class UnaryFunction>
class function_output_iterator {
public:
  typedef std::output_iterator_tag iterator_category;
  typedef void                     value_type;
  typedef void                     difference_type;
  typedef void                     pointer;
  typedef void                     reference;

  explicit function_output_iterator();

  explicit function_output_iterator(const UnaryFunction& f);

  /* 見下文 */ operator*();
  function_output_iterator& operator++();
  function_output_iterator& operator++(int);
private:
  UnaryFunction m_f;     // exposition only
};

function_output_iterator 的要求

UnaryFunction 必須是可賦值和可複製構造的。

function_output_iterator 的模型

function_output_iterator 是可寫和可遞增迭代器概念的 model.

function_output_iterator 的操作

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

作用：	構造一個 function_output_iterator 實例，其 m_f 構造自 f.

operator*();

返回：	一個未指定類型的對象 r，對於所有 t 滿足 r = t 等效於 m_f(t).

function_output_iterator& operator++();

返回：	*this

function_output_iterator& operator++(int);

返回：	*this

 

例子

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("hello");
  x.push_back(" ");
  x.push_back("world");
  x.push_back("!");

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

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

  return 0;
}