Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes