std::filesystem::copy_file

Las sobrecargas que no lanzan excepciones devuelven false si ocurre un error.

[editar] Parámetros

[editar] Valor de retorno

true si se copió el archivo, false de lo contrario.

[editar] Excepciones

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 from como el primer argumento de la ruta de acceso, to como el segundo 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.

[editar] Notas

Las funciones involucran a lo sumo una llamada directa o indirecta a filesystem::status(to) (utilizada tanto para determinar si el archivo existe, como para la opción filesystem::copy_options::update_existing, su último tiempo de escritura).

Se informa de un error cuando filesystem::copy_file se utiliza para copiar un directorio: utiliza filesystem::copy para eso.

filesystem::copy_file sigue los enlaces simbólicos: utiliza filesystem::copy_symlink o filesystem::copy con filesystem::copy_options::copy_symlinks para eso.

[editar] Ejemplos

#include <fstream>
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
 
int main()
{
    fs::create_directory("entorno_aislado");
    std::ofstream("entorno_aislado/archivo1.txt").put('a');
 
    fs::copy_file("entorno_aislado/archivo1.txt", "entorno_aislado/archivo2.txt");
 
    // ahora hay dos archivos en entorno_aislado:
    std::cout << "archivo1.txt alberga : "
              << std::ifstream("entorno_aislado/archivo1.txt").rdbuf() << '\n';
    std::cout << "archivo2.txt alberga : "
              << std::ifstream("entorno_aislado/archivo2.txt").rdbuf() << '\n';
 
    // fracasa al copiar el directorio
    fs::create_directory("entorno_aislado/abc");
    try {
        fs::copy_file("entorno_aislado/abc", "entorno_aislado/def");
    } catch(fs::filesystem_error& e) {
        std::cout << "No se pudo copiar entorno_aislado/abc: " << e.what() << '\n';
    }
    fs::remove_all("entorno_aislado");
}

archivo1.txt alberga : a
archivo2.txt alberga : a
No se pudo copiar entorno_aislado/abc: copy_file: Es un directorio: "entorno_aislado/abc", "entorno_aislado/def"

[editar] 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.

[editar] Véase también