(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_AtomicCompareAndSwap

Set an atomic variable to a new value if it is currently an old value.

Header File

Defined in <SDL3/SDL_atomic.h>

Syntax

SDL_bool SDL_AtomicCompareAndSwap(SDL_AtomicInt *a, int oldval, int newval);

Function Parameters

Return Value

Returns SDL_TRUE if the atomic variable was set, SDL_FALSE otherwise.

Remarks

Note: If you don't know what this function is for, you shouldn't use it!

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.0.0.

See Also

• SDL_AtomicCompareAndSwapPointer

CategoryAPI, CategoryAPIFunction, CategoryAtomic