std::basic_syncbuf<CharT,Traits,Allocator>::emit

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

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/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_syncbuf

公共成员函数

basic_syncbuf::basic_syncbuf (C++20)

basic_syncbuf::operator= (C++20)

basic_syncbuf::~basic_syncbuf (C++20)

basic_syncbuf::swap (C++20)

basic_syncbuf::emit (C++20)

basic_syncbuf::get_wrapped (C++20)

basic_syncbuf::get_allocator (C++20)

basic_syncbuf::set_emit_on_sync (C++20)

受保护成员函数

basic_syncbuf::sync (C++20)

非成员函数

swap(std::basic_syncbuf) (C++20)

 

bool emit();

原子性地将所有待处理的输出传输到包装的流。

所有 emit() 调用，将字符传输到同一包装的流缓冲区对象，都以总顺序执行，其中每个 emit() 调用 同步于 该总顺序中的后续 emit() 调用，即使这些调用是通过 std::basic_syncbuf/std::basic_osyncstream 的不同实例进行的。实际上，这意味着 emit() 获取与包装的流对象唯一关联的锁：例如，它可以保存在静态哈希映射中，其中包装的流的地址用作键。

如果在上次调用 emit() 之后调用了 sync，则还会通过在其上调用 pubsync() 来刷新包装的流。

参数

(无)

返回值

true 如果以下所有条件都为真

• 存在包装的流（包装的 streambuf 指针不为空）
• 来自临时存储的所有字符已成功发送到包装的流中
• 对 pubsync() 的调用（如果请求）也已成功完成。

否则返回 false。

注解

通常由拥有 std::basic_osyncstream 的析构函数或移动赋值调用，或由 std::basic_osyncstream::emit 调用。

参见

(析构函数)	销毁 basic_osyncstream 并发出其内部缓冲区 (std::basic_osyncstream<CharT,Traits,Allocator> 的公共成员函数)
emit	在底层 basic_syncbuf 上调用 emit() 以将其内部数据传输到最终目的地 (std::basic_osyncstream<CharT,Traits,Allocator> 的公共成员函数)
(构造函数)	构造一个 basic_syncbuf 对象 (公共成员函数)