std::istream_iterator

template< class T,
          class CharT = char,
          class Traits = std::char_traits<CharT>,
          class Distance = std::ptrdiff_t >
class istream_iterator
    : public std::iterator<std::input_iterator_tag, T, Distance, const T*, const T&>

template< class T,
          class CharT = char,
          class Traits = std::char_traits<CharT>,
          class Distance = std::ptrdiff_t >
class istream_iterator;

std::istream_iterator — это однопроходный входной итератор, который считывает последовательные объекты типа T из объекта std::basic_istream, для которого он был создан, вызывая соответствующий operator>>. Фактическое считывание выполняется при инкрементировании итератора, а не при его разыменовании. Первый объект считывается при создании итератора. Разыменование лишь возвращает копию последнего считанного объекта.

Итератор std::istream_iterator, созданный по умолчанию, называется итератором конца потока. Когда корректный std::istream_iterator достигает конца базового потока, он становится равным итератору конца потока. Дальнейшее разыменование или инкрементирование приводит к неопределённому поведению. Итератор конца потока остаётся в этом состоянии, даже если состояние базового потока изменится. Если не присвоить ему другое значение, он больше не может стать итератором, не являющимся итератором конца потока.

Типичная реализация std::istream_iterator содержит два элемента данных: указатель на соответствующий объект std::basic_istream и последнее считанное значение типа T.

T должен соответствовать требованиям DefaultConstructible, CopyConstructible и CopyAssignable.

Типы-члены

Функции-члены

Функции, не являющиеся членами

Примечания

При чтении символов std::istream_iterator по умолчанию пропускает пробельные символы (если это не отключено с помощью std::noskipws или эквивалентного средства), а std::istreambuf_iterator этого не делает. Кроме того, std::istreambuf_iterator эффективнее, поскольку позволяет избежать затрат на создание и уничтожение объекта sentry для каждого символа.

Пример

#include <algorithm>
#include <iostream>
#include <iterator>
#include <numeric>
#include <sstream>

int main()
{
    std::istringstream str("0.1 0.2 0.3 0.4");
    std::partial_sum(std::istream_iterator<double>(str),
                     std::istream_iterator<double>(),
                     std::ostream_iterator<double>(std::cout, " "));
    
    std::istringstream str2("1 3 5 7 8 9 10");
    auto it = std::find_if(std::istream_iterator<int>(str2),
                           std::istream_iterator<int>(),
                           [](int i){ return i % 2 == 0; });
    
    if (it != std::istream_iterator<int>())
        std::cout << "\nThe first even number is " << *it << ".\n";
    //" 9 10" left in the stream
}

0.1 0.3 0.6 1
The first even number is 8.

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также