__GNU_CXX::THROW_ALLOCATOR_RANDOM(3)

💖 __gnu_cxx::throw_allocator_random< _Tp > 💖

okay bestie, sit down, hydrate, because we're about to get into a libstdc++ manual page and honestly? it's giving niche-but-iconic. this one lives in the Library Functions Manual under the <pink>libstdc++</pink> banner, and the whole page is literally just __gnu_cxx:...dom< _Tp >(3) energy. yes, the title got truncated. no, we don't talk about it. 🎀

---

✨ NAME ✨

__gnu_cxx::throw_allocator_random< _Tp > — Allocator throwing via random condition. 🎲💥

---

🌸 SYNOPSIS 🌸

#include <throw_allocator.h>

Inherits __gnu_cxx::throw_allocator_base< _Tp, random_condition >. 🫶

👑 Public Types

• typedef const value_type * const_pointer — a pointer that refuses to let you touch the goods. read-only vibes.
• typedef const value_type & const_reference — same energy but a reference. no edits allowed, bestie.
• typedef std::ptrdiff_t difference_type — the difference between two pointers, standard issue.
• typedef value_type * pointer — the regular, fully-writable pointer type.
• typedef std::true_type propagate_on_container_move_assignment — yes, this container does carry its allocator along when move-assigned. std::true_type. it said "I'm coming with you" and meant it. 💅
• typedef value_type & reference — a normal reference.
• typedef std::size_t size_type — sizes are std::size_t. periodt.
• typedef _Tp value_type — the type you're storing. the main character, lowkey.

💅 Public Member Functions

• throw_allocator_random (const throw_allocator_random &) noexcept — copy constructor. noexcept, so it's not gonna surprise you. ✨
• template<typename _Tp1> throw_allocator_random (const throw_allocator_random< _Tp1 > &) noexcept — the templated converting copy constructor. yes it's a whole mouthful, yes it's noexcept. 😌
• pointer address (reference __x) const noexcept — hands you the actual address of __x. noexcept. no drama.
• pointer allocate (size_type __n, const void *__hint=0) — grab memory for __n things. there's an optional __hint pointer that defaults to 0.
• void check (size_type __n) — the member check. 👀
• void check_allocated (pointer __p, size_type __n) — verify that __p really is allocated for __n.
• map_alloc_type::iterator check_allocated (void *p, size_t size) — the overload taking a void *p and a size_t size, handing back a map_alloc_type::iterator.
• void check_constructed (size_t label) — checks construction, by label.
• map_construct_type::iterator check_constructed (void *p) — the void *p overload, returning a map_construct_type::iterator.
• void construct (_Up *__p, _Args &&... __args) — construct a _Up at __p from __args. the classic variadic glow-up. 🌈
• void deallocate (pointer __p, size_type __n) — give the memory back. bye babe, thanks for the memories. 🦋
• void destroy (_Up *__p) — tear down the object at __p.
• void erase (void *p, size_t size) — erase the (p, size) entry.
• void erase_construct (void *p) — erase the construction record at p.
• void insert (void *p, size_t size) — insert a (p, size) record.
• void insert_construct (void *p) — record a construction at p.
• size_type max_size () const noexcept — biggest size it'll handle. const and noexcept, obviously. 👑
• throw_allocator_random & operator= (const throw_allocator_random &)=default — assignment operator, defaulted. it's not doing anything extra, and that's on purpose.
• void seed (unsigned long __s) — seed the randomness with __s. this is the one that decides whether today is a throw day. 🎲

🎀 Static Public Member Functions

• static void check () — the no-argument static check. there are two checks on this page, keep up bestie. 🙈
• static size_t get_label () — returns the current label as a size_t.
• static void set_label (size_t l) — set the label to l.
• static void set_probability (double __p) — set the throw probability to __p. this is the dial that controls the chaos. 🔥
• static void throw_conditionally () — throw, conditionally. that's it. that's the function. it's giving "maybe". 💀

---

🧚 Detailed Description 🧚

template<typename _Tp>
    struct __gnu_cxx::throw_allocator_random< _Tp >

"Allocator throwing via random condition." 🌈✨

like, that's the whole description. an allocator that throws, and whether it throws is up to a random condition. chaotic? yes. iconic? also yes. no cap. 💖

ngl, that's all the detail the original page gives you on the description front. no extra lore, no secret tips, just the vibe. don't let anyone tell you otherwise. 😭

---

💜 Author 💜

Generated automatically by Doxygen for libstdc++ from the source code. so if you're mad about the formatting, take it up with Doxygen, not me. 🫶

---

okay that's the whole page!! 💖 this was the <hotpink>libstdc++</hotpink> manual page for __gnu_cxx:...dom< _Tp >(3) — yes the title is still truncated, and yes we're all going to be normal about it. thanks for reading, bestie, go forth and seed responsibly. 🎀🦋✨