CKTIS / C
rename — přejmenování souboru
Funkce rename z <stdio.h> mění název souboru. Při úspěchu vrací 0, při chybě nenulovou hodnotu.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) přijímá dva řetězce ukončené nulovým znakem: dosavadní název souboru a nový název. Po úspěšném provedení už soubor není dostupný pod svým původním názvem.
Pokud cílový soubor již existuje, chování závisí na implementaci: nepředpokládejte, že jeho nahrazení bude přenositelné. Při chybě si existující zdrojový soubor zachová svůj původní název.
Operace může selhat například tehdy, když je soubor otevřený nebo když přejmenování vyžaduje zkopírování jeho obsahu. Příklad soubor před přejmenováním zavře a výsledek kontroluje pomocí != 0, nikoli pomocí == -1.
Pří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ýsledek
Renamed and removed.
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.