WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

remove — eine Datei entfernen

Die Funktion remove aus <stdio.h> entfernt den Zugriff auf eine Datei unter dem angegebenen Namen. Bei Erfolg gibt sie null, bei einem Fehler einen Wert ungleich null zurück.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdio.h>
int remove(const char *filename);

Nach einem erfolgreichen Aufruf von remove(filename) ist die Datei unter dem in der Zeichenfolge filename angegebenen Namen nicht mehr zugänglich. Unter diesem Namen lässt sich später dennoch eine Datei öffnen, etwa wenn eine andere vorhandene Datei auf den frei gewordenen Namen umbenannt wurde.

Prüfe das Ergebnis durch Vergleich mit 0; gehe nicht davon aus, dass ein Fehler ausdrücklich -1 bedeutet. Das Verhalten bei einer geöffneten Datei ist implementierungsdefiniert. Schließe daher den Stream, bevor du die Datei entfernst.

Das Beispiel erstellt mit "wx" eine leere Datei, schließt sie und entfernt sie anschließend. Führe es in einem isolierten Testverzeichnis aus.

Beispiele

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *name = "cktis-remove-demo.tmp";
    FILE *file = fopen(name, "wx");
    if (file == NULL) {
        fputs("create failed\n", stderr);
        return EXIT_FAILURE;
    }
    if (fclose(file) != 0) {
        fputs("close failed\n", stderr);
        return EXIT_FAILURE;
    }
    if (remove(name) != 0) {
        fputs("remove failed\n", stderr);
        return EXIT_FAILURE;
    }
    puts("removed");
    return EXIT_SUCCESS;
}

Ergebnis

removed

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen