C++ 庫 - <filesystem>

C++ 中的<filesystem> 標頭檔案提供了一組用於執行檔案系統操作的函式，例如操作路徑、複製或刪除檔案以及檢查檔案狀態。

如果實現無法訪問分層檔案系統，或者它不提供必要的容量，則 <filesystem> 庫可能不可用。如果底層檔案系統（例如 FAT（檔案分配表））不支援某些功能，則這些功能可能不可用。

包含 <filesystem> 標頭檔案

要在 C++ 程式中包含 <filesystem> 標頭檔案，可以使用以下語法。

#include <filesystem>

<filesystem> 標頭檔案的函式

以下是 <filesystem> 標頭檔案中所有函式的列表。

路徑操作函式

這些路徑操作函式對檔案路徑進行操作，以組合、轉換或解析它們。

序號	函式和說明
1	absolute 此函式基於給定的相對路徑或絕對路徑組合絕對路徑。
2	canonical 和 weakly_canonical 這些函式透過解析所有符號連結和相對路徑將路徑轉換為規範形式。
3	relative, proximate 這些函式組合從一個路徑到另一個路徑的相對路徑。
4	copy 此函式複製檔案或目錄。
5	copy_file 此函式複製單個檔案的內容。
6	copy_symlink 此函式複製符號連結。
7	create_directory, create_directories 這些函式建立單個/多個新目錄。
8	create_hard_link 此函式建立一個硬連結，允許單個檔案具有多個目錄條目。
9	create_symlink, create_directory_symlink 這些函式為檔案建立一個符號連結。
10	current_path 此函式返回或設定當前工作目錄。
11	exists 此函式檢查路徑是否引用現有的檔案系統物件。
12	equivalent 此函式檢查兩個路徑是否引用同一個檔案系統物件。
13	file_size 此函式返回檔案的大小。
14	hard_link_count 此函式返回引用特定檔案的硬連結數。
15	last_write_time 此函式獲取或設定上次資料修改的時間。
16	permissions 此函式修改檔案訪問許可權。
17	read_symlink 此函式獲取符號連結的目標。
18	remove 此函式刪除檔案或空目錄。
19	remove_all 此函式刪除檔案或遞迴地刪除檔案或目錄及其所有內容。
20	rename 此函式移動或重新命名檔案或目錄。
21	resize_file 此函式透過截斷或零填充來更改常規檔案的大小。
22	space 此函式確定檔案系統上可用的可用空間。

路徑操作示例

在下面的示例中，我們將使用 exists() 檢查指定的路徑 (filePath) 是否引用現有的檔案系統物件。

#include <iostream>
#include <filesystem>
int main() {
    std::filesystem::path filePath{"example.txt"};

    if (std::filesystem::exists(filePath)) {
        std::cout << "The file exists." << std::endl;
    } else {
        std::cout << "The file does not exist." << std::endl;
    }
    return 0;
}

輸出

如果我們執行上面的程式碼，它將生成以下輸出：

The file does not exist.

檔案型別

<filesystem> 庫提供了一些函式來確定路徑指定的檔案或目錄的型別。這些函式用於瞭解檔案的特性並根據檔案型別實現邏輯。

序號	函式和說明
1	is_block_file 此函式檢查給定路徑是否引用塊裝置。
2	is_character_file 此函式檢查給定路徑是否引用字元裝置。
3	is_directory 此函式檢查給定路徑是否引用目錄。
4	is_empty 此函式檢查給定路徑是否引用空檔案或目錄。
5	is_fifo 此函式檢查給定路徑是否引用命名管道。
6	is_other 此函式檢查引數是否引用其他檔案。
7	is_regular_file 此函式檢查引數是否引用常規檔案。
8	is_socket 此函式檢查引數是否引用命名 IPC 套接字。
9	is_symlink 此函式檢查引數是否引用符號連結。
10	status_known 此函式檢查檔案狀態是否已知。

檢查指定的路徑

在下面的示例中，我們將使用 is_directory 檢查指定的路徑 (dirPath) 是否引用目錄。

#include <iostream>
#include <filesystem>
int main() {
    std::filesystem::path dirPath{"my_directory"};

    if (std::filesystem::is_directory(dirPath)) {
        std::cout << "This path refers to a directory." << std::endl;
    } else {
        std::cout << "This path does not refer to a directory." << std::endl;
    }
    return 0;
}

輸出

如果我們執行上面的程式碼，它將生成以下輸出：

This path does not refer to a directory.

列印頁面