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 является допустимым и обозначает, возможно, const-квалифицированный тип кодирующего символа (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 в случае неудачи выделения памяти.

Примечания

Эти функции фактически дают приблизительное представление о значении аргумента path 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/w/cpp/filesystem/path/append