Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

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

Replaces a single filename component with replacement.

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

Replaces a single filename component with replacement.

Equivalent to the following:

snippet.cpp
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

example.cpp
#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)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.