Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje