Espacios de nombres
Variantes

    std::filesystem::remove, std::filesystem::remove_all

    De cppreference.com
     
    C++
    Apoyo de compiladores
    Implementaciones independientes y albergadas
    Lenguaje
    Biblioteca estándar
    Encabezados de la biblioteca estándar
    Requisitos denominados
    Macros de prueba de característica (C++20)
    Biblioteca de apoyo del lenguaje
    Biblioteca de conceptos (C++20)
    Biblioteca de diagnósticos
    Biblioteca de gestión de memoria
    Biblioteca de metaprogramación (C++11)
    Biblioteca de servicios generales
    Biblioteca de contenedores
    Biblioteca de iteradores
    Biblioteca de rangos (C++20)
    Biblioteca de algoritmos
    Biblioteca de cadenas
    Biblioteca de procesamiento de texto
    Biblioteca numérica
    Biblioteca de fecha y hora
    Biblioteca de entrada/salida
    Biblioteca del sistema de archivos (C++17)
    Biblioteca de apoyo de concurrencia (C++11)
    Biblioteca de apoyo de ejecución (C++26)
    Especificaciones técnicas
    Índice de símbolos
    Bibliotecas externas
     
    Biblioteca del sistema de archivos
    Clases
    Funciones
    Tipos de archivo
     
    <tbody> </tbody>
    Definido en el archivo de encabezado <filesystem>
    bool remove( const std::filesystem::path& p ); bool remove( const std::filesystem::path& p, std::error_code& ec ) noexcept;
    		 (1) (desde C++17)
    std::uintmax_t remove_all( const std::filesystem::path& p ); std::uintmax_t remove_all( const std::filesystem::path& p, std::error_code& ec );
    		 (2) (desde C++17)
    1) Se borra el archivo o el directorio vacío identificado por la ruta de acceso p como si fuera por la función remove de POSIX. No se siguen los enlaces simbólicos (se elimina el enlace simbólico, pero no su objetivo).
    2) Borra el contenido de p (si es un directorio) y el contenido de todos sus subdirectorios recursivamente, luego borra a p mismo como si se aplicara repetidamente la función remove de POSIX. No se siguen los enlaces simbólicos (se elimina el enlace simbólico, pero no su objetivo).

    Parámetros

    p - La ruta de acceso a borrar.
    ec - El parámetro de salida para informe de errores en la sobrecarga que no lanza excepciones.

    Valor de retorno

    1) true si se borró el archivo, false si no existía. La sobrecarga que toma un argumento error_code& devuelve false si ocurren errores.
    2) Devuelve el número de archivos y directorios que se borraron (que puede ser cero si, para empezar, p no existía). La sobrecarga que toma un argumento error_code& devuelve static_cast<std::uintmax_t>(-1) si ocurren errores.

    Excepciones

    See More

    La sobrecarga que no toma un parámetro std::error_code& lanza filesystem::filesystem_error en los errores de la API del sistema operativo subyacente, construido con p como el primer argumento de la ruta de acceso y el código de error del sistema operativo como el argumento del código de error. La sobrecarga que toma un parámetro std::error_code& lo establece en el código de error de la API del sistema operativo si una llamada a la API del sistema operativo falla, y ejecuta ec.clear() si no ocurren errores. Cualquier sobrecarga que no está marcada con noexcept puede lanzar std::bad_alloc si la asignación de memoria falla.

    Notas

    En los sistemas POSIX, esta función generalmente llama a unlink y rmdir a medida que sea necesario, y en Windows, a RemoveDirectoryW y DeleteFileW.

    Ejemplo

    Ejecuta este código
    #include <iostream>
#include <cstdint>
#include <filesystem>
namespace fs = std::filesystem;
int main()
{
    fs::path tmp = fs::temp_directory_path();
    fs::create_directories(tmp / "abcdef/ejemplo");
    std::uintmax_t n = fs::remove_all(tmp / "abcdef");
    std::cout << "Se borraron " << n << " archivos o directorios\n";
}

    Posible salida: 

    Se borraron 2 archivos o directorios

    Informes de defectos

    Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

    ID Aplicado a Comportamiento según lo publicado Comportamiento correcto
    LWG 3014 C++17 La sobrecarga con error_code de remove_all está marcada con noexcept pero puede asignar memoria. Se eliminó noexcept.

    Véase también
    borra un archivo
    Original:
    erases a file
    The text has been machine-translated via Google Translate.
    You can help to correct and verify the translation. Click here for instructions.

    (función) [editar]