# LibHTTP API Reference

### `httplib_pthread_cond_wait( cv, mutex );`

### Parameters

| Parameter | Type | Description |
| :--- | :--- | :--- |
|**`cv`**|`pthread_cond_t`|The condition to wait for|
|**`mutex`**|`pthread_mutex_t *`|The mutex to release when the condition is met|

### Return Value

| Type | Description |
| :--- | :--- |
|`int`|Integer value with a success or error code of the function call|

### Description

The platform independent function `httplib_pthread_cond_wait()` is used to wait for a specific condition to be met. After the condition is met, the specified mutex is unlocked. If the function succeeds, the value **0** is returned, otherwise the return value is an error code. On systems which support it, the functionality is implemented as a direct call to `pthread_cond_wait()`. Otherwise an OS dependent alternative function is called.

### See Also

* [`httplib_pthread_cond_broadcast();`](httplib_pthread_cond_broadcast.md)
* [`httplib_pthread_cond_destroy();`](httplib_pthread_cond_destroy.md)
* [`httplib_pthread_cond_init();`](httplib_pthread_cond_init.md)
* [`httplib_pthread_cond_signal();`](httplib_pthread_cond_signal.md)
* [`httplib_pthread_cond_timedwait();`](httplib_pthread_cond_timedwait.md)