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

CKTIS / C++

std::filesystem::copy: copiar objetos del sistema de archivos

std::filesystem::copy copia un archivo, enlace simbólico o directorio según el tipo de origen y los bits copy_options, informando errores mediante excepción o error_code.

Versión: C++23

Sintaxis

void std::filesystem::copy(
    const std::filesystem::path& from,
    const std::filesystem::path& to,
    std::filesystem::copy_options options);

void std::filesystem::copy(
    const std::filesystem::path& from,
    const std::filesystem::path& to,
    std::filesystem::copy_options options, std::error_code& ec);

std::filesystem::copy(from, to, options) de <filesystem> devuelve void. El copy_options::none predeterminado copia contenido de archivos normales, sigue enlaces simbólicos y, para un directorio, copia sus archivos inmediatos pero no subdirectorios anidados; copy_options::recursive activa el descenso completo.

El ejemplo crea un directorio origen con a.txt, llama a copy con recursive, lee la copia e imprime 1 data. Es una operación real del sistema de archivos, por lo que el código elimina su directorio de prueba privado antes y después.

Solo puede fijarse un bit de cada grupo — destino existente, recursión, enlaces y forma de copia —; incumplir esta precondición causa comportamiento indefinido. skip_existing, overwrite_existing y update_existing tratan distinto el destino, mientras copy_symlinks y skip_symlinks cambian los enlaces. Con create_symlinks, from debe ser absoluto salvo que to esté en el directorio actual. Si equivalent(from, to) es true, la función informa un error; no es el comportamiento indefinido de la precondición de opciones. Las sobrecargas sin error_code pueden lanzar filesystem_error; la forma con ec informa allí los errores del sistema.

Ejemplos

#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>

int main() {
    namespace fs = std::filesystem;
    const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-copy";
    const fs::path source = root / "source";
    const fs::path target = root / "target";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directories(source);
    std::ofstream(source / "a.txt") << "data";

    fs::copy(source, target, fs::copy_options::recursive);
    std::ifstream input(target / "a.txt");
    std::string text;
    input >> text;
    std::cout << fs::exists(target / "a.txt") << ' ' << text << '\n';
    fs::remove_all(root, ignored);
}

Resultado

1 data

std::filesystem::copy → 1 data

Fuentes