std::subtra...ne::discard(3)

💅 NAME

std::subtract_with_carry_engine::discard — okay so this is the discard member of std::subtract_with_carry_engine, and the page is literally titled std::subtract_with_carry_engine::discard twice because man pages are dramatic like that 💅 this one comes straight from the C++ Standard Libary (their spelling, not mine 😅).

✨ Synopsis ✨

void discard( unsigned long long z );  (since C++11)

Advances the internal state by z times. Equivalent to calling operator() z times and discarding the result. No cap, that's the whole vibe: skip ahead by z, throw away what you skipped over 🫶

🎀 Parameters 🎀

• z — integer value specifying the number of times to advance the state by.

💖 Return value 💖

(none) — literally nothing comes back, bestie. It just quietly moves the state along 🙈

🔥 Complexity 🔥

No worse than the complexity of z consecutive calls to operator().

🦋 Notes 🦋

For some engines, <rainbow>"fast jump"</rainbow> algorithms are known, which advance the state by many steps (order of millions) without calculating intermediate state transitions, although not necessarily in constant time. So yeah — big leap energy, but don't assume it's always constant-time, iykyk 👑

🌈 See also 🌈

• operator() — advances the engine's state and returns the generated value (C++11) (public member function).

shoutout to http://cppreference.com, version 2024.06.10, and the footer that says std::subtra...ne::discard(3) — bye bestie, go discard something responsibly 🫶💜