Namespaces
Variants

std:: remove

From cppreference.net
< cpp ‎ | io ‎ | c
Definido en el encabezado <cstdio>
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.

La biblioteca estándar también define una plantilla de función std::remove que toma un par de iteradores y un valor, esta sobrecarga es uno de los algoritmos estándar.

Ejemplo

#include <cstdio>
#include <cstdlib>
#include <fstream>
#include <iostream>
int main()
{
    // crear un archivo, verificar éxito usando operator! del objeto stream temporal
    if (!std::ofstream("file1.txt").put('a'))
    {
        std::perror("Error creating file1.txt");
        return EXIT_FAILURE;
    }
    std::cout << std::ifstream("file1.txt").rdbuf() << '\n'; // imprimir archivo
    std::remove("file1.txt"); // eliminar archivo
    if (!std::ifstream{"file1.txt"}) // usa operator! del objeto stream temporal
    {
        std::perror("Error opening deleted file");
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Salida posible:

a
Error opening deleted file: No such file or directory

Véase también

(C++17) (C++17)
elimina un archivo o directorio vacío
elimina un archivo o directorio y todo su contenido, recursivamente
(función)
renombra un archivo
(función)