std::multiset::max_size(3)

🎀 std::multiset::max_size — C++ Standard Library 🎀

🌸 NAME 🌸

std::multiset::max_size — bestie, the name is literally std::multiset::max_size. It’s giving “the function is the function” energy, and honestly? Iconic. 💅✨

✨ Synopsis ✨

Okay so here’s the whole signature, no cap:

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) — literally no parameters, bestie. It takes zero arguments and minds its own business. 🦋

💖 Return value 💖

Maximum number of elements. That’s the whole return value, and it ate. ✨

🌈 Complexity 🌈

Constant. Periodt. 💅

🧚 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 slay is huge, but actual RAM can absolutely humble you. 😭💀

🔥 Example 🔥

// Run this code

#include <iostream>
#include <locale>
#include <set>

int main()
{
    std::multiset<char> p;
    std::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() = 461,168,601,842,738,790 = 0x666,666,666,666,666
q.max_size() = 461,168,601,842,738,790 = 0x666,666,666,666,666

👑 See also 👑

• size — returns the number of elements (public member function). Bestie, if you want the actual count, that’s the one. 💖

💖 xoxo, your local C++ bestie — source http://cppreference.com, date 2024.06.10, page std::multiset::max_size(3). mwah 💋