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.