Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::filesystem::copy: copiare oggetti del filesystem

std::filesystem::copy copia file, link simbolico o directory secondo il tipo sorgente e i bit copy_options, segnalando errori con eccezione o error_code.

Versione: C++23

Sintassi

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) di <filesystem> restituisce void. Il predefinito copy_options::none copia il contenuto dei file regolari, segue i link simbolici e, per una directory, copia i file immediati ma non le sottodirectory annidate; copy_options::recursive abilita la discesa completa.

L’esempio crea una directory sorgente con a.txt, chiama copy con recursive, legge la copia e stampa 1 data. È una vera operazione sul filesystem, quindi il codice elimina la propria directory di test privata prima e dopo.

Si può impostare al massimo un bit per gruppo — destinazione esistente, ricorsione, link e forma di copia —; violare la precondizione causa comportamento indefinito. skip_existing, overwrite_existing e update_existing trattano diversamente la destinazione, mentre copy_symlinks e skip_symlinks cambiano i link. Con create_symlinks, from deve essere assoluto salvo che to si trovi nella directory corrente. Se equivalent(from, to) è true, la funzione segnala un errore; non è il comportamento indefinito della precondizione sulle opzioni. Gli overload senza error_code possono lanciare filesystem_error; la forma con ec vi riporta gli errori del filesystem.

Esempi

#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);
}

Risultato

1 data

std::filesystem::copy → 1 data

Fonti