std::filesystem::resize_file
| ヘッダ <filesystem> で定義
|
||
| void resize_file(const std::filesystem::path& p, std::uintmax_t new_size); |
(C++17以上) | |
POSIX の truncate によって行われたかのように、 p によって表される普通のファイルのサイズを変更します。 以前のファイルサイズが new_size より大きい場合、ファイルの余りは捨てられます。 以前の���ァイルサイズが new_size より小さい場合、ファイルサイズは増加し、新しい領域がゼロで埋められたかのように現れます。
目次 |
[編集] 引数
| p | - | サイズ変更するパス |
| new_size | - | ファイルの新しいサイズ |
| ec | - | 例外を投げないオーバーロードでエラーを報告するための出力引数 |
[編集] 戻り値
(なし)
[編集] 例外
std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、第1パス引数に p、エラーコード引数に OS のエラーコードを指定して構築された filesystem_error を投げます。 std::error_code& 引数を取るオーバーロードは、 OS の API 呼び出しが失敗した場合、その引数を OS の API のエラーコードに設定し、エラーが発生しない場合は ec.clear() を実行します。 noexcept 指定のないあらゆるオーバーロードは、メモリ確保に失敗した場合 std::bad_alloc を投げる可能性があります。
[編集] ノート
スパースファイルをサポートするシステムでは、ファイルサイズの増加は、ファイルシステム上で占める領域を増加させません。 領域確保はファイルに非ゼロなバイトが書き込まれたときにのみ行われます。
[編集] 例
空き領域にスパースファイルを作成する効果をデモンストレーションします
#include <iostream> #include <iomanip> #include <fstream> #include <filesystem> namespace fs = std::filesystem; int main() { fs::path p = fs::current_path() / "example.bin"; std::ofstream(p).put('a'); std::cout << "File size: " << std::setw(10) << fs::file_size(p) << " Free space: " << fs::space(p).free << '\n'; fs::resize_file(p, 1024*1024*1024); // resize to 1 G std::cout << "File size: " << fs::file_size(p) << " Free space: " << fs::space(p).free << '\n'; fs::remove(p); }
出力例:
File size: 1 Free space: 3724541952 File size: 1073741824 Free space: 3724476416
[編集] 関連項目
| (C++17) |
ファイルのサイズを返します (関数) |
| (C++17) |
ファイルシステムの利用可能な空き容量を調べます (関数) |
