Boost C++ 库

……全球备受推崇、设计精湛的 C++ 库项目之一。 Herb SutterAndrei Alexandrescu, C++ Coding Standards

面向缓冲区的同步随机访问写入设备要求 - Boost C++ 函数库
PrevUpHomeNext

下表中的 a 表示同步随机访问写入设备对象,o 表示 boost::uint64_t 类型的偏移量,cb 表示满足 常量缓冲区序列 要求的对象,而 ec 则表示 error_code 类型的对象。

表 31. 面向缓冲区的同步随机访问写入设备要求

操作

type

语义、前/后置条件

a.write_some_at(o, cb);

size_t

等同于

error_code ec;
size_t s = a.write_some(o, cb, ec);
if (ec) throw system_error(ec);
return s;

a.write_some_at(o, cb, ec);

size_t

将一个或多个字节的数据写入设备 a 的偏移量 o 处。

常量缓冲区序列 cb 指定了要写入的数据所在的内存。 write_some_at 操作应始终完整地写入序列中的一个缓冲区,然后再继续处理下一个。

如果成功,则返回写入的字节数,并将 ec 设置为 !ec 为 true。如果发生错误,则返回 0,并将 ec 设置为 !!ec 为 true。

如果序列 cb 中所有缓冲区的总大小为 0,则该函数应立即返回 0



PrevUpHomeNext