SDL_WriteS8(3)

💖 SDL_WriteS8 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual — yes, THE SDL, the Simple Directmedia Layer girlies 🎀 — and today's main character is SDL_WriteS8. She's a little one-byte queen and she's about to eat. ✨

---

🌸 NAME 🌸

SDL_WriteS8 — use this function to write a signed byte to an SDL_IOStream. that's it. that's the whole job. and she does it flawlessly. 💅

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_iostream.h>

bool SDL_WriteS8(SDL_IOStream *dst, Sint8 value);

no cap, that's the whole signature. short. iconic. efficient. 👑

---

🎀 FUNCTION PARAMETERS 🎀

• dst — the SDL_IOStream you're writing to. this is where the byte goes, bestie, so like… pick a good one 🫶
• value — the byte value to write. literally just the byte. that's her moment. ⭐

---

✨ RETURN VALUE ✨

Returns true on successful write, or false on failure. if it fails, do NOT just sit there spiralling — call SDL_GetError() for more information, she'll tell you what went wrong 😭

---

🔥 THREAD SAFETY 🔥

Do not use the same SDL_IOStream from two threads at once.

fr fr. one stream, one thread at a time. sharing is caring everywhere EXCEPT here. 💀

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. she's been around. she's established. she's not new here. 👑

---

🧚 that's the whole page bestie 🧚

go forth and write your signed bytes, you absolute legend. 💜

— mwah, this was Simple Directmedia Layer, SDL 3.4.18, and the page is dated in that SDL_WriteS8(3) era 🍓✨ slay responsibly 💖