函數說明:
int ftw(const char *dirpath,
int (*fn) (const char *fpath, const struct stat *sb, int typeflag), int depth);
ftw() 會從參數dirpath指定的目錄開始,往下一層層地遞迴式遍曆子目錄。ftw()會傳三個參數給fn(), 第一個參數*fpath指向當時所在的目錄路徑,第二個參數是*sb, 為stat結構指標,第三個參數為flag,有下面幾種可能值
FTW_F 一般檔案
FTW_D 目錄
FTW_DNR 不可讀取的目錄,此目錄以下將不被遍曆
FTW_SL 符號串連
FTW_NS 無法取得stat結構資料,有可能是許可權問題
最後一個參數depth代表ftw()在進行遍曆目錄時同時開啟的檔案數。ftw()在遍曆時每一層目錄至少需要一個檔案描述詞,如果遍曆時用完了depth所給予的限制數目,整個遍曆將因不斷地關檔案和開檔案操作而顯得緩慢。
如果要結束ftw()的遍曆,fn()只需返回一非零值即可,此值同時也會是ftw()的傳回值。否則ftw()會試著走完所有的目錄,然後返回0
下面以一個簡單的程式進行說明:
#include <ftw.h>#include <stdio.h>#include <sys/stat.h>#include <unistd.h>int fn(const char *fpath, const struct stat *sb, int typeflag);int main(){int temp = ftw("/root/leeboy", fn, 500); //當返回為0時,表示遍曆完成printf("%d\n", temp);return 0;}int fn(const char *fpath, const struct stat *sb, int typeflag){//查看檔案是何類型並輸出檔案裝置編號if(typeflag == FTW_F){printf("標準檔案:\n");printf("dev:%d\n", sb->st_dev);}else if(typeflag == FTW_D){printf("檔案夾路徑\n");printf("dev:%d\n", sb->st_dev);} printf("%s\n", fpath);return 0; //此處如返回不為0的數,程式會終止返回,主程式ftw因此返回,並且傳回值相同}
程式運行結果:
遍曆完成後返回。
修改傳回值的情況:
只遍曆一層即返回,並且傳回值與fn傳回值相同。