Boost C++ 库

……是世界上最受推崇、设计最精湛的 C++ 库项目之一。 Herb SutterAndrei Alexandrescu, 《C++ 编码标准》

basic_random_access_file - Boost C++ 函数库
PrevUpHomeNext

提供随机访问文件功能。

template<
    typename Executor>
class basic_random_access_file :
  public basic_file< Executor >
类型

名称

描述

rebind_executor

将文件类型重新绑定到另一个执行器。

executor_type

与对象关联的执行器的类型。

flags

位掩码类型(C++ 标准 [lib.bitmask.types])。

native_handle_type

文件的本机表示。

seek_basis

文件查找的基准。

成员函数

名称

描述

assign

将现有本机文件分配给该文件。

async_read_some_at

在指定偏移量处开始异步读取。

async_write_some_at

在指定偏移量处开始异步写入。

basic_random_access_file [构造函数]

在不打开文件的情况下构造一个 basic_random_access_file。

构造并打开一个 basic_random_access_file。

在现有原生文件上构造一个 basic_random_access_file。

从另一个文件移动构造一个 basic_random_access_file。

从另一个执行器类型的对象移动构造一个 basic_random_access_file。

cancel

取消与该文件相关联的所有异步操作。

close

关闭文件。

get_executor

获取与对象关联的执行器。

is_open

确定文件是否已打开。

native_handle

获取文件的本机表示。

open

使用指定路径打开文件。

operator=

从另一个文件移动赋值一个 basic_random_access_file。

从另一个执行器类型的对象移动赋值一个 basic_random_access_file。

read_some_at

从指定偏移量处读取一些数据。

release

释放底层本机文件的所有权。

resize

更改文件的大小。

大小

获取文件的大小。

sync_all

将文件同步到磁盘。

sync_data

将文件数据同步到磁盘。

write_some_at

向指定偏移量处写入一些数据。

~basic_random_access_file [析构函数]

销毁该文件。

数据成员

名称

描述

append [静态]

以追加模式打开文件。

create [静态]

如果文件不存在,则创建文件。

exclusive [静态]

确保创建新文件。必须与 create 一起使用。

read_only [静态]

以只读模式打开文件。

read_write [静态]

以读写模式打开文件。

sync_all_on_write [静态]

以使写入操作自动将文件数据和元数据同步到磁盘的方式打开文件。

truncate [静态]

打开文件时截断其所有现有内容。

write_only [静态]

以只写模式打开文件。

类模板 basic_random_access_file 提供了异步和阻塞的随机访问文件功能。

线程安全

独立 对象: 安全。

共享 对象: 不安全。

如果底层操作系统调用也是线程安全的,则 read_some_atwrite_some_at 的同步操作彼此之间是线程安全的。这意味着允许在单个文件对象上并发执行这些同步操作。其他同步操作,如 openclose,则不是线程安全的。

要求

头文件: boost/asio/basic_random_access_file.hpp

便捷头文件: boost/asio.hpp


PrevUpHomeNext