std::experimental::filesystem::file_size
來自 cppreference.com
< cpp | experimental | fs
定義於標頭檔案 <experimental/filesystem> |
||
std::uintmax_t file_size( const path& p ); std::uintmax_t file_size( const path& p, error_code& ec ); |
(1) | (filesystem TS) |
返回常規檔案 p 的大小,其確定方式如同透過讀取 POSIX stat 獲取的結構中的 st_size
成員(符號連結被跟蹤)。
試圖確定目錄(以及任何其他非常規檔案或符號連結的檔案)的大小被視為錯誤。
不丟擲異常的過載在錯誤時返回 -1。
目錄 |
[編輯] 引數
p | - | 要檢查的路徑 |
ec | - | 非丟擲過載中用於錯誤報告的出參 |
[編輯] 返回值
檔案大小,以位元組為單位。
[編輯] 異常
不接受 error_code& 引數的過載在底層 OS API 錯誤時丟擲 filesystem_error,該錯誤以 p 作為第一個引數,OS 錯誤碼作為錯誤碼引數構造。std::bad_alloc 可能在記憶體分配失敗時丟擲。接受 error_code& 引數的過載在 OS API 呼叫失敗時將其設定為 OS API 錯誤碼,並且在沒有錯誤發生時執行 ec.clear()。此過載具有noexcept 規範:
noexcept
[編輯] 示例
執行此程式碼
#include <experimental/filesystem> #include <fstream> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::path p = fs::current_path() / "example.bin"; std::ofstream(p).put('a'); // create file of size 1 std::cout << "File size = " << fs::file_size(p) << '\n'; fs::remove(p); try { fs::file_size("/dev"); // attempt to get size of a directory } catch (fs::filesystem_error& e) { std::cout << e.what() << '\n'; } }
可能的輸出
File size = 1 filesystem error: cannot get file size: Is a directory [/dev]
[編輯] 參閱
透過截斷或零填充更改常規檔案的大小 (函式) | |
確定檔案系統上可用的空閒空間 (函式) |