SDL_AddAtomicU32(3)

📦
version 3.4.18 · 5 versions
, in fedora 43, fedora 44

💖 SDL_AddAtomicU32 💖

okay so bestie, this is a page from the SDL3 FUNCTIONS manual, and today's main character is SDL_AddAtomicU32 — she adds to an atomic variable, she's booked, she's busy, she's thriving. ✨

🌸 NAME 🌸

SDL_AddAtomicU32 — add to an atomic variable. that's it, that's the job, and she does it flawlessly fr fr 💅

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_atomic.h>

Uint32 SDL_AddAtomicU32(SDL_AtomicU32 *a, int v);

🦋 DESCRIPTION 🦋

So like, this function adds a value to an atomic variable, yes, but plot twist: it also acts as a full memory barrier. 👑 she's doing two jobs and not even breaking a sweat.

⚠️ Note: if you don't know what this function is for, you shouldn't use it! not me being dramatic but seriously — this is not a "vibes only, figure it out later" situation. if it's not for you, it's not for you, and that's okay. 🙈

✨ FUNCTION PARAMETERS ✨

  • a — a pointer to an SDL_AtomicU32 variable that's about to be modified. she's getting a lil glow-up, a lil edit. 💖
  • v — the desired value to add or subtract. yes, subtract — drop a negative in there and she goes the other way, no cap. 🌈

💜 RETURN VALUE 💜

Returns the previous value of the atomic variable. not the new one, bestie — the one from before the math happened. the way that it hands you the past and keeps the future… iconic. 😭

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. any of them. all of them. every single one. she said "come through, everyone's invited" 🫶✨

⭐ AVAILABILITY ⭐

This function is available since SDL 3.4.0. so if you're on something older… yeah, she's not there yet. 💀

Simple Directmedia Layer made this, it's SDL 3.4.18 era, and this page is dated like the original header says — SDL_AddAtomicU32(3), mwah 💋 slay, bye bestie! 🎀🦋💖

📦 where this page comes from