std::filesystem::path::append, std::filesystem::path::operator/=

path& operator/=( const path& p );	(1)	(начиная с C++17)
template< class Source > path& operator/=( const Source& source );	(2)	(начиная с C++17)
template< class Source > path& append( const Source& source );	(3)	(начиная с C++17)
template< class InputIt > path& append( InputIt first, InputIt last );	(4)	(начиная с C++17)

1) Если p.is_absolute() || (p.has_root_name() && p.root_name() != root_name()), заменяет текущий путь на p, как если бы был вызван operator=(p), и завершает работу.

* В противном случае, если p.has_root_directory(), удаляет корневой каталог и весь относительный путь из имени пути *this в обобщенном формате.

* В противном случае, если has_filename() || (!has_root_directory() && is_absolute()), добавляет path::preferred_separator к пути *this в обобщенном формате.

* В любом случае затем добавляет имя пути p в нативном формате, исключая любое имя корня из его обобщенного формата, к пути *this в нативном формате.

// Where "//host" is a root-name
path("//host")  / "foo" // the result is      "//host/foo" (appends with separator)
path("//host/") / "foo" // the result is also "//host/foo" (appends without separator)

// On POSIX,
path("foo") / ""      // the result is "foo/" (appends)
path("foo") / "/bar"; // the result is "/bar" (replaces)

// On Windows,
path("foo") / "C:/bar";  // the result is "C:/bar" (replaces)
path("foo") / "C:";      // the result is "C:"     (replaces)
path("C:") / "";         // the result is "C:"     (appends, without separator)
path("C:foo") / "/bar";  // yields "C:/bar"        (removes relative path, then appends)
path("C:foo") / "C:bar"; // yields "C:foo/bar"     (appends, omitting p's root-name)

2,3) То же, что и (1), но принимает любой std::basic_string, std::basic_string_view, строку из нескольких символов с нулевым завершающим символом или входной итератор, указывающий на последовательность из нескольких символов с нулевым завершающим символом. Эквивалентно return operator/=(path(source));.

4) То же, что и (1), но принимает любую пару итераторов, задающую строку из нескольких символов. Эквивалентно return operator/=(path(first, last));.

(2) и (3) участвуют в разрешении перегрузки, только если Source и path имеют разные типы и выполняется одно из следующих условий:

Source является специализацией std::basic_string или std::basic_string_view, либо
std::iterator_traits<std::decay_t<Source>>::value_type корректно и обозначает, возможно, константно-квалифицированный тип символа кодировки (char, char8_t, (начиная с C++20)char16_t, char32_t или wchar_t).

Параметры

p	-	путь для добавления
source	-	`std::basic_string`, `std::basic_string_view`, строка из нескольких символов с нулевым завершающим символом или входной итератор, указывающий на последовательность из нескольких символов с нулевым завершающим символом, представляющие имя пути (в переносимом или нативном формате)
first, last	-	пара LegacyInputIterators, задающая последовательность из нескольких символов, представляющую имя пути
Требования к типам
-`InputIt` должен соответствовать требованиям LegacyInputIterator.
-Тип значения `InputIt` должен быть одним из типов кодируемых символов (`char`, `wchar_t`, `char16_t` и `char32_t`).

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

*this

Исключения

Может выбросить std::bad_alloc, если не удается выделить память.

Примечания

Эти функции фактически дают приближенное представление значения пути-аргумента p в среде, где *this является начальным каталогом.

Пример

Вывод приведен для Windows.

#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;

int main()
{
    fs::path p1 = "C:";
    p1 /= "Users"; // does not insert a separator
    std::cout << "\"C:\" / \"Users\" == " << p1 << '\n';
    p1 /= "batman"; // inserts fs::path::preferred_separator, '\' on Windows
    std::cout << "\"C:\" / \"Users\" / \"batman\" == " << p1 << '\n';
}

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

"C:" / "Users" == "C:Users"
"C:" / "Users" / "batman" == "C:Users\\batman"

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

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

DR	Применяется к	Опубликованное поведение	Корректное поведение
LWG 3244	C++17	отсутствовало ограничение, согласно которому `Source` не может быть `path`	добавлено

См. также

concatoperator+=	объединяет два пути, не добавляя разделитель каталогов (функция-член)
operator/ (C++17)	объединяет два пути, добавляя разделитель каталогов (функция)

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