CKTIS / C
rename — een bestand hernoemen
De functie rename uit <stdio.h> verandert de naam van een bestand. Bij succes retourneert de functie 0 en bij een fout een waarde die niet nul is.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) neemt twee null-terminated tekenreeksen aan: de huidige naam van het bestand en de nieuwe naam. Na een geslaagde aanroep is het bestand niet meer onder de oude naam toegankelijk.
Als het doel al bestaat, is het gedrag implementatiegedefinieerd: ga er niet van uit dat het bestand op een overdraagbare manier wordt vervangen. Bij een fout behoudt een bestaand bronbestand zijn oorspronkelijke naam.
De bewerking kan bijvoorbeeld mislukken als het bestand geopend is of als het hernoemen vereist dat de inhoud wordt gekopieerd. Het voorbeeld sluit het bestand voordat het de naam wijzigt en controleert het resultaat met != 0, niet met == -1.
Voorbeelden
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
/* Run in a private directory where no other process changes these names. */
FILE *file = fopen("rename-before.txt", "wx");
if (file == NULL) {
return EXIT_FAILURE;
}
if (fclose(file) != 0) {
return EXIT_FAILURE;
}
/* Reserve the destination without opening or truncating an existing file. */
FILE *destination = fopen("rename-after.txt", "wx");
if (destination == NULL) {
return EXIT_FAILURE;
}
if (fclose(destination) != 0) {
remove("rename-after.txt");
return EXIT_FAILURE;
}
/* Some implementations do not allow rename to replace the placeholder. */
if (rename("rename-before.txt", "rename-after.txt") != 0) {
remove("rename-after.txt");
return EXIT_FAILURE;
}
if (remove("rename-after.txt") != 0) {
return EXIT_FAILURE;
}
puts("Renamed and removed.");
return EXIT_SUCCESS;
}Resultaat
Renamed and 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.