FreeBSD Manual Pages
al_wait_cond(3) Library Functions Manual al_wait_cond(3) NAME al_wait_cond - Allegro 5 API SYNOPSIS #include <allegro5/allegro.h> void al_wait_cond(ALLEGRO_COND *cond, ALLEGRO_MUTEX *mutex) DESCRIPTION On entering this function, mutex must be locked by the calling thread. The function will atomically release mutex and block on cond. The function will return when cond is "signalled", acquiring the lock on the mutex in the process. Example of proper use: al_lock_mutex(mutex); while (something_not_true) { al_wait_cond(cond, mutex); } do_something(); al_unlock_mutex(mutex); The mutex should be locked before checking the condition, and should be rechecked al_wait_cond(3) returns. al_wait_cond(3) can return for other reasons than the condition becoming true (e.g. the process was signalled). If multiple threads are blocked on the condition variable, the condition may no longer be true by the time the second and later threads are un- blocked. Remember not to unlock the mutex prematurely. SEE ALSO al_wait_cond_until(3), al_broadcast_cond(3), al_signal_cond(3). Allegro reference manual al_wait_cond(3)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_wait_cond&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>