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 应该逻辑上 OR 操作 EIO_O_WRONLYEIO_O_RDWR

参数

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