basic_istream Class

项目
03/15/2013

描述对象控制元素的提取和从流缓冲区包含的元素的类型的编码的对象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）如果在提取元素时遇到了文件结尾。

An object of class basic_istream<Elem, Tr> 存储：

虚拟公共类的基对象 basic_ios<Elem， Tr>.
最后一次不带格式的输入操作提取计数（称为计数在前面的代码）。

示例

有关示例，请参阅basic_ifstream Class以了解有关输入流的详细信息。

构造函数

basic_istream

构造类型的对象basic_istream。

成员函数

gcount	返回在最后一次的无格式输入过程中读取的字符数。
get	从输入流中读取一个或多个字符。
getline	从输入流中读取行。
ignore	导致跳过从位置中读取当前元素的数字。
查看	返回下一个要读取的字符。
putback	将指定的字符放到流。
read	从流中读取指定的数目的字符，并将它们存储在数组中。
readsome	从缓冲区只能读取。
seekg	移动在流中读取的位置。
卫士	嵌套的类描述其声明结构的格式输入的函数和未格式化输入的函数的对象。
换用	交换这basic_istream对象所提供的basic_istream参数的对象。
同步	同步流的缓冲区与流相关联的输入的设备。
tellg	报告当前读取流中的位置。
unget	将最近回流中读取字符。

运算符

运算符 >>	在输入流上调用一个函数，或从输入流中读取格式的数据。
operator=	将指定basic_istream运算符对此对象的右侧。这是一次移动分配涉及rvalue不会留下一个副本的引用。