readdir
函數是 Linux 系統中用于讀取目錄內容的函數,它定義在 <dirent.h>
頭文件中。readdir
函數用于遍歷目錄中的每個條目(文件或子目錄)。
#include <dirent.h>
struct dirent *readdir(DIR *dirp);
DIR *dirp
: 指向一個已打開的目錄流的指針。通常通過 opendir
函數打開一個目錄并返回一個 DIR
指針。struct dirent
結構的指針,該結構包含目錄條目的信息。NULL
。struct dirent
結構struct dirent
結構通常包含以下字段:
ino_t d_ino
: 目錄條目的 inode 號。off_t d_off
: 條目在目錄文件中的偏移量。unsigned short d_reclen
: 條目的長度。char d_type
: 條目的類型(例如,DT_REG 表示常規文件,DT_DIR 表示目錄)。char d_name[]
: 條目的名稱。下面是一個簡單的示例,演示如何使用 readdir
函數遍歷當前目錄中的所有文件和子目錄:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
int main() {
DIR *dir;
struct dirent *entry;
// 打開當前目錄
dir = opendir(".");
if (dir == NULL) {
perror("opendir");
return EXIT_FAILURE;
}
// 遍歷目錄中的每個條目
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
// 關閉目錄
closedir(dir);
return EXIT_SUCCESS;
}
readdir
時,應該檢查返回值是否為 NULL
,以確定是否到達目錄末尾或發生了錯誤。readdir
返回的 struct dirent
結構是由內核分配的,不需要手動釋放內存。readdir
不是線程安全的函數。如果在多線程環境中使用,需要適當的同步機制。通過這些基本的使用方法和注意事項,你可以有效地使用 readdir
函數來讀取和處理目錄內容。