SDL_SetMemoryFunctions - Man Page

Replace SDL's memory allocation functions with a custom set.

Header File

Defined in SDL3/SDL_stdinc.h

Synopsis

#include "SDL3/SDL.h"

bool SDL_SetMemoryFunctions(SDL_malloc_func malloc_func,
                                SDL_calloc_func calloc_func,
                                SDL_realloc_func realloc_func,
                                SDL_free_func free_func);

Description

It is not safe to call this function once any allocations have been made, as future calls to SDL_free
will use the new allocator, even if they came from an SDL_malloc
made with the old one!

If used, usually this needs to be the first call made into the SDL library, if not the very first thing done at program startup time.

Function Parameters

malloc_func

custom malloc function.

calloc_func

custom calloc function.

realloc_func

custom realloc function.

free_func

custom free function.

Return Value

Returns true on success or false on failure; call

SDL_GetError () for more information.

Thread Safety

It is safe to call this function from any thread, but one should not replace the memory functions once any allocations are made!

Availability

This function is available since SDL 3.2.0.

See Also

·(3), SDL_GetMemoryFunctions(3), ·(3), SDL_GetOriginalMemoryFunctions(3)

Referenced By

SDL_calloc_func.3type(3), SDL_free_func.3type(3), SDL_GetMemoryFunctions(3), SDL_malloc_func.3type(3), SDL_realloc_func.3type(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS