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