I/O manipulators | ||||
Print functions(C++23) | ||||
C-style I/O | ||||
Buffers | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++20) | ||||
Streams | ||||
Abstractions | ||||
File I/O | ||||
String I/O | ||||
Array I/O | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
Synchronized Output | ||||
(C++20) | ||||
Types | ||||
Error category interface | ||||
(C++11) | ||||
(C++11) |
Global objects | |||||||
| |||||||
Member functions | |||||||
(C++11) | |||||||
Formatted output | |||||||
Unformatted output | |||||||
Positioning | |||||||
Miscellaneous | |||||||
(C++11) | |||||||
Member classes | |||||||
Non-member functions | |||||||
(C++23) | |||||||
(C++23) | |||||||
(C++23) | |||||||
Defined in header <iostream> | ||
externstd::ostream cout; | (1) | |
externstd::wostream wcout; | (2) | |
The global objectsstd::cout
andstd::wcout
control output to a stream buffer of implementation-defined type (derived fromstd::streambuf), associated with the standard C output streamstdout.
These objects are guaranteed to be initialized during or before the first time an object of typestd::ios_base::Init is constructed and are available for use in the constructors and destructors of static objects withordered initialization (as long as<iostream> is included before the object is defined).
Unlessstd::ios_base::sync_with_stdio(false) has been issued, it is safe to concurrently access these objects from multiple threads for both formatted and unformatted output.
By specification ofstd::cin,std::cin.tie() returns&std::cout. This means that any input operation onstd::cin
executesstd::cout.flush() (viastd::basic_istream::sentry's constructor). Similarly,std::wcin.tie() returns&std::wcout.
By specification ofstd::cerr,std::cerr.tie() returns&std::cout. This means that any output operation onstd::cerr
executesstd::cout.flush() (viastd::basic_ostream::sentry's constructor). Similarly,std::wcerr.tie() returns&std::wcout.(since C++11)
The 'c' in the name refers to "character" (stroustrup.com FAQ);cout
means "character output" andwcout
means "wide character output".
Becausedynamic initialization oftemplated variables are unordered, it is not guaranteed thatstd::cout
has been initialized to a usable state before the initialization of such variables begins, unless an object of typestd::ios_base::Init has been constructed.
#include <iostream> struct Foo{int n; Foo(){ std::cout<<"static constructor\n";} ~Foo(){ std::cout<<"static destructor\n";}}; Foo f;// static object int main(){ std::cout<<"main function\n";}
Output:
static constructormain functionstatic destructor
initializes standard stream objects (public member class of std::ios_base )[edit] | |
writes to the standard C error streamstderr, unbuffered (global object)[edit] | |
writes to the standard C error streamstderr (global object)[edit] | |
expression of typeFILE* associated with the input stream expression of typeFILE* associated with the output stream expression of typeFILE* associated with the error output stream (macro constant)[edit] |