begin_free.md

begin

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

namespace std::filesystem {
  directory_iterator begin(directory_iterator iter) noexcept;
}

概要

先頭要素を指すイテレータを取得する。

この関数は、directory_iteratorクラスのオブジェクトを範囲for文に適用するために定義されている。

戻り値

return iter;

例

#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 it{"dir"};

  fs::directory_iterator first = fs::begin(it);
  fs::directory_iterator last = fs::end(it);

  for (; first != last; ++first) {
    std::cout << first->path() << std::endl;
  }
}

• fs::begin[color ff0000]
• fs::create_directory[link /reference/filesystem/create_directory.md]
• fs::end[link end_free.md]
• first->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++: