Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

rename — mudar o nome de um ficheiro

A função rename de <stdio.h> altera o nome de um ficheiro. Devolve 0 em caso de sucesso e um valor diferente de zero em caso de erro.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

rename(old, new) recebe duas cadeias terminadas em nulo: o nome atual do ficheiro e o novo nome. Em caso de sucesso, o ficheiro deixa de estar acessível pelo nome antigo.

Se o destino já existir, o comportamento é definido pela implementação: não partas do princípio de que a substituição é portável. Em caso de erro, um ficheiro de origem existente mantém o nome original.

A operação pode falhar, por exemplo, se o ficheiro estiver aberto ou se mudar o nome exigir a cópia do seu conteúdo. O exemplo fecha o ficheiro antes de lhe mudar o nome e testa o resultado com != 0, não com == -1.

Exemplos

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

Resultado

Renamed and removed.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes