object
<iostream>
std::wcin
extern basic_istream<wchar_t> wcin;
Standard input stream (wide)
Object of class wistream that represents the standard input stream oriented to wide characters (of type wchar_t
). It corresponds to the C stream stdin.
The standard input stream is a source of characters determined by the environment. It is generally assumed to be input from an external source, such as the keyboard or a file.
As an object of a basic_istream class, characters can be retrieved either as formatted data using the extraction operator (operator>>
) or as unformatted data, using member functions such as read.
The object is declared in header <iostream>
with external linkage and static duration: it lasts the entire duration of the program.
In terms of
static initialization order,
wcin is guaranteed to be properly constructed and initialized no later than the first time an object of type
ios_base::Init is constructed.
In terms of
static initialization order,
wcin is guaranteed to be properly constructed and initialized no later than the first time an object of type
ios_base::Init is constructed, with the inclusion of
<iostream> counting as at least one initialization of such objects with
static duration.
wcin is tied to the standard output stream wcout (see basic_ios::tie), which indicates that wcout's buffer is flushed (see basic_ostream::flush) before each i/o operation performed on wcin.
By default, wcin is synchronized with stdin (see ios_base::sync_with_stdio).
A program should not mix input operations on wcin with input operations on cin (or with other narrow-oriented input operations on stdin): Once an input operation has been performed on either, the standard input stream acquires an orientation (either narrow or wide) that can only be safely changed by calling freopen on stdin.
For more information on the operations supported by wcin, see the reference for its type: basic_istream.
See also
- istream
- Input stream (class
)
- cin
- Standard input stream (object
)
- wcout
- Standard output stream (wide) (object
)