PHP 大会日本 2024

eio_fallocate

(PECL eio >= 0.0.1dev)

eio_fallocate允许调用者直接操作文件的分配磁盘空间

描述

eio_fallocate(
    混合类型 $fd,
    整数 $mode,
    整数 $offset,
    整数 $length,
    整数 $pri = EIO_PRI_DEFAULT,
    可调用 $callback = NULL,
    混合类型 $data = NULL
): 资源

eio_fallocate() 允许调用者直接操作由 fd 文件描述符指定的从 offset 开始,持续 length 字节的文件的分配磁盘空间。

注意: 文件应以写入模式打开

EIO_O_CREAT 应该与 EIO_O_WRONLYEIO_O_RDWR 进行逻辑 OR 操作

参数

fd

流、套接字资源或数字文件描述符,例如由 eio_open() 返回。

mode

目前仅支持一个模式标志:EIO_FALLOC_FL_KEEP_SIZE(与 POSIX 常量 FALLOC_FL_KEEP_SIZE 相同)。

offset

指定字节范围的起始位置。

length

指定字节范围的长度。

pri

请求优先级:EIO_PRI_DEFAULTEIO_PRI_MINEIO_PRI_MAXnull。如果传递 null,则 pri 在内部设置为 EIO_PRI_DEFAULT

callback

callback 函数在请求完成时被调用。它应与以下原型匹配

void callback(混合类型 $data, 整数 $result[, 资源 $req]);
data

是传递给请求的自定义数据。

result

请求特定的结果值;基本上,是相应系统调用返回的值。

req

是可选的请求资源,可用于诸如 eio_get_last_error() 之类的函数。

data

传递给 callback 的任意变量。

返回值

eio_fallocate() 在成功时返回请求资源,在失败时返回 false

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top