std::unorde...et::max_size(3)

💖 NAME 💖

okay so bestie, this is the std::unordered_multiset::max_size page, and it lives in the C++ Standard Libary manual — yes, Libary, that's the spelling in the header, not a typo I invented, leave her alone 😭💅.

official name drop: std::unordered_multiset::max_size - std::unordered_multiset::max_size

---

🌸 Synopsis 🌸

size_type max_size() const noexcept;  (since C++11)

Returns the maximum number of elements the container is able to hold due to system or library implementation limitations, i.e. std::distance(begin(), end()) for the largest container.

---

🎀 Parameters 🎀

none. zero. zilch. no arguments, no params, nada — the page literally says (none) 🫶.

---

✨ Return value ✨

Maximum number of elements. that's it, that's the return value, main character energy 👑.

---

💅 Complexity 💅

Constant. no cap, bestie 💀.

---

🦋 Notes 🦋

This value typically reflects the theoretical limit on the size of the container, at most std::numeric_limits<difference_type>::max(). At runtime, the size of the container may be limited to a value smaller than max_size() by the amount of RAM available.

so like, the theoretical dream is huge, but actual RAM said “not today” 😭.

---

🍓 Example 🍓

the page says // Run this code, so here we go, bestie:

        #include <iostream>
        #include <locale>
        #include <unordered_set>

        int main()
        {
            std::unordered_multiset<char> p;
            std::unordered_multiset<long> q;

            std::cout.imbue(std::locale("en_US.UTF-8"));
            std::cout << std::uppercase
                      << "p.max_size() = " << std::dec << p.max_size() << " =
       0x"
                      << std::hex << p.max_size() << '\n'
                      << "q.max_size() = " << std::dec << q.max_size() << " =
       0x"
                      << std::hex << q.max_size() << '\n';
        }

Possible output:

        p.max_size() = 1,152,921,504,606,846,975 = 0xFFF,FFF,FFF,FFF,FFF
        q.max_size() = 1,152,921,504,606,846,975 = 0xFFF,FFF,FFF,FFF,FFF

---

👑 See also 👑

• size — returns the number of elements (public member function) 💜

---

mwah 💋 that's the page — source/version vibe: http://cppreference.com, date: 2024.06.10, footer title: std::unorde...et::max_size(3). periodt. 🌈