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())，则在 *this 的通用格式中追加 path::preferred_separator。

* 无论哪种方式，都会将 p 的本机格式路径名（省略其通用格式中的任何 root-name）追加到 *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。

[编辑] 备注

这些函数在 *this 是起始目录的环境中，实际上产生了对参数路径 p 含义的近似值。

[编辑] 示例

输出是在 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)	使用目录分隔符连接两个路径 (函数) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作