rename
Von cppreference.com
| Definiert in Header <stdio.h> |
||
| int umbenennen( const char* alter_dateiname, const char* neuer_dateiname ); |
||
Ändert den Dateinamen einer Datei. Die Datei wird durch die Zeichenkette identifiziert, auf die alter_dateiname zeigt. Der neue Dateiname wird durch die Zeichenkette identifiziert, auf die neuer_dateiname zeigt.
Wenn neuer_dateiname existiert, ist das Verhalten implementierungsabhängig.
Inhalt |
[bearbeiten] Parameter
| alter_dateiname | - | Zeiger auf eine nullterminierte Zeichenkette, die den Pfad zur umzubenennenden Datei enthält |
| neuer_dateiname | - | Zeiger auf eine nullterminierte Zeichenkette, die den neuen Pfad der Datei enthält |
[bearbeiten] Rückgabewert
0 bei Erfolg oder ein von Null verschiedener Wert bei einem Fehler.
[bearbeiten] Anmerkungen
POSIX legt viele zusätzliche Details zu den Semantiken dieser Funktion fest.
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <stdio.h> #include <stdlib.h> int main(void) { FILE* fp = fopen("from.txt", "w"); // create file "from.txt" if (!fp) { perror("from.txt"); return EXIT_FAILURE; } fputc('a', fp); // write to "from.txt" fclose(fp); int rc = rename("from.txt", "to.txt"); if (rc) { perror("rename"); return EXIT_FAILURE; } fp = fopen("to.txt", "r"); if(!fp) { perror("to.txt"); return EXIT_FAILURE; } printf("%c\n", fgetc(fp)); // read from "to.txt" fclose(fp); return EXIT_SUCCESS; }
Mögliche Ausgabe
a
[bearbeiten] Referenzen
- C23-Standard (ISO/IEC 9899:2024)
- 7.21.4.2 Die Funktion rename (p: TBD)
- C17-Standard (ISO/IEC 9899:2018)
- 7.21.4.2 Die Funktion rename (p: TBD)
- C11-Standard (ISO/IEC 9899:2011)
- 7.21.4.2 Die Funktion rename (p: 302-303)
- C99-Standard (ISO/IEC 9899:1999)
- 7.19.4.2 Die Funktion rename (p: 268-269)
- C89/C90-Standard (ISO/IEC 9899:1990)
- 4.9.4.2 Die Funktion rename
[bearbeiten] Siehe auch
| löscht eine Datei (Funktion) | |
| C++ Dokumentation für umbenennen
| |
