| path& replace_extension( const path& replacement = path() ); |
(1) | (filesystem TS) |
Replaces the extension with replacement or removes it when the default value of replacement is used.
Firstly, if this path has an extension(), it is removed.
Then, a dot character is appended if replacement is not empty or does not begin with a dot character.
Then replacement is appended to the path.
Parameters
| replacement | - | the extension to replace with |
Return value
*this
Exceptions
May throw implementation-defined exceptions.
Example
#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
{
fs::path p = "/foo/bar.jpeg";
std::cout << "Was: " << p << '\n';
p.replace_extension(".jpg");
std::cout << "Now: " << p << '\n';
}Was: "/foo/bar.jpeg"
Now: "/foo/bar.jpg"See also
| returns the file extension path component (public member function) | |
| returns the filename path component (public member function) | |
| returns the stem 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.