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

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (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 如果以下所有情况都为真

• 存在包装流（包装流缓冲区指针不为空）
• 临时存储中的所有字符都已成功发送到包装流
• 如果请求，对 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 对象 (公有成员函数)