[sdl_omap.git] / include / SDL_stdinc.h

/*
    SDL - Simple DirectMedia Layer
    Copyright (C) 1997-2009 Sam Lantinga

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    Sam Lantinga
    slouken@libsdl.org
*/

/** @file SDL_stdinc.h
 *  This is a general header that includes C language support
 */

#ifndef _SDL_stdinc_h
#define _SDL_stdinc_h

#include "SDL_config.h"


#ifdef HAVE_SYS_TYPES_H
#include <sys/types.h>
#endif
#ifdef HAVE_STDIO_H
#include <stdio.h>
#endif
#if defined(STDC_HEADERS)
# include <stdlib.h>
# include <stddef.h>
# include <stdarg.h>
#else
# if defined(HAVE_STDLIB_H)
#  include <stdlib.h>
# elif defined(HAVE_MALLOC_H)
#  include <malloc.h>
# endif
# if defined(HAVE_STDDEF_H)
#  include <stddef.h>
# endif
# if defined(HAVE_STDARG_H)
#  include <stdarg.h>
# endif
#endif
#ifdef HAVE_STRING_H
# if !defined(STDC_HEADERS) && defined(HAVE_MEMORY_H)
#  include <memory.h>
# endif
# include <string.h>
#endif
#ifdef HAVE_STRINGS_H
# include <strings.h>
#endif
#if defined(HAVE_INTTYPES_H)
# include <inttypes.h>
#elif defined(HAVE_STDINT_H)
# include <stdint.h>
#endif
#ifdef HAVE_CTYPE_H
# include <ctype.h>
#endif
#if defined(HAVE_ICONV) && defined(HAVE_ICONV_H)
# include <iconv.h>
#endif

/** The number of elements in an array */
#define SDL_arraysize(array)	(sizeof(array)/sizeof(array[0]))
#define SDL_TABLESIZE(table)	SDL_arraysize(table)

/* Use proper C++ casts when compiled as C++ to be compatible with the option
 -Wold-style-cast of GCC (and -Werror=old-style-cast in GCC 4.2 and above. */
#ifdef __cplusplus
#define SDL_reinterpret_cast(type, expression) reinterpret_cast<type>(expression)
#define SDL_static_cast(type, expression) static_cast<type>(expression)
#else
#define SDL_reinterpret_cast(type, expression) ((type)(expression))
#define SDL_static_cast(type, expression) ((type)(expression))
#endif

/** @name Basic data types */
/*@{*/
typedef enum {
	SDL_FALSE = 0,
	SDL_TRUE  = 1
} SDL_bool;

typedef int8_t		Sint8;
typedef uint8_t		Uint8;
typedef int16_t		Sint16;
typedef uint16_t	Uint16;
typedef int32_t		Sint32;
typedef uint32_t	Uint32;

#ifdef SDL_HAS_64BIT_TYPE
typedef int64_t		Sint64;
#ifndef SYMBIAN32_GCCE
typedef uint64_t	Uint64;
#endif
#else
/* This is really just a hack to prevent the compiler from complaining */
typedef struct {
	Uint32 hi;
	Uint32 lo;
} Uint64, Sint64;
#endif

/*@}*/

/** @name Make sure the types really have the right sizes */
/*@{*/
#define SDL_COMPILE_TIME_ASSERT(name, x)               \
       typedef int SDL_dummy_ ## name[(x) * 2 - 1]

SDL_COMPILE_TIME_ASSERT(uint8, sizeof(Uint8) == 1);
SDL_COMPILE_TIME_ASSERT(sint8, sizeof(Sint8) == 1);
SDL_COMPILE_TIME_ASSERT(uint16, sizeof(Uint16) == 2);
SDL_COMPILE_TIME_ASSERT(sint16, sizeof(Sint16) == 2);
SDL_COMPILE_TIME_ASSERT(uint32, sizeof(Uint32) == 4);
SDL_COMPILE_TIME_ASSERT(sint32, sizeof(Sint32) == 4);
SDL_COMPILE_TIME_ASSERT(uint64, sizeof(Uint64) == 8);
SDL_COMPILE_TIME_ASSERT(sint64, sizeof(Sint64) == 8);
/*@}*/

/** @name Enum Size Check
 *  Check to make sure enums are the size of ints, for structure packing.
 *  For both Watcom C/C++ and Borland C/C++ the compiler option that makes
 *  enums having the size of an int must be enabled.
 *  This is "-b" for Borland C/C++ and "-ei" for Watcom C/C++ (v11).
 */
/* Enable enums always int in CodeWarrior (for MPW use "-enum int") */
#ifdef __MWERKS__
#pragma enumsalwaysint on
#endif

typedef enum {
	DUMMY_ENUM_VALUE
} SDL_DUMMY_ENUM;

#ifndef __NDS__
SDL_COMPILE_TIME_ASSERT(enum, sizeof(SDL_DUMMY_ENUM) == sizeof(int));
#endif
/*@}*/

