Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła