定义于头文件 <istream>
template< class CharT, |
类模板 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 object
int main()
{
std::cout << "f.n is " << f.n << '\n';
}