PHP Manual
Prev |  | Next

# fstat

(PHP 4 , PHP 5)

fstat -- Gets information about a file using an open file pointer

## Description

array fstat ( resource handle)

Gathers the statistics of the file opened by the file pointer `handle`. This function is similar to the stat() function except that it operates on an open file pointer instead of a filename.

Returns an array with the statistics of the file; the format of the array is described in detail on the stat() manual page.

Example 1. fstat() example
`<?php // open a file $fp = fopen("/etc/passwd", "r"); // gather statistics $fstat = fstat($fp); // close the file fclose($fp); // print only the associative part print_r(array_slice($fstat, 13)); ?>`
this will output :
    Array
    (
        [dev] => 771
        [ino] => 488704
        [mode] => 33188
        [nlink] => 1
        [uid] => 0
        [gid] => 0
        [rdev] => 0
        [size] => 1114
        [atime] => 1061067181
        [mtime] => 1056136526
        [ctime] => 1056136526
        [blksize] => 4096
        [blocks] => 8
    )

> Note: The results of this function are cached. See clearstatcache() for more details.

> Note: This function will not work on remote files as the file to be examined must be accessible via the servers filesystem.

Prev | Home | Next
fseek | Up | ftell