Linux readdir函數詳解

readdir 函數是 Linux 系統中用于讀取目錄內容的函數，它定義在 <dirent.h> 頭文件中。這個函數允許程序遍歷一個目錄中的所有條目（文件和子目錄）。

函數原型

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

參數

• DIR *dirp：指向一個已經打開的目錄流的指針。這個目錄流是通過 opendir 函數打開的。

返回值

• 成功時，readdir 返回一個指向 struct dirent 結構的指針，該結構包含了目錄中的一個條目的信息。
• 如果到達目錄的末尾，返回 NULL。
• 如果發生錯誤，也返回 NULL，并且可以通過 errno 來確定具體的錯誤原因。

struct dirent 結構

struct dirent 結構通常包含以下成員：

• long d_ino：目錄項的 inode 號。
• off_t d_off：目錄項在目錄文件中的偏移量。
• unsigned short d_reclen：目錄項的長度。
• char d_name[]：目錄項的名稱，以 null 字符結尾。

使用示例

下面是一個簡單的示例，展示如何使用 readdir 函數來遍歷一個目錄：

#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <errno.h>

int main(int argc, char *argv[]) {
    DIR *dir;
    struct dirent *entry;

    if (argc != 2) {
        fprintf(stderr, "Usage: %s <directory>
", argv[0]);
        return EXIT_FAILURE;
    }

    dir = opendir(argv[1]);
    if (dir == NULL) {
        perror("opendir");
        return EXIT_FAILURE;
    }

    while ((entry = readdir(dir)) != NULL) {
        printf("%s
", entry->d_name);
    }

    if (closedir(dir) == -1) {
        perror("closedir");
        return EXIT_FAILURE;
    }

    return EXIT_SUCCESS;
}

在這個示例中，程序接受一個命令行參數作為目錄路徑，然后打開該目錄并遍歷其中的所有條目，打印出每個條目的名稱。最后，它關閉目錄流。

注意事項

• readdir 返回的 struct dirent 結構中的 d_name 字段是一個以 null 結尾的字符串，它包含了目錄項的名稱。
• readdir 函數并不保證返回的目錄項順序，除非目錄是以某種特定方式組織的（例如，按名稱排序）。
• 在使用 readdir 時，應該注意檢查返回值是否為 NULL，并且區分是到達目錄末尾還是發生了錯誤。

這個函數是 POSIX 標準的一部分，因此在大多數 Unix-like 系統上都可以使用。