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