W3cubDocs

/C++

std::filesystem::path::replace_filename

path& replace_filename( const path& replacement );
 (since C++17)

Replaces a single filename component with replacement.

Equivalent to: remove_filename(); return operator/=(replacement);.

Parameters

replacement - path used for replacing the filename component

Return value

*this.

Exceptions

May throw implementation-defined exceptions.

Example

#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
 
int main()
{
    std::cout << fs::path("/foo").replace_filename("bar") << '\n'
              << fs::path("/").replace_filename("bar") << '\n'
              << fs::path("").replace_filename("pub") << '\n';
}

Output:

"/bar"
"/bar"
"pub"

See also

replaces the extension
(public member function)
returns the filename path component
(public member function)
removes filename path component
(public member function)
checks if the corresponding path element is not empty
(public member function)

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