std::filesystem::path

class path;

Объекты типа path представляют пути в файловой системе. Обрабатываются только синтаксические аспекты путей: имя пути может обозначать несуществующий путь или даже путь, существование которого не допускается в текущей файловой системе или ОС.

Имя пути имеет следующий синтаксис:

1. root-name(необязательно): задаёт корень в файловой системе с несколькими корнями (например, "C:" или "//myserver"). В случае неоднозначности последовательность символов наибольшей длины, образующая допустимое root-name, считается root-name. Стандартная библиотека может определять дополнительные корневые имена, помимо тех, которые распознаются API операционной системы.
2. root-directory(необязательно): разделитель каталогов, наличие которого указывает, что путь является абсолютным. Если он отсутствует (и первый элемент после корневого имени является именем файла), путь является относительным и для разрешения в имя файла ему требуется другой путь в качестве начального расположения.
3. Ноль или более следующих элементов:

• file-name: последовательность символов, не являющихся разделителями каталогов или предпочтительными разделителями каталогов (ОС или файловая система могут накладывать дополнительные ограничения). Это имя может обозначать файл, жёсткую ссылку, символическую ссылку или каталог. Распознаются два специальных значения file-name:
• dot: имя файла, состоящее из одного символа точки ., является именем каталога, обозначающим текущий каталог.
• dot-dot: имя файла, состоящее из двух символов точки .., является именем каталога, обозначающим родительский каталог.
• directory-separator: символ прямой косой черты / или альтернативный символ, задаваемый как path::preferred_separator. Если этот символ повторяется, он считается одним разделителем каталогов: /usr///////lib эквивалентно /usr/lib.

Путь можно нормализовать по следующему алгоритму:

1. Если путь пуст, остановиться (нормальная форма пустого пути — пустой путь).
2. Заменить каждый directory-separator (который может состоять из нескольких косых черт) одним символом path::preferred_separator.
3. Заменить каждый символ косой черты в root-name на path::preferred_separator.
4. Удалить каждую dot и любой непосредственно следующий за ней directory-separator.
5. Удалить каждое имя файла, не являющееся dot-dot, за которым непосредственно следуют directory-separator и dot-dot, а также любой непосредственно следующий за ними directory-separator.
6. Если имеется root-directory, удалить все dot-dot и любые непосредственно следующие за ними directory-separator.
7. Если последнее имя файла — dot-dot, удалить все завершающие directory-separator.
8. Если путь пуст, добавить dot (нормальная форма ./ — .).

Путь можно обходить поэлементно с помощью итераторов, возвращаемых функциями begin() и end(). Они представляют путь в общем формате и выполняют итерацию по корневому имени, корневому каталогу и последующим элементам-именам файлов (разделители каталогов пропускаются, за исключением того, который обозначает корневой каталог). Если самый последний элемент пути — разделитель каталогов, при разыменовании последнего итератора будет получен пустой элемент.

Вызов любой неконстантной функции-члена объекта path делает недействительными все итераторы, ссылающиеся на элементы этого объекта.

Если в ОС используется нативный синтаксис, отличный от описанного выше переносимого общего синтаксиса, библиотечные функции, принимающие аргументы в «определяемом формате», принимают имена путей в обоих форматах: аргумент в определяемом формате считается заданным в общем формате тогда и только тогда, когда он соответствует общему формату, но не принимается операционной системой как нативный путь. В ОС, где нативный формат различается для имён путей каталогов и файлов, имя пути в общем формате считается путём к каталогу, если оно заканчивается разделителем каталогов, и обычным файлом в противном случае.

В любом случае класс path ведёт себя так, как если бы он хранил имя пути в нативном формате и автоматически преобразовывал его в общий формат при необходимости (каждая функция-член указывает, в каком формате интерпретирует путь).

В системах POSIX общий формат совпадает с нативным, поэтому различать их или преобразовывать один в другой не требуется.

Пути неявно преобразуются в std::basic_string и обратно, что позволяет использовать их с другими файловыми API.

Операторы потоков используют std::quoted, чтобы пробелы не приводили к усечению при последующем чтении с помощью оператора ввода из потока.

Функции-члены разложения (например, extension) возвращают объекты filesystem::path, а не объекты строк, как это делают другие API.

Типы-члены

Константы-члены

Функции-члены

Функции, не являющиеся членами

Вспомогательные классы

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.