std::experimental::ostream_joiner

来自cppreference.com
 
C++
 
实验性
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
实验性非 TS 功能特性
模式匹配
线性代数
std::execution
契约
2D 图形
 
库基础 v2
 
std::experimental::ostream_joiner
 
在标头 <experimental/iterator> 定义 
template<
    class DelimT,
    class CharT = char,
    class Traits = std::char_traits<CharT>
>
class ostream_joiner;
(库基础 TS v2)

std::experimental::ostream_joiner 是为 std::basic_ostream 构造的单趟老式输出迭代器 (LegacyOutputIterator) ，它用 operator<< 写入分隔符所分隔相继对象到该流中。在每两个写入的对象间，写入分隔符到输出流。在赋值给迭代器（无论是否解引用）时进行写入操作。自增 ostream_joiner 是无操作。

典型实现中，ostream_joiner 仅有的数据成员是指向关联 std::basic_ostream 的指针、分隔符和指示下次写入是否对于序列中首元素的 bool 成员。

与 std::ostream_iterator 相比，ostream_joiner 少打印一次分隔符，并且不在待打印的对象类型上模板化。

成员类型

成员类型 定义
char_type CharT
traits_type Traits
ostream_type std::basic_ostream<CharT, Traits>
value_type void
difference_type void
pointer void
reference void
iterator_category std::output_iterator_tag

成员函数

 创建新的 ostream_joiner
(公开成员函数)
(析构函数)
(隐式声明)
 销毁 ostream_joiner
(公开成员函数)
写入对象到关联输出序列
(公开成员函数)
无操作
(公开成员函数)
无操作
(公开成员函数)

非成员函数

 创建 ostream_joiner 对象，从函数实参推导模板实参
(函数模板)

示例

运行此代码
#include <algorithm>
#include <experimental/iterator>
#include <iostream>
#include <iterator>

int main()
{
    int i[] = {1, 2, 3, 4, 5};
    std::copy(std::begin(i),
              std::end(i),
              std::experimental::make_ostream_joiner(std::cout, ", "));
}

输出： 

1, 2, 3, 4, 5

参阅

 写入 std::basic_streambuf 的输出迭代器
(类模板)
写入 std::basic_ostream 的输出迭代器
(类模板)
从 std::basic_istream 读取的输入迭代器
(类模板)