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