Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

rename — rinominare un file

La funzione rename di <stdio.h> cambia il nome di un file. Restituisce 0 in caso di successo e un valore diverso da zero in caso di errore.

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

Sintassi

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

rename(old, new) accetta due stringhe terminate da un carattere nullo: il nome attuale del file e quello nuovo. Se l’operazione riesce, il file non è più accessibile con il nome precedente.

Se la destinazione esiste già, il comportamento è definito dall’implementazione: non dare per scontato che la sostituzione sia portabile. In caso di errore, un file sorgente esistente mantiene il nome originale.

L’operazione può fallire, per esempio, se il file è aperto o se rinominarlo richiede di copiarne il contenuto. L’esempio chiude il file prima di rinominarlo e verifica il risultato con != 0, non con == -1.

Esempi

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

Risultato

Renamed and removed.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti