std::condition_variable_any:: wait
|
template
<
class
Lock
>
void wait ( Lock & lock ) ; |
(1) | (desde C++11) |
|
template
<
class
Lock,
class
Predicate
>
void wait ( Lock & lock, Predicate pred ) ; |
(2) | (desde C++11) |
|
template
<
class
Lock,
class
Predicate
>
bool wait ( Lock & lock, std:: stop_token stoken, Predicate pred ) ; |
(3) | (desde C++20) |
wait
hace que el hilo actual se bloquee hasta que la variable de condición sea notificada o ocurra un despertar espurio.
pred
puede proporcionarse opcionalmente para detectar despertar espurio.
wait ( lock ) ;
{
if ( pred ( ) )
return true ;
wait ( lock ) ;
}
return pred ( ) ;
Inmediatamente después de que
wait
retorne,
lock
está bloqueado por el thread llamador. Si esta postcondición no puede satisfacerse
[1]
, llama a
std::terminate
.
- ↑ Esto puede ocurrir si el re-bloqueo del mutex lanza una excepción.
Contenidos |
Parámetros
| lock | - | un lock que debe ser bloqueado por el hilo que llama |
| stoken | - | un stop token para registrar la interrupción |
| pred | - | el predicado para verificar si la espera puede completarse |
| Requisitos de tipo | ||
-
Lock
debe cumplir con los requisitos de
BasicLockable
.
|
||
-
Predicate
debe cumplir con los requisitos de
FunctionObject
.
|
||
|
-
|
||
Valor de retorno
Excepciones
Notas
El valor devuelto de la sobrecarga (3) indica si pred evaluó a true , independientemente de si se solicitó una parada o no.
Los efectos de
notify_one()
/
notify_all()
y cada una de las tres partes atómicas de
wait()
/
wait_for()
/
wait_until()
(desbloquear+esperar, despertar y bloquear) ocurren en un único orden total que puede verse como el
orden de modificación
de una variable atómica: el orden es específico de esta variable de condición individual. Esto hace imposible que
notify_one()
pueda, por ejemplo, retrasarse y desbloquear un hilo que comenzó a esperar justo después de que se realizara la llamada a
notify_one()
.
Ejemplo
#include <chrono> #include <condition_variable> #include <iostream> #include <thread> std::condition_variable_any cv; std::mutex cv_m; // Este mutex se utiliza para tres propósitos: // 1) sincronizar accesos a i // 2) sincronizar accesos a std::cerr // 3) para la variable de condición cv int i = 0; void waits() { std::unique_lock<std::mutex> lk(cv_m); std::cerr << "Esperando... \n"; cv.wait(lk, []{ return i == 1; }); std::cerr << "...finalizada la espera. i == 1\n"; } void signals() { std::this_thread::sleep_for(std::chrono::seconds(1)); { std::lock_guard<std::mutex> lk(cv_m); std::cerr << "Notificando...\n"; } cv.notify_all(); std::this_thread::sleep_for(std::chrono::seconds(1)); { std::lock_guard<std::mutex> lk(cv_m); i = 1; std::cerr << "Notificando de nuevo...\n"; } cv.notify_all(); } int main() { std::thread t1(waits), t2(waits), t3(waits), t4(signals); t1.join(); t2.join(); t3.join(); t4.join(); }
Salida posible:
Esperando... Esperando... Esperando... Notificando... Notificando de nuevo... ...finalizada la espera. i == 1 ...finalizada la espera. i == 1 ...finalizada la espera. i == 1
Informes de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento publicado | Comportamiento correcto |
|---|---|---|---|
|
LWG 2114
( P2167R3 ) |
C++11 | la convertibilidad a bool era demasiado débil para reflejar la expectativa de las implementaciones | requisitos fortalecidos |
| LWG 2135 | C++11 | el comportamiento no estaba claro si lock. lock ( ) lanza una excepción | llama a std::terminate en este caso |
Véase también
|
bloquea el hilo actual hasta que la variable de condición se active o después de la duración de tiempo de espera especificada
(función miembro pública) |
|
|
bloquea el hilo actual hasta que la variable de condición se active o hasta que se alcance el punto de tiempo especificado
(función miembro pública) |
|
|
C documentation
para
cnd_wait
|
|
Enlaces externos
| The Old New Thing artículo: Despertares espurios en variables de condición de Win32. |