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

SDL_AtomicAdd

Add to an atomic variable.

Header File

Defined in <SDL3/SDL_atomic.h>

Syntax

int SDL_AtomicAdd(SDL_AtomicInt *a, int v);

Function Parameters

a a pointer to an SDL_AtomicInt variable to be modified
v the desired value to add

Return Value

Returns the previous value of the atomic variable.

Remarks

This function also acts as a full memory barrier.

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

CategoryAPI, CategoryAPIFunction, CategoryAtomic