#include "begin_code.h"
/* Set up for C function definitions, even when using C++ */
#ifdef __cplusplus
extern "C" {
#endif

#ifdef HAVE_MALLOC
#define SDL_malloc	malloc
#else
extern DECLSPEC void * SDLCALL SDL_malloc(size_t size);
#endif

#ifdef HAVE_CALLOC
#define SDL_calloc	calloc
#else
extern DECLSPEC void * SDLCALL SDL_calloc(size_t nmemb, size_t size);
#endif

#ifdef HAVE_REALLOC
#define SDL_realloc	realloc
#else
extern DECLSPEC void * SDLCALL SDL_realloc(void *mem, size_t size);
#endif

#ifdef HAVE_FREE
#define SDL_free	free
#else
extern DECLSPEC void SDLCALL SDL_free(void *mem);
#endif

#if defined(HAVE_ALLOCA) && !defined(alloca)
# if defined(HAVE_ALLOCA_H)
#  include <alloca.h>
# elif defined(__GNUC__)
#  define alloca __builtin_alloca
# elif defined(_MSC_VER)
#  include <malloc.h>
#  define alloca _alloca
# elif defined(__WATCOMC__)
#  include <malloc.h>
# elif defined(__BORLANDC__)
#  include <malloc.h>
# elif defined(__DMC__)
#  include <stdlib.h>
# elif defined(__AIX__)
  #pragma alloca
# elif defined(__MRC__)
   void *alloca (unsigned);
# else
   char *alloca ();
# endif
#endif
#ifdef HAVE_ALLOCA
#define SDL_stack_alloc(type, count)    (type*)alloca(sizeof(type)*(count))
#define SDL_stack_free(data)
#else
#define SDL_stack_alloc(type, count)    (type*)SDL_malloc(sizeof(type)*(count))
#define SDL_stack_free(data)            SDL_free(data)
#endif

#ifdef HAVE_GETENV
#define SDL_getenv	getenv
#else
extern DECLSPEC char * SDLCALL SDL_getenv(const char *name);
#endif

#ifdef HAVE_PUTENV
#define SDL_putenv	putenv
#else
extern DECLSPEC int SDLCALL SDL_putenv(const char *variable);
#endif

#ifdef HAVE_QSORT
#define SDL_qsort	qsort
#else
extern DECLSPEC void SDLCALL SDL_qsort(void *base, size_t nmemb, size_t size,
           int (*compare)(const void *, const void *));
#endif

#ifdef HAVE_ABS
#define SDL_abs		abs
#else
#define SDL_abs(X)	((X) < 0 ? -(X) : (X))
#endif

#define SDL_min(x, y)	(((x) < (y)) ? (x) : (y))
#define SDL_max(x, y)	(((x) > (y)) ? (x) : (y))

#ifdef HAVE_CTYPE_H
#define SDL_isdigit(X)  isdigit(X)
#define SDL_isspace(X)  isspace(X)
#define SDL_toupper(X)  toupper(X)
#define SDL_tolower(X)  tolower(X)
#else
#define SDL_isdigit(X)  (((X) >= '0') && ((X) <= '9'))
#define SDL_isspace(X)  (((X) == ' ') || ((X) == '\t') || ((X) == '\r') || ((X) == '\n'))
#define SDL_toupper(X)  (((X) >= 'a') && ((X) <= 'z') ? ('A'+((X)-'a')) : (X))
#define SDL_tolower(X)  (((X) >= 'A') && ((X) <= 'Z') ? ('a'+((X)-'A')) : (X))
#endif

#ifdef HAVE_MEMSET
#define SDL_memset      memset
#else
extern DECLSPEC void * SDLCALL SDL_memset(void *dst, int c, size_t len);
#endif

#if defined(__GNUC__) && defined(i386)
#define SDL_memset4(dst, val, len)				\
do {								\
	int u0, u1, u2;						\
	__asm__ __volatile__ (					\
		"cld\n\t"					\
		"rep ; stosl\n\t"				\
		: "=&D" (u0), "=&a" (u1), "=&c" (u2)		\
		: "0" (dst), "1" (val), "2" (SDL_static_cast(Uint32, len))	\
		: "memory" );					\
} while(0)
#endif
#ifndef SDL_memset4
#define SDL_memset4(dst, val, len)		\
do {						\
	unsigned _count = (len);		\
	unsigned _n = (_count + 3) / 4;		\
	Uint32 *_p = SDL_static_cast(Uint32 *, dst);	\
	Uint32 _val = (val);			\
	if (len == 0) break;			\
        switch (_count % 4) {			\
        case 0: do {    *_p++ = _val;		\
        case 3:         *_p++ = _val;		\
        case 2:         *_p++ = _val;		\
        case 1:         *_p++ = _val;		\
		} while ( --_n );		\
	}					\
} while(0)
#endif

/* We can count on memcpy existing on Mac OS X and being well-tuned. */
#if defined(__MACH__) && defined(__APPLE__)
#define SDL_memcpy(dst, src, len) memcpy(dst, src, len)
#elif defined(__GNUC__) && defined(i386)
#define SDL_memcpy(dst, src, len)					  \
do {									  \
	int u0, u1, u2;						  	  \
	__asm__ __volatile__ (						  \
		"cld\n\t"						  \
		"rep ; movsl\n\t"					  \
		"testb $2,%b4\n\t"					  \
		"je 1f\n\t"						  \
		"movsw\n"						  \
		"1:\ttestb $1,%b4\n\t"					  \
		"je 2f\n\t"						  \
		"movsb\n"						  \
		"2:"							  \
		: "=&c" (u0), "=&D" (u1), "=&S" (u2)			  \
		: "0" (SDL_static_cast(unsigned, len)/4), "q" (len), "1" (dst),"2" (src) \
		: "memory" );						  \
} while(0)
#endif
#ifndef SDL_memcpy
#ifdef HAVE_MEMCPY
#define SDL_memcpy      memcpy
#elif defined(HAVE_BCOPY)
#define SDL_memcpy(d, s, n)	bcopy((s), (d), (n))
#else
extern DECLSPEC void * SDLCALL SDL_memcpy(void *dst, const void *src, size_t len);
#endif
#endif

/* We can count on memcpy existing on Mac OS X and being well-tuned. */
#if defined(__MACH__) && defined(__APPLE__)
#define SDL_memcpy4(dst, src, len) memcpy(dst, src, (len)*4)
#elif defined(__GNUC__) && defined(i386)
#define SDL_memcpy4(dst, src, len)				\
do {								\
	int ecx, edi, esi;					\
	__asm__ __volatile__ (					\
		"cld\n\t"					\
		"rep ; movsl"					\
		: "=&c" (ecx), "=&D" (edi), "=&S" (esi)		\
		: "0" (SDL_static_cast(unsigned, len)), "1" (dst), "2" (src)	\
		: "memory" );					\
} while(0)
#endif
#ifndef SDL_memcpy4
#define SDL_memcpy4(dst, src, len)	SDL_memcpy(dst, src, (len) << 2)
#endif

#if defined(__GNUC__) && defined(i386)
#define SDL_revcpy(dst, src, len)			\
do {							\
	int u0, u1, u2;					\
	char *dstp = SDL_static_cast(char *, dst);	\
	char *srcp = SDL_static_cast(char *, src);	\
	int n = (len);					\
	if ( n >= 4 ) {					\
	__asm__ __volatile__ (				\
		"std\n\t"				\
		"rep ; movsl\n\t"			\
		"cld\n\t"				\
		: "=&c" (u0), "=&D" (u1), "=&S" (u2)	\
		: "0" (n >> 2),				\
		  "1" (dstp+(n-4)), "2" (srcp+(n-4))	\
		: "memory" );				\
	}						\
	switch (n & 3) {				\
		case 3: dstp[2] = srcp[2];		\
		case 2: dstp[1] = srcp[1];		\
		case 1: dstp[0] = srcp[0];		\
			break;				\
		default:				\
			break;				\
	}						\
} while(0)
#endif
#ifndef SDL_revcpy
extern DECLSPEC void * SDLCALL SDL_revcpy(void *dst, const void *src, size_t len);
#endif

#ifdef HAVE_MEMMOVE
#define SDL_memmove     memmove
#elif defined(HAVE_BCOPY)
#define SDL_memmove(d, s, n)	bcopy((s), (d), (n))
#else
#define SDL_memmove(dst, src, len)			\
do {							\
	if ( dst < src ) {				\
		SDL_memcpy(dst, src, len);		\
	} else {					\
		SDL_revcpy(dst, src, len);		\
	}						\
} while(0)
#endif

#ifdef HAVE_MEMCMP
#define SDL_memcmp      memcmp
#else
extern DECLSPEC int SDLCALL SDL_memcmp(const void *s1, const void *s2, size_t len);
#endif

#ifdef HAVE_STRLEN
#define SDL_strlen      strlen
#else
extern DECLSPEC size_t SDLCALL SDL_strlen(const char *string);
#endif

#ifdef HAVE_STRLCPY
#define SDL_strlcpy     strlcpy
#else
extern DECLSPEC size_t SDLCALL SDL_strlcpy(char *dst, const char *src, size_t maxlen);
#endif

#ifdef HAVE_STRLCAT
#define SDL_strlcat    strlcat
#else
extern DECLSPEC size_t SDLCALL SDL_strlcat(char *dst, const char *src, size_t maxlen);
#endif

#ifdef HAVE_STRDUP
#define SDL_strdup     strdup
#else
extern DECLSPEC char * SDLCALL SDL_strdup(const char *string);
#endif

#ifdef HAVE__STRREV
#define SDL_strrev      _strrev
#else
extern DECLSPEC char * SDLCALL SDL_strrev(char *string);
#endif

#ifdef HAVE__STRUPR
#define SDL_strupr      _strupr
#else
extern DECLSPEC char * SDLCALL SDL_strupr(char *string);
#endif

#ifdef HAVE__STRLWR
#define SDL_strlwr      _strlwr
#else
extern DECLSPEC char * SDLCALL SDL_strlwr(char *string);
#endif

#ifdef HAVE_STRCHR
#define SDL_strchr      strchr
#elif defined(HAVE_INDEX)
#define SDL_strchr      index
#else
extern DECLSPEC char * SDLCALL SDL_strchr(const char *string, int c);
#endif

#ifdef HAVE_STRRCHR
#define SDL_strrchr     strrchr
#elif defined(HAVE_RINDEX)
#define SDL_strrchr     rindex
#else
extern DECLSPEC char * SDLCALL SDL_strrchr(const char *string, int c);
#endif

#ifdef HAVE_STRSTR
#define SDL_strstr      strstr
#else
extern DECLSPEC char * SDLCALL SDL_strstr(const char *haystack, const char *needle);
#endif

#ifdef HAVE_ITOA
#define SDL_itoa        itoa
#else
#define SDL_itoa(value, string, radix)	SDL_ltoa((long)value, string, radix)
#endif

#ifdef HAVE__LTOA
#define SDL_ltoa        _ltoa
#else
extern DECLSPEC char * SDLCALL SDL_ltoa(long value, char *string, int radix);
#endif

#ifdef HAVE__UITOA
#define SDL_uitoa       _uitoa
#else
#define SDL_uitoa(value, string, radix)	SDL_ultoa((long)value, string, radix)
#endif

#ifdef HAVE__ULTOA
#define SDL_ultoa       _ultoa
#else
extern DECLSPEC char * SDLCALL SDL_ultoa(unsigned long value, char *string, int radix);
#endif

#ifdef HAVE_STRTOL
#define SDL_strtol      strtol
#else
extern DECLSPEC long SDLCALL SDL_strtol(const char *string, char **endp, int base);
#endif

#ifdef HAVE_STRTOUL
#define SDL_strtoul      strtoul
#else
extern DECLSPEC unsigned long SDLCALL SDL_strtoul(const char *string, char **endp, int base);
#endif

#ifdef SDL_HAS_64BIT_TYPE

#ifdef HAVE__I64TOA
#define SDL_lltoa       _i64toa
#else
extern DECLSPEC char* SDLCALL SDL_lltoa(Sint64 value, char *string, int radix);
#endif

#ifdef HAVE__UI64TOA
#define SDL_ulltoa      _ui64toa
#else
extern DECLSPEC char* SDLCALL SDL_ulltoa(Uint64 value, char *string, int radix);
#endif

#ifdef HAVE_STRTOLL
#define SDL_strtoll     strtoll
#else
extern DECLSPEC Sint64 SDLCALL SDL_strtoll(const char *string, char **endp, int base);
#endif

#ifdef HAVE_STRTOULL
#define SDL_strtoull     strtoull
#else
extern DECLSPEC Uint64 SDLCALL SDL_strtoull(const char *string, char **endp, int base);
#endif

#endif /* SDL_HAS_64BIT_TYPE */

#ifdef HAVE_STRTOD
#define SDL_strtod      strtod
#else
extern DECLSPEC double SDLCALL SDL_strtod(const char *string, char **endp);
#endif

#ifdef HAVE_ATOI
#define SDL_atoi        atoi
#else
#define SDL_atoi(X)     SDL_strtol(X, NULL, 0)
#endif

#ifdef HAVE_ATOF
#define SDL_atof        atof
#else
#define SDL_atof(X)     SDL_strtod(X, NULL)
#endif

#ifdef HAVE_STRCMP
#define SDL_strcmp      strcmp
#else
extern DECLSPEC int SDLCALL SDL_strcmp(const char *str1, const char *str2);
#endif

#ifdef HAVE_STRNCMP
#define SDL_strncmp     strncmp
#else
extern DECLSPEC int SDLCALL SDL_strncmp(const char *str1, const char *str2, size_t maxlen);
#endif

#ifdef HAVE_STRCASECMP
#define SDL_strcasecmp  strcasecmp
#elif defined(HAVE__STRICMP)
#define SDL_strcasecmp  _stricmp
#else
extern DECLSPEC int SDLCALL SDL_strcasecmp(const char *str1, const char *str2);
#endif

#ifdef HAVE_STRNCASECMP
#define SDL_strncasecmp strncasecmp
#elif defined(HAVE__STRNICMP)
#define SDL_strncasecmp _strnicmp
#else
extern DECLSPEC int SDLCALL SDL_strncasecmp(const char *str1, const char *str2, size_t maxlen);
#endif

#ifdef HAVE_SSCANF
#define SDL_sscanf      sscanf
#else
extern DECLSPEC int SDLCALL SDL_sscanf(const char *text, const char *fmt, ...);
#endif

#ifdef HAVE_SNPRINTF
#define SDL_snprintf    snprintf
#else
extern DECLSPEC int SDLCALL SDL_snprintf(char *text, size_t maxlen, const char *fmt, ...);
#endif

#ifdef HAVE_VSNPRINTF
#define SDL_vsnprintf   vsnprintf
#else
extern DECLSPEC int SDLCALL SDL_vsnprintf(char *text, size_t maxlen, const char *fmt, va_list ap);
#endif

/** @name SDL_ICONV Error Codes
 *  The SDL implementation of iconv() returns these error codes 
 */
/*@{*/
#define SDL_ICONV_ERROR		(size_t)-1
#define SDL_ICONV_E2BIG		(size_t)-2
#define SDL_ICONV_EILSEQ	(size_t)-3
#define SDL_ICONV_EINVAL	(size_t)-4
/*@}*/

#if defined(HAVE_ICONV) && defined(HAVE_ICONV_H)
#define SDL_iconv_t     iconv_t
#define SDL_iconv_open  iconv_open
#define SDL_iconv_close iconv_close
#else
typedef struct _SDL_iconv_t *SDL_iconv_t;
extern DECLSPEC SDL_iconv_t SDLCALL SDL_iconv_open(const char *tocode, const char *fromcode);
extern DECLSPEC int SDLCALL SDL_iconv_close(SDL_iconv_t cd);
#endif
extern DECLSPEC size_t SDLCALL SDL_iconv(SDL_iconv_t cd, const char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft);
/** This function converts a string between encodings in one pass, returning a
 *  string that must be freed with SDL_free() or NULL on error.
 */
extern DECLSPEC char * SDLCALL SDL_iconv_string(const char *tocode, const char *fromcode, const char *inbuf, size_t inbytesleft);
#define SDL_iconv_utf8_locale(S)	SDL_iconv_string("", "UTF-8", S, SDL_strlen(S)+1)
#define SDL_iconv_utf8_ucs2(S)		(Uint16 *)SDL_iconv_string("UCS-2", "UTF-8", S, SDL_strlen(S)+1)
#define SDL_iconv_utf8_ucs4(S)		(Uint32 *)SDL_iconv_string("UCS-4", "UTF-8", S, SDL_strlen(S)+1)

/* Ends C function definitions when using C++ */
#ifdef __cplusplus
}
#endif
#include "close_code.h"

#endif /* _SDL_stdinc_h */
Commit	Line	Data
e14743d1	1	/*
	2	SDL - Simple DirectMedia Layer
	3	Copyright (C) 1997-2009 Sam Lantinga
	4
	5	This library is free software; you can redistribute it and/or
	6	modify it under the terms of the GNU Lesser General Public
	7	License as published by the Free Software Foundation; either
	8	version 2.1 of the License, or (at your option) any later version.
	9
	10	This library is distributed in the hope that it will be useful,
	11	but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	13	Lesser General Public License for more details.
	14
	15	You should have received a copy of the GNU Lesser General Public
	16	License along with this library; if not, write to the Free Software
	17	Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	18
	19	Sam Lantinga
	20	slouken@libsdl.org
	21	*/
	22
	23	/** @file SDL_stdinc.h
	24	* This is a general header that includes C language support
	25	*/
	26
	27	#ifndef _SDL_stdinc_h
	28	#define _SDL_stdinc_h
	29
	30	#include "SDL_config.h"
	31
	32
	33	#ifdef HAVE_SYS_TYPES_H
	34	#include <sys/types.h>
	35	#endif
	36	#ifdef HAVE_STDIO_H
	37	#include <stdio.h>
	38	#endif
	39	#if defined(STDC_HEADERS)
	40	# include <stdlib.h>
	41	# include <stddef.h>
	42	# include <stdarg.h>
	43	#else
	44	# if defined(HAVE_STDLIB_H)
	45	# include <stdlib.h>
	46	# elif defined(HAVE_MALLOC_H)
	47	# include <malloc.h>
	48	# endif
	49	# if defined(HAVE_STDDEF_H)
	50	# include <stddef.h>
	51	# endif
	52	# if defined(HAVE_STDARG_H)
	53	# include <stdarg.h>
	54	# endif
	55	#endif
	56	#ifdef HAVE_STRING_H
	57	# if !defined(STDC_HEADERS) && defined(HAVE_MEMORY_H)
	58	# include <memory.h>
	59	# endif
	60	# include <string.h>
	61	#endif
	62	#ifdef HAVE_STRINGS_H
	63	# include <strings.h>
	64	#endif
