std::shared_future<T>:: wait_for

Wartet, bis das Ergebnis verfügbar wird. Blockiert bis zur Ablauf der angegebenen timeout_duration oder bis das Ergebnis verfügbar wird, je nachdem, was zuerst eintritt. Der Rückgabewert identifiziert den Zustand des Ergebnisses.

Wenn die Zukunft das Ergebnis eines Aufrufs von std::async ist, der verzögerte Auswertung verwendete, kehrt diese Funktion sofort zurück, ohne zu warten.

Diese Funktion kann aufgrund von Planungs- oder Ressourcenkonflikten länger blockieren als timeout_duration .

Der Standard empfiehlt, dass ein stabiler Taktgeber zur Messung der Dauer verwendet wird. Falls eine Implementierung stattdessen einen Systemtakt verwendet, kann die Wartezeit auch anfällig für Taktjustierungen sein.

Das Verhalten ist undefiniert, falls valid() vor dem Aufruf dieser Funktion false ist.

Parameter

Rückgabewert

Ausnahmen

Jede Ausnahme, die von clock, time_point oder duration während der Ausführung geworfen wird (von der Standardbibliothek bereitgestellte Uhren, Zeitpunkte und Dauern werfen niemals).

Hinweise

Die Implementierungen sind angehalten, den Fall zu erkennen, wenn valid == false vor dem Aufruf gilt und eine std::future_error mit einer Fehlerbedingung von std::future_errc::no_state zu werfen.

Beispiel

#include <chrono>
#include <future>
#include <iostream>
#include <thread>
using namespace std::chrono_literals;
int main()
{
    std::shared_future<int> future = std::async(std::launch::async, []()
    {
        std::this_thread::sleep_for(3s);
        return 8;
    });
    std::cout << "waiting...\n";
    std::future_status status;
    do
    {
        switch (status = future.wait_for(1s); status)
        {
            case std::future_status::deferred:
                std::cout << "deferred\n";
                break;
            case std::future_status::timeout:
                std::cout << "timeout\n";
                break;
            case std::future_status::ready:
                std::cout << "ready!\n";
                break;
        }
    }
    while (status != std::future_status::ready);
    std::cout << "result is " << future.get() << '\n';
}

waiting...
timeout
timeout
timeout
ready!
result is 8

Siehe auch