SDL_TellIO(3)

💖 SDL_TellIO(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_TellIO ✨ she's the one who tells you where you're at in a stream. literally your emotional support offset reader 🫶

---

🌸 NAME 🌸

SDL_TellIO — figure out the current read/write offset inside an SDL_IOStream data stream. yes, like a little "you are here" map but for bytes 🗺️✨

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_iostream.h>

Sint64 SDL_TellIO(SDL_IOStream *context);

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ SDL_TellIO is actually a wrapper function — she's not out here doing the work herself, she's calling the SDL_IOStream's seek method with an offset of 0 bytes from SDL_IO_SEEK_CUR, purely to make your application development life easier. no cap, that's the whole bit 💅

like. she's the friend who forwards your text to the right group chat. iconic behaviour honestly 👑

---

💜 FUNCTION PARAMETERS 💜

• context — an SDL_IOStream data stream object, aka the lil stream you wanna get the current offset from. bestie, this is the one you're asking "where r u" 🌈

---

⭐ RETURN VALUE ⭐

Returns the current offset in the stream, or -1 if that information cannot be determined 😭 (yes, -1 is the "idk her" of return values).

---

🔥 THREAD SAFETY 🔥

Do NOT use the same SDL_IOStream from two threads at once. 🚫🧵 she is not built for that kind of chaos, and honestly? same.

---

🌈 AVAILABILITY 🌈

this function has been available since SDL 3.2.0 ✨ so if you're on anything older, she hasn't been born yet, sorry bestie 🙈

---

👑 SEE ALSO 👑

• SDL_SeekIO(3) — her sister, the one who actually does the seeking 💖 go say hi

---

Simple Directmedia Layer 🎀 SDL 3.4.18 — that's the source and version, babes, straight from the footer, love u, drink water, go check your stream offsets 💅🦋✨