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

💅 std::discard_block_engine::discard 💅

Okay bestie, welcome to the std::discar...ne::discard(3) page from the C++ Standard Libary — manual-name check, folded in right here at the top like a little name tag. The function serving main-character energy is std::discard_block_engine::discard, and yes, the NAME line is exactly std::discard_block_engine::discard - std::discard_block_engine::discard. We love a self-referential icon.

💖 NAME 💖

std::discard_block_engine::discard - std::discard_block_engine::discard

🦋 Synopsis 🦋

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

It advances the internal state by z times. Equivalent to calling operator() z times and discarding the result. The state of the underlying engine may be advanced by more than z times. So yeah, it's giving "skip ahead," but the underlying engine might take a few extra steps, no cap.

🌸 Parameters 🌸

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

🎀 Return value 🎀

(none) — she returns absolutely nothing. Void behavior, zero results to catch.

✨ Exceptions ✨

Throws nothing. Not a single exception. Calm, quiet, unbothered.

💜 See also 💜

• operator() — advances the state of the underlying engine and returns the generated value (C++11) (public member function)

Big kiss to http://cppreference.com, source/version and date 2024.06.10, for the lore — and that's the whole page, periodt. 🫶💖