NAME

       SDL_stack_alloc - Allocate memory on the stack (maybe).

SYNOPSIS

       #include <SDL3/SDL_stdinc.h>

       #define SDL_stack_alloc(type, count)    (type*)alloca(sizeof(type)*(count))

DESCRIPTION

       If  SDL  knows  how  to  access alloca() on the current platform, it will use it to stack-allocate memory
       here. If it doesn't, it will use SDL_malloc() to heap-allocate memory.

       Since this might not be stack memory at all, it's important that you check the returned pointer for NULL,
       and that you call SDL_stack_free on the memory when done with it. Since this might be stack memory,  it's
       important  that  you don't allocate large amounts of it, or allocate in a loop without returning from the
       function, so the stack doesn't overflow.

MACRO PARAMETERS

       type   the datatype of the memory to allocate.

       count  the number of type objects to allocate.

RETURN VALUE

       Returns newly-allocated memory, or NULL on failure.

THREAD SAFETY

       It is safe to call this macro from any thread.

AVAILABILITY

       This macro is available since SDL 3.2.0.

SEE ALSO

       SDL_stack_free(3)

Simple Directmedia Layer                           SDL 3.2.26                                 SDL_stack_alloc(3)