(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

a a pointer to an SDL_AtomicInt variable to be modified
oldval the old value
newval the new value

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!

Version

This function is available since SDL 3.0.0.

See Also


CategoryAPI, CategoryAPIFunction, CategoryAtomic