Namespaces

• Page
• Discussion

Variants

Views

• View
• Edit
• History

Actions

• If!filesystem::is_regular_file(from) (either because the source file doesn't exist or because it is not a regular file), report an error.
• Otherwise, if the destination file does not exist,

• copies the contents and the attributes of the file to whichfrom resolves to the file to whichto resolves (symlinks are followed).

• Otherwise, if the destination file already exists,

• report an error if any of the following is true:

• to andfrom are the same as determined byfilesystem::equivalent(from, to);
• to is not a regular file as determined by!filesystem::is_regular_file(to);
• none of thefilesystem::copy_file control options are set inoptions.

• Otherwise, ifcopy_options::skip_existing is set inoptions, do nothing.
• Otherwise, ifcopy_options::overwrite_existing is set inoptions, copy the contents and the attributes of the file to whichfrom resolves to the file to whichto resolves.
• Otherwise, ifcopy_options::update_existing is set inoptions, only copy the file iffrom is newer thanto, as defined byfilesystem::last_write_time().

#include <filesystem>#include <fstream>#include <iostream>namespace fs= std::filesystem; int main(){    fs::create_directory("sandbox");std::ofstream("sandbox/file1.txt").put('a');     fs::copy_file("sandbox/file1.txt","sandbox/file2.txt"); // now there are two files in sandbox:std::cout<<"file1.txt holds: "<<std::ifstream("sandbox/file1.txt").rdbuf()<<'\n';std::cout<<"file2.txt holds: "<<std::ifstream("sandbox/file2.txt").rdbuf()<<'\n'; // fail to copy directory    fs::create_directory("sandbox/abc");try{        fs::copy_file("sandbox/abc","sandbox/def");}catch(fs::filesystem_error& e){std::cout<<"Could not copy sandbox/abc: "<< e.what()<<'\n';}    fs::remove_all("sandbox");}

Possible output:

file1.txt holds: afile2.txt holds: aCould not copy sandbox/abc: copy_file: Is a directory: "sandbox/abc", "sandbox/def"