std::experi...e_extension(3)

💖 std::experi...e_extension(3) 💖

okay so this page is from the C++ Standard Libary manual, and it’s all about std::experimental::filesystem::path::replace_extension. bestie, it’s giving filesystem TS realness, and we’re gonna get into it. ✨

🌸 NAME 🌸

• std::experimental::filesystem::path::replace_extension — yep, std::experimental::filesystem::path::replace_extension (the page repeats its own name, iconic)

✨ Synopsis ✨

path& replace_extension( const path& replacement = path() ); (1)
(filesystem TS)

It replaces the extension with replacement, or removes it when the default value of replacement is used. 💅

Here’s the order of operations, no cap:

1. Firstly, if this path has an extension(), it is removed.
2. Then, a dot character is appended if replacement is not empty or does not begin with a dot character.
3. Then replacement is appended to the path.

🎀 Parameters 🎀

• replacement — the extension to replace with

💖 Return value 💖

• *this — that’s the whole return, bestie. No extra packaging. 🫶

🔥 Exceptions 🔥

May throw implementation-defined exceptions. 😭

🦋 Example 🦋

// Run this code

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

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

🌟 Category 🌟

• * Noindexed pages

mwah 💋 source is http://cppreference.com, version/date is 2024.06.10, and the footer name is std::experi...e_extension(3). periodt. 🎀