SDL_ASSERT_SHARED_CAPABILITY(3)

💖 SDL_ASSERT_SHARED_CAPABILITY 💖

okay bestie, so we're in the SDL3 part of the manual, and this one is literally a macro called SDL_ASSERT_SHARED_CAPABILITY. it's not a function you call, it's not a vibe you feel — it's a lil wrapper that hands your code over to Clang's thread safety analysis annotations. that's it, that's the whole girl. 🎀

---

✨ NAME ✨

SDL_ASSERT_SHARED_CAPABILITY — a wrapper around Clang thread safety analysis annotations. no cap, that's genuinely all she does.

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_mutex.h>

#define SDL_ASSERT_SHARED_CAPABILITY(x) \
  SDL_THREAD_ANNOTATION_ATTRIBUTE__(assert_shared_capability(x))

so you pull in SDL_mutex.h and the macro does its lil handoff to SDL_THREAD_ANNOTATION_ATTRIBUTE__, which passes assert_shared_capability(x) along to Clang. chef's kiss. 💅

---

🦋 DESCRIPTION 🦋

okay so here's the tea: the docs for this one are not in here, they're over on the Clang side. go read:

https://clang.llvm.org/docs/ThreadSafetyAnalysis.html#mutex-h

that link is the whole explanation, fr fr. it's giving "read the upstream docs, bestie." 📚

---

⭐ AVAILABILITY ⭐

this macro has been around since SDL 3.2.0. so if you're on anything older, sorry babe, she's not there yet. 💀

---

heads up: this is a thread-safety annotation thing — it's about telling the compiler what you know so it can yell at you nicely. don't skip the Clang link, it's the main character here. 👑

---

and that's the page!! 🌈 go forth and annotate responsibly, my love. 🫶

Simple Directmedia Layer · SDL 3.4.18 · SDL_ASSERT_SHARED_CAPABILITY(3) — mwah, bye bestie! 💖✨🎀🦋🌸💅