DOKK / manpages / debian 13 / libsdl3-doc / SDL_TryLockRWLockForReading.3.en
SDL_TryLockRWLockForReading(3) SDL3 FUNCTIONS SDL_TryLockRWLockForReading(3)

SDL_TryLockRWLockForReading - Try to lock a read/write lock _for reading_ without blocking.

Defined in SDL3/SDL_mutex.h

#include "SDL3/SDL.h"
bool SDL_TryLockRWLockForReading(SDL_RWLock *rwlock);

This works just like

SDL_LockRWLockForReading (), but if the rwlock is not available, then this function returns false immediately.

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

Trying to lock for read-only access can succeed if other threads are holding read-only locks, as this won't prevent access.

This function returns true if passed a NULL rwlock.

the rwlock to try to lock.

Returns true on success, false if the lock would block.

This function is available since SDL 3.2.0.

(3), SDL_LockRWLockForReading(3), (3), SDL_TryLockRWLockForWriting(3), (3), SDL_UnlockRWLock(3)

SDL 3.2.10 Simple Directmedia Layer