pthread_cond_destroy(3thr)pthread_cond_destroy(3thr)Namepthread_cond_destroy - Deletes a condition variable.
Syntax
#include <pthread.h>
int pthread_cond_destroy (cond)
pthread_cond_t *cond;
Arguments
cond Condition variable deleted.
Description
This routine deletes a condition variable. Call this routine when a
condition variable will no longer be referenced. The effect of calling
this routine is to give permission to reclaim storage for the condition
variable.
The results of this routine are unpredictable if the condition variable
specified in cond does not exist.
The results of this routine are also unpredictable if there are threads
waiting for the specified condition variable to be signaled or broad‐
cast when it is deleted.
Return Values
If an error condition occurs, this routine returns -1 and sets errno to
the corresponding error value. Possible return values are as follows.
Return Error Description
0 Successful comple‐
tion.
-1 [EINVAL] The value specified
by cond is invalid.
-1 [EBUSY] A thread is cur‐
rently executing a
pthread_cond_wait
or
pthread_cond_timed‐
wait on the condi‐
tion variable spec‐
ified in cond.
pthread_cond_destroy(3thr)