std::geomet...::operator()(3)

💅 std::geometric_distribution::operator() — the cppreference page, but make it make sense

okay so bestie, you found the page for std::geometric_distribution::operator() (the header up top says std::geomet...::operator()(3), which is just the C++ Standard Library being dramatic and truncating itself 💀). This is the little callable that actually spits out your random numbers, and I'm gonna walk you through it like we're on FaceTime. 🎀

---

✨ SYNOPSIS ✨

Two overloads, both (since C++11), and look at them, they're gorgeous:

template< class Generator >                                       (1)
(since C++11)
result_type operator()( Generator& g );

template< class Generator >                                       (2)
(since C++11)
result_type operator()( Generator& g, const param_type& params );

So basically: it generates random numbers that are distributed according to the associated probability function, and the entropy is acquired by calling g.operator(). 🔥

The first version uses the associated parameter set, and the second version uses params. And the associated parameter set is not modified — she's untouched, she's unbothered, she's booked and busy. 👑

---

🌸 PARAMETERS 🌸

• g — a uniform random bit generator object. That's the lil engine churning out the randomness, bestie.
• params — distribution parameter set to use instead of the associated one. Like, "use this vibe instead of your default vibe." 🦋

---

💜 TYPE REQUIREMENTS 💜

• Generator must meet the requirements of UniformRandomBitGenerator.

That's it. That's the whole requirement. No cap. ✨

---

🫶 RETURN VALUE 🫶

The generated random number. Boom. Iconic. 💅

---

⭐ COMPLEXITY ⭐

Amortized constant number of invocations of g.operator().

Translation: it's not doing a whole saga of calls, it's amortized constant and it's slaying while doing it 🌈

---

lowkey the most important thing here: version (1) does not touch the associated parameter set, and version (2) uses params instead of it. Don't get it twisted. 🙈

---

and that's the whole page, bestie 💖 source is http://cppreference.com, version/date 2024.06.10, footer title std::geomet...::operator()(3) — periodt. 💀🎀🧚