Go to the documentation of this file.
33 #ifdef HAVE_SYS_TYPES_H
34 #include <sys/types.h>
39 #if defined(STDC_HEADERS)
44 # if defined(HAVE_STDLIB_H)
46 # elif defined(HAVE_MALLOC_H)
49 # if defined(HAVE_STDDEF_H)
52 # if defined(HAVE_STDARG_H)
57 # if !defined(STDC_HEADERS) && defined(HAVE_MEMORY_H)
68 #if defined(HAVE_INTTYPES_H)
69 # include <inttypes.h>
70 #elif defined(HAVE_STDINT_H)
77 # if defined(__WINRT__)
82 # define _USE_MATH_DEFINES
89 #if defined(HAVE_ALLOCA) && !defined(alloca)
90 # if defined(HAVE_ALLOCA_H)
92 # elif defined(__GNUC__)
93 # define alloca __builtin_alloca
94 # elif defined(_MSC_VER)
96 # define alloca _alloca
97 # elif defined(__WATCOMC__)
99 # elif defined(__BORLANDC__)
101 # elif defined(__DMC__)
103 # elif defined(__AIX__)
105 # elif defined(__MRC__)
106 void *alloca(
unsigned);
115 #define SDL_arraysize(array) (sizeof(array)/sizeof(array[0]))
116 #define SDL_TABLESIZE(table) SDL_arraysize(table)
123 #define SDL_STRINGIFY_ARG(arg) #arg
133 #define SDL_reinterpret_cast(type, expression) reinterpret_cast<type>(expression)
134 #define SDL_static_cast(type, expression) static_cast<type>(expression)
135 #define SDL_const_cast(type, expression) const_cast<type>(expression)
137 #define SDL_reinterpret_cast(type, expression) ((type)(expression))
138 #define SDL_static_cast(type, expression) ((type)(expression))
139 #define SDL_const_cast(type, expression) ((type)(expression))
144 #define SDL_FOURCC(A, B, C, D) \
145 ((SDL_static_cast(Uint32, SDL_static_cast(Uint8, (A))) << 0) | \
146 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (B))) << 8) | \
147 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (C))) << 16) | \
148 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (D))) << 24))
171 #define SDL_MAX_SINT8 ((Sint8)0x7F)
172 #define SDL_MIN_SINT8 ((Sint8)(~0x7F))
177 #define SDL_MAX_UINT8 ((Uint8)0xFF)
178 #define SDL_MIN_UINT8 ((Uint8)0x00)
183 #define SDL_MAX_SINT16 ((Sint16)0x7FFF)
184 #define SDL_MIN_SINT16 ((Sint16)(~0x7FFF))
189 #define SDL_MAX_UINT16 ((Uint16)0xFFFF)
190 #define SDL_MIN_UINT16 ((Uint16)0x0000)
195 #define SDL_MAX_SINT32 ((Sint32)0x7FFFFFFF)
196 #define SDL_MIN_SINT32 ((Sint32)(~0x7FFFFFFF))
201 #define SDL_MAX_UINT32 ((Uint32)0xFFFFFFFFu)
202 #define SDL_MIN_UINT32 ((Uint32)0x00000000)
208 #define SDL_MAX_SINT64 ((Sint64)0x7FFFFFFFFFFFFFFFll)
209 #define SDL_MIN_SINT64 ((Sint64)(~0x7FFFFFFFFFFFFFFFll))
214 #define SDL_MAX_UINT64 ((Uint64)0xFFFFFFFFFFFFFFFFull)
215 #define SDL_MIN_UINT64 ((Uint64)(0x0000000000000000ull))
225 #define SDL_PRIs64 PRIs64
226 #elif defined(__WIN32__)
227 #define SDL_PRIs64 "I64d"
228 #elif defined(__LINUX__) && defined(__LP64__)
229 #define SDL_PRIs64 "ld"
231 #define SDL_PRIs64 "lld"
236 #define SDL_PRIu64 PRIu64
237 #elif defined(__WIN32__)
238 #define SDL_PRIu64 "I64u"
239 #elif defined(__LINUX__) && defined(__LP64__)
240 #define SDL_PRIu64 "lu"
242 #define SDL_PRIu64 "llu"
247 #define SDL_PRIx64 PRIx64
248 #elif defined(__WIN32__)
249 #define SDL_PRIx64 "I64x"
250 #elif defined(__LINUX__) && defined(__LP64__)
251 #define SDL_PRIx64 "lx"
253 #define SDL_PRIx64 "llx"
258 #define SDL_PRIX64 PRIX64
259 #elif defined(__WIN32__)
260 #define SDL_PRIX64 "I64X"
261 #elif defined(__LINUX__) && defined(__LP64__)
262 #define SDL_PRIX64 "lX"
264 #define SDL_PRIX64 "llX"
269 #ifdef SDL_DISABLE_ANALYZE_MACROS
270 #define SDL_IN_BYTECAP(x)
271 #define SDL_INOUT_Z_CAP(x)
272 #define SDL_OUT_Z_CAP(x)
273 #define SDL_OUT_CAP(x)
274 #define SDL_OUT_BYTECAP(x)
275 #define SDL_OUT_Z_BYTECAP(x)
276 #define SDL_PRINTF_FORMAT_STRING
277 #define SDL_SCANF_FORMAT_STRING
278 #define SDL_PRINTF_VARARG_FUNC( fmtargnumber )
279 #define SDL_SCANF_VARARG_FUNC( fmtargnumber )
281 #if defined(_MSC_VER) && (_MSC_VER >= 1600)
284 #define SDL_IN_BYTECAP(x) _In_bytecount_(x)
285 #define SDL_INOUT_Z_CAP(x) _Inout_z_cap_(x)
286 #define SDL_OUT_Z_CAP(x) _Out_z_cap_(x)
287 #define SDL_OUT_CAP(x) _Out_cap_(x)
288 #define SDL_OUT_BYTECAP(x) _Out_bytecap_(x)
289 #define SDL_OUT_Z_BYTECAP(x) _Out_z_bytecap_(x)
291 #define SDL_PRINTF_FORMAT_STRING _Printf_format_string_
292 #define SDL_SCANF_FORMAT_STRING _Scanf_format_string_impl_
294 #define SDL_IN_BYTECAP(x)
295 #define SDL_INOUT_Z_CAP(x)
296 #define SDL_OUT_Z_CAP(x)
297 #define SDL_OUT_CAP(x)
298 #define SDL_OUT_BYTECAP(x)
299 #define SDL_OUT_Z_BYTECAP(x)
300 #define SDL_PRINTF_FORMAT_STRING
301 #define SDL_SCANF_FORMAT_STRING
303 #if defined(__GNUC__)
304 #define SDL_PRINTF_VARARG_FUNC( fmtargnumber ) __attribute__ (( format( __printf__, fmtargnumber, fmtargnumber+1 )))
305 #define SDL_SCANF_VARARG_FUNC( fmtargnumber ) __attribute__ (( format( __scanf__, fmtargnumber, fmtargnumber+1 )))
307 #define SDL_PRINTF_VARARG_FUNC( fmtargnumber )
308 #define SDL_SCANF_VARARG_FUNC( fmtargnumber )
312 #define SDL_COMPILE_TIME_ASSERT(name, x) \
313 typedef int SDL_compile_time_assert_ ## name[(x) * 2 - 1]
315 #ifndef DOXYGEN_SHOULD_IGNORE_THIS
334 #ifndef DOXYGEN_SHOULD_IGNORE_THIS
335 #if !defined(__ANDROID__)
354 #define SDL_stack_alloc(type, count) (type*)alloca(sizeof(type)*(count))
355 #define SDL_stack_free(data)
357 #define SDL_stack_alloc(type, count) (type*)SDL_malloc(sizeof(type)*(count))
358 #define SDL_stack_free(data) SDL_free(data)
406 #define SDL_min(x, y) (((x) < (y)) ? (x) : (y))
407 #define SDL_max(x, y) (((x) > (y)) ? (x) : (y))
416 #define SDL_zero(x) SDL_memset(&(x), 0, sizeof((x)))
417 #define SDL_zerop(x) SDL_memset((x), 0, sizeof(*(x)))
422 #if defined(__GNUC__) && defined(i386)
424 __asm__ __volatile__ (
427 :
"=&D" (u0),
"=&a" (
u1),
"=&c" (
u2)
432 size_t _n = (dwords + 3) / 4;
439 case 0:
do { *_p++ = _val;
440 case 3: *_p++ = _val;
441 case 2: *_p++ = _val;
442 case 1: *_p++ = _val;
499 #define M_PI 3.14159265358979323846264338327950288
541 #define SDL_ICONV_ERROR (size_t)-1
542 #define SDL_ICONV_E2BIG (size_t)-2
543 #define SDL_ICONV_EILSEQ (size_t)-3
544 #define SDL_ICONV_EINVAL (size_t)-4
549 const char *fromcode);
552 size_t * inbytesleft,
char **outbuf,
553 size_t * outbytesleft);
559 const char *fromcode,
562 #define SDL_iconv_utf8_locale(S) SDL_iconv_string("", "UTF-8", S, SDL_strlen(S)+1)
563 #define SDL_iconv_utf8_ucs2(S) (Uint16 *)SDL_iconv_string("UCS-2-INTERNAL", "UTF-8", S, SDL_strlen(S)+1)
564 #define SDL_iconv_utf8_ucs4(S) (Uint32 *)SDL_iconv_string("UCS-4-INTERNAL", "UTF-8", S, SDL_strlen(S)+1)
568 #if defined(__clang_analyzer__) && !defined(SDL_DISABLE_ANALYZE_MACROS)
569 #define SDL_malloc malloc
570 #define SDL_calloc calloc
571 #define SDL_realloc realloc
572 #define SDL_free free
573 #define SDL_memset memset
574 #define SDL_memcpy memcpy
575 #define SDL_memmove memmove
576 #define SDL_memcmp memcmp
577 #define SDL_strlen strlen
578 #define SDL_strlcpy strlcpy
579 #define SDL_strlcat strlcat
580 #define SDL_strdup strdup
581 #define SDL_strchr strchr
582 #define SDL_strrchr strrchr
583 #define SDL_strstr strstr
584 #define SDL_strcmp strcmp
585 #define SDL_strncmp strncmp
586 #define SDL_strcasecmp strcasecmp
587 #define SDL_strncasecmp strncasecmp
588 #define SDL_sscanf sscanf
589 #define SDL_vsscanf vsscanf
590 #define SDL_snprintf snprintf
591 #define SDL_vsnprintf vsnprintf
void *(* SDL_realloc_func)(void *mem, size_t size)
char * SDL_strstr(const char *haystack, const char *needle)
int SDL_GetNumAllocations(void)
Get the number of outstanding (unfreed) allocations.
SDL_iconv_t SDL_iconv_open(const char *tocode, const char *fromcode)
SDL_FORCE_INLINE void * SDL_memcpy4(SDL_OUT_BYTECAP(dwords *4) void *dst, SDL_IN_BYTECAP(dwords *4) const void *src, size_t dwords)
int SDL_sscanf(const char *text, SDL_SCANF_FORMAT_STRING const char *fmt,...) SDL_SCANF_VARARG_FUNC(2)
size_t SDL_wcslcpy(SDL_OUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
int SDL_strcasecmp(const char *str1, const char *str2)
#define SDL_static_cast(type, expression)
double SDL_floor(double x)
wchar_t * SDL_wcsdup(const wchar_t *wstr)
void *(* SDL_calloc_func)(size_t nmemb, size_t size)
#define SDL_PRINTF_FORMAT_STRING
SDL_calloc_func calloc_func
SDL_malloc_func malloc_func
double SDL_atan2(double x, double y)
#define SDL_SCANF_VARARG_FUNC(fmtargnumber)
unsigned long SDL_strtoul(const char *str, char **endp, int base)
size_t SDL_strlcpy(SDL_OUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen)
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)
void * SDL_calloc(size_t nmemb, size_t size)
double SDL_copysign(double x, double y)
void * SDL_memmove(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len)
int SDL_memcmp(const void *s1, const void *s2, size_t len)
double SDL_atof(const char *str)
Uint64 SDL_strtoull(const char *str, char **endp, int base)
char * SDL_strupr(char *str)
size_t SDL_wcslen(const wchar_t *wstr)
#define SDL_INOUT_Z_CAP(x)
void SDL_GetMemoryFunctions(SDL_malloc_func *malloc_func, SDL_calloc_func *calloc_func, SDL_realloc_func *realloc_func, SDL_free_func *free_func)
Get the current set of SDL memory functions.
int SDL_iconv_close(SDL_iconv_t cd)
void * SDL_memset(SDL_OUT_BYTECAP(len) void *dst, int c, size_t len)
GLuint GLfloat GLfloat GLfloat GLfloat GLfloat GLfloat GLfloat GLfloat s1
long SDL_strtol(const char *str, char **endp, int base)
void * SDL_malloc(size_t size)
double SDL_log10(double x)
size_t SDL_wcslcat(SDL_INOUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
#define SDL_COMPILE_TIME_ASSERT(name, x)
float SDL_log10f(float x)
void(* SDL_free_func)(void *mem)
char * SDL_ltoa(long value, char *str, int radix)
GLint GLint GLint GLint GLint x
double SDL_acos(double x)
char * SDL_iconv_string(const char *tocode, const char *fromcode, const char *inbuf, size_t inbytesleft)
char * SDL_strrev(char *str)
char * SDL_ulltoa(Uint64 value, char *str, int radix)
GLuint const GLchar * name
char * SDL_itoa(int value, char *str, int radix)
size_t SDL_strlcat(SDL_INOUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen)
double SDL_ceil(double x)
int SDL_atoi(const char *str)
static char text[MAX_TEXT_LENGTH]
int SDL_strncmp(const char *str1, const char *str2, size_t maxlen)
size_t SDL_iconv(SDL_iconv_t cd, const char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft)
int SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, const char *fmt, va_list ap)
double SDL_scalbn(double x, int n)
double SDL_pow(double x, double y)
char * SDL_strdup(const char *str)
SDL_FORCE_INLINE void SDL_memset4(void *dst, Uint32 val, size_t dwords)
GLint GLint GLint GLint GLint GLint y
int SDL_setenv(const char *name, const char *value, int overwrite)
void * SDL_memcpy(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len)
float SDL_atan2f(float x, float y)
void *(* SDL_malloc_func)(size_t size)
double SDL_fabs(double x)
double SDL_fmod(double x, double y)
float SDL_floorf(float x)
float SDL_scalbnf(float x, int n)
char * SDL_uitoa(unsigned int value, char *str, int radix)
int SDL_SetMemoryFunctions(SDL_malloc_func malloc_func, SDL_calloc_func calloc_func, SDL_realloc_func realloc_func, SDL_free_func free_func)
Replace SDL's memory allocation functions with a custom set.
GLsizei const GLfloat * value
char * SDL_strchr(const char *str, int c)
int SDL_vsscanf(const char *text, const char *fmt, va_list ap)
#define SDL_OUT_BYTECAP(x)
double SDL_asin(double x)
double SDL_sqrt(double x)
int SDL_strcmp(const char *str1, const char *str2)
char * SDL_ultoa(unsigned long value, char *str, int radix)
#define SDL_PRINTF_VARARG_FUNC(fmtargnumber)
char * SDL_lltoa(Sint64 value, char *str, int radix)
SDL_realloc_func realloc_func
int SDL_wcscmp(const wchar_t *str1, const wchar_t *str2)
char * SDL_strlwr(char *str)
void * SDL_realloc(void *mem, size_t size)
char * SDL_getenv(const char *name)
float SDL_copysignf(float x, float y)
#define SDL_IN_BYTECAP(x)
int SDL_strncasecmp(const char *str1, const char *str2, size_t len)
#define SDL_SCANF_FORMAT_STRING
float SDL_powf(float x, float y)
const SDL_PRINTF_FORMAT_STRING char int const SDL_PRINTF_FORMAT_STRING char int const SDL_PRINTF_FORMAT_STRING char int const SDL_PRINTF_FORMAT_STRING char const char const SDL_SCANF_FORMAT_STRING char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
Sint64 SDL_strtoll(const char *str, char **endp, int base)
double SDL_strtod(const char *str, char **endp)
size_t SDL_utf8strlcpy(SDL_OUT_Z_CAP(dst_bytes) char *dst, const char *src, size_t dst_bytes)
size_t SDL_utf8strlen(const char *str)
void SDL_qsort(void *base, size_t nmemb, size_t size, int(*compare)(const void *, const void *))
char * SDL_strrchr(const char *str, int c)
unsigned long long uint64_t
float SDL_fmodf(float x, float y)
size_t SDL_strlen(const char *str)
double SDL_atan(double x)