rename

Ändert den Dateinamen einer Datei. Die Datei wird durch die Zeichenkette identifiziert, auf die old_filename zeigt. Der neue Dateiname wird durch die Zeichenkette identifiziert, auf die new_filename zeigt.

Wenn new_filename existiert, ist das Verhalten implementierungsdefiniert.

Parameter

Rückgabewert

​ 0 ​ bei Erfolg oder einen Wert ungleich Null bei Fehler.

Hinweise

POSIX spezifiziert viele zusätzliche Details zur Semantik dieser Funktion.

Beispiel

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* fp = fopen("from.txt", "w"); // Datei "from.txt" erstellen
    if (!fp)
    {
        perror("from.txt");
        return EXIT_FAILURE;
    }
    fputc('a', fp); // in "from.txt" schreiben
    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)); // aus "to.txt" lesen
    fclose(fp);
    return EXIT_SUCCESS;
}

a

Referenzen

Siehe auch