std::packag...:get_future(3)

💅 NAME

std::packaged_task::get_future — ok so this is literally the std::packaged_task::get_future page, bestie, coming at you straight from the C++ Standard Libary manual 🦋

✨ Synopsis

Here's the whole vibe, one line, no cap:

std::future<R> get_future();  (since C++11)

So what does it actually do? It returns a future which shares the same shared state as *this 🫶 That's it. That's the whole personality.

⚠️ But bestie listen — get_future can be called only once for each packaged_task. Not twice. Not "oops let me try again." Once. Periodt. 💅

🎀 Parameters

(none) — she takes nothing! No arguments, no drama, iconic behavior honestly 🌸

🌸 Return value

A future which shares the same shared state as *this ✨ (yes, same sentence as the synopsis — cppreference said it twice so we're saying it twice, consistency queen 👑)

💀 Exceptions

If things go sideways, you get a std::future_error on the following error conditions:

• The shared state has already been retrieved via a call to get_future. The error category is set to future_already_retrieved. 😭 (you already asked, girl, she's not gonna give it twice)
• *this has no shared state. The error category is set to no_state. 💀 (there's literally nothing there to share — vibe check failed)

anyway that's the whole page, mwah 💖 shoutout to http://cppreference.com for hosting this, dated 2024.06.10 — go drink some water and go call get_future exactly once, iykyk 🧚‍♀️🫶