SDL 3.0
SDL_stdinc.h
Go to the documentation of this file.
1/*
2 Simple DirectMedia Layer
3 Copyright (C) 1997-2023 Sam Lantinga <slouken@libsdl.org>
4
5 This software is provided 'as-is', without any express or implied
6 warranty. In no event will the authors be held liable for any damages
7 arising from the use of this software.
8
9 Permission is granted to anyone to use this software for any purpose,
10 including commercial applications, and to alter it and redistribute it
11 freely, subject to the following restrictions:
12
13 1. The origin of this software must not be misrepresented; you must not
14 claim that you wrote the original software. If you use this software
15 in a product, an acknowledgment in the product documentation would be
16 appreciated but is not required.
17 2. Altered source versions must be plainly marked as such, and must not be
18 misrepresented as being the original software.
19 3. This notice may not be removed or altered from any source distribution.
20*/
21
22/**
23 * \file SDL_stdinc.h
24 *
25 * \brief This is a general header that includes C language support.
26 */
27
28#ifndef SDL_stdinc_h_
29#define SDL_stdinc_h_
30
32
33#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
34#include <inttypes.h>
35#endif
36#include <stdarg.h>
37#include <stdint.h>
38#include <wchar.h>
39
40#ifndef alloca
41# ifdef HAVE_ALLOCA_H
42# include <alloca.h>
43# elif defined(__GNUC__)
44# define alloca __builtin_alloca
45# elif defined(_MSC_VER)
46# include <malloc.h>
47# define alloca _alloca
48# elif defined(__WATCOMC__)
49# include <malloc.h>
50# elif defined(__BORLANDC__)
51# include <malloc.h>
52# elif defined(__DMC__)
53# include <stdlib.h>
54# elif defined(__AIX__)
55#pragma alloca
56# elif defined(__MRC__)
57void *alloca(unsigned);
58# else
59char *alloca();
60# endif
61#endif
62
63#ifdef SIZE_MAX
64# define SDL_SIZE_MAX SIZE_MAX
65#else
66# define SDL_SIZE_MAX ((size_t) -1)
67#endif
68
69/**
70 * Check if the compiler supports a given builtin.
71 * Supported by virtually all clang versions and recent gcc. Use this
72 * instead of checking the clang version if possible.
73 */
74#ifdef __has_builtin
75#define SDL_HAS_BUILTIN(x) __has_builtin(x)
76#else
77#define SDL_HAS_BUILTIN(x) 0
78#endif
79
80/**
81 * The number of elements in an array.
82 */
83#define SDL_arraysize(array) (sizeof(array)/sizeof(array[0]))
84#define SDL_TABLESIZE(table) SDL_arraysize(table)
85
86/**
87 * Macro useful for building other macros with strings in them
88 *
89 * e.g. #define LOG_ERROR(X) OutputDebugString(SDL_STRINGIFY_ARG(__FUNCTION__) ": " X "\n")
90 */
91#define SDL_STRINGIFY_ARG(arg) #arg
92
93/**
94 * \name Cast operators
95 *
96 * Use proper C++ casts when compiled as C++ to be compatible with the option
97 * -Wold-style-cast of GCC (and -Werror=old-style-cast in GCC 4.2 and above).
98 */
99/* @{ */
100#ifdef __cplusplus
101#define SDL_reinterpret_cast(type, expression) reinterpret_cast<type>(expression)
102#define SDL_static_cast(type, expression) static_cast<type>(expression)
103#define SDL_const_cast(type, expression) const_cast<type>(expression)
104#else
105#define SDL_reinterpret_cast(type, expression) ((type)(expression))
106#define SDL_static_cast(type, expression) ((type)(expression))
107#define SDL_const_cast(type, expression) ((type)(expression))
108#endif
109/* @} *//* Cast operators */
110
111/* Define a four character code as a Uint32 */
112#define SDL_FOURCC(A, B, C, D) \
113 ((SDL_static_cast(Uint32, SDL_static_cast(Uint8, (A))) << 0) | \
114 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (B))) << 8) | \
115 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (C))) << 16) | \
116 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (D))) << 24))
117
118/**
119 * \name Basic data types
120 */
121/* @{ */
122
123#ifdef __CC_ARM
124/* ARM's compiler throws warnings if we use an enum: like "SDL_bool x = a < b;" */
125#define SDL_FALSE 0
126#define SDL_TRUE 1
127typedef int SDL_bool;
128#else
129typedef enum
130{
132 SDL_TRUE = 1
134#endif
135
136/**
137 * \brief A signed 8-bit integer type.
138 */
139#define SDL_MAX_SINT8 ((Sint8)0x7F) /* 127 */
140#define SDL_MIN_SINT8 ((Sint8)(~0x7F)) /* -128 */
141typedef int8_t Sint8;
142/**
143 * \brief An unsigned 8-bit integer type.
144 */
145#define SDL_MAX_UINT8 ((Uint8)0xFF) /* 255 */
146#define SDL_MIN_UINT8 ((Uint8)0x00) /* 0 */
147typedef uint8_t Uint8;
148/**
149 * \brief A signed 16-bit integer type.
150 */
151#define SDL_MAX_SINT16 ((Sint16)0x7FFF) /* 32767 */
152#define SDL_MIN_SINT16 ((Sint16)(~0x7FFF)) /* -32768 */
153typedef int16_t Sint16;
154/**
155 * \brief An unsigned 16-bit integer type.
156 */
157#define SDL_MAX_UINT16 ((Uint16)0xFFFF) /* 65535 */
158#define SDL_MIN_UINT16 ((Uint16)0x0000) /* 0 */
159typedef uint16_t Uint16;
160/**
161 * \brief A signed 32-bit integer type.
162 */
163#define SDL_MAX_SINT32 ((Sint32)0x7FFFFFFF) /* 2147483647 */
164#define SDL_MIN_SINT32 ((Sint32)(~0x7FFFFFFF)) /* -2147483648 */
165typedef int32_t Sint32;
166/**
167 * \brief An unsigned 32-bit integer type.
168 */
169#define SDL_MAX_UINT32 ((Uint32)0xFFFFFFFFu) /* 4294967295 */
170#define SDL_MIN_UINT32 ((Uint32)0x00000000) /* 0 */
171typedef uint32_t Uint32;
172
173/**
174 * \brief A signed 64-bit integer type.
175 */
176#define SDL_MAX_SINT64 ((Sint64)0x7FFFFFFFFFFFFFFFll) /* 9223372036854775807 */
177#define SDL_MIN_SINT64 ((Sint64)(~0x7FFFFFFFFFFFFFFFll)) /* -9223372036854775808 */
178typedef int64_t Sint64;
179/**
180 * \brief An unsigned 64-bit integer type.
181 */
182#define SDL_MAX_UINT64 ((Uint64)0xFFFFFFFFFFFFFFFFull) /* 18446744073709551615 */
183#define SDL_MIN_UINT64 ((Uint64)(0x0000000000000000ull)) /* 0 */
184typedef uint64_t Uint64;
185
186/* @} *//* Basic data types */
187
188/**
189 * \name Floating-point constants
190 */
191/* @{ */
192
193#ifdef FLT_EPSILON
194#define SDL_FLT_EPSILON FLT_EPSILON
195#else
196#define SDL_FLT_EPSILON 1.1920928955078125e-07F /* 0x0.000002p0 */
197#endif
198
199/* @} *//* Floating-point constants */
200
201/* Make sure we have macros for printing width-based integers.
202 * <stdint.h> should define these but this is not true all platforms.
203 * (for example win32) */
204#ifndef SDL_PRIs64
205#ifdef PRIs64
206#define SDL_PRIs64 PRIs64
207#elif defined(__WIN32__) || defined(__GDK__)
208#define SDL_PRIs64 "I64d"
209#elif defined(__LP64__) && !defined(__APPLE__)
210#define SDL_PRIs64 "ld"
211#else
212#define SDL_PRIs64 "lld"
213#endif
214#endif
215#ifndef SDL_PRIu64
216#ifdef PRIu64
217#define SDL_PRIu64 PRIu64
218#elif defined(__WIN32__) || defined(__GDK__)
219#define SDL_PRIu64 "I64u"
220#elif defined(__LP64__) && !defined(__APPLE__)
221#define SDL_PRIu64 "lu"
222#else
223#define SDL_PRIu64 "llu"
224#endif
225#endif
226#ifndef SDL_PRIx64
227#ifdef PRIx64
228#define SDL_PRIx64 PRIx64
229#elif defined(__WIN32__) || defined(__GDK__)
230#define SDL_PRIx64 "I64x"
231#elif defined(__LP64__) && !defined(__APPLE__)
232#define SDL_PRIx64 "lx"
233#else
234#define SDL_PRIx64 "llx"
235#endif
236#endif
237#ifndef SDL_PRIX64
238#ifdef PRIX64
239#define SDL_PRIX64 PRIX64
240#elif defined(__WIN32__) || defined(__GDK__)
241#define SDL_PRIX64 "I64X"
242#elif defined(__LP64__) && !defined(__APPLE__)
243#define SDL_PRIX64 "lX"
244#else
245#define SDL_PRIX64 "llX"
246#endif
247#endif
248#ifndef SDL_PRIs32
249#ifdef PRId32
250#define SDL_PRIs32 PRId32
251#else
252#define SDL_PRIs32 "d"
253#endif
254#endif
255#ifndef SDL_PRIu32
256#ifdef PRIu32
257#define SDL_PRIu32 PRIu32
258#else
259#define SDL_PRIu32 "u"
260#endif
261#endif
262#ifndef SDL_PRIx32
263#ifdef PRIx32
264#define SDL_PRIx32 PRIx32
265#else
266#define SDL_PRIx32 "x"
267#endif
268#endif
269#ifndef SDL_PRIX32
270#ifdef PRIX32
271#define SDL_PRIX32 PRIX32
272#else
273#define SDL_PRIX32 "X"
274#endif
275#endif
276
277/* Annotations to help code analysis tools */
278#ifdef SDL_DISABLE_ANALYZE_MACROS
279#define SDL_IN_BYTECAP(x)
280#define SDL_INOUT_Z_CAP(x)
281#define SDL_OUT_Z_CAP(x)
282#define SDL_OUT_CAP(x)
283#define SDL_OUT_BYTECAP(x)
284#define SDL_OUT_Z_BYTECAP(x)
285#define SDL_PRINTF_FORMAT_STRING
286#define SDL_SCANF_FORMAT_STRING
287#define SDL_PRINTF_VARARG_FUNC( fmtargnumber )
288#define SDL_SCANF_VARARG_FUNC( fmtargnumber )
289#define SDL_WPRINTF_VARARG_FUNC( fmtargnumber )
290#define SDL_WSCANF_VARARG_FUNC( fmtargnumber )
291#else
292#if defined(_MSC_VER) && (_MSC_VER >= 1600) /* VS 2010 and above */
293#include <sal.h>
294
295#define SDL_IN_BYTECAP(x) _In_bytecount_(x)
296#define SDL_INOUT_Z_CAP(x) _Inout_z_cap_(x)
297#define SDL_OUT_Z_CAP(x) _Out_z_cap_(x)
298#define SDL_OUT_CAP(x) _Out_cap_(x)
299#define SDL_OUT_BYTECAP(x) _Out_bytecap_(x)
300#define SDL_OUT_Z_BYTECAP(x) _Out_z_bytecap_(x)
301
302#define SDL_PRINTF_FORMAT_STRING _Printf_format_string_
303#define SDL_SCANF_FORMAT_STRING _Scanf_format_string_impl_
304#else
305#define SDL_IN_BYTECAP(x)
306#define SDL_INOUT_Z_CAP(x)
307#define SDL_OUT_Z_CAP(x)
308#define SDL_OUT_CAP(x)
309#define SDL_OUT_BYTECAP(x)
310#define SDL_OUT_Z_BYTECAP(x)
311#define SDL_PRINTF_FORMAT_STRING
312#define SDL_SCANF_FORMAT_STRING
313#endif
314#ifdef __GNUC__
315#define SDL_PRINTF_VARARG_FUNC( fmtargnumber ) __attribute__ (( format( __printf__, fmtargnumber, fmtargnumber+1 )))
316#define SDL_SCANF_VARARG_FUNC( fmtargnumber ) __attribute__ (( format( __scanf__, fmtargnumber, fmtargnumber+1 )))
317#define SDL_WPRINTF_VARARG_FUNC( fmtargnumber ) /* __attribute__ (( format( __wprintf__, fmtargnumber, fmtargnumber+1 ))) */
318#define SDL_WSCANF_VARARG_FUNC( fmtargnumber ) /* __attribute__ (( format( __wscanf__, fmtargnumber, fmtargnumber+1 ))) */
319#else
320#define SDL_PRINTF_VARARG_FUNC( fmtargnumber )
321#define SDL_SCANF_VARARG_FUNC( fmtargnumber )
322#define SDL_WPRINTF_VARARG_FUNC( fmtargnumber )
323#define SDL_WSCANF_VARARG_FUNC( fmtargnumber )
324#endif
325#endif /* SDL_DISABLE_ANALYZE_MACROS */
326
327#ifndef SDL_COMPILE_TIME_ASSERT
328#ifdef __cplusplus
329#if (__cplusplus >= 201103L)
330#define SDL_COMPILE_TIME_ASSERT(name, x) static_assert(x, #x)
331#endif
332#elif defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 201112L)
333#define SDL_COMPILE_TIME_ASSERT(name, x) _Static_assert(x, #x)
334#endif
335#endif /* !SDL_COMPILE_TIME_ASSERT */
336
337#ifndef SDL_COMPILE_TIME_ASSERT
338/* universal, but may trigger -Wunused-local-typedefs */
339#define SDL_COMPILE_TIME_ASSERT(name, x) \
340 typedef int SDL_compile_time_assert_ ## name[(x) * 2 - 1]
341#endif
342
343/** \cond */
344#ifndef DOXYGEN_SHOULD_IGNORE_THIS
345SDL_COMPILE_TIME_ASSERT(uint8, sizeof(Uint8) == 1);
346SDL_COMPILE_TIME_ASSERT(sint8, sizeof(Sint8) == 1);
347SDL_COMPILE_TIME_ASSERT(uint16, sizeof(Uint16) == 2);
348SDL_COMPILE_TIME_ASSERT(sint16, sizeof(Sint16) == 2);
349SDL_COMPILE_TIME_ASSERT(uint32, sizeof(Uint32) == 4);
350SDL_COMPILE_TIME_ASSERT(sint32, sizeof(Sint32) == 4);
351SDL_COMPILE_TIME_ASSERT(uint64, sizeof(Uint64) == 8);
352SDL_COMPILE_TIME_ASSERT(sint64, sizeof(Sint64) == 8);
353#endif /* DOXYGEN_SHOULD_IGNORE_THIS */
354/** \endcond */
355
356/* Check to make sure enums are the size of ints, for structure packing.
357 For both Watcom C/C++ and Borland C/C++ the compiler option that makes
358 enums having the size of an int must be enabled.
359 This is "-b" for Borland C/C++ and "-ei" for Watcom C/C++ (v11).
360*/
361
362/** \cond */
363#ifndef DOXYGEN_SHOULD_IGNORE_THIS
364#if !defined(__ANDROID__) && !defined(__VITA__) && !defined(__3DS__)
365 /* TODO: include/SDL_stdinc.h:174: error: size of array 'SDL_dummy_enum' is negative */
366typedef enum
367{
368 DUMMY_ENUM_VALUE
369} SDL_DUMMY_ENUM;
370
371SDL_COMPILE_TIME_ASSERT(enum, sizeof(SDL_DUMMY_ENUM) == sizeof(int));
372#endif
373#endif /* DOXYGEN_SHOULD_IGNORE_THIS */
374/** \endcond */
375
376#include <SDL3/SDL_begin_code.h>
377/* Set up for C function definitions, even when using C++ */
378#ifdef __cplusplus
379extern "C" {
380#endif
381
382#ifdef HAVE_ALLOCA
383#define SDL_stack_alloc(type, count) (type*)alloca(sizeof(type)*(count))
384#define SDL_stack_free(data)
385#else
386#define SDL_stack_alloc(type, count) (type*)SDL_malloc(sizeof(type)*(count))
387#define SDL_stack_free(data) SDL_free(data)
388#endif
389
390extern DECLSPEC SDL_MALLOC void *SDLCALL SDL_malloc(size_t size);
391extern DECLSPEC SDL_MALLOC SDL_ALLOC_SIZE2(1, 2) void *SDLCALL SDL_calloc(size_t nmemb, size_t size);
392extern DECLSPEC SDL_ALLOC_SIZE(2) void *SDLCALL SDL_realloc(void *mem, size_t size);
393extern DECLSPEC void SDLCALL SDL_free(void *mem);
394
395typedef void *(SDLCALL *SDL_malloc_func)(size_t size);
396typedef void *(SDLCALL *SDL_calloc_func)(size_t nmemb, size_t size);
397typedef void *(SDLCALL *SDL_realloc_func)(void *mem, size_t size);
398typedef void (SDLCALL *SDL_free_func)(void *mem);
399
400/**
401 * Get the original set of SDL memory functions
402 *
403 * \param malloc_func filled with malloc function
404 * \param calloc_func filled with calloc function
405 * \param realloc_func filled with realloc function
406 * \param free_func filled with free function
407 *
408 * \since This function is available since SDL 3.0.0.
409 */
410extern DECLSPEC void SDLCALL SDL_GetOriginalMemoryFunctions(SDL_malloc_func *malloc_func,
411 SDL_calloc_func *calloc_func,
412 SDL_realloc_func *realloc_func,
413 SDL_free_func *free_func);
414
415/**
416 * Get the current set of SDL memory functions
417 *
418 * \param malloc_func filled with malloc function
419 * \param calloc_func filled with calloc function
420 * \param realloc_func filled with realloc function
421 * \param free_func filled with free function
422 *
423 * \since This function is available since SDL 3.0.0.
424 */
425extern DECLSPEC void SDLCALL SDL_GetMemoryFunctions(SDL_malloc_func *malloc_func,
426 SDL_calloc_func *calloc_func,
427 SDL_realloc_func *realloc_func,
428 SDL_free_func *free_func);
429
430/**
431 * Replace SDL's memory allocation functions with a custom set
432 *
433 * \param malloc_func custom malloc function
434 * \param calloc_func custom calloc function
435 * \param realloc_func custom realloc function
436 * \param free_func custom free function
437 * \returns 0 on success or a negative error code on failure; call
438 * SDL_GetError() for more information.
439 *
440 * \since This function is available since SDL 3.0.0.
441 */
442extern DECLSPEC int SDLCALL SDL_SetMemoryFunctions(SDL_malloc_func malloc_func,
443 SDL_calloc_func calloc_func,
444 SDL_realloc_func realloc_func,
445 SDL_free_func free_func);
446
447/**
448 * Allocate memory aligned to a specific value
449 *
450 * If `alignment` is less than the size of `void *`, then it will be increased
451 * to match that.
452 *
453 * The returned memory address will be a multiple of the alignment value, and
454 * the amount of memory allocated will be a multiple of the alignment value.
455 *
456 * The memory returned by this function must be freed with SDL_aligned_free()
457 *
458 * \param alignment the alignment requested
459 * \param size the size to allocate
460 * \returns a pointer to the aligned memory
461 *
462 * \since This function is available since SDL 3.0.0.
463 *
464 * \sa SDL_aligned_free
465 */
466extern DECLSPEC SDL_MALLOC void *SDLCALL SDL_aligned_alloc(size_t alignment, size_t size);
467
468/**
469 * Free memory allocated by SDL_aligned_alloc()
470 *
471 * \since This function is available since SDL 3.0.0.
472 *
473 * \sa SDL_aligned_alloc
474 */
475extern DECLSPEC void SDLCALL SDL_aligned_free(void *mem);
476
477/**
478 * Get the number of outstanding (unfreed) allocations
479 *
480 * \returns the number of allocations
481 *
482 * \since This function is available since SDL 3.0.0.
483 */
484extern DECLSPEC int SDLCALL SDL_GetNumAllocations(void);
485
486extern DECLSPEC char *SDLCALL SDL_getenv(const char *name);
487extern DECLSPEC int SDLCALL SDL_setenv(const char *name, const char *value, int overwrite);
488
489extern DECLSPEC void SDLCALL SDL_qsort(void *base, size_t nmemb, size_t size, int (SDLCALL *compare) (const void *, const void *));
490extern DECLSPEC void * SDLCALL SDL_bsearch(const void *key, const void *base, size_t nmemb, size_t size, int (SDLCALL *compare) (const void *, const void *));
491
492extern DECLSPEC int SDLCALL SDL_abs(int x);
493
494/* NOTE: these double-evaluate their arguments, so you should never have side effects in the parameters */
495#define SDL_min(x, y) (((x) < (y)) ? (x) : (y))
496#define SDL_max(x, y) (((x) > (y)) ? (x) : (y))
497#define SDL_clamp(x, a, b) (((x) < (a)) ? (a) : (((x) > (b)) ? (b) : (x)))
498
499extern DECLSPEC int SDLCALL SDL_isalpha(int x);
500extern DECLSPEC int SDLCALL SDL_isalnum(int x);
501extern DECLSPEC int SDLCALL SDL_isblank(int x);
502extern DECLSPEC int SDLCALL SDL_iscntrl(int x);
503extern DECLSPEC int SDLCALL SDL_isdigit(int x);
504extern DECLSPEC int SDLCALL SDL_isxdigit(int x);
505extern DECLSPEC int SDLCALL SDL_ispunct(int x);
506extern DECLSPEC int SDLCALL SDL_isspace(int x);
507extern DECLSPEC int SDLCALL SDL_isupper(int x);
508extern DECLSPEC int SDLCALL SDL_islower(int x);
509extern DECLSPEC int SDLCALL SDL_isprint(int x);
510extern DECLSPEC int SDLCALL SDL_isgraph(int x);
511extern DECLSPEC int SDLCALL SDL_toupper(int x);
512extern DECLSPEC int SDLCALL SDL_tolower(int x);
513
514extern DECLSPEC Uint16 SDLCALL SDL_crc16(Uint16 crc, const void *data, size_t len);
515extern DECLSPEC Uint32 SDLCALL SDL_crc32(Uint32 crc, const void *data, size_t len);
516
517extern DECLSPEC void *SDLCALL SDL_memset(SDL_OUT_BYTECAP(len) void *dst, int c, size_t len);
518extern DECLSPEC void *SDLCALL SDL_memset4(void *dst, Uint32 val, size_t dwords);
519
520#define SDL_zero(x) SDL_memset(&(x), 0, sizeof((x)))
521#define SDL_zerop(x) SDL_memset((x), 0, sizeof(*(x)))
522#define SDL_zeroa(x) SDL_memset((x), 0, sizeof((x)))
523
524#define SDL_copyp(dst, src) \
525 { SDL_COMPILE_TIME_ASSERT(SDL_copyp, sizeof (*(dst)) == sizeof (*(src))); } \
526 SDL_memcpy((dst), (src), sizeof (*(src)))
527
528
529
530extern DECLSPEC void *SDLCALL SDL_memcpy(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len);
531
532extern DECLSPEC void *SDLCALL SDL_memmove(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len);
533extern DECLSPEC int SDLCALL SDL_memcmp(const void *s1, const void *s2, size_t len);
534
535extern DECLSPEC size_t SDLCALL SDL_wcslen(const wchar_t *wstr);
536extern DECLSPEC size_t SDLCALL SDL_wcslcpy(SDL_OUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen);
537extern DECLSPEC size_t SDLCALL SDL_wcslcat(SDL_INOUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen);
538extern DECLSPEC wchar_t *SDLCALL SDL_wcsdup(const wchar_t *wstr);
539extern DECLSPEC wchar_t *SDLCALL SDL_wcsstr(const wchar_t *haystack, const wchar_t *needle);
540
541extern DECLSPEC int SDLCALL SDL_wcscmp(const wchar_t *str1, const wchar_t *str2);
542extern DECLSPEC int SDLCALL SDL_wcsncmp(const wchar_t *str1, const wchar_t *str2, size_t maxlen);
543extern DECLSPEC int SDLCALL SDL_wcscasecmp(const wchar_t *str1, const wchar_t *str2);
544extern DECLSPEC int SDLCALL SDL_wcsncasecmp(const wchar_t *str1, const wchar_t *str2, size_t len);
545extern DECLSPEC long SDLCALL SDL_wcstol(const wchar_t *str, wchar_t **endp, int base);
546
547extern DECLSPEC size_t SDLCALL SDL_strlen(const char *str);
548extern DECLSPEC size_t SDLCALL SDL_strlcpy(SDL_OUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen);
549extern DECLSPEC size_t SDLCALL SDL_utf8strlcpy(SDL_OUT_Z_CAP(dst_bytes) char *dst, const char *src, size_t dst_bytes);
550extern DECLSPEC size_t SDLCALL SDL_strlcat(SDL_INOUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen);
551extern DECLSPEC SDL_MALLOC char *SDLCALL SDL_strdup(const char *str);
552extern DECLSPEC SDL_MALLOC char *SDLCALL SDL_strndup(const char *str, size_t maxlen);
553extern DECLSPEC char *SDLCALL SDL_strrev(char *str);
554extern DECLSPEC char *SDLCALL SDL_strupr(char *str);
555extern DECLSPEC char *SDLCALL SDL_strlwr(char *str);
556extern DECLSPEC char *SDLCALL SDL_strchr(const char *str, int c);
557extern DECLSPEC char *SDLCALL SDL_strrchr(const char *str, int c);
558extern DECLSPEC char *SDLCALL SDL_strstr(const char *haystack, const char *needle);
559extern DECLSPEC char *SDLCALL SDL_strcasestr(const char *haystack, const char *needle);
560extern DECLSPEC char *SDLCALL SDL_strtok_r(char *s1, const char *s2, char **saveptr);
561extern DECLSPEC size_t SDLCALL SDL_utf8strlen(const char *str);
562extern DECLSPEC size_t SDLCALL SDL_utf8strnlen(const char *str, size_t bytes);
563
564extern DECLSPEC char *SDLCALL SDL_itoa(int value, char *str, int radix);
565extern DECLSPEC char *SDLCALL SDL_uitoa(unsigned int value, char *str, int radix);
566extern DECLSPEC char *SDLCALL SDL_ltoa(long value, char *str, int radix);
567extern DECLSPEC char *SDLCALL SDL_ultoa(unsigned long value, char *str, int radix);
568extern DECLSPEC char *SDLCALL SDL_lltoa(Sint64 value, char *str, int radix);
569extern DECLSPEC char *SDLCALL SDL_ulltoa(Uint64 value, char *str, int radix);
570
571extern DECLSPEC int SDLCALL SDL_atoi(const char *str);
572extern DECLSPEC double SDLCALL SDL_atof(const char *str);
573extern DECLSPEC long SDLCALL SDL_strtol(const char *str, char **endp, int base);
574extern DECLSPEC unsigned long SDLCALL SDL_strtoul(const char *str, char **endp, int base);
575extern DECLSPEC Sint64 SDLCALL SDL_strtoll(const char *str, char **endp, int base);
576extern DECLSPEC Uint64 SDLCALL SDL_strtoull(const char *str, char **endp, int base);
577extern DECLSPEC double SDLCALL SDL_strtod(const char *str, char **endp);
578
579extern DECLSPEC int SDLCALL SDL_strcmp(const char *str1, const char *str2);
580extern DECLSPEC int SDLCALL SDL_strncmp(const char *str1, const char *str2, size_t maxlen);
581extern DECLSPEC int SDLCALL SDL_strcasecmp(const char *str1, const char *str2);
582extern DECLSPEC int SDLCALL SDL_strncasecmp(const char *str1, const char *str2, size_t len);
583
584extern DECLSPEC int SDLCALL SDL_sscanf(const char *text, SDL_SCANF_FORMAT_STRING const char *fmt, ...) SDL_SCANF_VARARG_FUNC(2);
585extern DECLSPEC int SDLCALL SDL_vsscanf(const char *text, const char *fmt, va_list ap);
586extern DECLSPEC int SDLCALL SDL_snprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, SDL_PRINTF_FORMAT_STRING const char *fmt, ... ) SDL_PRINTF_VARARG_FUNC(3);
587extern DECLSPEC int SDLCALL SDL_swprintf(SDL_OUT_Z_CAP(maxlen) wchar_t *text, size_t maxlen, SDL_PRINTF_FORMAT_STRING const wchar_t *fmt, ... ) SDL_WPRINTF_VARARG_FUNC(3);
588extern DECLSPEC int SDLCALL SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, const char *fmt, va_list ap);
589extern DECLSPEC int SDLCALL SDL_vswprintf(SDL_OUT_Z_CAP(maxlen) wchar_t *text, size_t maxlen, const wchar_t *fmt, va_list ap);
590extern DECLSPEC int SDLCALL SDL_asprintf(char **strp, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
591extern DECLSPEC int SDLCALL SDL_vasprintf(char **strp, const char *fmt, va_list ap);
592
593#ifndef SDL_PI_D
594#define SDL_PI_D 3.141592653589793238462643383279502884 /**< pi (double) */
595#endif
596#ifndef SDL_PI_F
597#define SDL_PI_F 3.141592653589793238462643383279502884F /**< pi (float) */
598#endif
599
600/**
601 * Use this function to compute arc cosine of `x`.
602 *
603 * The definition of `y = acos(x)` is `x = cos(y)`.
604 *
605 * Domain: `-1 <= x <= 1`
606 *
607 * Range: `0 <= y <= Pi`
608 *
609 * \param x floating point value, in radians.
610 * \returns arc cosine of `x`.
611 *
612 * \since This function is available since SDL 3.0.0.
613 */
614extern DECLSPEC double SDLCALL SDL_acos(double x);
615extern DECLSPEC float SDLCALL SDL_acosf(float x);
616extern DECLSPEC double SDLCALL SDL_asin(double x);
617extern DECLSPEC float SDLCALL SDL_asinf(float x);
618extern DECLSPEC double SDLCALL SDL_atan(double x);
619extern DECLSPEC float SDLCALL SDL_atanf(float x);
620extern DECLSPEC double SDLCALL SDL_atan2(double y, double x);
621extern DECLSPEC float SDLCALL SDL_atan2f(float y, float x);
622extern DECLSPEC double SDLCALL SDL_ceil(double x);
623extern DECLSPEC float SDLCALL SDL_ceilf(float x);
624extern DECLSPEC double SDLCALL SDL_copysign(double x, double y);
625extern DECLSPEC float SDLCALL SDL_copysignf(float x, float y);
626extern DECLSPEC double SDLCALL SDL_cos(double x);
627extern DECLSPEC float SDLCALL SDL_cosf(float x);
628extern DECLSPEC double SDLCALL SDL_exp(double x);
629extern DECLSPEC float SDLCALL SDL_expf(float x);
630extern DECLSPEC double SDLCALL SDL_fabs(double x);
631extern DECLSPEC float SDLCALL SDL_fabsf(float x);
632extern DECLSPEC double SDLCALL SDL_floor(double x);
633extern DECLSPEC float SDLCALL SDL_floorf(float x);
634extern DECLSPEC double SDLCALL SDL_trunc(double x);
635extern DECLSPEC float SDLCALL SDL_truncf(float x);
636extern DECLSPEC double SDLCALL SDL_fmod(double x, double y);
637extern DECLSPEC float SDLCALL SDL_fmodf(float x, float y);
638extern DECLSPEC double SDLCALL SDL_log(double x);
639extern DECLSPEC float SDLCALL SDL_logf(float x);
640extern DECLSPEC double SDLCALL SDL_log10(double x);
641extern DECLSPEC float SDLCALL SDL_log10f(float x);
642extern DECLSPEC double SDLCALL SDL_modf(double x, double *y);
643extern DECLSPEC float SDLCALL SDL_modff(float x, float *y);
644extern DECLSPEC double SDLCALL SDL_pow(double x, double y);
645extern DECLSPEC float SDLCALL SDL_powf(float x, float y);
646extern DECLSPEC double SDLCALL SDL_round(double x);
647extern DECLSPEC float SDLCALL SDL_roundf(float x);
648extern DECLSPEC long SDLCALL SDL_lround(double x);
649extern DECLSPEC long SDLCALL SDL_lroundf(float x);
650extern DECLSPEC double SDLCALL SDL_scalbn(double x, int n);
651extern DECLSPEC float SDLCALL SDL_scalbnf(float x, int n);
652extern DECLSPEC double SDLCALL SDL_sin(double x);
653extern DECLSPEC float SDLCALL SDL_sinf(float x);
654extern DECLSPEC double SDLCALL SDL_sqrt(double x);
655extern DECLSPEC float SDLCALL SDL_sqrtf(float x);
656extern DECLSPEC double SDLCALL SDL_tan(double x);
657extern DECLSPEC float SDLCALL SDL_tanf(float x);
658
659/* The SDL implementation of iconv() returns these error codes */
660#define SDL_ICONV_ERROR (size_t)-1
661#define SDL_ICONV_E2BIG (size_t)-2
662#define SDL_ICONV_EILSEQ (size_t)-3
663#define SDL_ICONV_EINVAL (size_t)-4
664
665/* SDL_iconv_* are now always real symbols/types, not macros or inlined. */
666typedef struct SDL_iconv_data_t *SDL_iconv_t;
667extern DECLSPEC SDL_iconv_t SDLCALL SDL_iconv_open(const char *tocode,
668 const char *fromcode);
669extern DECLSPEC int SDLCALL SDL_iconv_close(SDL_iconv_t cd);
670extern DECLSPEC size_t SDLCALL SDL_iconv(SDL_iconv_t cd, const char **inbuf,
671 size_t * inbytesleft, char **outbuf,
672 size_t * outbytesleft);
673
674/**
675 * This function converts a buffer or string between encodings in one pass,
676 * returning a string that must be freed with SDL_free() or NULL on error.
677 *
678 * \since This function is available since SDL 3.0.0.
679 */
680extern DECLSPEC char *SDLCALL SDL_iconv_string(const char *tocode,
681 const char *fromcode,
682 const char *inbuf,
683 size_t inbytesleft);
684#define SDL_iconv_utf8_locale(S) SDL_iconv_string("", "UTF-8", S, SDL_strlen(S)+1)
685#define SDL_iconv_utf8_ucs2(S) (Uint16 *)SDL_iconv_string("UCS-2-INTERNAL", "UTF-8", S, SDL_strlen(S)+1)
686#define SDL_iconv_utf8_ucs4(S) (Uint32 *)SDL_iconv_string("UCS-4-INTERNAL", "UTF-8", S, SDL_strlen(S)+1)
687#define SDL_iconv_wchar_utf8(S) SDL_iconv_string("UTF-8", "WCHAR_T", (char *)S, (SDL_wcslen(S)+1)*sizeof(wchar_t))
688
689/* force builds using Clang's static analysis tools to use literal C runtime
690 here, since there are possibly tests that are ineffective otherwise. */
691#if defined(__clang_analyzer__) && !defined(SDL_DISABLE_ANALYZE_MACROS)
692
693/* The analyzer knows about strlcpy even when the system doesn't provide it */
694#ifndef HAVE_STRLCPY
695size_t strlcpy(char* dst, const char* src, size_t size);
696#endif
697
698/* The analyzer knows about strlcat even when the system doesn't provide it */
699#ifndef HAVE_STRLCAT
700size_t strlcat(char* dst, const char* src, size_t size);
701#endif
702
703#ifndef HAVE_WCSLCPY
704size_t wcslcpy(wchar_t *dst, const wchar_t *src, size_t size);
705#endif
706
707#ifndef HAVE_WCSLCAT
708size_t wcslcat(wchar_t *dst, const wchar_t *src, size_t size);
709#endif
710
711/* Starting LLVM 16, the analyser errors out if these functions do not have
712 their prototype defined (clang-diagnostic-implicit-function-declaration) */
713#include <stdlib.h>
714#include <string.h>
715#include <stdio.h>
716
717#define SDL_malloc malloc
718#define SDL_calloc calloc
719#define SDL_realloc realloc
720#define SDL_free free
721#define SDL_memset memset
722#define SDL_memcpy memcpy
723#define SDL_memmove memmove
724#define SDL_memcmp memcmp
725#define SDL_strlcpy strlcpy
726#define SDL_strlcat strlcat
727#define SDL_strlen strlen
728#define SDL_wcslen wcslen
729#define SDL_wcslcpy wcslcpy
730#define SDL_wcslcat wcslcat
731#define SDL_strdup strdup
732#define SDL_wcsdup wcsdup
733#define SDL_strchr strchr
734#define SDL_strrchr strrchr
735#define SDL_strstr strstr
736#define SDL_wcsstr wcsstr
737#define SDL_strtok_r strtok_r
738#define SDL_strcmp strcmp
739#define SDL_wcscmp wcscmp
740#define SDL_strncmp strncmp
741#define SDL_wcsncmp wcsncmp
742#define SDL_strcasecmp strcasecmp
743#define SDL_strncasecmp strncasecmp
744#define SDL_sscanf sscanf
745#define SDL_vsscanf vsscanf
746#define SDL_snprintf snprintf
747#define SDL_vsnprintf vsnprintf
748#endif
749
750SDL_FORCE_INLINE void *SDL_memcpy4(SDL_OUT_BYTECAP(dwords*4) void *dst, SDL_IN_BYTECAP(dwords*4) const void *src, size_t dwords)
751{
752 return SDL_memcpy(dst, src, dwords * 4);
753}
754
755/**
756 * If a * b would overflow, return -1. Otherwise store a * b via ret
757 * and return 0.
758 *
759 * \since This function is available since SDL 3.0.0.
760 */
762 size_t b,
763 size_t *ret)
764{
765 if (a != 0 && b > SDL_SIZE_MAX / a) {
766 return -1;
767 }
768 *ret = a * b;
769 return 0;
770}
771
772#if SDL_HAS_BUILTIN(__builtin_mul_overflow)
773/* This needs to be wrapped in an inline rather than being a direct #define,
774 * because __builtin_mul_overflow() is type-generic, but we want to be
775 * consistent about interpreting a and b as size_t. */
776SDL_FORCE_INLINE int SDL_size_mul_overflow_builtin (size_t a,
777 size_t b,
778 size_t *ret)
779{
780 return __builtin_mul_overflow(a, b, ret) == 0 ? 0 : -1;
781}
782#define SDL_size_mul_overflow(a, b, ret) (SDL_size_mul_overflow_builtin(a, b, ret))
783#endif
784
785/**
786 * If a + b would overflow, return -1. Otherwise store a + b via ret
787 * and return 0.
788 *
789 * \since This function is available since SDL 3.0.0.
790 */
792 size_t b,
793 size_t *ret)
794{
795 if (b > SDL_SIZE_MAX - a) {
796 return -1;
797 }
798 *ret = a + b;
799 return 0;
800}
801
802#if SDL_HAS_BUILTIN(__builtin_add_overflow)
803/* This needs to be wrapped in an inline rather than being a direct #define,
804 * the same as the call to __builtin_mul_overflow() above. */
805SDL_FORCE_INLINE int SDL_size_add_overflow_builtin (size_t a,
806 size_t b,
807 size_t *ret)
808{
809 return __builtin_add_overflow(a, b, ret) == 0 ? 0 : -1;
810}
811#define SDL_size_add_overflow(a, b, ret) (SDL_size_add_overflow_builtin(a, b, ret))
812#endif
813
814/* This is a generic function pointer which should be cast to the type you expect */
815#ifdef SDL_FUNCTION_POINTER_IS_VOID_POINTER
816typedef void *SDL_FunctionPointer;
817#else
818typedef void (*SDL_FunctionPointer)(void);
819#endif
820
821/* Ends C function definitions when using C++ */
822#ifdef __cplusplus
823}
824#endif
825#include <SDL3/SDL_close_code.h>
826
827#endif /* SDL_stdinc_h_ */
#define SDL_FORCE_INLINE
#define SDL_MALLOC
Try to get a standard set of platform defines.
wchar_t * SDL_wcsdup(const wchar_t *wstr)
double SDL_sqrt(double x)
int SDL_atoi(const char *str)
SDL_iconv_t SDL_iconv_open(const char *tocode, const char *fromcode)
float SDL_tanf(float x)
char * SDL_strtok_r(char *s1, const char *s2, char **saveptr)
int SDL_isspace(int x)
int SDL_isalnum(int x)
char * SDL_strlwr(char *str)
struct SDL_iconv_data_t * SDL_iconv_t
Definition: SDL_stdinc.h:666
int SDL_tolower(int x)
float SDL_modff(float x, float *y)
double SDL_modf(double x, double *y)
int SDL_abs(int x)
char * alloca()
size_t SDL_iconv(SDL_iconv_t cd, const char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft)
double SDL_tan(double x)
uint8_t Uint8
Definition: SDL_stdinc.h:147
char * SDL_ltoa(long value, char *str, int radix)
int SDL_isxdigit(int x)
float SDL_ceilf(float x)
int64_t Sint64
Definition: SDL_stdinc.h:178
void SDL_GetOriginalMemoryFunctions(SDL_malloc_func *malloc_func, SDL_calloc_func *calloc_func, SDL_realloc_func *realloc_func, SDL_free_func *free_func)
SDL_MALLOC SDL_ALLOC_SIZE2(1, 2) void *SDL_calloc(size_t nmemb
void *(* SDL_malloc_func)(size_t size)
Definition: SDL_stdinc.h:395
#define SDL_OUT_BYTECAP(x)
Definition: SDL_stdinc.h:309
char * SDL_strrchr(const char *str, int c)
#define SDL_SIZE_MAX
Definition: SDL_stdinc.h:66
int SDL_wcsncmp(const wchar_t *str1, const wchar_t *str2, size_t maxlen)
uint16_t Uint16
Definition: SDL_stdinc.h:159
int SDL_sscanf(const char *text, SDL_SCANF_FORMAT_STRING const char *fmt,...) SDL_SCANF_VARARG_FUNC(2)
void SDL_qsort(void *base, size_t nmemb, size_t size, int(*compare)(const void *, const void *))
int SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, const char *fmt, va_list ap)
float SDL_atanf(float x)
int SDL_isprint(int x)
int SDL_wcsncasecmp(const wchar_t *str1, const wchar_t *str2, size_t len)
char * SDL_itoa(int value, char *str, int radix)
float SDL_copysignf(float x, float y)
SDL_MALLOC char * SDL_strndup(const char *str, size_t maxlen)
char * SDL_strupr(char *str)
float SDL_acosf(float x)
int SDL_SetMemoryFunctions(SDL_malloc_func malloc_func, SDL_calloc_func calloc_func, SDL_realloc_func realloc_func, SDL_free_func free_func)
size_t SDL_wcslcat(SDL_INOUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
SDL_FORCE_INLINE int SDL_size_mul_overflow(size_t a, size_t b, size_t *ret)
Definition: SDL_stdinc.h:761
int SDL_strncmp(const char *str1, const char *str2, size_t maxlen)
char * SDL_strchr(const char *str, int c)
SDL_MALLOC void * SDL_aligned_alloc(size_t alignment, size_t size)
#define SDL_IN_BYTECAP(x)
Definition: SDL_stdinc.h:305
char * SDL_uitoa(unsigned int value, char *str, int radix)
int SDL_isalpha(int x)
double SDL_round(double x)
long SDL_lround(double x)
int SDL_isdigit(int x)
int SDL_isblank(int x)
int SDL_iconv_close(SDL_iconv_t cd)
double SDL_sin(double x)
char * SDL_strcasestr(const char *haystack, const char *needle)
float SDL_scalbnf(float x, int n)
void * SDL_memcpy(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len)
double SDL_pow(double x, double y)
size_t SDL_utf8strlcpy(SDL_OUT_Z_CAP(dst_bytes) char *dst, const char *src, size_t dst_bytes)
float SDL_asinf(float x)
double SDL_asin(double x)
double SDL_acos(double x)
int8_t Sint8
Definition: SDL_stdinc.h:141
wchar_t * SDL_wcsstr(const wchar_t *haystack, const wchar_t *needle)
float SDL_sinf(float x)
int SDL_swprintf(SDL_OUT_Z_CAP(maxlen) wchar_t *text, size_t maxlen, SDL_PRINTF_FORMAT_STRING const wchar_t *fmt,...) SDL_WPRINTF_VARARG_FUNC(3)
double SDL_ceil(double x)
size_t SDL_utf8strnlen(const char *str, size_t bytes)
void * SDL_memset(SDL_OUT_BYTECAP(len) void *dst, int c, size_t len)
int SDL_strcasecmp(const char *str1, const char *str2)
void * SDL_memset4(void *dst, Uint32 val, size_t dwords)
#define SDL_SCANF_FORMAT_STRING
Definition: SDL_stdinc.h:312
char * SDL_strstr(const char *haystack, const char *needle)
int SDL_GetNumAllocations(void)
double SDL_exp(double x)
size_t SDL_wcslcpy(SDL_OUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
double SDL_atan(double x)
float SDL_sqrtf(float x)
SDL_ALLOC_SIZE(2) void *SDL_realloc(void *mem
size_t SDL_wcslen(const wchar_t *wstr)
int32_t Sint32
Definition: SDL_stdinc.h:165
int SDL_setenv(const char *name, const char *value, int overwrite)
size_t SDL_strlcpy(SDL_OUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen)
#define SDL_INOUT_Z_CAP(x)
Definition: SDL_stdinc.h:306
double SDL_scalbn(double x, int n)
char * SDL_iconv_string(const char *tocode, const char *fromcode, const char *inbuf, size_t inbytesleft)
int SDL_wcscasecmp(const wchar_t *str1, const wchar_t *str2)
char * SDL_getenv(const char *name)
double SDL_fmod(double x, double y)
char * SDL_lltoa(Sint64 value, char *str, int radix)
double SDL_fabs(double x)
Sint64 SDL_strtoll(const char *str, char **endp, int base)
int SDL_ispunct(int x)
float SDL_truncf(float x)
double SDL_log10(double x)
SDL_MALLOC size_t size
Definition: SDL_stdinc.h:391
float SDL_expf(float x)
char * SDL_strrev(char *str)
double SDL_floor(double x)
int SDL_wcscmp(const wchar_t *str1, const wchar_t *str2)
long SDL_strtol(const char *str, char **endp, int base)
SDL_bool
Definition: SDL_stdinc.h:130
@ SDL_TRUE
Definition: SDL_stdinc.h:132
@ SDL_FALSE
Definition: SDL_stdinc.h:131
Uint32 SDL_crc32(Uint32 crc, const void *data, size_t len)
int SDL_islower(int x)
void SDL_aligned_free(void *mem)
float SDL_logf(float x)
float SDL_log10f(float x)
void * SDL_memmove(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len)
void(* SDL_free_func)(void *mem)
Definition: SDL_stdinc.h:398
int SDL_memcmp(const void *s1, const void *s2, size_t len)
char * SDL_ulltoa(Uint64 value, char *str, int radix)
int16_t Sint16
Definition: SDL_stdinc.h:153
float SDL_roundf(float x)
double SDL_strtod(const char *str, char **endp)
long SDL_lroundf(float x)
char * SDL_ultoa(unsigned long value, char *str, int radix)
double SDL_atof(const char *str)
int SDL_vsscanf(const char *text, const char *fmt, va_list ap)
unsigned long SDL_strtoul(const char *str, char **endp, int base)
float SDL_floorf(float x)
int SDL_strcmp(const char *str1, const char *str2)
SDL_FORCE_INLINE int SDL_size_add_overflow(size_t a, size_t b, size_t *ret)
Definition: SDL_stdinc.h:791
double SDL_cos(double x)
#define SDL_PRINTF_FORMAT_STRING
Definition: SDL_stdinc.h:311
float SDL_fmodf(float x, float y)
int SDL_vswprintf(SDL_OUT_Z_CAP(maxlen) wchar_t *text, size_t maxlen, const wchar_t *fmt, va_list ap)
void SDL_GetMemoryFunctions(SDL_malloc_func *malloc_func, SDL_calloc_func *calloc_func, SDL_realloc_func *realloc_func, SDL_free_func *free_func)
SDL_MALLOC void * SDL_malloc(size_t size)
#define SDL_PRINTF_VARARG_FUNC(fmtargnumber)
Definition: SDL_stdinc.h:320
#define SDL_COMPILE_TIME_ASSERT(name, x)
Definition: SDL_stdinc.h:339
float SDL_atan2f(float y, float x)
int SDL_isupper(int x)
long SDL_wcstol(const wchar_t *str, wchar_t **endp, int base)
float SDL_fabsf(float x)
uint64_t Uint64
Definition: SDL_stdinc.h:184
SDL_MALLOC char * SDL_strdup(const char *str)
int SDL_iscntrl(int x)
void SDL_free(void *mem)
void *(* SDL_calloc_func)(size_t nmemb, size_t size)
Definition: SDL_stdinc.h:396
#define SDL_SCANF_VARARG_FUNC(fmtargnumber)
Definition: SDL_stdinc.h:321
double SDL_atan2(double y, double x)
double SDL_log(double x)
void(* SDL_FunctionPointer)(void)
Definition: SDL_stdinc.h:818
int SDL_toupper(int x)
SDL_FORCE_INLINE void * SDL_memcpy4(SDL_OUT_BYTECAP(dwords *4) void *dst, SDL_IN_BYTECAP(dwords *4) const void *src, size_t dwords)
Definition: SDL_stdinc.h:750
uint32_t Uint32
Definition: SDL_stdinc.h:171
float SDL_powf(float x, float y)
size_t SDL_strlen(const char *str)
Uint16 SDL_crc16(Uint16 crc, const void *data, size_t len)
int SDL_snprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(3)
float SDL_cosf(float x)
void * SDL_bsearch(const void *key, const void *base, size_t nmemb, size_t size, int(*compare)(const void *, const void *))
size_t SDL_strlcat(SDL_INOUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen)
int SDL_vasprintf(char **strp, const char *fmt, va_list ap)
double SDL_copysign(double x, double y)
void *(* SDL_realloc_func)(void *mem, size_t size)
Definition: SDL_stdinc.h:397
size_t SDL_utf8strlen(const char *str)
int SDL_isgraph(int x)
int SDL_strncasecmp(const char *str1, const char *str2, size_t len)
int SDL_asprintf(char **strp, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2)
#define SDL_OUT_Z_CAP(x)
Definition: SDL_stdinc.h:307
#define SDL_WPRINTF_VARARG_FUNC(fmtargnumber)
Definition: SDL_stdinc.h:322
Uint64 SDL_strtoull(const char *str, char **endp, int base)
double SDL_trunc(double x)