fstat（由檔案描述詞取得檔案狀態），相關函式 stat，lstat，chmod，chown，readlink，utime。
基本介紹
- 中文名：fstat
- 定義：由檔案描述詞取得檔案狀態
- 相關函式：stat，lstat，chmod
- 返回值：執行成功則返回0
定義和用法,語法,說明,提示和注釋,例子,Linux fstat,定義,語法,
定義和用法
fstat（由檔案描述詞取得檔案狀態）
相關函式 stat，lstat，chmod，chown，readlink，utime
表頭檔案 #include<sys/stat.h>
#include<unistd.h>
定義函式 int fstat(int fildes,struct stat *buf);
函式說明 fstat()用來將參數fildes所指的檔案狀態，複製到參數buf所指的
結構中(struct stat)。Fstat()與stat()作用完全相同，不同處在
於傳入的參數為已打開的檔案描述詞。詳細內容請參考stat()。
返回值 執行成功則返回0，失敗返回-1，錯誤代碼存於errno。
語法
fstat(file) |
參數 | 描述 |
pipe | 必需。規定要檢查的打開檔案。 |
說明
獲取由檔案指針 handle 所打開檔案的統計信息。
該函式返回的數組具有該檔案的統計信息，該數組包含以下元素：
數字下標 | 關聯鍵名（自 PHP 4.0.6） | 說明 |
0 | dev | 設備名 |
1 | ino | 號碼 |
2 | mode | inode 保護模式 |
3 | nlink | 被連線數目 |
4 | uid | 所有者的用戶 id |
5 | gid | 所有者的組 id |
6 | rdev | 設備類型，如果是 inode 設備的話 |
7 | size | 檔案大小的位元組數 |
8 | atime | 上次訪問時間（Unix 時間戳） |
9 | mtime | 上次修改時間（Unix 時間戳） |
10 | ctime | 上次改變時間（Unix 時間戳） |
11 | blksize | 檔案系統 IO 的塊大小 |
12 | blocks | 所占據塊的數目 |
提示和注釋
提示：本函式與 stat() 函式相似，不同的是，它是作用於已打開的檔案指針而不是檔案名稱。
例子
<?php
$file = fopen("test.txt","r");
print_r(fstat($file));
fclose($file);
?>
輸出類似：
Array ( [0] => 0 [1] => 0 [2] => 33206 [3] => 1 [4] => 0 [5] => 0 [6] => 0 [7] => 92 [8] => 1141633430 [9] => 1141298003 [10] => 1138609592 [11] => -1 [12] => -1 [dev] => 0 [ino] => 0 [mode] => 33206 [nlink] => 1 [uid] => 0 [gid] => 0 [rdev] => 0 [size] => 92 [atime] => 1141633430 [mtime] => 1141298003 [ctime] => 1138609592 [blksize] => -1 [blocks] => -1 )
