命名空间
变体
操作

std::cerr, std::wcerr

来自 cppreference.cn
< cpp‎ | io
 
 
 
 
定义于头文件 <iostream>
extern std::ostream cerr;
(1)
extern std::wostream wcerr;
(2)

全局对象 std::cerrstd::wcerr 控制向实现定义的类型(分别派生自 std::streambufstd::wstreambuf)的流缓冲区输出,该缓冲区关联到标准 C 错误输出流 stderr

这些对象保证在类型为 std::ios_base::Init 的对象首次构造期间或之前被初始化,并且可用于具有有序初始化的静态对象的构造函数和析构函数中(只要在对象定义之前包含了 <iostream>)。

除非已经发出 std::ios_base::sync_with_stdio(false),否则可以安全地从多个线程并发访问这些对象,以进行格式化和非格式化输出。

一旦初始化,(std::cerr.flags() & unitbuf) != 0std::wcerr 亦同),这意味着发送到这些流对象的任何输出都将立即刷新到操作系统(通过 std::basic_ostream::sentry 的析构函数)。

此外,std::cerr.tie() 返回 &std::coutstd::wcerrstd::wcout 亦同),这意味着对 std::cerr 的任何输出操作都会首先执行 std::cout.flush()(通过 std::basic_ostream::sentry 的构造函数)。

目录

[编辑] 注意

名称中的“c”指的是“字符”(stroustrup.com FAQ);cerr 表示“字符错误(流)”,wcerr 表示“宽字符错误(流)”。

[编辑] 示例

通过 std::cerr 输出到 stderr 会刷新 std::cout 上待处理的输出,而通过 std::clog 输出到 stderr 则不会。

#include <chrono>
#include <iostream>
#include <thread>
using namespace std::chrono_literals;
 
void f()
{
    std::cout << "Output from thread...";
    std::this_thread::sleep_for(2s);
    std::cout << "...thread calls flush()" << std::endl;
}
 
int main()
{
    std::jthread t1{f};
    std::this_thread::sleep_for(1000ms);
    std::clog << "This output from main is not tie()'d to cout\n";
    std::cerr << "This output is tie()'d to cout\n";
}

可能的输出

This output from main is not tie()'d to cout
Output from thread...This output is tie()'d to cout
...thread calls flush()

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
LWG 455 C++98 std::cerr.tie()
std::wcerr.tie() 返回空指针
它们分别返回 &std::cout
&std::wcout

[编辑] 参阅

初始化标准流对象
(std::ios_base 的公共成员类) [编辑]
写入标准 C 错误流 stderr
(全局对象)[编辑]
写入标准 C 输出流 stdout
(全局对象)[编辑]
与输入流关联的 FILE* 类型的表达式
与输出流关联的 FILE* 类型的表达式
与错误输出流关联的 FILE* 类型的表达式
(宏常量) [编辑]