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

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Filesystem library

Template:cpp/experimental/fs/navbar content

 

path

Template:cpp/experimental/fs/path/navbar content

 

path& replace_filename( const path& replacement );	(1)	(filesystem TS)

Replaces a single filename component with replacement. Equivalent to the following:

remove_filename();
operator/=(replacement);

Parameters

(none)

Return value

*this

Exceptions

(none)

Example

Run this code

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

Output:

/bar
bar

See also

replace_extension

replaces the extension (public member function)