C-Bibliotheksfunktionen -rename()

C-Standardbibliothek - <stdio.h>

rename() ist eine C-Standardbibliotheksfunktion, die zumUmbenennen von Datei oder Verzeichnisder Funktion verwendet wird.

rename() ist in der Header-Datei <stdio.h> definiert.

C-Bibliotheksfunktionenint rename(const char *old_filename, const char *new_filename)haltenold_filenameDer Name der Datei, auf die er zeigt, wird geändert zunew_filename。

Deklaration

Nachfolgend ist die Deklaration der Funktion rename() aufgeführt.

int rename(const char *old_filename, const char *new_filename)

Parameter

  • old_filename-- Der ursprüngliche Dateiname (wenn er einen Pfad enthält, muss der vollständige Pfad angegeben werden).
  • new_filename-- new_filename: der neue Dateiname (kann auch einen Pfad enthalten).

Rückgabewert

  • 0: Ausführung erfolgreich (Datei/Verzeichnis erfolgreich umbenannt).
  • Nicht null: Ausführungsfehler (häufige Fehlerursachen sind unzureichende Berechtigungen, Datei existiert nicht, Ziel existiert bereits usw.).

Hinweise zur Verwendung

Die Datei muss vorhanden sein; andernfalls wird ein Fehler zurückgegeben.

Wenn die Zieldatei new_filename bereits existiert, können unterschiedliche Systeme unterschiedlich damit umgehen:

  • Unter den meisten Unix/Linux-Systemen überschreibt rename() die Zieldatei direkt.
  • Unter Windows schlägt rename() fehl, wenn die Zieldatei existiert.

Ein Umbenennen über verschiedene Mount-Punkte (Partitionen/Geräte) hinweg ist nicht möglich.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der Funktion rename().

Beispiel

#include <stdio.h>

int main () {
   int ret;
   char oldname[] = "file.txt";
   char newname[] = "newfile.txt";
   
   ret = rename(oldname, newname);

   if(ret == 0)  {
      printf("File renamed successfully");
   } else   {
      printf("Error: cannot rename the file");
   }
   
   return(0);
}

Angenommen, wir haben eine Textdateifile.txt, deren Inhalt wie folgt lautet. Wir werden das obige Programm verwenden, um die Datei umzubenennen. Lassen Sie uns das obige Programm kompilieren und ausführen, was die folgende Meldung ausgibt, und die Datei wird umbenannt innewfile.txtDatei.

File renamed successfully.

C-Standardbibliothek - <stdio.h>

Weitere Erweiterungen