std::clog, std::wclog

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ostream

全局对象
coutwcout	cerrwcerr	clogwclog
成员函数
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
有格式输出
basic_ostream::operator<<
无格式输出
basic_ostream::put
basic_ostream::write
定位
basic_ostream::tellp
basic_ostream::seekp
杂项
basic_ostream::flush
basic_ostream::swap (C++11)
成员类
basic_ostream::sentry
非成员函数
operator<<(std::basic_ostream)

 

在标头 <iostream> 定义
extern std::ostream clog;	(1)
extern std::wostream wclog;	(2)

全局对象 std::clog 和 std::wclog 控制实现定义类型（导出自 std::streambuf ）的流缓冲，与标准 C 输出流 stderr 关联，但不同于 std::cerr/std::wcerr ，不自动冲入这些流，且不自动与 cout tie() 。

保证这些对象在构造首个 std::ios_base::Init 类型对象之前或期间得到初始化，而且可用于带有序初始化的静态对象的构造函数和析构函数（只要在定义对象前包含 <iostream> ）。

除非发出 sync_with_stdio(false) ，有格式和无格式输出从多个线程访问这些对象是安全的。

注解

名称中的 'c' 指代“字符”（ stroustrup.com FAQ ）； clog 表示“字符日志”而 wclog 表示“宽字符日志”。

示例

运行此代码

#include <iostream>
 
struct Foo {
    int n;
    Foo() {
       std::clog << "static constructor\n";
    }
    ~Foo() {
       std::clog << "static destructor\n";
    }
};
 
Foo f; // 静态对象
 
int main()
{
    std::clog << "main function\n";
}

输出：

static constructor
main function
static destructor

参阅

Init	初始化标准流对象 (std::ios_base 的公开成员类)
cerrwcerr	写入到标准 C 错误流 stderr，无缓冲 (全局对象)
coutwcout	写入到标准 C 输出流 stdout (全局对象)
stdinstdoutstderr	与输入流关联到 FILE* 类型表达式 与输出流关联的 FILE* 类型表达式 与错误输出流关联的 FILE* 类型表达式 (宏常量)