std::filesystem::path::replace_filename
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 <iostream>
#include <filesystem>
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';
}
Output:
"/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) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/path/replace_filename
