PHP Conference Japan 2024

eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_range将文件段与磁盘同步

描述

eio_sync_file_range(
    混合 $fd,
    整数 $offset,
    整数 $nbytes,
    整数 $flags,
    整数 $pri = EIO_PRI_DEFAULT,
    可调用 $callback = NULL,
    混合 $data = NULL
): 资源

eio_sync_file_range() 允许在将文件描述符 fd 指向的打开文件与磁盘同步时进行精细控制。

参数

fd

文件描述符

offset

要同步的文件范围的起始字节

nbytes

指定要同步的范围的长度(以字节为单位)。如果 nbytes 为零,则同步从 offset 到文件结尾的所有字节。

flags

位掩码。可以包含以下任何值:EIO_SYNC_FILE_RANGE_WAIT_BEFOREEIO_SYNC_FILE_RANGE_WRITEEIO_SYNC_FILE_RANGE_WAIT_AFTER。这些标志的含义与其 SYNC_FILE_RANGE_* 对应项相同(参见 SYNC_FILE_RANGE(2) 手册页)。

pri

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

callback

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

void callback(mixed $data, int $result[, resource $req]);
data

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

result

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

req

是可选的请求资源,可与 eio_get_last_error() 等函数一起使用。

data

传递给 callback 的任意变量。

返回值

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

添加注释

用户贡献的注释

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