Класс basic_istream

Статья
06/09/2015

Описывает объект, извлечение элементов управления и элементов кодированных объектов из буфера потока с элементы типа Elem, также известные как char_type, в котором характеристики символа определяемые классом результатов, также известного как traits_type.

template <class Elem, class Tr = char_traits<Elem> > 
   class basic_istream 
      : virtual public basic_ios<Elem, Tr>

Заметки

Большинство функций-членов, перегружаются оператор>> форматированные входных функции. Они соответствуют шаблону:

    iostate state = goodbit;
    const sentry ok(*this);
    if (ok)
        {try
            {<extract elements and convert
            accumulate flags in state
            store a successful conversion> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);
    return (*this);

Многие функции-члены unformatted входных функции. Они соответствуют шаблону:

    iostate state = goodbit;
    count = 0;    // the value returned by gcount
    const sentry ok(*this, true);
    if (ok)
        {try
            {<extract elements and deliver
            count extracted elements in count
            accumulate flags in state> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);

Обе команды в составе вызов функции setstate(eofbit), если они обнаруживается конец файла во время извлечения элементов.

Объект класса basic_istream<Elem, Tr> хранит:

Открытый объект виртуального базового класса basic_ios<Elem, Tr>.
Число для извлечения последней unformatted вызываемой операции ввода ( count в предыдущем коде).

Пример

См. пример для Класс basic_ifstream, чтобы узнать больше о входных потоках.

конструкторов;

basic_istream

Создает объект типа basic_istream.

Функции-члены

gcount	Возвращает количество прочитанных символов во время последнего unformatted.
get	Считывает один или более символов из входного потока.
getline	Считывает линии из входного потока.
ignore	Вызывает несколько элементов необходимо пропустить с текущей прочитанной позиции.
украдкой взгляд	Возвращает следующий символ, предназначенного для чтения.
putback	Помещает указанный символ в поток.
read (чтение)	Считывает указанное количество символов из потока и сохраняет их в массиве.
readsome	Только чтение из буфера.
seekg	Перемещает положение, указанная в потоке.
sentry	Вложенный класс описывает объект которого структуры объявления форматированные входных функций и unformatted входных функции.
буфер обмена	Меняет местами этот объект basic_istream для предоставленного параметр объекта basic_istream.
синхронизация	Синхронизирует устройства ввода, связанное с потоком с буфером потока.
tellg	Отчеты текущая позиция, указанная в потоке.
unget	Помещает последним чтение символ обратно в поток.

Операторы

operator>>	Вызывает функцию на входном потоке или считывает форматированные данные из входного потока.
operator=	Присвоить basic_istream в правой части оператора к этому объекту. Это назначение перемещения, включающий ссылку rvalue, не произошло копию назад.