std::condition_variable::wait
 |
This page has been machine-translated from the English version of the wiki using Google Translate.
The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here. |
<metanoindex/>
<tbody> </tbody> void wait( std::unique_lock<std::mutex>& lock ); |
(1) | (seit C++11) |
template< class Predicate > void wait( std::unique_lock<std::mutex>& lock, Predicate pred ); |
(2) | (seit C++11) |
wait blockiert den aktuellen Thread, bis die condition-Variable benachrichtigt wird oder ein spurious wakeup auftritt, optional wird eine Schleife durchlaufen, bis die Bedingung pred erfüllt ist.
1) lock wird atomar freigegeben, der aktuell ausführende Thread wird blockiert und zur Liste der Threads hinzugefügt, die auf *this warten. Der Thread wird freigegeben, wenn notify_all() oder notify_one() ausgeführt wird. Er kann auch fälschlicherweise entsperrt werden (spurious wakeup). Wenn der Thread freigegeben wird, unabhängig vom Grund, wird lock zurückerworben und wait beendet. Wenn diese Funktion durch eine Ausnahme verlassen wird (exception), dann wird lock auch zurückerworben.
2)
You can help to correct and verify the translation. Click here for instructions.
while (!pred()) { wait(lock); }
Diese Überladung kann verwendet werden, um spurious wakeups zu behandeln, während auf das Eintreten der Bedingung pred gewartet wird.
Parameter
| lock | - | ein Objekt des Typs
std::unique_lock<std::mutex>, die durch den aktuellen Thread gesperrt werden mussOriginal: an object of type std::unique_lock<std::mutex>, which must be locked by the current threadThe text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
| pred | - | predicate which returns false wenn das Warten sollte fortgesetzt werden . Original: if the waiting should be continued The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. The signature of the predicate function should be equivalent to the following:
|
Rückgabewert
You can help to correct and verify the translation. Click here for instructions.
Ausnahmen
lock.lock() geworfen oder lock.unlock() .You can help to correct and verify the translation. Click here for instructions.
Notes
lock.mutex() nicht durch den aktuellen Thread gesperrt ist undefiniert .lock.mutex() is not locked by the current thread is undefined behavior.You can help to correct and verify the translation. Click here for instructions.
lock.mutex() nicht das gleiche Mutex als ein von allen anderen Threads, wartet derzeit auf der gleichen Bedingung variabel ist undefiniert verwendet .lock.mutex() is not the same mutex as the one used by all other threads that are currently waiting on the same condition variable is undefined behavior.You can help to correct and verify the translation. Click here for instructions.
Beispiel
#include <iostream>
#include <condition_variable>
#include <thread>
#include <chrono>
std::condition_variable cv;
std::mutex cv_m;
int i = 0;
void waits()
{
std::unique_lock<std::mutex> lk(cv_m);
std::cerr << "Waiting... \n";
cv.wait(lk, [](){return i == 1;});
std::cerr << "...finished waiting. i == 1\n";
}
void signals()
{
std::this_thread::sleep_for(std::chrono::seconds(1));
std::cerr << "Notifying...\n";
cv.notify_all();
std::this_thread::sleep_for(std::chrono::seconds(1));
i = 1;
std::cerr << "Notifying again...\n";
cv.notify_all();
}
int main()
{
std::thread t1(waits), t2(waits), t3(waits), t4(signals);
t1.join();
t2.join();
t3.join();
t4.join();
}
Output:
Waiting...
Waiting...
Waiting...
Notifying...
Notifying again...
...finished waiting. i == 1
...finished waiting. i == 1
...finished waiting. i == 1
Siehe auch
Blockiert den aktuellen Thread, bis die condition variable geweckt wird oder die angegebenene Zeitspanne abgelaufen ist Original: blocks the current thread until the condition variable is woken up or after the specified timeout duration The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (öffentliche Elementfunktion) | |
Blockiert den aktuellen Thread, bis die condition variable geweckt wird oder bis der angegebenene Zeitpunkt erreicht wurde Original: blocks the current thread until the condition variable is woken up or until specified time point has been reached The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (öffentliche Elementfunktion) | |