375{
376 DUMMY_ENUM_VALUE
377} SDL_DUMMY_ENUM;
378
380#endif
381#endif
382
383
385
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
401extern DECLSPEC
void SDLCALL
SDL_free(
void *mem);
402
407
408
409
410
411
412
413
414
415
416
417
422
423
424
425
426
427
428
429
430
431
432
437
438
439
440
441
442
443
444
445
446
447
448
449
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
475
476
477
478
479
480
481
482
484
485
486
487
488
489
490
491
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
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
521
524
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
539
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);
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);
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);
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);
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
604
605#ifndef SDL_PI_D
606#define SDL_PI_D 3.141592653589793238462643383279502884
607#endif
608#ifndef SDL_PI_F
609#define SDL_PI_F 3.141592653589793238462643383279502884F
610#endif
611
612
613
614
615
616
617
618
619
620
621
622
623
624
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);
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
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
680 const char *fromcode);
683 size_t * inbytesleft, char **outbuf,
684 size_t * outbytesleft);
685
686
687
688
689
690
691
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
702
703#if defined(__clang_analyzer__) && !defined(SDL_DISABLE_ANALYZE_MACROS)
704
705
706#ifndef HAVE_STRLCPY
707size_t strlcpy(
char* dst,
const char* src,
size_t size);
708#endif
709
710
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
724
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
763{
765}
766
767
768
769
770
771
772
774 size_t b,
775 size_t *ret)
776{
778 return -1;
779 }
780 *ret = a * b;
781 return 0;
782}
783
784#if SDL_HAS_BUILTIN(__builtin_mul_overflow)
785
786
787
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
799
800
801
802
804 size_t b,
805 size_t *ret)
806{
808 return -1;
809 }
810 *ret = a + b;
811 return 0;
812}
813
814#if SDL_HAS_BUILTIN(__builtin_add_overflow)
815
816
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
827#ifdef SDL_FUNCTION_POINTER_IS_VOID_POINTER
829#else
831#endif
832
833
834#ifdef __cplusplus
835}
836#endif
838
839#endif
#define SDL_ALLOC_SIZE(p)
#define SDL_ALLOC_SIZE2(p1, p2)
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)
char * SDL_strtok_r(char *s1, const char *s2, char **saveptr)
char * SDL_strlwr(char *str)
struct SDL_iconv_data_t * SDL_iconv_t
wchar_t * SDL_wcsnstr(const wchar_t *haystack, const wchar_t *needle, size_t maxlen)
float SDL_modff(float x, float *y)
double SDL_modf(double x, double *y)
size_t SDL_iconv(SDL_iconv_t cd, const char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft)
char * SDL_ltoa(long value, char *str, int radix)
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)
#define SDL_OUT_BYTECAP(x)
char * SDL_strrchr(const char *str, int c)
int SDL_wcsncmp(const wchar_t *str1, const wchar_t *str2, size_t maxlen)
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 *))
#define SDL_PRINTF_VARARG_FUNCV(fmtargnumber)
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)
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)
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)
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)
double SDL_round(double x)
long SDL_lround(double x)
size_t SDL_strnlen(const char *str, size_t maxlen)
int SDL_iconv_close(SDL_iconv_t cd)
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)
double SDL_asin(double x)
double SDL_acos(double x)
wchar_t * SDL_wcsstr(const wchar_t *haystack, const wchar_t *needle)
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)
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
char * SDL_strstr(const char *haystack, const char *needle)
int SDL_GetNumAllocations(void)
size_t SDL_wcslcpy(SDL_OUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
double SDL_atan(double x)
size_t SDL_wcslen(const wchar_t *wstr)
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)
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)
float SDL_truncf(float x)
double SDL_log10(double 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)
void SDL_aligned_free(void *mem)
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)
int SDL_memcmp(const void *s1, const void *s2, size_t len)
char * SDL_ulltoa(Uint64 value, char *str, int radix)
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)
#define SDL_PRINTF_FORMAT_STRING
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)
#define SDL_COMPILE_TIME_ASSERT(name, x)
float SDL_atan2f(float y, float x)
long SDL_wcstol(const wchar_t *str, wchar_t **endp, int base)
SDL_MALLOC char * SDL_strdup(const char *str)
void *(* SDL_calloc_func)(size_t nmemb, size_t size)
#define SDL_SCANF_VARARG_FUNC(fmtargnumber)
double SDL_atan2(double y, double x)
void(* SDL_FunctionPointer)(void)
SDL_FORCE_INLINE void * SDL_memcpy4(SDL_OUT_BYTECAP(dwords *4) void *dst, SDL_IN_BYTECAP(dwords *4) const void *src, size_t dwords)
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)
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)
size_t SDL_utf8strlen(const char *str)
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_WPRINTF_VARARG_FUNC(fmtargnumber)
Uint64 SDL_strtoull(const char *str, char **endp, int base)
double SDL_trunc(double x)