GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::istreambuf_iterator - cpprefjp C++日本語リファレンス

リファレンス
iterator
istreambuf_iterator

最終更新日時: 2026年08月24日 19時22分23秒 (JST)
Akira Takahashi が更新

履歴編集

class template

std::istreambuf_iterator

namespace std {
  template <class CharT, class Traits = char_traits<CharT> >
  class istreambuf_iterator
    : public iterator<input_iterator_tag, CharT, typename Traits::off_type, unspecified, CharT>;
}

概要

istreambuf_iteratorは、operator++()でイテレータを進めることにより、ストリームバッファのsbumpc()メンバ関数でストリームからデータを読み込む入力イテレータである。

ストリームからのsgetc()メンバ関数による読み取りがTraits::eof()を返した場合に、イテレータはendイテレータと等しくなる。

istream_iteratorとは異なり、スペースや改行が読み飛ばされることはない。いくつかのメンバ関数は、同じstreambufオブジェクトを参照するためにプロキシオブジェクトを返す。

メンバ関数

名前	説明	対応バージョン
`(constructor)`	コンストラクタ
`~istreambuf_iterator() = default`	デストラクタ
`operator*`	間接参照
`operator->`	メンバアクセス	C++11 C++17で削除
`operator++`	イテレータをインクリメントする
`equal`	`istreambuf_iterator`オブジェクトの等値比較

メンバ型

名前	説明	対応バージョン
`char_type`	`CharT`
`traits_type`	`Traits` (デフォルトは`char_traits<CharT>`)
`int_type`	`Traits::int_type`
`streambuf_type`	`basic_streambuf<CharT, Traits>`
`istream_type`	`basic_istream<CharT, Traits>`
`difference_type`	`Traits::off_type`
`pointer`	未規定
`value_type`	`CharT`
`iterator_category`	`input_iterator_tag`
`reference`	`CharT`

非メンバ関数

名前	説明	対応バージョン
`operator==`	等値比較
`operator!=`	非等値比較

備考

このクラスは、フリースタンディング処理系では使用できない。

例

#include <iostream>
#include <iterator>
#include <sstream>
#include <algorithm> // for_each

int main()
{
  std::stringstream ss;
  ss << "1 2 3" << std::endl
     << "4 5 6";

  // 文字列の入力ストリームから順に文字を読み込むイテレータを用意
  std::istreambuf_iterator<char> it(ss);
  std::istreambuf_iterator<char> last;

  // イテレータを進めることにより、入力ストリームからデータを順に読み取る
  std::for_each(it, last, [](char c) { std::cout << c; });
}

出力

1 2 3
4 5 6

GeezerVison

std::istreambuf_iterator

概要

メンバ関数

メンバ型

非メンバ関数

備考

例

出力

関連項目