Linux readdir函數如何使用

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;
}

注意事項

1. 錯誤處理: 在使用 readdir 時，應該檢查返回值是否為 NULL，以確定是否到達目錄末尾或發生了錯誤。
2. 內存管理: readdir 返回的 struct dirent 結構是由內核分配的，不需要手動釋放內存。
3. 線程安全: readdir 不是線程安全的函數。如果在多線程環境中使用，需要適當的同步機制。

通過這些基本的使用方法和注意事項，你可以有效地使用 readdir 函數來讀取和處理目錄內容。