docs: Update documentation for SDL_stack_free.

Reference Issue #15727.
This commit is contained in:
Ryan C. Gordon 2026-05-30 22:49:38 -04:00
parent 67e6f5b7ee
commit 098a066f20
No known key found for this signature in database
GPG key ID: FA148B892AB48044

View file

@ -1302,8 +1302,9 @@ extern "C" {
/**
* Free memory previously allocated with SDL_stack_alloc.
*
* If SDL used alloca() to allocate this memory, this macro does nothing and
* the allocated memory will be automatically released when the function that
* If SDL used alloca() to allocate this memory, this macro does nothing (other
* than insert `((void)(data)` so the compiler sees an expression) and the
* allocated memory will be automatically released when the function that
* called SDL_stack_alloc() returns. If SDL used SDL_malloc(), it will
* SDL_free the memory immediately.
*
@ -1315,7 +1316,7 @@ extern "C" {
*
* \sa SDL_stack_alloc
*/
#define SDL_stack_free(data)
#define SDL_stack_free(data) ((void)(data))
#elif !defined(SDL_DISABLE_ALLOCA)
#define SDL_stack_alloc(type, count) (type*)alloca(sizeof(type)*(count))
#define SDL_stack_free(data) ((void)(data))