65	#if defined(HAVE_INTTYPES_H)
66	# include <inttypes.h>
67	#elif defined(HAVE_STDINT_H)
68	# include <stdint.h>
69	#endif
70	#ifdef HAVE_CTYPE_H
71	# include <ctype.h>
72	#endif
73	#if defined(HAVE_ICONV) && defined(HAVE_ICONV_H)
74	# include <iconv.h>
75	#endif
76
77	/** The number of elements in an array */
78	#define SDL_arraysize(array) (sizeof(array)/sizeof(array[0]))
79	#define SDL_TABLESIZE(table) SDL_arraysize(table)
80
81	/* Use proper C++ casts when compiled as C++ to be compatible with the option
82	-Wold-style-cast of GCC (and -Werror=old-style-cast in GCC 4.2 and above. */
83	#ifdef __cplusplus
84	#define SDL_reinterpret_cast(type, expression) reinterpret_cast<type>(expression)
85	#define SDL_static_cast(type, expression) static_cast<type>(expression)
86	#else
87	#define SDL_reinterpret_cast(type, expression) ((type)(expression))
88	#define SDL_static_cast(type, expression) ((type)(expression))
89	#endif
90
91	/** @name Basic data types */
92	/@{/
93	typedef enum {
94	SDL_FALSE = 0,
95	SDL_TRUE = 1
96	} SDL_bool;
97
98	typedef int8_t Sint8;
99	typedef uint8_t Uint8;
100	typedef int16_t Sint16;
101	typedef uint16_t Uint16;
102	typedef int32_t Sint32;
103	typedef uint32_t Uint32;
104
105	#ifdef SDL_HAS_64BIT_TYPE
106	typedef int64_t Sint64;
107	#ifndef SYMBIAN32_GCCE
108	typedef uint64_t Uint64;
109	#endif
110	#else
111	/* This is really just a hack to prevent the compiler from complaining */
112	typedef struct {
113	Uint32 hi;
114	Uint32 lo;
115	} Uint64, Sint64;
116	#endif
117
118	/@}/
119
120	/** @name Make sure the types really have the right sizes */
121	/@{/
122	#define SDL_COMPILE_TIME_ASSERT(name, x) \
123	typedef int SDL_dummy_ ## name[(x) * 2 - 1]
124
125	SDL_COMPILE_TIME_ASSERT(uint8, sizeof(Uint8) == 1);
126	SDL_COMPILE_TIME_ASSERT(sint8, sizeof(Sint8) == 1);
127	SDL_COMPILE_TIME_ASSERT(uint16, sizeof(Uint16) == 2);
128	SDL_COMPILE_TIME_ASSERT(sint16, sizeof(Sint16) == 2);
129	SDL_COMPILE_TIME_ASSERT(uint32, sizeof(Uint32) == 4);
130	SDL_COMPILE_TIME_ASSERT(sint32, sizeof(Sint32) == 4);
131	SDL_COMPILE_TIME_ASSERT(uint64, sizeof(Uint64) == 8);
132	SDL_COMPILE_TIME_ASSERT(sint64, sizeof(Sint64) == 8);
133	/@}/
134
135	/** @name Enum Size Check
136	* Check to make sure enums are the size of ints, for structure packing.
137	* For both Watcom C/C++ and Borland C/C++ the compiler option that makes
138	* enums having the size of an int must be enabled.
139	* This is "-b" for Borland C/C++ and "-ei" for Watcom C/C++ (v11).
140	*/
141	/* Enable enums always int in CodeWarrior (for MPW use "-enum int") */
142	#ifdef __MWERKS__
143	#pragma enumsalwaysint on
144	#endif
145
146	typedef enum {
147	DUMMY_ENUM_VALUE
148	} SDL_DUMMY_ENUM;
149
150	#ifndef __NDS__
151	SDL_COMPILE_TIME_ASSERT(enum, sizeof(SDL_DUMMY_ENUM) == sizeof(int));
152	#endif
153	/@}/
154
155	#include "begin_code.h"
156	/* Set up for C function definitions, even when using C++ */
157	#ifdef __cplusplus
158	extern "C" {
159	#endif
160
161	#ifdef HAVE_MALLOC
162	#define SDL_malloc malloc
163	#else
164	extern DECLSPEC void * SDLCALL SDL_malloc(size_t size);
165	#endif
166
167	#ifdef HAVE_CALLOC
168	#define SDL_calloc calloc
169	#else
170	extern DECLSPEC void * SDLCALL SDL_calloc(size_t nmemb, size_t size);
171	#endif
172
173	#ifdef HAVE_REALLOC
174	#define SDL_realloc realloc
175	#else
176	extern DECLSPEC void * SDLCALL SDL_realloc(void *mem, size_t size);
177	#endif
178
179	#ifdef HAVE_FREE
180	#define SDL_free free
181	#else
182	extern DECLSPEC void SDLCALL SDL_free(void *mem);
183	#endif
184
185	#if defined(HAVE_ALLOCA) && !defined(alloca)
186	# if defined(HAVE_ALLOCA_H)
187	# include <alloca.h>
188	# elif defined(__GNUC__)
189	# define alloca __builtin_alloca
190	# elif defined(_MSC_VER)
191	# include <malloc.h>
192	# define alloca _alloca
193	# elif defined(__WATCOMC__)
194	# include <malloc.h>
195	# elif defined(__BORLANDC__)
196	# include <malloc.h>
197	# elif defined(__DMC__)
198	# include <stdlib.h>
199	# elif defined(__AIX__)
200	#pragma alloca
201	# elif defined(__MRC__)
202	void *alloca (unsigned);
203	# else
204	char *alloca ();
205	# endif
206	#endif
207	#ifdef HAVE_ALLOCA
208	#define SDL_stack_alloc(type, count) (type)alloca(sizeof(type)(count))
209	#define SDL_stack_free(data)
210	#else
211	#define SDL_stack_alloc(type, count) (type)SDL_malloc(sizeof(type)(count))
212	#define SDL_stack_free(data) SDL_free(data)
213	#endif
214
215	#ifdef HAVE_GETENV
216	#define SDL_getenv getenv
217	#else
218	extern DECLSPEC char * SDLCALL SDL_getenv(const char *name);
219	#endif
220
221	#ifdef HAVE_PUTENV
222	#define SDL_putenv putenv
223	#else
224	extern DECLSPEC int SDLCALL SDL_putenv(const char *variable);
225	#endif
226
227	#ifdef HAVE_QSORT
228	#define SDL_qsort qsort
229	#else
230	extern DECLSPEC void SDLCALL SDL_qsort(void *base, size_t nmemb, size_t size,
231	int (compare)(const void , const void *));
232	#endif
233
234	#ifdef HAVE_ABS
235	#define SDL_abs abs
236	#else
237	#define SDL_abs(X) ((X) < 0 ? -(X) : (X))
238	#endif
239
240	#define SDL_min(x, y) (((x) < (y)) ? (x) : (y))
241	#define SDL_max(x, y) (((x) > (y)) ? (x) : (y))
242
243	#ifdef HAVE_CTYPE_H
244	#define SDL_isdigit(X) isdigit(X)
245	#define SDL_isspace(X) isspace(X)
246	#define SDL_toupper(X) toupper(X)
247	#define SDL_tolower(X) tolower(X)
248	#else
249	#define SDL_isdigit(X) (((X) >= '0') && ((X) <= '9'))
250	#define SDL_isspace(X) (((X) == ' ') \|\| ((X) == '\t') \|\| ((X) == '\r') \|\| ((X) == '\n'))
251	#define SDL_toupper(X) (((X) >= 'a') && ((X) <= 'z') ? ('A'+((X)-'a')) : (X))
252	#define SDL_tolower(X) (((X) >= 'A') && ((X) <= 'Z') ? ('a'+((X)-'A')) : (X))
253	#endif
254
255	#ifdef HAVE_MEMSET
256	#define SDL_memset memset
257	#else
258	extern DECLSPEC void * SDLCALL SDL_memset(void *dst, int c, size_t len);
259	#endif
260
261	#if defined(__GNUC__) && defined(i386)
262	#define SDL_memset4(dst, val, len) \
263	do { \
264	int u0, u1, u2; \
265	__asm__ __volatile__ ( \
266	"cld\n\t" \
267	"rep ; stosl\n\t" \
268	: "=&D" (u0), "=&a" (u1), "=&c" (u2) \
269	: "0" (dst), "1" (val), "2" (SDL_static_cast(Uint32, len)) \
270	: "memory" ); \
271	} while(0)
272	#endif
273	#ifndef SDL_memset4
274	#define SDL_memset4(dst, val, len) \
275	do { \
276	unsigned _count = (len); \
277	unsigned _n = (_count + 3) / 4; \
278	Uint32 _p = SDL_static_cast(Uint32 , dst); \
279	Uint32 _val = (val); \
280	if (len == 0) break; \
281	switch (_count % 4) { \
282	case 0: do { *_p++ = _val; \
283	case 3: *_p++ = _val; \
284	case 2: *_p++ = _val; \
285	case 1: *_p++ = _val; \
286	} while ( --_n ); \
287	} \
288	} while(0)
289	#endif
290
291	/* We can count on memcpy existing on Mac OS X and being well-tuned. */
292	#if defined(__MACH__) && defined(__APPLE__)
293	#define SDL_memcpy(dst, src, len) memcpy(dst, src, len)
294	#elif defined(__GNUC__) && defined(i386)
295	#define SDL_memcpy(dst, src, len) \
296	do { \
297	int u0, u1, u2; \
298	__asm__ __volatile__ ( \
299	"cld\n\t" \
300	"rep ; movsl\n\t" \
301	"testb $2,%b4\n\t" \
302	"je 1f\n\t" \
303	"movsw\n" \
304	"1:\ttestb $1,%b4\n\t" \
305	"je 2f\n\t" \
306	"movsb\n" \
307	"2:" \
308	: "=&c" (u0), "=&D" (u1), "=&S" (u2) \
309	: "0" (SDL_static_cast(unsigned, len)/4), "q" (len), "1" (dst),"2" (src) \
310	: "memory" ); \
311	} while(0)
312	#endif
313	#ifndef SDL_memcpy
314	#ifdef HAVE_MEMCPY
315	#define SDL_memcpy memcpy
316	#elif defined(HAVE_BCOPY)
317	#define SDL_memcpy(d, s, n) bcopy((s), (d), (n))
318	#else
319	extern DECLSPEC void * SDLCALL SDL_memcpy(void dst, const void src, size_t len);
320	#endif
321	#endif
322
323	/* We can count on memcpy existing on Mac OS X and being well-tuned. */
324	#if defined(__MACH__) && defined(__APPLE__)
325	#define SDL_memcpy4(dst, src, len) memcpy(dst, src, (len)*4)
326	#elif defined(__GNUC__) && defined(i386)
327	#define SDL_memcpy4(dst, src, len) \
328	do { \
329	int ecx, edi, esi; \
330	__asm__ __volatile__ ( \
331	"cld\n\t" \
332	"rep ; movsl" \
333	: "=&c" (ecx), "=&D" (edi), "=&S" (esi) \
334	: "0" (SDL_static_cast(unsigned, len)), "1" (dst), "2" (src) \
335	: "memory" ); \
336	} while(0)
337	#endif
338	#ifndef SDL_memcpy4
339	#define SDL_memcpy4(dst, src, len) SDL_memcpy(dst, src, (len) << 2)
340	#endif
341
342	#if defined(__GNUC__) && defined(i386)
343	#define SDL_revcpy(dst, src, len) \
344	do { \
345	int u0, u1, u2; \
346	char dstp = SDL_static_cast(char , dst); \
347	char srcp = SDL_static_cast(char , src); \
348	int n = (len); \
349	if ( n >= 4 ) { \
350	__asm__ __volatile__ ( \
351	"std\n\t" \
352	"rep ; movsl\n\t" \
353	"cld\n\t" \
354	: "=&c" (u0), "=&D" (u1), "=&S" (u2) \
355	: "0" (n >> 2), \
356	"1" (dstp+(n-4)), "2" (srcp+(n-4)) \
357	: "memory" ); \
358	} \
359	switch (n & 3) { \
360	case 3: dstp[2] = srcp[2]; \
361	case 2: dstp[1] = srcp[1]; \
362	case 1: dstp[0] = srcp[0]; \
363	break; \
364	default: \
365	break; \
366	} \
367	} while(0)
368	#endif
369	#ifndef SDL_revcpy
370	extern DECLSPEC void * SDLCALL SDL_revcpy(void dst, const void src, size_t len);
371	#endif
372
373	#ifdef HAVE_MEMMOVE
374	#define SDL_memmove memmove
375	#elif defined(HAVE_BCOPY)
376	#define SDL_memmove(d, s, n) bcopy((s), (d), (n))
377	#else
378	#define SDL_memmove(dst, src, len) \
379	do { \
380	if ( dst < src ) { \
381	SDL_memcpy(dst, src, len); \
382	} else { \
383	SDL_revcpy(dst, src, len); \
384	} \
385	} while(0)
386	#endif
387
388	#ifdef HAVE_MEMCMP
389	#define SDL_memcmp memcmp
390	#else
391	extern DECLSPEC int SDLCALL SDL_memcmp(const void s1, const void s2, size_t len);
392	#endif
393
394	#ifdef HAVE_STRLEN
395	#define SDL_strlen strlen
396	#else
397	extern DECLSPEC size_t SDLCALL SDL_strlen(const char *string);
398	#endif
399
400	#ifdef HAVE_STRLCPY
401	#define SDL_strlcpy strlcpy
402	#else
403	extern DECLSPEC size_t SDLCALL SDL_strlcpy(char dst, const char src, size_t maxlen);
404	#endif
405
406	#ifdef HAVE_STRLCAT
407	#define SDL_strlcat strlcat
408	#else
409	extern DECLSPEC size_t SDLCALL SDL_strlcat(char dst, const char src, size_t maxlen);
410	#endif
411
412	#ifdef HAVE_STRDUP
413	#define SDL_strdup strdup
414	#else
415	extern DECLSPEC char * SDLCALL SDL_strdup(const char *string);
416	#endif
417
418	#ifdef HAVE__STRREV
419	#define SDL_strrev _strrev
420	#else
421	extern DECLSPEC char * SDLCALL SDL_strrev(char *string);
422	#endif
423
424	#ifdef HAVE__STRUPR
425	#define SDL_strupr _strupr
426	#else
427	extern DECLSPEC char * SDLCALL SDL_strupr(char *string);
428	#endif
429
430	#ifdef HAVE__STRLWR
431	#define SDL_strlwr _strlwr
432	#else
433	extern DECLSPEC char * SDLCALL SDL_strlwr(char *string);
434	#endif
435
436	#ifdef HAVE_STRCHR
437	#define SDL_strchr strchr
438	#elif defined(HAVE_INDEX)
439	#define SDL_strchr index
440	#else
441	extern DECLSPEC char * SDLCALL SDL_strchr(const char *string, int c);
442	#endif
443
444	#ifdef HAVE_STRRCHR
445	#define SDL_strrchr strrchr
446	#elif defined(HAVE_RINDEX)
447	#define SDL_strrchr rindex
448	#else
449	extern DECLSPEC char * SDLCALL SDL_strrchr(const char *string, int c);
450	#endif
451
452	#ifdef HAVE_STRSTR
453	#define SDL_strstr strstr
454	#else
455	extern DECLSPEC char * SDLCALL SDL_strstr(const char haystack, const char needle);
456	#endif
457
458	#ifdef HAVE_ITOA
459	#define SDL_itoa itoa
460	#else
461	#define SDL_itoa(value, string, radix) SDL_ltoa((long)value, string, radix)
462	#endif
463
464	#ifdef HAVE__LTOA
465	#define SDL_ltoa _ltoa
466	#else
467	extern DECLSPEC char * SDLCALL SDL_ltoa(long value, char *string, int radix);
468	#endif
469
470	#ifdef HAVE__UITOA
471	#define SDL_uitoa _uitoa
472	#else
473	#define SDL_uitoa(value, string, radix) SDL_ultoa((long)value, string, radix)
474	#endif
475
476	#ifdef HAVE__ULTOA
477	#define SDL_ultoa _ultoa
478	#else
479	extern DECLSPEC char * SDLCALL SDL_ultoa(unsigned long value, char *string, int radix);
480	#endif
481
482	#ifdef HAVE_STRTOL
483	#define SDL_strtol strtol
484	#else
485	extern DECLSPEC long SDLCALL SDL_strtol(const char string, char *endp, int base);
486	#endif
487
488	#ifdef HAVE_STRTOUL
489	#define SDL_strtoul strtoul
490	#else
491	extern DECLSPEC unsigned long SDLCALL SDL_strtoul(const char string, char *endp, int base);
492	#endif
493
494	#ifdef SDL_HAS_64BIT_TYPE
495
496	#ifdef HAVE__I64TOA
497	#define SDL_lltoa _i64toa
498	#else
499	extern DECLSPEC char* SDLCALL SDL_lltoa(Sint64 value, char *string, int radix);
500	#endif
501
502	#ifdef HAVE__UI64TOA
503	#define SDL_ulltoa _ui64toa
504	#else
505	extern DECLSPEC char* SDLCALL SDL_ulltoa(Uint64 value, char *string, int radix);
506	#endif
507
508	#ifdef HAVE_STRTOLL
509	#define SDL_strtoll strtoll
510	#else
511	extern DECLSPEC Sint64 SDLCALL SDL_strtoll(const char string, char *endp, int base);
512	#endif
513
514	#ifdef HAVE_STRTOULL
515	#define SDL_strtoull strtoull
516	#else
517	extern DECLSPEC Uint64 SDLCALL SDL_strtoull(const char string, char *endp, int base);
518	#endif
519
520	#endif /* SDL_HAS_64BIT_TYPE */
521
522	#ifdef HAVE_STRTOD
523	#define SDL_strtod strtod
524	#else
525	extern DECLSPEC double SDLCALL SDL_strtod(const char string, char *endp);
526	#endif
527
528	#ifdef HAVE_ATOI
529	#define SDL_atoi atoi
530	#else
531	#define SDL_atoi(X) SDL_strtol(X, NULL, 0)
532	#endif
533
534	#ifdef HAVE_ATOF
535	#define SDL_atof atof
536	#else
537	#define SDL_atof(X) SDL_strtod(X, NULL)
538	#endif
539
540	#ifdef HAVE_STRCMP
541	#define SDL_strcmp strcmp
542	#else
543	extern DECLSPEC int SDLCALL SDL_strcmp(const char str1, const char str2);
544	#endif
545
546	#ifdef HAVE_STRNCMP
547	#define SDL_strncmp strncmp
548	#else
549	extern DECLSPEC int SDLCALL SDL_strncmp(const char str1, const char str2, size_t maxlen);
550	#endif
551
552	#ifdef HAVE_STRCASECMP
553	#define SDL_strcasecmp strcasecmp
554	#elif defined(HAVE__STRICMP)
555	#define SDL_strcasecmp _stricmp
556	#else
557	extern DECLSPEC int SDLCALL SDL_strcasecmp(const char str1, const char str2);
558	#endif
559
560	#ifdef HAVE_STRNCASECMP
561	#define SDL_strncasecmp strncasecmp
562	#elif defined(HAVE__STRNICMP)
563	#define SDL_strncasecmp _strnicmp
564	#else
565	extern DECLSPEC int SDLCALL SDL_strncasecmp(const char str1, const char str2, size_t maxlen);
566	#endif
567
568	#ifdef HAVE_SSCANF
569	#define SDL_sscanf sscanf
570	#else
571	extern DECLSPEC int SDLCALL SDL_sscanf(const char text, const char fmt, ...);
572	#endif
573
574	#ifdef HAVE_SNPRINTF
575	#define SDL_snprintf snprintf
576	#else
577	extern DECLSPEC int SDLCALL SDL_snprintf(char text, size_t maxlen, const char fmt, ...);
578	#endif
579
580	#ifdef HAVE_VSNPRINTF
581	#define SDL_vsnprintf vsnprintf
582	#else
583	extern DECLSPEC int SDLCALL SDL_vsnprintf(char text, size_t maxlen, const char fmt, va_list ap);
584	#endif
585
586	/** @name SDL_ICONV Error Codes
587	* The SDL implementation of iconv() returns these error codes
588	*/
589	/@{/
590	#define SDL_ICONV_ERROR (size_t)-1
591	#define SDL_ICONV_E2BIG (size_t)-2
592	#define SDL_ICONV_EILSEQ (size_t)-3
593	#define SDL_ICONV_EINVAL (size_t)-4
594	/@}/
595
596	#if defined(HAVE_ICONV) && defined(HAVE_ICONV_H)
597	#define SDL_iconv_t iconv_t
598	#define SDL_iconv_open iconv_open
599	#define SDL_iconv_close iconv_close
600	#else
601	typedef struct _SDL_iconv_t *SDL_iconv_t;
602	extern DECLSPEC SDL_iconv_t SDLCALL SDL_iconv_open(const char tocode, const char fromcode);
603	extern DECLSPEC int SDLCALL SDL_iconv_close(SDL_iconv_t cd);
604	#endif
605	extern DECLSPEC size_t SDLCALL SDL_iconv(SDL_iconv_t cd, const char *inbuf, size_t inbytesleft, char *outbuf, size_t outbytesleft);
606	/** This function converts a string between encodings in one pass, returning a
607	* string that must be freed with SDL_free() or NULL on error.
608	*/
609	extern DECLSPEC char * SDLCALL SDL_iconv_string(const char tocode, const char fromcode, const char *inbuf, size_t inbytesleft);
610	#define SDL_iconv_utf8_locale(S) SDL_iconv_string("", "UTF-8", S, SDL_strlen(S)+1)
611	#define SDL_iconv_utf8_ucs2(S) (Uint16 *)SDL_iconv_string("UCS-2", "UTF-8", S, SDL_strlen(S)+1)
612	#define SDL_iconv_utf8_ucs4(S) (Uint32 *)SDL_iconv_string("UCS-4", "UTF-8", S, SDL_strlen(S)+1)
613
614	/* Ends C function definitions when using C++ */
615	#ifdef __cplusplus
616	}
617	#endif
618	#include "close_code.h"
619
620	#endif /* _SDL_stdinc_h */