Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::filesystem::copy : copier des objets du système de fichiers

std::filesystem::copy copie fichier, lien symbolique ou répertoire selon le type source et les bits copy_options, avec erreur par exception ou error_code.

Version : C++23

Syntaxe

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> renvoie void. Par défaut, copy_options::none copie le contenu des fichiers ordinaires, suit les liens symboliques et, pour un répertoire, copie ses fichiers immédiats mais pas les sous-répertoires imbriqués ; copy_options::recursive active la descente complète.

L’exemple crée un répertoire source avec a.txt, appelle copy avec recursive, lit la copie et affiche 1 data. Il s’agit d’une vraie opération du système de fichiers ; le code supprime donc son répertoire de test privé avant et après.

Au plus un bit de chaque groupe — cible existante, récursion, liens et forme de copie — peut être fixé ; violer cette précondition donne un comportement indéfini. skip_existing, overwrite_existing et update_existing traitent différemment la cible, tandis que copy_symlinks et skip_symlinks changent les liens. Avec create_symlinks, from doit être absolu sauf si to se trouve dans le répertoire courant. Si equivalent(from, to) vaut true, la fonction signale une erreur ; ce n’est pas le comportement indéfini de la précondition sur les options. Les surcharges sans error_code peuvent lever filesystem_error ; la forme ec y rapporte les erreurs du système.

Exemples

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

Résultat

1 data

std::filesystem::copy → 1 data

Sources