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