std:: 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 более эффективен, поскольку избегает накладных расходов на создание и уничтожение сторожевого объекта для каждого символа.

Пример

#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++.

Смотрите также