DOKK / manpages / debian 13 / libsdl3-doc / SDL_ALLOC_SIZE.3.en
SDL_ALLOC_SIZE(3) SDL3 FUNCTIONS SDL_ALLOC_SIZE(3)

SDL_ALLOC_SIZE - A macro to tag a function as returning a certain allocation.

Defined in SDL3/SDL_begin_code.h

#include "SDL3/SDL.h"
#define SDL_ALLOC_SIZE(p) __attribute__((alloc_size(p)))

This is a hint to the compiler that a function allocates and returns a specific amount of memory based on one of its arguments. For example, the C runtime's malloc() function could use this macro with an argument of 1 (first argument to malloc is the size of the allocation).

On compilers without alloc_size support, this is defined to nothing.

Most apps don't need to, and should not, use this directly.

This macro is available since SDL 3.2.0.

SDL 3.2.10 Simple Directmedia Layer