CKTIS / C++
std::filesystem::copy: kopiowanie obiektów systemu plików
std::filesystem::copy kopiuje plik, dowiązanie albo katalog zgodnie z typem źródła i bitami copy_options, raportując błędy wyjątkiem lub error_code.
Wersja: C++23
Składnia
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) z <filesystem> zwraca void. Domyślne copy_options::none kopiuje zawartość zwykłego pliku, śledzi dowiązania symboliczne i dla katalogu kopiuje jego bezpośrednie pliki, ale nie zagnieżdżone podkatalogi; copy_options::recursive włącza pełne zejście.
Przykład tworzy katalog źródłowy z plikiem a.txt, wywołuje copy z recursive, odczytuje kopię i drukuje 1 data. To prawdziwa operacja systemu plików, dlatego kod usuwa swój katalog testowy przed i po użyciu.
Z każdej grupy opcji — istniejący cel, rekursja, dowiązania i forma kopii — wolno ustawić najwyżej jeden bit; naruszenie tego warunku wstępnego daje niezdefiniowane zachowanie. skip_existing, overwrite_existing i update_existing różnią obsługę celu, a copy_symlinks i skip_symlinks zmieniają dowiązania. Przy create_symlinks ścieżka from musi być bezwzględna, chyba że to leży w bieżącym katalogu. Gdy equivalent(from, to) jest true, funkcja raportuje błąd — nie jest to niezdefiniowane zachowanie z grup opcji. Przeciążenia bez error_code mogą rzucić filesystem_error; wariant z nim raportuje błędy systemu plików przez ec.
Przykłady
#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);
}
Wynik
1 data
std::filesystem::copy → 1 data