eio_truncate()

异步截断指定路径的文件,并将其大小设置为指定的偏移量

首字母:E

函数名:eio_truncate()

版本:PHP 5 >= 5.4.0, PECL eio >= 0.1.0

用法:eio_truncate(string $path, int $offset = 0 [, int $pri = EIO_PRI_DEFAULT [, callable|null $callback = NULL [, mixed $data = NULL]]]): resource

说明:eio_truncate()函数用于异步截断指定路径的文件,并将其大小设置为指定的偏移量。该函数是非阻塞的,所以在调用该函数后,程序可以继续执行其他操作。

参数:

  • $path:文件的路径。
  • $offset:截断文件的偏移量。如果该值大于文件的大小,则文件将被扩展到该偏移量。如果该值小于文件的大小,则文件将被截断到该偏移量处。默认为0,即截断文件到0字节。
  • $pri:可选参数,指定异步操作的优先级。可以是以下常量之一:EIO_PRI_DEFAULT(默认),EIO_PRI_MIN,EIO_PRI_MAX。
  • $callback:可选参数,指定一个回调函数,当操作完成时将被调用。回调函数接受两个参数:intval $data表示异步操作完成后的返回值,mixed $req表示相关的请求对象。
  • $data:可选参数,传递给回调函数的自定义数据。

返回值:返回一个请求资源,可以传递给eio_cancel()函数以取消该请求。

示例:


以上示例中,我们调用eio_truncate()函数异步地截断了指定路径的文件。如果截断成功,则在回调函数中得到的$result参数将为0,我们在回调函数中输出了相应的提示信息。如果截断失败,则$result参数将为负数,我们也在回调函数中输出了相应的提示信息。

同首字母函数