misc/builddeps/win32/sdl/include/SDL/SDL_stdinc.h

   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 */