Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::filesystem::copy: copiar objetos do sistema de ficheiros

std::filesystem::copy copia ficheiro, link simbólico ou diretório conforme o tipo de origem e os bits copy_options, comunicando erros por exceção ou error_code.

Versão: C++23

Sintaxe

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> devolve void. O copy_options::none predefinido copia conteúdo de ficheiros normais, segue links simbólicos e, num diretório, copia ficheiros imediatos mas não subdiretórios aninhados; copy_options::recursive ativa a descida completa.

O exemplo cria um diretório de origem com a.txt, chama copy com recursive, lê a cópia e imprime 1 data. É uma operação real do sistema de ficheiros, por isso o código remove o seu diretório de teste privado antes e depois.

Pode definir-se no máximo um bit de cada grupo — destino existente, recursão, links e forma de cópia —; violar a pré-condição causa comportamento indefinido. skip_existing, overwrite_existing e update_existing tratam o destino de modo diferente, enquanto copy_symlinks e skip_symlinks alteram os links. Com create_symlinks, from tem de ser absoluto, exceto se to estiver no diretório atual. Se equivalent(from, to) for true, a função comunica um erro; não é o comportamento indefinido da pré-condição das opções. Sobrecargas sem error_code podem lançar filesystem_error; a forma com ec comunica aí erros do sistema.

Exemplos

#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

Fontes