| 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';
}"/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.