SDL_CAPABILITY(3)

πŸ’… SDL_CAPABILITY πŸ’…

okay bestie, welcome to the SDL_CAPABILITY page β€” it lives in the SDL3 FUNCTIONS corner of the manual and it's literally just a cute little wrapper around Clang thread safety analysis annotations. yes, fr fr. 🌸


πŸŽ€ NAME πŸŽ€

SDL_CAPABILITY β€” a wrapper around Clang thread safety analysis annotations. that's it, that's the whole vibe. no cap. ✨


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <SDL3/SDL_mutex.h>

#define SDL_CAPABILITY(x) \
  SDL_THREAD_ANNOTATION_ATTRIBUTE__(capability(x))

so you pull in SDL_mutex.h and then this macro does its one (1) job: it takes your x and hands it straight over to SDL_THREAD_ANNOTATION_ATTRIBUTE__(capability(x)). she's a middlewoman and she's thriving. πŸ‘‘


πŸ’– DESCRIPTION πŸ’–

ngl, the description is literally just a link. the whole lore lives over here:

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

go read it, it's giving ✨documentation✨. i'm not adding anything else because there is nothing else β€” the page said what it said and i respect it. 🫢


🌈 AVAILABILITY 🌈

this macro has been around since SDL 3.2.0. if your SDL is older than that, she simply does not exist for you yet. πŸ’€


heads up bestie: this page is short and it knows it. don't go looking for extra options or exit statuses, there are none. the facts are the facts. πŸ’…

mwah β€” that's the whole page!! brought to you by Simple Directmedia Layer, running on SDL 3.4.18, filed under SDL_CAPABILITY(3). stay annotated, stay thread-safe, ily πŸ§šπŸ’œ

πŸ“¦ where this page comes from