SDL_WriteU64BE(3)

💾 SDL_WriteU64BE(3) 💾

okay bestie so we're deep in the SDL3 FUNCTIONS section of the manual and this one is literally all about yeeting a 64-bit number into a stream, big-endian style. no cap. 🦋

---

✨ NAME ✨

SDL_WriteU64BE — use this function to write 64 bits in native format to an SDL_IOStream as big-endian data.

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_iostream.h>

bool SDL_WriteU64BE(SDL_IOStream *dst, Uint64 value);

💅 DESCRIPTION 💅

okay so here's the tea: SDL byteswaps the data only if necessary. which means you the application always get to hand it over in native format — your regular everyday vibes — and SDL handles the glow-up so that what actually lands in the stream is in big-endian</big-endian> format. it's giving effortless. it's giving main character energy. periodt. 👑

🎀 FUNCTION PARAMETERS 🎀

• dst — the stream to which data will be written. that's the destination, the place we're sending the bits to, the whole point basically 🫶
• value — the data to be written, in native format. yes bestie, native. don't you dare pre-swap it, SDL's got it. 💖

⭐ RETURN VALUE ⭐

Returns true on successful write or false on failure. and if it fails?? call SDL_GetError() for more information, because you deserve to know what went wrong. 😭

not the silent false... always check, bestie, always check. 🙈

🔥 THREAD SAFETY 🔥

Do not use the same SDL_IOStream from two threads at once. nope. nope nope nope. that's the one rule. sharing is not caring here, it's chaos. 💀

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on something older... yeah, it's not gonna be there. 😌

---

and that's the whole page, you're welcome, go write some big-endian bytes and slay ✨

mwah 💋 this has been Simple Directmedia Layer, SDL 3.4.18, for SDL_WriteU64BE(3) — see you in the next manpage, bestie 🎀