std::list::max_size(3)

🎀 NAME 🎀

std::list::max_size — literally std::list::max_size. Also hiii bestie, this is the C++ Standard Libary manual page for std::list::max_size(3), and we're gonna get into it. 💖

✨ Synopsis ✨

Here's the signature, bestie — keep it cute and exact:

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. It's giving "the absolute biggest container it could theoretically hold" energy. ✨

🌸 Parameters 🌸

None. Like, (none) — not a single parameter, not even one. 🙈

💫 Return value 💫

Maximum number of elements. That's the whole return value, and it ate. 💅

🦋 Complexity 🦋

Constant. No drama, no scaling, just constant. 🫶

👑 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… your container's dreams are huge, but RAM says "bestie, no." 😭

🍓 Example 🍓

Hit up this example, bestie:

// Run this code

        #include <iostream>
        #include <locale>
        #include <list>

        int main()
        {
            std::list<char> p;
            std::list<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() = 768,614,336,404,564,650 = 0xAAA,AAA,AAA,AAA,AAA
        q.max_size() = 768,614,336,404,564,650 = 0xAAA,AAA,AAA,AAA,AAA

👀 See also 👀

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

🌸 Source/version: http://cppreference.com, dated 2024.06.10 — this was the std::list::max_size(3) page, and you ate. 💖