CKTIS / C
remove — een bestand verwijderen
De functie remove uit <stdio.h> maakt een bestand ontoegankelijk onder de opgegeven naam. De functie retourneert nul bij succes en een waarde ongelijk aan nul bij een fout.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int remove(const char *filename);Na een geslaagde aanroep van remove(filename) is het bestand niet meer toegankelijk onder de naam die in de tekenreeks filename staat. Later kan het openen van een bestand onder die naam alsnog lukken, bijvoorbeeld als een ander bestaand bestand de vrijgekomen naam heeft gekregen.
Controleer het resultaat door het met 0 te vergelijken; ga er niet van uit dat een fout specifiek -1 betekent. Het gedrag voor een geopend bestand is implementatiegedefinieerd. Sluit daarom de stream voordat je het bestand verwijdert.
Het voorbeeld maakt met "wx" een leeg bestand aan, sluit het en verwijdert het. Voer het uit in een geïsoleerde testmap.
Voorbeelden
#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;
}Resultaat
removed
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.