op_assign.md

operator=

• filesystem[meta header]
• std::filesystem[meta namespace]
• directory_iterator[meta class]
• function[meta id-type]
• cpp17[meta cpp]

directory_iterator& operator=(const directory_iterator& rhs);     // (1)
directory_iterator& operator=(directory_iterator&& rhs) noexcept; // (2)

概要

• (1) : コピー代入演算子
• (2) : ムーブ代入演算子

効果

rhsと*thisが同じオブジェクトである場合はなにもしない

• (1) : rhsが保持するデータを*thisにコピーする
• (2) : rhsが保持するデータを*thisにムーブする

戻り値

*this

備考

未規定だが、GCC 8.2およびClang 7.0環境では、この代入演算子はコピー元とコピー先で所有権を共有する。そのため、コピー・ムーブに関わらず、代入元のイテレータは代入後に再構築以外の操作をしてはならない

例

#include <iostream>
#include <filesystem>
#include <fstream>

namespace fs = std::filesystem;

int main()
{
  fs::create_directory("dir");
  std::ofstream{"dir/a.txt"};
  std::ofstream{"dir/b.txt"};

  fs::directory_iterator it1{"dir"};
  fs::directory_iterator it2;

  it2 = it1;

  std::cout << it2->path() << std::endl;
  ++it2;
  std::cout << it2->path() << std::endl;
}

• fs::create_directory[link /reference/filesystem/create_directory.md]
• it2->path()[link /reference/filesystem/directory_entry/path.md]

出力例

"dir/b.txt"
"dir/a.txt"

バージョン

言語

• C++17

処理系

• Clang: 7.0 [mark verified]
• GCC: 8.1 [mark verified]
• Visual C++: