<condition_variable>

Definiert die Klassen condition_variable und condition_variable_any, mit denen die Objekte erstellt werden, die auf das Eintreten einer Bedingung warten.

Für diesen Header wird "Concurrency Runtime (ConcRT)" verwendet, sodass er zusammen mit anderen ConcRT-Mechanismen verwendet werden kann. Weitere Informationen finden Sie unter Concurrency Runtime.

Anforderungen

Header:<condition_variable>

Namespace: std

Hinweis

In Code, der mithilfe von /clr kompiliert wird, wird dieser Header blockiert.

Hinweise

Code, der auf eine Bedingungsvariable wartet, muss auch einen mutex verwenden. Ein aufrufender Thread muss den mutex vor dem Aufrufen der Funktionen, die auf die Bedingungsvariable warten, sperren. Der mutex ist dann gesperrt, wenn die aufgerufene Funktion zurückgegeben wird. Die mutex ist nicht gesperrt, während der Thread auf das Eintreten der Bedingung wartet. Damit keine unvorhersehbaren Ergebnisse produziert werden, muss jeder Thread, der auf eine Bedingungsvariable wartet, das gleiche mutex Objekt verwenden.

Objekte vom Typ condition_variable_any können mit einem Mutex eines beliebigen Typs verwendet werden. Der Typ des verwendeten Mutex muss keine try_lock-Methode angeben. Objekte vom Typ condition_variable können ausschließlich mit einem Mutex des Typs unique_lock<mutex> verwendet werden. Objekte dieses Typs sind möglicherweise schneller als Objekte vom Typ condition_variable_any<unique_lock<mutex>>.

Sie warten auf ein Ereignis, indem Sie zuerst den Mutex sperren und anschließend eine der wait-Methoden auf der Bedingungsvariablen aufrufen. Der wait-Aufruf wird so lange gesperrt, bis ein anderer Thread die Bedingungsvariable signalisiert.

Spurious Wakeups treten auf, wenn die Threads, die auf die Bedingungsvariable warten, ohne geeignete Benachrichtigungen entsperrt werden. Ein solches fälschliches Aufwecken kann durch den Code, der auf das Eintreten der Bedingung wartet, erkannt werden. Dazu muss er jedoch prüfen, ob die Bedingung, auf die er wartet, tatsächlich eingetreten ist. Dies erfolgt in der Regel mithilfe einer Schleife. Verwenden Sie wait(unique_lock<mutex>& lock, Predicate pred), um diese Schleife für Sie durchzuführen.

while (condition is false)
    wait for condition variable;

Die condition_variable_any- und condition_variable- Klassen verfügen über drei Methoden, um auf eine Bedingung zu warten.

  • wait wartet für einen unbegrenzten Zeitraum.

  • wait_until wartet, bis einem angegebenen Zeitpunkt (time).

  • wait_for wartet, bis zu einer angegebenen Dauer (time interval).

Jede dieser Methoden verfügt über zwei überladene Versionen. Eine davon wartet einfach und kann fälschlicherweise aufwachen. Die andere verwendet ein zusätzliches Vorlagenargument, das ein Prädikat definiert. Die Methode gibt erst dann zurück, wenn das Prädikat den Wert true hat.

Jede Klasse verfügt auch über zwei Methoden, mit denen eine Bedingungsvariable benachrichtigt wird, dass die Bedingung den Wert true hat.

  • notify_one weckt einen der Threads auf, der auf die Bedingungsvariable wartet.

  • notify_all weckt alle Threads auf, die auf die Bedingungsvariable warten.

Funktionen und Enumerationen

void notify_all_at_thread_exit(condition_variable& cond, unique_lock<mutex> lk);

enum class cv_status { no_timeout, timeout };

Siehe auch

Headerdateienreferenz
condition_variable-Klasse
condition_variable_any-Klasse