# eio_fstat

(PECL eio >= 0.0.1dev)

eio_fstat — Get file status

### 说明

eio_fstat ( mixed `$fd` , int `$pri` , callable `$callback` [, mixed `$data` ] ) : resource

eio_fstat() returns file status information in `result` argument of `callback`

### 参数

`fd`

  Stream, Socket resource, or numeric file descriptor.

`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`

  Arbitrary variable passed to `callback`.

### 返回值

eio_busy() returns request resource on success or `FALSE` on error.

### 范例

Example #1 eio_lstat() example

    <?php
    // Create temporary file
    $tmp_filename = dirname(__FILE__) ."/eio-file.tmp";
    touch($tmp_filename);

    /* Is called when eio_fstat() done */
    function my_res_cb($data, $result) {
     // Should output array with stat info
     var_dump($result);

     if ($data['fd']) {
      // Close temporary file
      eio_close($data['fd']);
      eio_event_loop();
     }
     // Remove temporary file
     @unlink($data['file']);
    }

    /* Is called when eio_open() done */
    function my_open_cb($data, $result) {
     // Prepare data for callback
     $d = array(
      'fd'  => $result,
      'file'=> $data
     );
     // Request stat info
     eio_fstat($result, EIO_PRI_DEFAULT, "my_res_cb", $d);
     // Process request(s)
     eio_event_loop();
    }

    // Open temporary file
    eio_open($tmp_filename, EIO_O_RDONLY, NULL, EIO_PRI_DEFAULT,
      "my_open_cb", $tmp_filename);
    eio_event_loop();
    ?>

以上例程的输出类似于：

    array(12) {
     ["st_dev"]=>
      int(2050)
      ["st_ino"]=>
      int(2489159)
      ["st_mode"]=>
      int(33188)
      ["st_nlink"]=>
      int(1)
      ["st_uid"]=>
      int(1000)
      ["st_gid"]=>
      int(100)
      ["st_rdev"]=>
      int(0)
      ["st_blksize"]=>
      int(4096)
      ["st_blocks"]=>
      int(0)
      ["st_atime"]=>
      int(1318239506)
      ["st_mtime"]=>
      int(1318239506)
      ["st_ctime"]=>
      int(1318239506)
    }

### 参见

- eio_lstat
- eio_stat