basic_istream 类

描述对象元素和编码对象的控件从以流缓冲区具有类型 Elem,也称为 char_type元素的类,由性格字符 Tr,也称为 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);

许多其他成员函数未格式输入的函数。 他们遵循:

    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>.虚公共基对象

  • 最后无格式的输入操作的提取计数 (称为前面代码中的 count )。

示例

针对 basic_ifstream 类 参见示例更多有关内容。

构造函数

basic_istream

构造 basic_istream 类型的对象。

成员函数

gcount

返回最后在无格式的输入中读取的字符数。

get

读取输入流中的一个或多个字符。

getline

读取输入流中的一行。

ignore

导致大量的元素读取从当前位置跳过。

偷看

返回要读取的下一个字符。

放回

将的指定字符到流中。

read

数组中读取指定数量的字符并从流存储它们。

readsome

仅限从缓冲区的只读。

seekg

移动在读取流中的位置。

哨兵

嵌套类描述声明构造格式输入的函数和非格式化的输入函数的对象。

swap

提供 basic_istream 的对象参数交换此 basic_istream 对象。

同步

同步与输入设备。流的缓冲区的流。

tellg

报告在读取流的当前位置。

unget

放置新的回流读取字符。

运算符

operator>>

对内容的函数或读取输入流格式的数据。

operator=

与运算符右侧的 basic_istream 指派给此对象。 这是不涉及将复制代码的 rvalue 引用的将分配。

要求

页眉:<istream>

命名空间: std

请参见

参考

C++ 标准库中的线程安全

iostream 编程

iostreams 约定

其他资源

basic_istream 成员

istream 成员