CKTIS / C
rename — premenovanie súboru
Funkcia rename z <stdio.h> mení názov súboru. Pri úspechu vracia 0 a pri chybe nenulovú hodnotu.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) prijíma dva reťazce ukončené nulovým znakom: doterajší názov súboru a nový názov. Po úspešnom vykonaní už súbor nie je dostupný pod svojím pôvodným názvom.
Ak cieľový súbor už existuje, správanie závisí od implementácie: nepredpokladajte, že jeho nahradenie bude prenositeľné. Pri chybe si existujúci zdrojový súbor zachová svoj pôvodný názov.
Operácia môže zlyhať napríklad vtedy, keď je súbor otvorený alebo keď premenovanie vyžaduje skopírovanie jeho obsahu. Príklad súbor pred premenovaním zatvorí a výsledok kontroluje pomocou != 0, nie pomocou == -1.
Príklady
#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;
}Výsledok
Renamed and removed.
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.