std::filesystem::path::begin
std::filesystem::path::begin, std::filesystem::path::end
iterator begin() const; | (1) | (since C++17) |
iterator end() const; | (2) | (since C++17) |
1) Returns an iterator to the first element of the path. If the path is empty, the returned iterator is equal to
end()
.
2) Returns an iterator one past the last element of the path. Dereferencing this iterator is undefined behavior.
The sequence denoted by this pair of iterators consists of the following:
1) root-name (if any)
2) root-directory (if any)
3) sequence of file-names, omitting any directory separators
4) If there is a directory separator after the last file-name in the path, the last element before the end iterator is a fictitious dot file name.
Parameters
(none).
Return value
1) Iterator to the first element of the path.
2) Iterator one past the end of the path
Exceptions
(none).
Example
#include <iostream> #include <filesystem> namespace fs = std::filesystem; int main() { fs::path p = "C:\\users\\abcdef\\AppData\\Local\\Temp\\"; std::cout << "Examining the path " << p << " through iterators gives\n"; for(auto& e : p) std::cout << e << '\n'; }
Output:
Examining the path "C:\users\abcdef\AppData\Local\Temp\" through iterators gives "C:" "/" "users" "abcdef" "AppData" "Local" "Temp" "."
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/filesystem/path/begin