SDL_SetAtomicInt(3)

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

💅 NAME 💅

okay bestie, gather round — SDL_SetAtomicInt is the one that sets an atomic variable to a value. that's it. that's the whole job. she's simple, she's powerful, she's iconic. 🎀

✨ SYNOPSIS ✨

#include <SDL3/SDL_atomic.h>

int SDL_SetAtomicInt(SDL_AtomicInt *a, int v);

like. look at her. two args, one return, zero drama. 🦋

🌸 DESCRIPTION 🌸

so basically this function also acts as a full memory barrier. that part is lowkey the whole point, bestie — it's not just "assign a number," it's "assign a number and make sure everything before and after plays nice in the right order." main character behavior, no cap. 💅

Note: If you don't know what this function is for, you shouldn't use it! 😭 fr fr, this is not the vibe-check-and-see option. if you have to ask, the answer is no.

🫶 FUNCTION PARAMETERS 🫶

  • a — a pointer to an SDL_AtomicInt variable to be modified. that's the glow-up target. ✨
  • v — the desired value. the new fit. the makeover. 👑

🔥 RETURN VALUE 🔥

Returns the previous value of the atomic variable. she gives you receipts, okay? so you always know what it was before you changed it. very considerate of her honestly. 💖

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. every thread. all of them. they can all pull up at the same time and it's fine. 🧚✨

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on anything older, bestie, it's giving "not in your version." 😭 upgrade era.

👑 SEE ALSO 👑

  • SDL_GetAtomicInt(3) — the other half of the duo. read the value, write the value, slay the value. 🎀

kisses and full memory barriers, babes — this lil page came from Simple Directmedia Layer, running SDL 3.4.18. go forth and atomically set ur ints, you gorgeous little multithreaded gremlin 🦋💜🌸

📦 where this page comes from