31 #include "SDL_config.h" 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 93 #define SDL_arraysize(array) (sizeof(array)/sizeof(array[0])) 94 #define SDL_TABLESIZE(table) SDL_arraysize(table) 101 #define SDL_STRINGIFY_ARG(arg) #arg 111 #define SDL_reinterpret_cast(type, expression) reinterpret_cast<type>(expression) 112 #define SDL_static_cast(type, expression) static_cast<type>(expression) 113 #define SDL_const_cast(type, expression) const_cast<type>(expression) 115 #define SDL_reinterpret_cast(type, expression) ((type)(expression)) 116 #define SDL_static_cast(type, expression) ((type)(expression)) 117 #define SDL_const_cast(type, expression) ((type)(expression)) 122 #define SDL_FOURCC(A, B, C, D) \ 123 ((SDL_static_cast(Uint32, SDL_static_cast(Uint8, (A))) << 0) | \ 124 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (B))) << 8) | \ 125 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (C))) << 16) | \ 126 (SDL_static_cast(Uint32, SDL_static_cast(Uint8, (D))) << 24)) 137 typedef int SDL_bool;
149 #define SDL_MAX_SINT8 ((Sint8)0x7F) 150 #define SDL_MIN_SINT8 ((Sint8)(~0x7F)) 151 typedef int8_t Sint8;
155 #define SDL_MAX_UINT8 ((Uint8)0xFF) 156 #define SDL_MIN_UINT8 ((Uint8)0x00) 157 typedef uint8_t Uint8;
161 #define SDL_MAX_SINT16 ((Sint16)0x7FFF) 162 #define SDL_MIN_SINT16 ((Sint16)(~0x7FFF)) 163 typedef int16_t Sint16;
167 #define SDL_MAX_UINT16 ((Uint16)0xFFFF) 168 #define SDL_MIN_UINT16 ((Uint16)0x0000) 169 typedef uint16_t Uint16;
173 #define SDL_MAX_SINT32 ((Sint32)0x7FFFFFFF) 174 #define SDL_MIN_SINT32 ((Sint32)(~0x7FFFFFFF)) 175 typedef int32_t Sint32;
179 #define SDL_MAX_UINT32 ((Uint32)0xFFFFFFFFu) 180 #define SDL_MIN_UINT32 ((Uint32)0x00000000) 181 typedef uint32_t Uint32;
186 #define SDL_MAX_SINT64 ((Sint64)0x7FFFFFFFFFFFFFFFll) 187 #define SDL_MIN_SINT64 ((Sint64)(~0x7FFFFFFFFFFFFFFFll)) 188 typedef int64_t Sint64;
192 #define SDL_MAX_UINT64 ((Uint64)0xFFFFFFFFFFFFFFFFull) 193 #define SDL_MIN_UINT64 ((Uint64)(0x0000000000000000ull)) 194 typedef uint64_t Uint64;
203 #define SDL_PRIs64 PRIs64 204 #elif defined(__WIN32__) 205 #define SDL_PRIs64 "I64d" 206 #elif defined(__LINUX__) && defined(__LP64__) 207 #define SDL_PRIs64 "ld" 209 #define SDL_PRIs64 "lld" 214 #define SDL_PRIu64 PRIu64 215 #elif defined(__WIN32__) 216 #define SDL_PRIu64 "I64u" 217 #elif defined(__LINUX__) && defined(__LP64__) 218 #define SDL_PRIu64 "lu" 220 #define SDL_PRIu64 "llu" 225 #define SDL_PRIx64 PRIx64 226 #elif defined(__WIN32__) 227 #define SDL_PRIx64 "I64x" 228 #elif defined(__LINUX__) && defined(__LP64__) 229 #define SDL_PRIx64 "lx" 231 #define SDL_PRIx64 "llx" 236 #define SDL_PRIX64 PRIX64 237 #elif defined(__WIN32__) 238 #define SDL_PRIX64 "I64X" 239 #elif defined(__LINUX__) && defined(__LP64__) 240 #define SDL_PRIX64 "lX" 242 #define SDL_PRIX64 "llX" 247 #ifdef SDL_DISABLE_ANALYZE_MACROS 248 #define SDL_IN_BYTECAP(x) 249 #define SDL_INOUT_Z_CAP(x) 250 #define SDL_OUT_Z_CAP(x) 251 #define SDL_OUT_CAP(x) 252 #define SDL_OUT_BYTECAP(x) 253 #define SDL_OUT_Z_BYTECAP(x) 254 #define SDL_PRINTF_FORMAT_STRING 255 #define SDL_SCANF_FORMAT_STRING 256 #define SDL_PRINTF_VARARG_FUNC( fmtargnumber ) 257 #define SDL_SCANF_VARARG_FUNC( fmtargnumber ) 259 #if defined(_MSC_VER) && (_MSC_VER >= 1600) 262 #define SDL_IN_BYTECAP(x) _In_bytecount_(x) 263 #define SDL_INOUT_Z_CAP(x) _Inout_z_cap_(x) 264 #define SDL_OUT_Z_CAP(x) _Out_z_cap_(x) 265 #define SDL_OUT_CAP(x) _Out_cap_(x) 266 #define SDL_OUT_BYTECAP(x) _Out_bytecap_(x) 267 #define SDL_OUT_Z_BYTECAP(x) _Out_z_bytecap_(x) 269 #define SDL_PRINTF_FORMAT_STRING _Printf_format_string_ 270 #define SDL_SCANF_FORMAT_STRING _Scanf_format_string_impl_ 272 #define SDL_IN_BYTECAP(x) 273 #define SDL_INOUT_Z_CAP(x) 274 #define SDL_OUT_Z_CAP(x) 275 #define SDL_OUT_CAP(x) 276 #define SDL_OUT_BYTECAP(x) 277 #define SDL_OUT_Z_BYTECAP(x) 278 #define SDL_PRINTF_FORMAT_STRING 279 #define SDL_SCANF_FORMAT_STRING 281 #if defined(__GNUC__) 282 #define SDL_PRINTF_VARARG_FUNC( fmtargnumber ) __attribute__ (( format( __printf__, fmtargnumber, fmtargnumber+1 ))) 283 #define SDL_SCANF_VARARG_FUNC( fmtargnumber ) __attribute__ (( format( __scanf__, fmtargnumber, fmtargnumber+1 ))) 285 #define SDL_PRINTF_VARARG_FUNC( fmtargnumber ) 286 #define SDL_SCANF_VARARG_FUNC( fmtargnumber ) 290 #define SDL_COMPILE_TIME_ASSERT(name, x) \ 291 typedef int SDL_compile_time_assert_ ## name[(x) * 2 - 1] 293 #ifndef DOXYGEN_SHOULD_IGNORE_THIS 294 SDL_COMPILE_TIME_ASSERT(uint8,
sizeof(Uint8) == 1);
295 SDL_COMPILE_TIME_ASSERT(sint8,
sizeof(Sint8) == 1);
296 SDL_COMPILE_TIME_ASSERT(uint16,
sizeof(Uint16) == 2);
297 SDL_COMPILE_TIME_ASSERT(sint16,
sizeof(Sint16) == 2);
298 SDL_COMPILE_TIME_ASSERT(uint32,
sizeof(Uint32) == 4);
299 SDL_COMPILE_TIME_ASSERT(sint32,
sizeof(Sint32) == 4);
300 SDL_COMPILE_TIME_ASSERT(uint64,
sizeof(Uint64) == 8);
301 SDL_COMPILE_TIME_ASSERT(sint64,
sizeof(Sint64) == 8);
312 #ifndef DOXYGEN_SHOULD_IGNORE_THIS 313 #if !defined(__ANDROID__) 320 SDL_COMPILE_TIME_ASSERT(
enum,
sizeof(SDL_DUMMY_ENUM) ==
sizeof(
int));
331 #if defined(HAVE_ALLOCA) && !defined(alloca) 332 # if defined(HAVE_ALLOCA_H) 334 # elif defined(__GNUC__) 335 # define alloca __builtin_alloca 336 # elif defined(_MSC_VER) 338 # define alloca _alloca 339 # elif defined(__WATCOMC__) 341 # elif defined(__BORLANDC__) 343 # elif defined(__DMC__) 345 # elif defined(__AIX__) 347 # elif defined(__MRC__) 348 void *alloca(
unsigned);
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) 361 extern DECLSPEC
void *SDLCALL SDL_malloc(
size_t size);
362 extern DECLSPEC
void *SDLCALL SDL_calloc(
size_t nmemb,
size_t size);
363 extern DECLSPEC
void *SDLCALL SDL_realloc(
void *mem,
size_t size);
364 extern DECLSPEC
void SDLCALL SDL_free(
void *mem);
366 typedef void *(SDLCALL *SDL_malloc_func)(
size_t size);
367 typedef void *(SDLCALL *SDL_calloc_func)(
size_t nmemb,
size_t size);
368 typedef void *(SDLCALL *SDL_realloc_func)(
void *mem,
size_t size);
369 typedef void (SDLCALL *SDL_free_func)(
void *mem);
375 SDL_calloc_func *calloc_func,
376 SDL_realloc_func *realloc_func,
377 SDL_free_func *free_func);
388 SDL_calloc_func calloc_func,
389 SDL_realloc_func realloc_func,
390 SDL_free_func free_func);
397 extern DECLSPEC
char *SDLCALL SDL_getenv(
const char *name);
398 extern DECLSPEC
int SDLCALL SDL_setenv(
const char *name,
const char *value,
int overwrite);
400 extern DECLSPEC
void SDLCALL SDL_qsort(
void *base,
size_t nmemb,
size_t size,
int (*compare) (
const void *,
const void *));
402 extern DECLSPEC
int SDLCALL SDL_abs(
int x);
406 #define SDL_min(x, y) (((x) < (y)) ? (x) : (y)) 407 #define SDL_max(x, y) (((x) > (y)) ? (x) : (y)) 409 extern DECLSPEC
int SDLCALL SDL_isdigit(
int x);
410 extern DECLSPEC
int SDLCALL SDL_isspace(
int x);
411 extern DECLSPEC
int SDLCALL SDL_toupper(
int x);
412 extern DECLSPEC
int SDLCALL SDL_tolower(
int x);
414 extern DECLSPEC
void *SDLCALL SDL_memset(SDL_OUT_BYTECAP(len)
void *dst,
int c,
size_t len);
416 #define SDL_zero(x) SDL_memset(&(x), 0, sizeof((x))) 417 #define SDL_zerop(x) SDL_memset((x), 0, sizeof(*(x))) 420 SDL_FORCE_INLINE
void SDL_memset4(
void *dst, Uint32 val,
size_t dwords)
422 #if defined(__GNUC__) && defined(i386) 424 __asm__ __volatile__ (
427 :
"=&D" (u0),
"=&a" (u1),
"=&c" (u2)
428 :
"0" (dst),
"1" (val),
"2" (SDL_static_cast(Uint32, dwords))
432 size_t _n = (dwords + 3) / 4;
433 Uint32 *_p = SDL_static_cast(Uint32 *, dst);
439 case 0:
do { *_p++ = _val;
440 case 3: *_p++ = _val;
441 case 2: *_p++ = _val;
442 case 1: *_p++ = _val;
449 extern DECLSPEC
void *SDLCALL SDL_memcpy(SDL_OUT_BYTECAP(len)
void *dst, SDL_IN_BYTECAP(len)
const void *src,
size_t len);
451 extern DECLSPEC
void *SDLCALL SDL_memmove(SDL_OUT_BYTECAP(len)
void *dst, SDL_IN_BYTECAP(len)
const void *src,
size_t len);
452 extern DECLSPEC
int SDLCALL SDL_memcmp(
const void *s1,
const void *s2,
size_t len);
454 extern DECLSPEC
size_t SDLCALL SDL_wcslen(
const wchar_t *wstr);
455 extern DECLSPEC
size_t SDLCALL SDL_wcslcpy(SDL_OUT_Z_CAP(maxlen)
wchar_t *dst,
const wchar_t *src,
size_t maxlen);
456 extern DECLSPEC
size_t SDLCALL SDL_wcslcat(SDL_INOUT_Z_CAP(maxlen)
wchar_t *dst,
const wchar_t *src,
size_t maxlen);
457 extern DECLSPEC
int SDLCALL SDL_wcscmp(
const wchar_t *str1,
const wchar_t *str2);
459 extern DECLSPEC
size_t SDLCALL SDL_strlen(
const char *str);
460 extern DECLSPEC
size_t SDLCALL SDL_strlcpy(SDL_OUT_Z_CAP(maxlen)
char *dst,
const char *src,
size_t maxlen);
461 extern DECLSPEC
size_t SDLCALL SDL_utf8strlcpy(SDL_OUT_Z_CAP(dst_bytes)
char *dst,
const char *src,
size_t dst_bytes);
462 extern DECLSPEC
size_t SDLCALL SDL_strlcat(SDL_INOUT_Z_CAP(maxlen)
char *dst,
const char *src,
size_t maxlen);
463 extern DECLSPEC
char *SDLCALL SDL_strdup(
const char *str);
464 extern DECLSPEC
char *SDLCALL SDL_strrev(
char *str);
465 extern DECLSPEC
char *SDLCALL SDL_strupr(
char *str);
466 extern DECLSPEC
char *SDLCALL SDL_strlwr(
char *str);
467 extern DECLSPEC
char *SDLCALL SDL_strchr(
const char *str,
int c);
468 extern DECLSPEC
char *SDLCALL SDL_strrchr(
const char *str,
int c);
469 extern DECLSPEC
char *SDLCALL SDL_strstr(
const char *haystack,
const char *needle);
470 extern DECLSPEC
size_t SDLCALL SDL_utf8strlen(
const char *str);
472 extern DECLSPEC
char *SDLCALL SDL_itoa(
int value,
char *str,
int radix);
473 extern DECLSPEC
char *SDLCALL SDL_uitoa(
unsigned int value,
char *str,
int radix);
474 extern DECLSPEC
char *SDLCALL SDL_ltoa(
long value,
char *str,
int radix);
475 extern DECLSPEC
char *SDLCALL SDL_ultoa(
unsigned long value,
char *str,
int radix);
476 extern DECLSPEC
char *SDLCALL SDL_lltoa(Sint64 value,
char *str,
int radix);
477 extern DECLSPEC
char *SDLCALL SDL_ulltoa(Uint64 value,
char *str,
int radix);
479 extern DECLSPEC
int SDLCALL SDL_atoi(
const char *str);
480 extern DECLSPEC
double SDLCALL SDL_atof(
const char *str);
481 extern DECLSPEC
long SDLCALL SDL_strtol(
const char *str,
char **endp,
int base);
482 extern DECLSPEC
unsigned long SDLCALL SDL_strtoul(
const char *str,
char **endp,
int base);
483 extern DECLSPEC Sint64 SDLCALL SDL_strtoll(
const char *str,
char **endp,
int base);
484 extern DECLSPEC Uint64 SDLCALL SDL_strtoull(
const char *str,
char **endp,
int base);
485 extern DECLSPEC
double SDLCALL SDL_strtod(
const char *str,
char **endp);
487 extern DECLSPEC
int SDLCALL SDL_strcmp(
const char *str1,
const char *str2);
488 extern DECLSPEC
int SDLCALL SDL_strncmp(
const char *str1,
const char *str2,
size_t maxlen);
489 extern DECLSPEC
int SDLCALL SDL_strcasecmp(
const char *str1,
const char *str2);
490 extern DECLSPEC
int SDLCALL SDL_strncasecmp(
const char *str1,
const char *str2,
size_t len);
492 extern DECLSPEC
int SDLCALL SDL_sscanf(
const char *text, SDL_SCANF_FORMAT_STRING
const char *fmt, ...) SDL_SCANF_VARARG_FUNC(2);
493 extern DECLSPEC
int SDLCALL SDL_vsscanf(const
char *text, const
char *fmt, va_list ap);
494 extern 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);
495 extern DECLSPEC
int SDLCALL SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen)
char *text,
size_t maxlen, const
char *fmt, va_list ap);
499 #define M_PI 3.14159265358979323846264338327950288 503 extern DECLSPEC
double SDLCALL SDL_acos(
double x);
504 extern DECLSPEC
float SDLCALL SDL_acosf(
float x);
505 extern DECLSPEC
double SDLCALL SDL_asin(
double x);
506 extern DECLSPEC
float SDLCALL SDL_asinf(
float x);
507 extern DECLSPEC
double SDLCALL SDL_atan(
double x);
508 extern DECLSPEC
float SDLCALL SDL_atanf(
float x);
509 extern DECLSPEC
double SDLCALL SDL_atan2(
double x,
double y);
510 extern DECLSPEC
float SDLCALL SDL_atan2f(
float x,
float y);
511 extern DECLSPEC
double SDLCALL SDL_ceil(
double x);
512 extern DECLSPEC
float SDLCALL SDL_ceilf(
float x);
513 extern DECLSPEC
double SDLCALL SDL_copysign(
double x,
double y);
514 extern DECLSPEC
float SDLCALL SDL_copysignf(
float x,
float y);
515 extern DECLSPEC
double SDLCALL SDL_cos(
double x);
516 extern DECLSPEC
float SDLCALL SDL_cosf(
float x);
517 extern DECLSPEC
double SDLCALL SDL_fabs(
double x);
518 extern DECLSPEC
float SDLCALL SDL_fabsf(
float x);
519 extern DECLSPEC
double SDLCALL SDL_floor(
double x);
520 extern DECLSPEC
float SDLCALL SDL_floorf(
float x);
521 extern DECLSPEC
double SDLCALL SDL_fmod(
double x,
double y);
522 extern DECLSPEC
float SDLCALL SDL_fmodf(
float x,
float y);
523 extern DECLSPEC
double SDLCALL SDL_log(
double x);
524 extern DECLSPEC
float SDLCALL SDL_logf(
float x);
525 extern DECLSPEC
double SDLCALL SDL_log10(
double x);
526 extern DECLSPEC
float SDLCALL SDL_log10f(
float x);
527 extern DECLSPEC
double SDLCALL SDL_pow(
double x,
double y);
528 extern DECLSPEC
float SDLCALL SDL_powf(
float x,
float y);
529 extern DECLSPEC
double SDLCALL SDL_scalbn(
double x,
int n);
530 extern DECLSPEC
float SDLCALL SDL_scalbnf(
float x,
int n);
531 extern DECLSPEC
double SDLCALL SDL_sin(
double x);
532 extern DECLSPEC
float SDLCALL SDL_sinf(
float x);
533 extern DECLSPEC
double SDLCALL SDL_sqrt(
double x);
534 extern DECLSPEC
float SDLCALL SDL_sqrtf(
float x);
535 extern DECLSPEC
double SDLCALL SDL_tan(
double x);
536 extern DECLSPEC
float SDLCALL SDL_tanf(
float x);
539 #define SDL_ICONV_ERROR (size_t)-1 540 #define SDL_ICONV_E2BIG (size_t)-2 541 #define SDL_ICONV_EILSEQ (size_t)-3 542 #define SDL_ICONV_EINVAL (size_t)-4 545 typedef struct _SDL_iconv_t *SDL_iconv_t;
546 extern DECLSPEC SDL_iconv_t SDLCALL SDL_iconv_open(
const char *tocode,
547 const char *fromcode);
548 extern DECLSPEC
int SDLCALL SDL_iconv_close(SDL_iconv_t cd);
549 extern DECLSPEC
size_t SDLCALL SDL_iconv(SDL_iconv_t cd,
const char **inbuf,
550 size_t * inbytesleft,
char **outbuf,
551 size_t * outbytesleft);
557 const char *fromcode,
560 #define SDL_iconv_utf8_locale(S) SDL_iconv_string("", "UTF-8", S, SDL_strlen(S)+1) 561 #define SDL_iconv_utf8_ucs2(S) (Uint16 *)SDL_iconv_string("UCS-2-INTERNAL", "UTF-8", S, SDL_strlen(S)+1) 562 #define SDL_iconv_utf8_ucs4(S) (Uint32 *)SDL_iconv_string("UCS-4-INTERNAL", "UTF-8", S, SDL_strlen(S)+1) 566 #if defined(__clang_analyzer__) && !defined(SDL_DISABLE_ANALYZE_MACROS) 567 #define SDL_malloc malloc 568 #define SDL_calloc calloc 569 #define SDL_realloc realloc 570 #define SDL_free free 571 #define SDL_memset memset 572 #define SDL_memcpy memcpy 573 #define SDL_memmove memmove 574 #define SDL_memcmp memcmp 575 #define SDL_strlen strlen 576 #define SDL_strlcpy strlcpy 577 #define SDL_strlcat strlcat 578 #define SDL_strdup strdup 579 #define SDL_strchr strchr 580 #define SDL_strrchr strrchr 581 #define SDL_strstr strstr 582 #define SDL_strcmp strcmp 583 #define SDL_strncmp strncmp 584 #define SDL_strcasecmp strcasecmp 585 #define SDL_strncasecmp strncasecmp 586 #define SDL_sscanf sscanf 587 #define SDL_vsscanf vsscanf 588 #define SDL_snprintf snprintf 589 #define SDL_vsnprintf vsnprintf 592 SDL_FORCE_INLINE
void *SDL_memcpy4(SDL_OUT_BYTECAP(dwords*4)
void *dst, SDL_IN_BYTECAP(dwords*4)
const void *src,
size_t dwords)
594 return SDL_memcpy(dst, src, dwords * 4);
DECLSPEC int SDLCALL SDL_GetNumAllocations(void)
Get the number of outstanding (unfreed) allocations.
DECLSPEC char *SDLCALL SDL_iconv_string(const char *tocode, const char *fromcode, const char *inbuf, size_t inbytesleft)
DECLSPEC void SDLCALL 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.
DECLSPEC int SDLCALL 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.