SysTutorials

Linux Manual Pages › Section 3

stdexperimentalfilesystempathreplace_extension(3)

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

Synopsis

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

(none)

Example

// Run this code

#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"

See also

              returns the file extension path component extension (public member function)               returns the filename path component filename (public member function)               returns the stem path component stem (public member function)               checks if the corresponding path element is not empty has_extension (public member function)