std::experimental::filesystem::path::replace_filename

From cppreference.com
< cpp‎ | experimental‎ | fs‎ | path
 
 
Experimental
Technical Specification
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
Experimental Non-TS
Pattern Matching
Linear Algebra
std::execution
Contracts
2D Graphics
 
 
 
path& replace_filename( const path& replacement );
(filesystem TS)

Replaces a single filename component with replacement.

Equivalent to the following:

remove_filename();
operator/=(replacement);

The behavior is undefined if the path has no filename component (has_filename returns false).

Parameters

(none)

Return value

*this

Exceptions

May throw implementation-defined exceptions.

Example

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

Output:

"/bar"
"bar"

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)