std::allocator::max_size(3)

🌸 NAME 🌸

okay so bestie, welcome to the C++ Standard Library corner of the manual — this is std::allocator::max_size(3), and she's here to tell you the absolute most n you could theoretically ask for. no cap, it's giving "how big can we go" energy. 💅✨

🔥 Synopsis 🔥

size_type max_size() const throw();   (until C++11)
                                      (since C++11)
size_type max_size() const noexcept;  (deprecated in C++17)
                                      (removed in C++20)

so what does she actually do? she returns the maximum theoretically possible value of n for which the call allocate(n, 0) could succeed. yes, allocate(n, 0) — write it down, bestie. 📝

and in most implementations, this is literally just:

std::numeric_limits<size_type>::max() / sizeof(value_type)

slay, math queen. 🧮👑

🦋 Parameters 🦋

(none) — zero, zilch, nada. she takes no parameters, she's lowkey low-maintenance like that. 💖

🎀 Return value 🎀

the maximum supported allocation size. that's it, that's the tea. ☕✨

🌈 See also 🌈

• max_size returns the maximum object size supported by the allocator [static] — as in, a public static member function of std::allocator_traits<Alloc>. iykyk. 🫶

shoutout to the source http://cppreference.com and the 2024.06.10 date — that's the version vibe, periodt. 💅🌸