EIO_FSTAT(3) 1 EIO_FSTAT(3)
eio_fstat - Get file status
SYNOPSIS
resource eio_fstat (mixed $fd, int $pri, callable $callback, [mixed $data])
DESCRIPTION
eio_fstat(3) returns file status information in $result argument of $callback
PARAMETERS
o $fd
- Stream, Socket resource, or numeric file descriptor.
o $pri
-The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL. If NULL passed, $pri internally is set to
EIO_PRI_DEFAULT.
o $callback
-$callback function is called when the request is done. It should match the following prototype:
void callback(mixed $data, int $result[, resource $req]);
o $data
-is custom data passed to the request.
o $result
-request-specific result value; basically, the value returned by corresponding system call.
o $req
-is optional request resource which can be used with functions like eio_get_last_error(3)
o $data
- Arbitrary variable passed to $callback.
RETURN VALUES
eio_busy(3) returns request resource on success or FALSE on error.
EXAMPLES
Example #1
eio_lstat(3) 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();
?>
The above example will output something similar to:
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)
}
SEE ALSO eio_lstat, eio_stat.
PHP Documentation Group EIO_FSTAT(3)