std::rename
Von cppreference.com
| Definiert in Header <cstdio> |
||
| int rename( const char* old_filename, const char* new_filename ); |
||
Ändert den Dateinamen einer Datei. Die Datei wird durch den von old_filename gezeigten Zeichenkettenzeiger identifiziert. Der neue Dateiname wird durch den von new_filename gezeigten Zeichenkettenzeiger identifiziert.
Wenn new_filename existiert, ist das Verhalten implementierungsabhängig.
Inhalt |
[bearbeiten] Parameter
| old_filename | - | Zeiger auf eine null-terminierte Zeichenkette, die den Pfad zur umzubenennenden Datei enthält |
| new_filename | - | Zeiger auf eine null-terminierte Zeichenkette, die den neuen Pfad der Datei enthält |
[bearbeiten] Rückgabewert
0 bei Erfolg oder ein Wert ungleich Null bei einem Fehler.
[bearbeiten] Hinweise
POSIX spezifiziert viele zusätzliche Details zu den Semantiken dieser Funktion, die in C++ durch std::filesystem::rename übernommen werden.
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <cstdio> #include <cstdlib> #include <fstream> #include <iostream> int main() { if (!std::ofstream("from.txt").put('a')) // create and write to file { std::perror("Error creating from.txt"); return EXIT_FAILURE; } if (std::rename("from.txt", "to.txt")) { std::perror("Error renaming"); return EXIT_FAILURE; } std::cout << std::ifstream("to.txt").rdbuf() << '\n'; // print file return EXIT_SUCCESS; }
Ausgabe
a
[bearbeiten] Siehe auch
| (C++17) |
verschiebt oder benennt eine Datei oder ein Verzeichnis um (Funktion) |
| löscht eine Datei (function) | |
| C-Dokumentation für rename
| |
