readdir 函數是一種用于獲取目錄內容的工具函數，在遵循 POSIX 標準的操作系統（例如 Linux 和 macos）中廣泛使用。此函數的定義可以在 頭文件中找到。readdir 函數的參數如下所示：

Struct dirent *readdir(DIR *dirp);

• DIR *dirp：這代表一個指向 DIR 類型的指針，用于標識需要讀取的目錄流。在使用 readdir 之前，需要通過調用 opendir 函數開啟目錄，并得到一個有效的 DIR 指針。

readdir 函數本身并不直接返回結果狀態，而是通過返回值來傳遞信息。若執行成功，它會返回一個指向 struct dirent 結構體的指針，這個結構體包含了關于目錄中下一個條目的一些細節信息。當到達目錄結尾或者出現錯誤時，函數將返回 NULL。

struct dirent 結構體一般包括以下成員：

• long d_ino：這是文件的 inode 編號。
• off_t d_off：偏移量，用于下一次讀取操作。
• unsigned short d_reclen：d_name 字段的實際長度。
• char d_name[]：一個以 null 結尾的字符串形式的文件名稱。

需要注意的是，在多線程程序中使用 readdir 函數時，可能會遇到線程安全問題，因為多個線程可能同時對同一個目錄流進行操作。此時，應當采取適當的同步措施來防止潛在的競爭條件。