Subversion Repositories Games.Descent

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 pmbaty 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 */