Namespaces
Variants
Views
Actions

std::filesystem::path::replace_filename

From cppreference.com
< cpp‎ | filesystem‎ | path
 
 
 
 
path& replace_filename( const path& replacement );
(since C++17)

Replaces a single filename component with replacement.

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

Contents

[edit] Parameters

replacement - path used for replacing the filename component

[edit] Return value

*this

[edit] Exceptions

May throw implementation-defined exceptions.

[edit] 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"

[edit] See also

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