---
name: "std::future"
section: "3"
platform: "linux"
package: "gcc"
version: "16.2.1+r23+gd564253eb6c8-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/std::future"
---

# std::future(3)

Primary template for future.

## NAME

std::future\< \_Res \> - Primary template for future.

## SYNOPSIS

\#include \<future\>

Inherits **std::\_\_basic\_future\< \_Res \>**.

### Public Member Functions

**future** (const future &)=delete\
 **future** (future &&\_\_uf) noexcept\
 Move constructor.  \_Res **get** ()\
 Retrieving the value.  future & **operator=** (const future &)=delete\
 future & **operator=** (future &&\_\_fut) noexcept\
 **shared\_future**\< \_Res \> **share** () noexcept\
 bool **valid** () const noexcept\
 void **wait** () const\
 template\<typename \_Rep, typename \_Period\> **future\_status** **wait\_for** (const **chrono::duration**\< \_Rep, \_Period \> &\_\_rel) const\
 template\<typename \_Clock, typename \_Duration\> **future\_status** **wait\_until** (const **chrono::time\_point**\< \_Clock, \_Duration \> &\_\_abs) const\

### Protected Types

typedef \_\_future\_base::\_Result\< \_Res \> & **\_\_result\_type**\

### Protected Member Functions

\_\_result\_type **\_M\_get\_result** () const\
 Wait for the state to be ready and rethrow any stored exception.  void **\_M\_swap** (\_\_basic\_future &\_\_that) noexcept\

### Friends

template\<typename \_Fn, typename... \_Args\> future\< \_\_async\_result\_of\< \_Fn, \_Args... \> \> **async** (**launch**, \_Fn &&, \_Args &&...)\
 template\<typename\> class **packaged\_task**\
 class **promise\< \_Res \>**\

## Detailed Description

### template\<typename \_Res\>

class std::future\< \_Res \>"Primary template for future.

## Constructor & Destructor Documentation

### template\<typename \_Res\> std::future\< \_Res \>::future (future\< \_Res \> && \_\_uf) \[inline\], \[noexcept\]

Move constructor.

References **std::move()**.

## Member Function Documentation

### template\<typename \_Res\> \_\_result\_type std::\_\_basic\_future\< \_Res \>::\_M\_get\_result () const \[inline\], \[protected\], \[inherited\]

Wait for the state to be ready and rethrow any stored exception.

Referenced by **std::future\< \_Res \>::get()**, and **std::shared\_future\< \_Res \>::get()**.

### template\<typename \_Res\> \_Res std::future\< \_Res \>::get () \[inline\]

Retrieving the value.

References **std::\_\_basic\_future\< \_Res \>::\_M\_get\_result()**, and **std::move()**.

## Author

Generated automatically by Doxygen for libstdc++ from the source code.