std::istreambuf_iterator

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Iterator библиотеки

Iterator примитивов Original: Iterator primitives The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
iterator_traits
input_iterator_tag output_iterator_tag forward_iterator_tag bidirectional_iterator_tag random_access_iterator_tag
iterator
Iterator адаптеров Original: Iterator adaptors The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
reverse_iterator
move_iterator (C++11) back_insert_iterator front_insert_iterator insert_iterator	make_move_iterator (C++11) back_inserter front_inserter inserter
Поток итераторы Original: Stream iterators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
istream_iterator
ostream_iterator
istreambuf_iterator
ostreambuf_iterator
Iterator операций Original: Iterator operations The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
advance
distance
prev (C++11)
next (C++11)
Диапазон доступа Original: Range access The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
begin (C++11)
end (C++11)

 

std::istreambuf_iterator

Член функций Original: Member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

istreambuf_iterator::istreambuf_iterator

istreambuf_iterator::operator* istreambuf_iterator::operator-> (C++11)

istreambuf_iterator::operator++ istreambuf_iterator::operator++(int)

istreambuf_iterator::equal

Не являющиеся членами функций Original: Non-member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

operator== operator!=

 

Заголовочный файл <iterator>
template< class CharT, class Traits = std::char_traits<CharT> > class istreambuf_iterator : public std::iterator< std::input_iterator_tag,                                                   CharT,                                                   typename Traits::off_type,                                                   /* unspecified, usually CharT* */,                                                   CharT >

std::istreambuf_iterator является однопроходной итератор ввода, который читает последовательных символов из std::basic_streambuf объекта, для которого она была построена. Фактически операция чтения выполняется, когда итератор увеличивается, а не когда он разыменовываются. Первый символ может быть прочитано, когда итератор построен или при появлении первых разыменования сделано. В противном случае, разыменование только возвращает копию недавно прочитал характер.

Original:

std::istreambuf_iterator is a single-pass input iterator that reads successive characters from the std::basic_streambuf object for which it was constructed. The actual read operation is performed when the iterator is incremented, not when it is dereferenced. The first character 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 character.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

По-умолчанию std::istreambuf_iterator известен как конца поток итератор. Когда действительный std::istreambuf_iterator достигает конца основной поток, он становится равным конца потока итератора. Разыменование или увеличивая его дальнейшего вызывает неопределенное поведение.

Original:

The default-constructed std::istreambuf_iterator is known as the end-of-stream iterator. When a valid std::istreambuf_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.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

std::istreambuf_iterator имеет тривиальный конструктор копирования, конструктор КонстВыраж умолчанию, и тривиальный деструктор.

Original:

std::istreambuf_iterator has a trivial copy constructor, a constexpr default constructor, and a trivial destructor.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Член типов

Член типа Original: Member type The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.	Definition
char_type	CharT
traits_type	Traits
int_type	typename traits::int_type
streambuf_type	std::basic_streambuf<CharT, Traits>
istream_type	std::basic_istream<CharT, Traits>

Член функций

(constructor)	создает новый istreambuf_iterator Original: constructs a new istreambuf_iterator The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
(destructor) (объявлено неявно)	destructs an istreambuf_iterator (public функция-член)
operator* operator-> (начиная с C++11)	получает копию текущего character accesses членом текущего характера, если CharT имеет членов Original: obtains a copy of the current character accesses a member of the current character, if CharT has members The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
operator++ operator++(int)	авансы istreambuf_iterator Original: advances the istreambuf_iterator The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)
equal	Тесты, если оба istreambuf_iterators являются конца потока или, если оба являются действительными Original: tests if both istreambuf_iterators are end-of-stream or if both are valid The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (public функция-член)

Не являющиеся членами функций

operator== operator!=	сравнивает два istreambuf_iterators Original: compares two istreambuf_iterators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон функции)

Унаследован от std::iterator

Member types

Член типа Original: Member type The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.	Definition
value_type	CharT
difference_type	Traits::off_type
pointer	/* unspecified, usually CharT* */
reference	CharT
iterator_category	std::input_iterator_tag

Пример

#include <vector>
#include <sstream>
#include <iostream>
#include <iterator>
int main()
{
    // typical use case: an input stream represented as a pair of iterators
    std::istringstream in("Hello, world");
    std::vector<char> v( (std::istreambuf_iterator<char>(in)),
                          std::istreambuf_iterator<char>() );
    std::cout << "v has " << v.size() << " bytes. ";
    v.push_back('\0');
    std::cout << "it holds \"" << &v[0] << "\"\n";
 
 
    // demonstration of the single-pass nature
    std::istringstream s("abc");
    std::istreambuf_iterator<char> i1(s), i2(s);
    std::cout << "i1 returns " << *i1 << '\n'
              << "i2 returns " << *i2 << '\n';
    ++i1;
    std::cout << "after incrementing i1, but not i2\n"
              << "i1 returns " << *i1 << '\n'
              << "i2 returns " << *i2 << '\n';
    ++i2; // this makes the apparent value of *i2 to jump from 'a' to 'c'
    std::cout << "after incrementing i2, but not i1\n"
              << "i1 returns " << *i1 << '\n'
              << "i2 returns " << *i2 << '\n';
 
}

Вывод:

v has 12 bytes. it holds "Hello, world"
i1 returns a
i2 returns a
after incrementing i1, but not i2
i1 returns b
i2 returns a
after incrementing i2, but not i1
i1 returns b
i2 returns c

См. также

ostreambuf_iterator	Выход итератора, который пишет std::basic_streambuf Original: output iterator that writes to std::basic_streambuf The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон класса)
istream_iterator	итератор ввода, который читает std::basic_istream Original: input iterator that reads from std::basic_istream The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (шаблон класса)