std::experimental::filesystem::path::replace_extension

From cppreference.com
< cpp‎ | experimental‎ | fs‎ | path
 
 
Technical specifications
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals 2 TS)
Extensions for parallelism (parallelism TS)
Concepts (concepts TS)
Extensions for concurrency (concurrency TS)
Special mathematical functions (special math TR)
 
 
 
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.

Contents

[edit] Parameters

replacement - the extension to replace with

[edit] Return value

*this

[edit] Exceptions

(none)

[edit] Example

#include <iostream>
#include <experimental/filesystem>
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.replace_extension(".jpg") << '\n';
}

Output:

Was: "/foo/bar.jpeg"
Now: "/foo/bar.jpg"

[edit] 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)