Namespaces
Variants

remove

From cppreference.net
< c ‎ | io
Definido en el encabezado <stdio.h>
int remove ( const char * pathname ) ;

Elimina el archivo identificado por la cadena de caracteres apuntada por pathname .

Si el archivo está actualmente abierto por cualquier proceso, el comportamiento de esta función está definido por la implementación. Los sistemas POSIX desvinculan el nombre del archivo (entrada de directorio), pero el espacio del sistema de archivos utilizado por el archivo no se recupera mientras esté abierto en cualquier proceso y mientras existan otros enlaces físicos al archivo. Windows no permite eliminar el archivo en tales casos.

Contenidos

Parámetros

pathname - puntero a una cadena terminada en nulo que contiene la ruta que identifica el archivo a eliminar

Valor de retorno

0 en caso de éxito o valor distinto de cero en caso de error.

Notas

POSIX especifica muchos detalles adicionales para el comportamiento de esta función.

Ejemplo

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* fp = fopen("file1.txt", "w"); // crear archivo
    if (!fp)
    {
        perror("file1.txt");
        return EXIT_FAILURE;
    }
    puts("Created file1.txt");
    fclose(fp);
    int rc = remove("file1.txt");
    if (rc)
    {
        perror("remove");
        return EXIT_FAILURE;
    }
    puts("Removed file1.txt");
    fp = fopen("file1.txt", "r"); // Fallo: el archivo no existe
    if (!fp)
        perror("Opening removed file failed");
    rc = remove("file1.txt"); // Fallo: el archivo no existe
    if (rc)
        perror("Double-remove failed");
    return EXIT_SUCCESS;
}

Salida posible:

Created file1.txt
Removed file1.txt
Opening removed file failed: No such file or directory
Double-remove failed: No such file or directory

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.21.4.1 La función remove (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.21.4.1 La función remove (p: TBD)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.21.4.1 La función remove (p: 302)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.19.4.1 La función remove (p: 268)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 4.9.4.1 La función remove

Véase también

renombra un archivo
(función)