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 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)) 159 typedef int SDL_bool;
171 #define SDL_MAX_SINT8 ((Sint8)0x7F) 172 #define SDL_MIN_SINT8 ((Sint8)(~0x7F)) 173 typedef int8_t Sint8;
177 #define SDL_MAX_UINT8 ((Uint8)0xFF) 178 #define SDL_MIN_UINT8 ((Uint8)0x00) 179 typedef uint8_t Uint8;
183 #define SDL_MAX_SINT16 ((Sint16)0x7FFF) 184 #define SDL_MIN_SINT16 ((Sint16)(~0x7FFF)) 185 typedef int16_t Sint16;
189 #define SDL_MAX_UINT16 ((Uint16)0xFFFF) 190 #define SDL_MIN_UINT16 ((Uint16)0x0000) 191 typedef uint16_t Uint16;
195 #define SDL_MAX_SINT32 ((Sint32)0x7FFFFFFF) 196 #define SDL_MIN_SINT32 ((Sint32)(~0x7FFFFFFF)) 197 typedef int32_t Sint32;
201 #define SDL_MAX_UINT32 ((Uint32)0xFFFFFFFFu) 202 #define SDL_MIN_UINT32 ((Uint32)0x00000000) 203 typedef uint32_t Uint32;
208 #define SDL_MAX_SINT64 ((Sint64)0x7FFFFFFFFFFFFFFFll) 209 #define SDL_MIN_SINT64 ((Sint64)(~0x7FFFFFFFFFFFFFFFll)) 210 typedef int64_t Sint64;
214 #define SDL_MAX_UINT64 ((Uint64)0xFFFFFFFFFFFFFFFFull) 215 #define SDL_MIN_UINT64 ((Uint64)(0x0000000000000000ull)) 216 typedef uint64_t Uint64;
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 316 SDL_COMPILE_TIME_ASSERT(uint8,
sizeof(Uint8) == 1);
317 SDL_COMPILE_TIME_ASSERT(sint8,
sizeof(Sint8) == 1);
318 SDL_COMPILE_TIME_ASSERT(uint16,
sizeof(Uint16) == 2);
319 SDL_COMPILE_TIME_ASSERT(sint16,
sizeof(Sint16) == 2);
320 SDL_COMPILE_TIME_ASSERT(uint32,
sizeof(Uint32) == 4);
321 SDL_COMPILE_TIME_ASSERT(sint32,
sizeof(Sint32) == 4);
322 SDL_COMPILE_TIME_ASSERT(uint64,
sizeof(Uint64) == 8);
323 SDL_COMPILE_TIME_ASSERT(sint64,
sizeof(Sint64) == 8);
334 #ifndef DOXYGEN_SHOULD_IGNORE_THIS 335 #if !defined(__ANDROID__) 342 SDL_COMPILE_TIME_ASSERT(
enum,
sizeof(SDL_DUMMY_ENUM) ==
sizeof(
int));
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;
448 extern DECLSPEC
void *SDLCALL SDL_memcpy(SDL_OUT_BYTECAP(len)
void *dst, SDL_IN_BYTECAP(len)
const void *src,
size_t len);
450 extern DECLSPEC
void *SDLCALL SDL_memmove(SDL_OUT_BYTECAP(len)
void *dst, SDL_IN_BYTECAP(len)
const void *src,
size_t len);
451 extern DECLSPEC
int SDLCALL SDL_memcmp(
const void *s1,
const void *s2,
size_t len);
453 extern DECLSPEC
wchar_t *SDLCALL SDL_wcsdup(
const wchar_t *wstr);
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_exp(
double x);
518 extern DECLSPEC
float SDLCALL SDL_expf(
float x);
519 extern DECLSPEC
double SDLCALL SDL_fabs(
double x);
520 extern DECLSPEC
float SDLCALL SDL_fabsf(
float x);
521 extern DECLSPEC
double SDLCALL SDL_floor(
double x);
522 extern DECLSPEC
float SDLCALL SDL_floorf(
float x);
523 extern DECLSPEC
double SDLCALL SDL_fmod(
double x,
double y);
524 extern DECLSPEC
float SDLCALL SDL_fmodf(
float x,
float y);
525 extern DECLSPEC
double SDLCALL SDL_log(
double x);
526 extern DECLSPEC
float SDLCALL SDL_logf(
float x);
527 extern DECLSPEC
double SDLCALL SDL_log10(
double x);
528 extern DECLSPEC
float SDLCALL SDL_log10f(
float x);
529 extern DECLSPEC
double SDLCALL SDL_pow(
double x,
double y);
530 extern DECLSPEC
float SDLCALL SDL_powf(
float x,
float y);
531 extern DECLSPEC
double SDLCALL SDL_scalbn(
double x,
int n);
532 extern DECLSPEC
float SDLCALL SDL_scalbnf(
float x,
int n);
533 extern DECLSPEC
double SDLCALL SDL_sin(
double x);
534 extern DECLSPEC
float SDLCALL SDL_sinf(
float x);
535 extern DECLSPEC
double SDLCALL SDL_sqrt(
double x);
536 extern DECLSPEC
float SDLCALL SDL_sqrtf(
float x);
537 extern DECLSPEC
double SDLCALL SDL_tan(
double x);
538 extern DECLSPEC
float SDLCALL SDL_tanf(
float x);
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 547 typedef struct _SDL_iconv_t *SDL_iconv_t;
548 extern DECLSPEC SDL_iconv_t SDLCALL SDL_iconv_open(
const char *tocode,
549 const char *fromcode);
550 extern DECLSPEC
int SDLCALL SDL_iconv_close(SDL_iconv_t cd);
551 extern DECLSPEC
size_t SDLCALL SDL_iconv(SDL_iconv_t cd,
const char **inbuf,
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 594 SDL_FORCE_INLINE
void *SDL_memcpy4(SDL_OUT_BYTECAP(dwords*4)
void *dst, SDL_IN_BYTECAP(dwords*4)
const void *src,
size_t dwords)
596 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.