CKTIS / C
remove — usuwanie pliku
Funkcja remove z <stdio.h> usuwa dostęp do pliku pod wskazaną nazwą. Zwraca zero przy powodzeniu, a wartość niezerową przy błędzie.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdio.h>
int remove(const char *filename);Po udanym wywołaniu remove(filename) plik przestaje być dostępny pod nazwą wskazaną przez łańcuch filename. Późniejsze otwarcie pliku pod tą nazwą może się udać, na przykład jeśli nazwę innego istniejącego pliku zmieniono na tę, która się zwolniła.
Sprawdzaj wynik przez porównanie z 0; nie zakładaj, że błąd oznacza konkretnie -1. Dla otwartego pliku zachowanie jest zdefiniowane przez implementację — przed usunięciem zamknij strumień.
Przykład tworzy pusty plik za pomocą "wx", zamyka go i usuwa. Uruchamiaj go w odizolowanym katalogu testowym.
Przykłady
#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;
}Wynik
removed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.