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_extension

Replaces the extension with replacement or removes it when the default value of replacement is used.

NotebookLM
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

example.cpp
#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';
}
Output
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.