A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://en.cppreference.com/w/cpp/language/../named_req/../thread/future.html below:

std::future - cppreference.com

template< class T > class future;

(1) (since C++11)

template< class T > class future<T&>;

(2) (since C++11)

template<> class future<void>;

(3) (since C++11)

The class template std::future provides a mechanism to access the result of asynchronous operations:

Note that std::future references shared state that is not shared with any other asynchronous return objects (as opposed to std::shared_future).

[edit] Member functions constructs the future object
(public member function) [edit] destructs the future object
(public member function) [edit] moves the future object
(public member function) [edit] transfers the shared state from *this to a shared_future and returns it
(public member function) [edit] Getting the result returns the result
(public member function) [edit] State checks if the future has a shared state
(public member function) [edit] waits for the result to become available
(public member function) [edit] waits for the result, returns if it is not available for the specified timeout duration
(public member function) [edit] waits for the result, returns if it is not available until specified time point has been reached
(public member function) [edit] [edit] Examples
#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    // future from a packaged_task
    std::packaged_task<int()> task([]{ return 7; }); // wrap the function
    std::future<int> f1 = task.get_future(); // get a future
    std::thread t(std::move(task)); // launch on a thread
 
    // future from an async()
    std::future<int> f2 = std::async(std::launch::async, []{ return 8; });
 
    // future from a promise
    std::promise<int> p;
    std::future<int> f3 = p.get_future();
    std::thread([&p]{ p.set_value_at_thread_exit(9); }).detach();
 
    std::cout << "Waiting..." << std::flush;
    f1.wait();
    f2.wait();
    f3.wait();
    std::cout << "Done!\nResults are: "
              << f1.get() << ' ' << f2.get() << ' ' << f3.get() << '\n';
    t.join();
}

Output:

Waiting...Done!
Results are: 7 8 9
[edit] Example with exceptions
#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    std::promise<int> p;
    std::future<int> f = p.get_future();
 
    std::thread t([&p]
    {
        try
        {
            // code that may throw
            throw std::runtime_error("Example");
        }
        catch (...)
        {
            try
            {
                // store anything thrown in the promise
                p.set_exception(std::current_exception());
            }
            catch (...) {} // set_exception() may throw too
        }
    });
 
    try
    {
        std::cout << f.get();
    }
    catch (const std::exception& e)
    {
        std::cout << "Exception from the thread: " << e.what() << '\n';
    }
    t.join();
}

Output:

Exception from the thread: Example
[edit] See also runs a function asynchronously (potentially in a new thread) and returns a std::future that will hold the result
(function template) [edit] waits for a value (possibly referenced by other futures) that is set asynchronously
(class template) [edit]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4