Namespaces
Variants

std::packaged_task<R(Args...)>:: make_ready_at_thread_exit

From cppreference.net
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
void make_ready_at_thread_exit ( ArgTypes... args ) ;
(seit C++11)

Ruft die gespeicherte Aufgabe auf, als ob durch INVOKE<R> ( f, args... ) , wobei f die gespeicherte Aufgabe ist. Der Rückgabewert der Aufgabe oder jede von ihr geworfene Ausnahme wird im gemeinsamen Zustand von * this gespeichert.

Der gemeinsame Zustand wird erst bereit gemacht, nachdem der aktuelle Thread beendet ist und alle Objekte mit Thread-Local-Speicherdauer zerstört wurden.

Inhaltsverzeichnis

Parameter

args - die beim Aufruf der gespeicherten Aufgabe zu übergebenden Parameter

Rückgabewert

(keine)

Ausnahmen

std::future_error bei den folgenden Fehlerbedingungen:

  • Die gespeicherte Aufgabe wurde bereits aufgerufen. Die Fehlerkategorie ist auf promise_already_satisfied gesetzt.
  • * this hat keinen gemeinsamen Zustand. Die Fehlerkategorie ist auf no_state gesetzt.

Beispiel

#include <chrono>
#include <functional>
#include <future>
#include <iostream>
#include <memory>
#include <thread>
#include <utility>
struct ProgramState
{
    std::packaged_task<void()> task;
    std::future<void> future;
    std::thread worker;
};
static void worker(std::shared_ptr<ProgramState> state)
{
    state->task.make_ready_at_thread_exit(); // execute task right away
    auto status = state->future.wait_for(std::chrono::seconds(0));
    if (status == std::future_status::timeout)
        std::cout << "worker: future is not ready yet\n";
    else
        std::cout << "worker: future is ready\n";
    std::cout << "worker: exit\n";
}
static std::shared_ptr<ProgramState> create_state()
{
    auto state = std::make_shared<ProgramState>();
    state->task = std::packaged_task<void()>{[]
    {
        std::cout << "task: executed\n";
    }};
    state->future = state->task.get_future();
    state->worker = std::thread{worker, state};
    return state;
}
int main()
{
    auto state = create_state();
    state->worker.join();
    std::cout << "main: worker finished\n";
    auto status = state->future.wait_for(std::chrono::seconds(0));
    if (status == std::future_status::timeout)
        std::cout << "main: future is not ready yet\n";
    else
        std::cout << "main: future is ready\n";
}

Ausgabe:

task: executed
worker: future is not ready yet
worker: exit
main: worker finished
main: future is ready

Siehe auch

führt die Funktion aus
(öffentliche Elementfunktion)