SDL_MALLOC(3)

SDL_MALLOC3

A macro to tag a function as an allocator.

Usage

#include "SDL3/SDL.h"

#define SDL_MALLOC __declspec(allocator) __desclspec(restrict)

Header file

Defined in SDL3/SDL_begin_code.h

Overview

This is a hint to the compiler that a function is an allocator, like malloc(), with certain rules. A description of how GCC treats this hint is here:

https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-malloc-function-attribute

On compilers without allocator tag support, this is defined to nothing.

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

Availability

This macro is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.