# SDL_TryLockMutex

Try to lock a mutex without blocking.

## Header File

Defined in [<SDL3/SDL_mutex.h>](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_mutex.h)

## Syntax

```c
bool SDL_TryLockMutex(SDL_Mutex *mutex);
```

## Function Parameters

|                          |           |                           |
| ------------------------ | --------- | ------------------------- |
| [SDL_Mutex](SDL_Mutex) * | **mutex** | the mutex to try to lock. |

## Return Value

(bool) Returns true on success, false if the mutex would block.

## Remarks

This works just like [SDL_LockMutex](SDL_LockMutex)(), but if the mutex is
not available, this function returns false immediately.

This technique is useful if you need exclusive access to a resource but
don't want to wait for it, and will return to it to try again later.

This function returns true if passed a NULL mutex.

## Thread Safety

It is safe to call this function from any thread.

## Version

This function is available since SDL 3.2.0.

## See Also

- [SDL_LockMutex](SDL_LockMutex)
- [SDL_UnlockMutex](SDL_UnlockMutex)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategoryMutex](CategoryMutex)

