SDL_INVALID_UNICODE_CODEPOINT(3)

💖 SDL_INVALID_UNICODE_CODEPOINT 💖

okay so bestie, welcome to the SDL3 FUNCTIONS manual, and today's main character is literally just a lil macro that holds the Unicode REPLACEMENT CHARACTER codepoint. yes, that one. the "something went wrong but we're being polite about it" character. iconic behavior tbh 🎀

---

✨ NAME ✨

SDL_INVALID_UNICODE_CODEPOINT — the Unicode REPLACEMENT CHARACTER codepoint. that's it. that's the whole job. she's a constant, she's lowkey famous, she's giving "i contain multitudes (of broken bytes)" 💅

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_stdinc.h>

#define SDL_INVALID_UNICODE_CODEPOINT 0xFFFD

no cap, that's the entire vibe. one include, one define, zero drama. 🫶

---

🌸 DESCRIPTION 🌸

so when SDL_StepUTF8() and SDL_StepBackUTF8() are out here doing their lil walks through a UTF-8 string and they hit encoding errors, they don't just ghost you — they report this codepoint. like, "hey bestie, something's wrong with the bytes, here's the replacement character, carry on." 💀

and here's the fun part: this tends to render as something like a question mark in most places. so if you've ever seen a mysterious ? where a letter should be, congrats, you've met her. it's giving mystery, it's giving chaos, it's giving unreadable text energy 😭

---

⭐ AVAILABILITY ⭐

this macro is available since SDL 3.2.0. so if you're on anything older, she simply has not made her debut yet. respect the timeline bestie 🕰️✨

---

👑 SEE ALSO 👑

• SDL_StepBackUTF8(3)
• SDL_StepUTF8(3)

go read those too, they're the ones actually doing the stepping and reporting. this macro is just the codepoint they point at. iykyk 🌈

---

and that's the whole page, no notes 💜 brought to you by Simple Directmedia Layer, version SDL 3.4.18. mwah, go forth and handle your encoding errors with grace, bestie 🎀🦋✨