名稱空間
變體
操作

std::experimental::filesystem::remove, std::experimental::filesystem::remove_all

來自 cppreference.com
< cpp‎ | experimental‎ | fs
 
 
實驗性
技術規範
檔案系統庫 (檔案系統 TS)
庫基礎 (庫基礎 TS)
庫基礎 2 (庫基礎 TS v2)
庫基礎 3 (庫基礎 TS v3)
並行性擴充套件 (並行性 TS)
並行性擴充套件 2 (並行性 TS v2)
併發性擴充套件 (併發性 TS)
併發擴充套件 2 (併發 TS v2)
概念 (概念 TS)
範圍 (範圍 TS)
反射 (反射 TS)
數學特殊函式 (特殊函式 TR)
實驗性非 TS
模式匹配
線性代數
std::execution
契約
2D 圖形
 
 
定義於標頭檔案 <experimental/filesystem>
bool remove( const path& p );
bool remove( const path& p, error_code& ec );
(1) (檔案系統 TS)
std::uintmax_t remove_all( const path& p );
std::uintmax_t remove_all( const path& p, error_code& ec );
(2) (檔案系統 TS)
1) 透過路徑 p 標識的檔案或空目錄被刪除,如同透過 POSIX remove 函式刪除。不追隨符號連結(刪除符號連結本身,而不是其目標)。
2) 刪除 p 的內容(如果它是一個目錄)及其所有子目錄的內容,遞迴進行,然後刪除 p 本身,如同透過重複應用 POSIX remove 函式刪除。不追隨符號連結(刪除符號連結本身,而不是其目標)。

目錄

[編輯] 引數

p - 要刪除的路徑
ec - 非丟擲過載中用於錯誤報告的出參

[編輯] 返回值

1) 如果檔案被刪除則返回 true,如果檔案不存在則返回 false。接受 error_code& 引數的過載在錯誤時返回 false
2) 返回被刪除的檔案和目錄的數量(如果 p 最初不存在,則可能為零)。接受 error_code& 引數的過載在錯誤時返回 static_cast<std::uintmax_t>(-1)

[編輯] 異常

不接受 error_code& 引數的過載在底層作業系統 API 錯誤時丟擲 filesystem_error,構造時將 p 作為第一個引數,作業系統錯誤碼作為錯誤碼引數。如果記憶體分配失敗,可能會丟擲 std::bad_alloc。接受 error_code& 引數的過載在作業系統 API 呼叫失敗時將其設定為作業系統 API 錯誤碼,並且在沒有錯誤發生時執行 ec.clear()。此過載具有
noexcept 規範:  
noexcept
  

[編輯] 注意

在 POSIX 系統上,此函式通常根據需要呼叫 `unlink` 和 `rmdir`,在 Windows 上呼叫 `RemoveDirectoryW` 和 `DeleteFileW`。

[編輯] 示例

#include <cstdint>
#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::filesystem;
 
int main()
{
    fs::path dir = fs::temp_directory_path();
    fs::create_directories(dir / "abcdef/example");
    std::uintmax_t n = fs::remove_all(dir / "abcdef");
    std::cout << "Deleted " << n << " files or directories\n";
}

可能的輸出

Deleted 2 files or directories

[編輯] 另請參閱

擦除檔案
(函式) [編輯]