|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Initialize a condition variable
#include <pthread.h> pthread_cond_t cond = PTHREAD_COND_INITIALIZER; int pthread_cond_init( pthread_cond_t* cond, pthread_condattr_t* attr );
- A pointer to the pthread_cond_t object that you want to initialize.
- NULL, or a pointer to a pthread_condattr_t object that specifies the attributes that you want to use for the condvar. For more information, see pthread_condattr_init().
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The pthread_cond_init() function initializes the condition variable cond with the attributes in the condition variable attribute object attr. If attr is NULL, cond is initialized with the default values for the attributes.
If the condition variable is statically allocated, you can initialize it with the default attribute values by assigning to it the macro PTHREAD_COND_INITIALIZER.
Condition variables have at least the following attributes defined:
- The condition variable can only be accessed by threads created within the same process as the thread that initialized the condition variable.
- Any thread that has access to the memory where the condition variable is allocated can access the condition variable.
- All kernel synchronization objects are in use.
- Previously initialized condition variable, cond, hasn't been destroyed.
- A fault occurred when the kernel tried to access cond or attr.
- The value specified by cond is invalid.