Пространства имён
Варианты
Действия

std::istream_iterator

Материал из cppreference.com
< cpp‎ | iterator

 
 
Библиотека итераторов
Концепты итераторов
Примитивы итераторов
Концепты алгоритмов и утилиты
Косвенно вызываемые концепты
Общие требования к алгоритмам
Утилиты
(C++20)
Адаптеры итераторов
Потоковые итераторы
istream_iterator
Точки настройки итераторов
Операции итераторов
(C++11)
(C++11)
Доступ к диапазону
(C++11)(C++14)
(C++11)(C++14)
(C++17)(C++20)
(C++14)(C++14)
(C++14)(C++14)
(C++17)
(C++17)
 
std::istream_iterator
Член функций
Оригинал:
Member functions
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Не являющиеся членами функций
Оригинал:
Non-member functions
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
 
Определено в заголовочном файле <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&>
std::istream_iterator является однопроходной итератор ввода, который читает последовательных объектов типа T от std::basic_istream объекта, для которого она была построена, вызывая соответствующий operator>>. Фактически операция чтения выполняется, когда итератор увеличивается, а не когда он разыменовываются. Первый объект может быть прочитано, когда итератор построен или при появлении первых разыменования сделано. В противном случае, разыменование только возвращает копию недавно читал объекта.
Оригинал:
std::istream_iterator is a single-pass input iterator that reads successive objects of type T from the std::basic_istream object for which it was constructed, by calling the appropriate operator>>. The actual read operation is performed when the iterator is incremented, not when it is dereferenced. The first object may be read when the iterator is constructed or when the first dereferencing is done. Otherwise, dereferencing only returns a copy of the most recently read object.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
По-умолчанию std::istream_iterator известен как конца поток итератор. Когда действительный std::istream_iterator достигает конца основной поток, он становится равным конца потока итератора. Разыменование или увеличивая его дальнейшего вызывает неопределенное поведение.
Оригинал:
The default-constructed std::istream_iterator is known as the end-of-stream iterator. When a valid std::istream_iterator reaches the end of the underlying stream, it becomes equal to the end-of-stream iterator. Dereferencing or incrementing it further invokes undefined behavior.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Типичная реализация std::istream_iterator имеет два данным участников: указатель на соответствующий объект std::basic_istream и наиболее недавно прочитал значение типа T.
Оригинал:
A typical implementation of std::istream_iterator holds two data members: a pointer to the associated std::basic_istream object and the most recently read value of type T.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
При чтении символов, std::istreambuf_iterator является более эффективным, так как оно позволяет избежать накладных расходов на строительство и разрушать часовой объект один раз в характере.
Оригинал:
When reading characters, std::istreambuf_iterator is more efficient, since it avoids the overhead of constructing and destructing the sentry object once per character.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Содержание

[править] Типы-члены

Тип члена Определение
char_type CharT
traits_type Traits
istream_type std::basic_istream<CharT, Traits>

[править] Функции-члены

создает новый istream_iterator
Оригинал:
constructs a new istream_iterator
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-элемент)
(деструктор)
(объявлено неявно)
destructs an istream_iterator, including the cached value
(public функция-элемент)
получает копию текущего element
accesses членом текущего элемента
Оригинал:
obtains a copy of the current element
accesses a member of the current element
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-элемент)
авансы istream_iterator
Оригинал:
advances the istream_iterator
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(public функция-элемент)

[править] Функции, не являющиеся членами

сравнивает два istream_iterators
Оригинал:
compares two istream_iterators
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(шаблон функции)

[править] Типы элементы

Тип элемент Определение
iterator_category std::input_iterator_tag
value_type T
difference_type Distance
pointer const T*
reference const T&

Типы элемены iterator_category, value_type, difference_type, pointer и reference должны быть получены путём наследования от std::iterator<std::input_iterator_tag, T, Distance, const T*, const T&>.

(до C++17)

[править] Пример

#include <iostream>
#include <sstream>
#include <iterator>
#include <numeric>
 
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, " "));
}

Вывод:

0.1 0.3 0.6 1

[править] См. также

итератор вывода, записывающий в std::basic_ostream
(шаблон класса) [править]
итератор ввода, читающий из std::basic_streambuf
(шаблон класса) [править]