std::experimental::filesystem:: copy_file

• 宛先ファイルが存在しない場合、

• from が解決するファイルの内容と属性を、 to が解決するファイルへコピーします（シンボリックリンクは追従されます）。

• それ以外の場合、宛先ファイルが既に存在する場合：

• to と from が equivalent(from, to) によって同一と判定された場合、エラーを報告する。
• それ以外の場合、 options にcopy_file制御オプションが一つも設定されていない場合、エラーを報告する。
• それ以外の場合、 options に copy_options::skip_existing が設定されている場合、何も行わない。
• それ以外の場合、 options に copy_options::overwrite_existing が設定されている場合、 from が解決するファイルの内容と属性を to が解決するファイルにコピーする。
• それ以外の場合、 options に copy_options::update_existing が設定されている場合、 last_write_time() で定義される from が to より新しい場合にのみファイルをコピーする。

例外を送出しないオーバーロードは、 エラーが発生した場合に false を返します。

パラメータ

戻り値

true ファイルがコピーされた場合、 false それ以外の場合。

例外

注記

これらの関数は、最大でも1回の直接または間接的な status(to) 呼び出しを含みます（ファイルの存在確認と、 copy_options::update_existing オプションの場合には最終更新時刻の確認の両方に使用されます）。

ディレクトリのコピーに copy_file を使用するとエラーが報告されます：その場合は copy を使用してください。

copy_file はシンボリックリンクを追従します：その場合は copy_symlink または copy を copy_options::copy_symlinks オプションで使用してください。

例

#include <experimental/filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
{
    fs::create_directory("sandbox");
    std::ofstream("sandbox/file1.txt").put('a');
    fs::copy_file("sandbox/file1.txt", "sandbox/file2.txt");
    // 現在、sandboxには2つのファイルが存在します:
    std::cout << "file1.txt holds : "
              << std::ifstream("sandbox/file1.txt").rdbuf() << '\n';
    std::cout << "file2.txt holds : "
              << std::ifstream("sandbox/file2.txt").rdbuf() << '\n';
    // ディレクトリのコピーに失敗
    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");
}

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

関連項目