CKTIS / C
rename — cambiar el nombre de un archivo
La función rename de <stdio.h> cambia el nombre de un archivo. Devuelve 0 si la operación tiene éxito y un valor distinto de cero si falla.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) recibe dos cadenas terminadas en nulo: el nombre actual del archivo y el nuevo. Si la operación tiene éxito, el archivo deja de estar disponible con su nombre anterior.
Si el destino ya existe, el comportamiento está definido por la implementación: no des por sentado que se reemplazará de forma portable. Si falla, un archivo de origen existente conserva su nombre original.
La operación puede fallar, por ejemplo, si el archivo está abierto o si cambiarle el nombre requiere copiar su contenido. El ejemplo cierra el archivo antes de cambiarle el nombre y comprueba el resultado con != 0, no con == -1.
Ejemplos
#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.
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.