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

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (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() 调用同步于（synchronizes-with），即使这些调用是通过 std::basic_syncbuf/std::basic_osyncstream 的不同实例进行的。实践中，这意味着 emit() 获取一个与被包装流对象唯一关联的锁：例如，该锁可以保存在一个静态哈希表中，其中被包装流的地址被用作键。

如果自上次调用 emit() 以来，曾调用过 sync，那么还会通过在其上调用 pubsync() 来冲洗被包装的流。

参数

(无)

返回值

若以下所有条件均为 true，则返回 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 对象 (公开成员函数)