Просмотр исходного кода

docs: Update documentation for SDL_stack_free.

Reference Issue #15727.

(cherry picked from commit 098a066f202c87014f783c2730610aa7ed913e50)
Ryan C. Gordon 16 часов назад
Родитель
Сommit
543072cd50
1 измененных файлов с 4 добавлено и 3 удалено
  1. 4 3
      include/SDL3/SDL_stdinc.h

+ 4 - 3
include/SDL3/SDL_stdinc.h

@@ -1290,8 +1290,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.
  *
@@ -1303,7 +1304,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))