basic_istream::get
Считывает один или более символов из входного потока.
int_type get();
basic_istream<Elem, Tr>& get(
Elem& _Ch
);
basic_istream<Elem, Tr>& get(
Elem *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& get(
Elem *_Str,
streamsize _Count,
Elem _Delim
);
basic_istream<Elem, Tr>& get(
basic_streambuf<Elem, Tr>& _Strbuf
);
basic_istream<Elem, Tr>& get(
basic_streambuf<Elem, Tr>& _Strbuf,
Elem _Delim
);
Параметры
_Count
Число символов, предназначенных для чтения из strbuf._Delim
Символ, который должен выполнить чтение, если он встречается перед _Count._Str
Строка, в которой, которые требуется записать._Ch
Символ, который необходимо получить._Strbuf
Буфер, которые требуется записать.
Возвращаемое значение
Без форма получает возвращает элемент чтение как целое число или конца файла. Оставшиеся формы возвращают поток (*this).
Заметки
Первая из этих unformatted входных функций извлекает элемент, если это возможно, если, возвращая rdbuf->sbumpc. В противном случае возвращается значение traits_type::eof. Если функция не извлекает элемент, он вызывает функцию setstate(failbit).
Вторая функция извлекает элемент metaint_type таким же образом. Если meta сравнивает равно traits_type::eof, функция setstate(failbit). В противном случае он хранит traits_type::to_char_type(meta) в _Ch. Функция возвращает *this.
Третья функция возвращает get(_Str, _Count, widen('\n').
Четвертая функция извлекает до _Count — элементы 1 и сохраняет их в начале массива с _Str. Он всегда хранится char_type после того, как все извлеченные элементы он хранит. В порядке тестирования, извлечение останавливается.
В конце файла.
После того как функция извлекает элемент, который сравнивает равно _Delim; в этом случае которого он помещается обратно в контролируемой последовательности.
После функции извлекает элементы _Count — 1.
Если функция не извлекает элементов, она вызывает setstate(failbit). В любом случае, она возвращает *this.
Пятая функция возвращает get(strbuf,n'\ widen(').
Функция шестая извлекает элементы и вставляет их в strbuf. Извлечение прерывается на элемент — файле или для элемента, который сравнивает равно _Delim , которое не извлекано. Он также останавливается, без извлечения элементов в сообщении, если вставка завершилась ошибкой или создает исключение, оно (обработано, но не, повторно создаются). Если функция не извлекает элементов, она вызывает setstate(failbit). В любом случае функция возвращает *this.
Пример
// basic_istream_get.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char c[10];
c[0] = cin.get( );
cin.get( c[1] );
cin.get( &c[2],3 );
cin.get( &c[4], 4, '7' );
cout << c << endl;
}
Требования
Заголовок:<istream>
Пространство имен: std