| path& replace_filename( const path& replacement ); |
(since C++17) | |
Replaces a single filename component with replacement.
Equivalent to: remove_filename(); return operator/=(replacement);.
Parameters
| replacement | - | path used for replacing the filename component
|
Return value
*this
Exceptions
May throw implementation-defined exceptions.
Example
#include <filesystem>
#include <iostream>
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';
}"/bar"
"/bar"
"pub"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.