std::flat_set::replace(3)

✨ std::flat_set::replace(3) ✨

Okay bestie, welcome to the std::flat_set::replace(3) manual page from the C++ Standard Libary — yes, that manual name is folded in right up top, no header-line copy-paste happening here. This is the glow-up for replacing that underlying container. 💅

🌸 NAME 🌸

std::flat_set::replace — the NAME line is literally std::flat_set::replace - std::flat_set::replace. It's giving "I contain myself," and honestly? Iconic. This page explains the member that replaces the underlying container for a std::flat_set.

🦋 Synopsis 🦋

Here's the signature, no cap:

void replace( container_type&& cont );

Since C++23. ✨

So what does it do? It replaces the underlying container, c, and it's equivalent to:

c = std::move(cont);

Heads up, bestie: the elements of cont must be sorted with respect to compare, and cont must not contain equal elements. Otherwise, the behavior is undefined. This is the "do not skip the vibe check" part. 😭

🎀 Parameters 🎀

• cont — a sorted container of type KeyContainer, the contents of which will be moved into *this. 🫶

⭐ Return value ⭐

(none) — nothing comes back, bestie. It's giving "I did the move and I'm not returning your texts." 💀

💜 Complexity 💜

Equals the complexity of std::move applied to the adapted container. No secret extra drama, no hidden plot twist — that's the whole complexity story. ✨

🌈 Example 🌈

// Run this code

#include <algorithm>
#include <cassert>
#include <flat_set>
#include <print>
#include <vector>

int main()
{
    std::vector<int> keys{1, 2, 3};
    assert(std::ranges::is_sorted(keys));

    std::flat_set<int> set;
    assert(set.empty());

    set.replace(keys);
    assert(set.size() == 3);
    assert(keys.empty());

    std::println("{}", set); // set.keys()
}

💖 Output 💖

[1, 2, 3]

Ate. Periodt. 🍓

👑 See also 👑

• extract — extracts the underlying container (public member function). Go off, extract. 💅

---

Source/version/date sign-off: this iconic little page comes from http://cppreference.com, dated 2024.06.10, and it is the std::flat_set::replace(3) manual page. Mwah 💋✨