std::istreambuf_iterator
Материал из cppreference.com
 |
Эта страница была переведена автоматически с английской версии вики используя Переводчик Google. Перевод может содержать ошибки и странные формулировки. Наведите курсор на текст, чтобы увидеть оригинал. Щёлкните здесь, чтобы увидеть английскую версию этой страницы. (Вы можете помочь в исправлении ошибок и улучшении перевода. Для инструкций перейдите по ссылке.) |
<metanoindex/>
<tbody> </tbody>| Определено в заголовочном файле <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 объекта, для которого она была построена. Фактически операция чтения выполняется, когда итератор увеличивается, а не когда он разыменовываются. Первый символ может быть прочитано, когда итератор построен или при появлении первых разыменования сделано. В противном случае, разыменование только возвращает копию недавно прочитал характер.Оригинал:
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.Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
По-умолчанию
std::istreambuf_iterator известен как конца поток итератор. Когда действительный std::istreambuf_iterator достигает конца основной поток, он становится равным конца потока итератора. Разыменование или увеличивая его дальнейшего вызывает неопределенное поведение.Оригинал:
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.Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
std::istreambuf_iterator имеет тривиальный конструктор копирования, конструктор КонстВыраж умолчанию, и тривиальный деструктор.Оригинал:
std::istreambuf_iterator has a trivial copy constructor, a constexpr default constructor, and a trivial destructor.Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Типы-члены
| Тип члена | Определение |
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>
|
| Этот раздел не завершён Причина: the proxy member type |
Функции-члены
создает новый istreambuf_iterator Оригинал: constructs a new istreambuf_iterator Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент) | |
(деструктор) (объявлено неявно) |
destructs an istreambuf_iterator (public функция-элемент) |
(начиная с C++11) |
получает копию текущего character accesses членом текущего характера, если CharT имеет членов Оригинал: obtains a copy of the current character accesses a member of the current character, if CharT has members Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент) |
авансы istreambuf_iterator Оригинал: advances the istreambuf_iterator Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент) | |
Тесты, если оба istreambuf_iterators являются конца потока или, если оба являются действительными Оригинал: tests if both istreambuf_iterators are end-of-stream or if both are valid Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент) |
Функции, не являющиеся членами
сравнивает два istreambuf_iterators Оригинал: compares two istreambuf_iterators Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (шаблон функции) |
Типы элементы
| Тип элемент | Определение |
iterator_category
|
std::input_iterator_tag
|
value_type
|
CharT
|
difference_type
|
Traits::off_type
|
pointer
|
/* unspecified, usually CharT* */
|
reference
|
CharT
|
|
Типы элемены |
(до C++17) |
Пример
Запустить этот код
#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
См. также
| итератор вывода, записывающий в std::basic_streambuf (шаблон класса) | |
| итератор ввода, читающий из std::basic_istream (шаблон класса) |
