(PECL eio >= 0.0.1dev)
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_BEFORE
、EIO_SYNC_FILE_RANGE_WRITE
、EIO_SYNC_FILE_RANGE_WAIT_AFTER
。這些旗標的含義與其 SYNC_FILE_RANGE_* 對應項相同(請參閱 SYNC_FILE_RANGE(2)
線上手冊頁面)。
pri
請求優先級:EIO_PRI_DEFAULT
、EIO_PRI_MIN
、EIO_PRI_MAX
或 null
。如果傳遞 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
。