Spec-Zone.ru › C++

std::filesystem::path::begin, std::filesystem::path::end

iterator begin() const;
(1) (since C++17)
iterator end() const;
(2) (since C++17)
1) Возвращает итератор на первый элемент пути. Если путь пустой, возвращаемый итератор равен end().
2) Возвращает итератор, указывающий на элемент, следующий за последним элементом пути. Обращение к значению этого итератора определено как недопустимое поведение.

Последовательность, обозначаемая этой парой итераторов, состоит из:

  1. имя корня (если есть).
  2. корневой каталог (если есть).
  3. Последовательность имён файлов, опуская любые разделители каталогов.
  4. Если после последнего имени файла в пути есть разделитель каталогов, последним элементом перед итератором конца будет пустой элемент.

Параметры

(нет)

Возвращаемое значение

1) Итератор на первый элемент пути.
2) Итератор, указывающий на элемент, следующий за последним элементом пути

Исключения

Может выбросить исключение, определённое реализацией.

Пример

#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';
}

Возможный вывод:

--- 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" │

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/path/begin

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API