SDL_Swap32(3)

💅 SDL_Swap32 💅

okay bestie, welcome to SDL_Swap32, straight outta the SDL3 FUNCTIONS lineup ✨ this one's short and sweet and honestly kind of iconic for it.

---

🌸 NAME 🌸

SDL_Swap32 — Byte-swap an unsigned 32-bit number. that's it. that's the whole job. she flips your bytes and she does NOT elaborate 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_endian.h>

SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x);

---

✨ DESCRIPTION ✨

okay so listen. this function will always byte-swap the value, no cap — whether it's currently in the native byteorder of the system or not. like, it does not check. it does not care. it just swaps. periodt.

which is exactly why, in most cases, you should be using SDL_Swap32LE or SDL_Swap32BE instead. those two are the responsible ones who actually look before they leap 🫶

💀 important lore alert: this is a forced-inline function in a header, NOT a public API function available in the SDL library. which is to say — the code is embedded in the calling program, and the linker and dynamic loader will not be able to find this function inside SDL itself. she lives in your binary now. no takebacks 🙈

---

🧚 FUNCTION PARAMETERS 🧚

• x — the value to byte-swap. hand her your lil 32-bit number and she'll hand it back flipped 💖

---

⭐ RETURN VALUE ⭐

Returns x, with its bytes in the opposite endian order. same number, new arrangement, main character energy 👑

---

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. go wild, gorl, every thread can have a turn 💜

---

🦋 AVAILABILITY 🦋

This function is available since SDL 3.2.0. if you're on anything older, sorry bestie, she hasn't been born yet 😭

---

okay that's the whole page, love that for us 🎀 mwah 💋

— Simple Directmedia Layer, SDL 3.4.18, and yes this was SDL_Swap32(3) the whole time. stream it, byte-swap responsibly, bye bestie 🫶✨