pthread_cond_destroy

Deletes a condition variable.

Syntax

pthread_cond_destroy( cond );

Argument Data Type Access

cond opaque pthread_cond_t read

C Binding

int
pthread_cond_destroy (
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 broadcasted 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 completion. -1 [EINVAL] The value specified by cond is invalid. -1 [EBUSY] A thread is currently executing a pthread_cond_wait or pthread_cond_ timedwait on the condition variable specified in cond.