ubuntu readdir與readdir_r的區別

readdir 和 readdir_r 都是用于讀取目錄內容的函數，但它們之間存在一些關鍵區別：

readdir

1. 線程安全性：

• readdir 不是線程安全的。
• 在多線程環境中使用 readdir 可能會導致數據競爭和不一致的結果。

2. 返回值：

• 成功時，返回一個指向 struct dirent 的指針，該結構體包含了目錄項的信息。
• 失敗時，返回 NULL。

3. 使用方式：

• 需要手動管理目錄流的打開和關閉。
• 示例代碼：

  DIR *dir = opendir("/path/to/directory");
  if (dir == NULL) {
      perror("opendir");
      return 1;
  }
  
  struct dirent *entry;
  while ((entry = readdir(dir)) != NULL) {
      printf("%s\n", entry->d_name);
  }
  
  closedir(dir);
  

4. 全局狀態：

• readdir 使用全局變量來跟蹤當前讀取的位置，這可能導致在多線程環境中出現問題。

readdir_r

1. 線程安全性：

• readdir_r 是線程安全的版本。
• 它通過傳遞一個額外的參數（通常是緩沖區）來避免全局狀態的問題。

2. 返回值：

• 成功時，返回0，并通過輸出參數更新目錄項信息。
• 失敗時，返回非零錯誤碼。

3. 使用方式：

• 需要提供一個緩沖區來存儲目錄項信息。
• 示例代碼：

  DIR *dir = opendir("/path/to/directory");
  if (dir == NULL) {
      perror("opendir");
      return 1;
  }
  
  struct dirent buffer;
  struct dirent *entry;
  while ((entry = readdir_r(dir, &buffer, &entry)) == 0) {
      printf("%s\n", entry->d_name);
  }
  
  if (entry != NULL) {
      perror("readdir_r");
  }
  
  closedir(dir);
  

4. 局部狀態：

• readdir_r 使用局部變量來跟蹤當前讀取的位置，因此在多線程環境中更加安全。

總結

• 如果你在單線程環境中工作，或者能夠確保對目錄流的訪問是線程安全的，可以使用 readdir。
• 如果你在多線程環境中工作，或者希望代碼更加健壯和安全，建議使用 readdir_r。

需要注意的是，現代的 POSIX 標準已經推薦使用 readdir_r 的替代方案，如 readdir 的線程安全版本（在某些系統上可能不可用），或者使用更高級別的抽象，如 dirent.h 中的其他函數。