Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

rename — preimenovanje datoteke

Funkcija rename iz <stdio.h> mijenja naziv datoteke. Uspješno vraća 0, a u slučaju pogreške vrijednost različitu od nule.

Verzija: C23; repository compiler flag, production runtime not attested

Sintaksa

#include <stdio.h>
int rename(const char *old, const char *new);

rename(old, new) prima dva niza završena nul-znakom: postojeći naziv datoteke i novi naziv. Nakon uspješnog poziva datoteka više nije dostupna pod starim nazivom.

Ako odredište već postoji, ponašanje ovisi o implementaciji: nemojte pretpostaviti da je zamjena prenosiva. U slučaju pogreške postojeća izvorna datoteka zadržava svoj izvorni naziv.

Operacija može ne uspjeti, primjerice, ako je datoteka otvorena ili ako je za promjenu naziva potrebno kopirati njezin sadržaj. Primjer zatvara datoteku prije preimenovanja i provjerava rezultat pomoću != 0, a ne pomoću == -1.

Primjeri

#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;
}

Rezultat

Renamed and removed.

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori