定义于头文件 <istream>

template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_istream : virtual public std::basic_ios<CharT, Traits>

 类模板 basic_istream 提供字符流上的高层输入支持。受支持操作包含带格式的输入（例如整数值或空白符分隔的字符与字符串）和无格式输入（例如未处理字符和字符数组）。此功能以通过 basic_ios 基类访问的底层 basic_streambuf 类所提供的接口实现。大多数库实现中， basic_istream 有一个非继承数据成员：用于存储 basic_istream::gcount() 所返回的值。

全局对象

标准库提供二个全局 basic_istream 对象。

从标准 C 输入流 stdin 中读取

std::cin, 
std::wcin

extern std::istream cin;	(1)
extern std::wistream wcin;	(2)

 全局对象 std::cin 和 std::wcin 控制来自实现定义类型（导出自 std::streambuf ）的流缓冲区的输入，与标准 C 输入流 stdin 关联。

保证在首次构造 std::ios_base::Init 前或期间初始化这些对象，且它们可用于拥有有序初始化的静态对象的构造及析构函数（只要在定义该对象前包含 <iostream> ）。

如果不使用 sync_with_stdio(false)， 则从多个线程访问这些对象，进行有格式和无格式输入是安全的。

一旦构造 std::cin ， std::cin.tie() 就返回 &std::cout ，类似地 std::wcin.tie() 返回 &std::wcout 。这表示若有任何字符正在等待输出，则任何 std::cin 上的格式化输入操作会强制调用 std::cout.flush() 。

注意

名称中的 'c' 指代“character”（ stroustrup.com FAQ ）； cin 表示“字符输入”而 wcin 表示“宽字符输入”。

调用示例

#include <iostream>struct Foo
{int n;Foo(){std::cout << "Enter n: "; // 不需要冲入std::cin >> n;}
};Foo f; // static objectint main()
{std::cout << "f.n is " << f.n << '\n';
}

输出