std::experimental::filesystem:: resize_file
|
Definiert im Header
<experimental/filesystem>
|
||
|
void
resize_file
(
const
path
&
p,
std::
uintmax_t
new_size
)
;
void resize_file ( const path & p, std:: uintmax_t new_size, error_code & ec ) ; |
(Filesystem TS) | |
Ändert die Größe der regulären Datei, die durch p benannt ist, wie durch POSIX truncate : Wenn die vorherige Dateigröße größer als new_size war, wird der Rest der Datei verworfen. Wenn die Datei vorher kleiner als new_size war, wird die Dateigröße erhöht und der neue Bereich erscheint wie mit Nullen gefüllt.
Inhaltsverzeichnis |
Parameter
| p | - | Pfad der geändert werden soll |
| new_size | - | neue Größe der Datei |
| ec | - | Out-Parameter für Fehlerberichterstattung in der nicht-werfenden Überladung |
Rückgabewert
(keine)
Ausnahmen
The overload that does not take an error_code & parameter throws filesystem_error on underlying OS API errors, constructed with p as the first argument and the OS error code as the error code argument. std:: bad_alloc may be thrown if memory allocation fails. The overload taking an error_code & parameter sets it to the OS API error code if an OS API call fails, and executes ec. clear ( ) if no errors occur. This overload hasHinweise
Auf Systemen, die Sparse-Dateien unterstützen, erhöht eine Vergrößerung der Dateigröße nicht den belegten Speicherplatz im Dateisystem: Die Speicherplatz-Zuweisung erfolgt erst, wenn Nicht-Null-Bytes in die Datei geschrieben werden.
Beispiel
Demonstriert die Auswirkung der Erstellung einer Sparse-Datei auf den freien Speicherplatz.
#include <experimental/filesystem> #include <fstream> #include <iostream> namespace fs = std::experimental::filesystem; int main() { fs::path p = fs::temp_directory_path() / "example.bin"; std::ofstream(p).put('a'); std::cout << "File size: " << fs::file_size(p) << '\n' << "Free space: " << fs::space(p).free << '\n'; fs::resize_file(p, 64*1024); // resize to 64 KB std::cout << "File size: " << fs::file_size(p) << '\n' << "Free space: " << fs::space(p).free << '\n'; fs::remove(p); }
Mögliche Ausgabe:
File size: 1 Free space: 31805444096 File size: 65536 Free space: 31805444096
Siehe auch
|
gibt die Größe einer Datei zurück
(Funktion) |
|
|
ermittelt den verfügbaren freien Speicherplatz im Dateisystem
(Funktion) |