std::filesystem::path:: begin, std::filesystem::path:: end
From cppreference.net
<
cpp
|
filesystem
|
path
C++
std::filesystem::path
| Member types | ||||||||||||||||||||||||||
| Member constants | ||||||||||||||||||||||||||
| Member functions | ||||||||||||||||||||||||||
|
||||||||||||||||||||||||||
| Path decomposition | ||||||||||||||||||||||||||
| Non-member functions | ||||||||||||||||||||||||||
|
||||||||||||||||||||||||||
| Helper classes | ||||||||||||||||||||||||||
|
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:
- root-name (if any).
- root-directory (if any).
- Sequence of file-name s, omitting any directory separators.
- If there is a directory separator after the last file-name in the path, the last element before the end iterator is an empty element.
Contents |
Parameters
(none)
Return value
1)
Iterator to the first element of the path.
2)
Iterator one past the end of the path
Exceptions
May throw implementation-defined exceptions.
Example
Run this code
#include <filesystem> #include <iostream> namespace fs = std::filesystem; int main() { const fs::path p = # ifdef _WIN32 "C:\\users\\abcdef\\AppData\\Local\\Temp\\"; # else "/home/user/.config/Cppcheck/Cppcheck-GUI.conf"; # endif std::cout << "Examining the path " << p << " through iterators gives\n"; for (auto it = p.begin(); it != p.end(); ++it) std::cout << *it << " │ "; std::cout << '\n'; }
Possible output:
--- Windows --- Examining the path "C:\users\abcdef\AppData\Local\Temp\" through iterators gives "C:" │ "/" │ "users" │ "abcdef" │ "AppData" │ "Local" │ "Temp" │ "" │ --- UNIX --- Examining the path "/home/user/.config/Cppcheck/Cppcheck-GUI.conf" through iterators gives "/" │ "home" │ "user" │ ".config" │ "Cppcheck" │ "Cppcheck-GUI.conf" │