# mtx_unlock

> C++ Atlas: `cppatlas.com/w/c/thread/mtx_unlock` | Source: https://en.cppreference.com/w/c/thread/mtx_unlock | Domain: Concurrency support | Standards: C11

Unlocks the mutex pointed to by mutex.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <threads.h>
int mtx_unlock( mtx_t *mutex ); // (since C11)
```

Unlocks the mutex pointed to by `mutex`.

The behavior is undefined if the mutex is not locked by the calling thread.

This function *synchronizes-with* subsequent `mtx_lock`, `mtx_trylock`, or `mtx_timedlock` on the same mutex. All lock/unlock operations on any given mutex form a single total order (similar to the modification order of an atomic).

### Parameters

- `mutex` - pointer to the mutex to unlock

### Return value

`thrd_success` if successful, `thrd_error` otherwise.

### References

- C17 standard (ISO/IEC 9899:2018):

  - 7.26.4.6 The mtx_unlock function (p: 279)

- C11 standard (ISO/IEC 9899:2011):

  - 7.26.4.6 The mtx_unlock function (p: 382)

### See also

- [`mtx_lock`](https://en.cppreference.com/w/c/thread/mtx_lock) (C11): blocks until locks a mutex (function)
- [`mtx_timedlock`](https://en.cppreference.com/w/c/thread/mtx_timedlock) (C11): blocks until locks a mutex or times out (function)
- [`mtx_trylock`](https://en.cppreference.com/w/c/thread/mtx_trylock) (C11): locks a mutex or returns without blocking if already locked (function)
- [C++ documentation for `mutex::unlock`](https://en.cppreference.com/w/cpp/thread/mutex/unlock)
- [C++ documentation for `timed_mutex::unlock`](https://en.cppreference.com/w/cpp/thread/timed_mutex/unlock)
- [C++ documentation for `recursive_mutex::unlock`](https://en.cppreference.com/w/cpp/thread/recursive_mutex/unlock)
- [C++ documentation for `recursive_timed_mutex::unlock`](https://en.cppreference.com/w/cpp/thread/recursive_timed_mutex/unlock)

---
Attribution: content from https://en.cppreference.com/w/c/thread/mtx_unlock (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.