- Main Page
- Related Pages
- Classes
- Files

- File List
- File Members

# cpl_port.h

Go to the documentation of this file.

    00001 /******************************************************************************
    00002  * $Id: cpl_port.h 28375 2015-01-30 12:06:11Z rouault $
    00003  *
    00004  * Project:  CPL - Common Portability Library
    00005  * Author:   Frank Warmerdam, warmerdam@pobox.com
    00006  * Purpose:  Include file providing low level portability services for CPL.
    00007  *           This should be the first include file for any CPL based code.
    00008  *
    00009  ******************************************************************************
    00010  * Copyright (c) 1998, 2005, Frank Warmerdam <warmerdam@pobox.com>
    00011  * Copyright (c) 2008-2013, Even Rouault <even dot rouault at mines-paris dot org>
    00012  *
    00013  * Permission is hereby granted, free of charge, to any person obtaining a
    00014  * copy of this software and associated documentation files (the "Software"),
    00015  * to deal in the Software without restriction, including without limitation
    00016  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
    00017  * and/or sell copies of the Software, and to permit persons to whom the
    00018  * Software is furnished to do so, subject to the following conditions:
    00019  *
    00020  * The above copyright notice and this permission notice shall be included
    00021  * in all copies or substantial portions of the Software.
    00022  *
    00023  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
    00024  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    00025  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
    00026  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    00027  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    00028  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    00029  * DEALINGS IN THE SOFTWARE.
    00030  ****************************************************************************/
    00031
    00032 #ifndef CPL_BASE_H_INCLUDED
    00033 #define CPL_BASE_H_INCLUDED
    00034
    00042 /* ==================================================================== */
    00043 /*      We will use macos_pre10 to indicate compilation with MacOS      */
    00044 /*      versions before MacOS X.                                        */
    00045 /* ==================================================================== */
    00046 #ifdef macintosh
    00047 #  define macos_pre10
    00048 #endif
    00049
    00050 /* ==================================================================== */
    00051 /*      We will use WIN32 as a standard windows define.                 */
    00052 /* ==================================================================== */
    00053 #if defined(_WIN32) && !defined(WIN32) && !defined(_WIN32_WCE)
    00054 #  define WIN32
    00055 #endif
    00056
    00057 #if defined(_WINDOWS) && !defined(WIN32) && !defined(_WIN32_WCE)
    00058 #  define WIN32
    00059 #endif
    00060
    00061 /* ==================================================================== */
    00062 /*      We will use WIN32CE as a standard Windows CE (Mobile) define.   */
    00063 /* ==================================================================== */
    00064 #if defined(_WIN32_WCE)
    00065 #  define WIN32CE
    00066 #endif
    00067
    00068 /* -------------------------------------------------------------------- */
    00069 /*      The following apparently allow you to use strcpy() and other    */
    00070 /*      functions judged "unsafe" by microsoft in VS 8 (2005).          */
    00071 /* -------------------------------------------------------------------- */
    00072 #ifdef _MSC_VER
    00073 #  ifndef _CRT_SECURE_NO_DEPRECATE
    00074 #    define _CRT_SECURE_NO_DEPRECATE
    00075 #  endif
    00076 #  ifndef _CRT_NONSTDC_NO_DEPRECATE
    00077 #    define _CRT_NONSTDC_NO_DEPRECATE
    00078 #  endif
    00079 #endif
    00080
    00081 #include "cpl_config.h"
    00082
    00083 /* ==================================================================== */
    00084 /*      A few sanity checks, mainly to detect problems that sometimes   */
    00085 /*      arise with bad configured cross-compilation.                    */
    00086 /* ==================================================================== */
    00087
    00088 #if !defined(SIZEOF_INT) || SIZEOF_INT != 4
    00089 #error "Unexpected value for SIZEOF_INT"
    00090 #endif
    00091
    00092 #if !defined(SIZEOF_UNSIGNED_LONG) || (SIZEOF_UNSIGNED_LONG != 4 && SIZEOF_UNSIGNED_LONG != 8)
    00093 #error "Unexpected value for SIZEOF_UNSIGNED_LONG"
    00094 #endif
    00095
    00096 #if !defined(SIZEOF_VOIDP) || (SIZEOF_VOIDP != 4 && SIZEOF_VOIDP != 8)
    00097 #error "Unexpected value for SIZEOF_VOIDP"
    00098 #endif
    00099
    00100
    00101 /* ==================================================================== */
    00102 /*      This will disable most WIN32 stuff in a Cygnus build which      */
    00103 /*      defines unix to 1.                                              */
    00104 /* ==================================================================== */
    00105
    00106 #ifdef unix
    00107 #  undef WIN32
    00108 #  undef WIN32CE
    00109 #endif
    00110
    00111 #if defined(VSI_NEED_LARGEFILE64_SOURCE) && !defined(_LARGEFILE64_SOURCE)
    00112 #  define _LARGEFILE64_SOURCE 1
    00113 #endif
    00114
    00115 /* ==================================================================== */
    00116 /*      If iconv() is available use extended recoding module.           */
    00117 /*      Stub implementation is always compiled in, because it works     */
    00118 /*      faster than iconv() for encodings it supports.                  */
    00119 /* ==================================================================== */
    00120
    00121 #if defined(HAVE_ICONV)
    00122 #  define CPL_RECODE_ICONV
    00123 #endif
    00124
    00125 #define CPL_RECODE_STUB
    00126
    00127 /* ==================================================================== */
    00128 /*      MinGW stuff                                                     */
    00129 /* ==================================================================== */
    00130
    00131 /* We need __MSVCRT_VERSION__ >= 0x0601 to have "struct __stat64" */
    00132 /* Latest versions of mingw32 define it, but with older ones, */
    00133 /* we need to define it manually */
    00134 #if defined(__MINGW32__)
    00135 #ifndef __MSVCRT_VERSION__
    00136 #define __MSVCRT_VERSION__ 0x0601
    00137 #endif
    00138 #endif
    00139
    00140 /* ==================================================================== */
    00141 /*      Standard include files.                                         */
    00142 /* ==================================================================== */
    00143
    00144 #include <stdio.h>
    00145 #include <stdlib.h>
    00146 #include <math.h>
    00147 #include <stdarg.h>
    00148 #include <string.h>
    00149 #include <ctype.h>
    00150 #include <limits.h>
    00151
    00152 #if !defined(WIN32CE)
    00153 #  include <time.h>
    00154 #else
    00155 #  include <wce_time.h>
    00156 #  include <wce_errno.h>
    00157 #endif
    00158
    00159
    00160 #if defined(HAVE_ERRNO_H)
    00161 #  include <errno.h>
    00162 #endif
    00163
    00164 #ifdef HAVE_LOCALE_H
    00165 #  include <locale.h>
    00166 #endif
    00167
    00168 #ifdef HAVE_DIRECT_H
    00169 #  include <direct.h>
    00170 #endif
    00171
    00172 #if !(defined(WIN32) || defined(WIN32CE))
    00173 #  include <strings.h>
    00174 #endif
    00175
    00176 #if defined(HAVE_LIBDBMALLOC) && defined(HAVE_DBMALLOC_H) && defined(DEBUG)
    00177 #  define DBMALLOC
    00178 #  include <dbmalloc.h>
    00179 #endif
    00180
    00181 #if !defined(DBMALLOC) && defined(HAVE_DMALLOC_H)
    00182 #  define USE_DMALLOC
    00183 #  include <dmalloc.h>
    00184 #endif
    00185
    00186 /* ==================================================================== */
    00187 /*      Base portability stuff ... this stuff may need to be            */
    00188 /*      modified for new platforms.                                     */
    00189 /* ==================================================================== */
    00190
    00191 /*---------------------------------------------------------------------
    00192  *        types for 16 and 32 bits integers, etc...
    00193  *--------------------------------------------------------------------*/
    00194 #if UINT_MAX == 65535
    00195 typedef long            GInt32;
    00196 typedef unsigned long   GUInt32;
    00197 #else
    00198 typedef int             GInt32;
    00199 typedef unsigned int    GUInt32;
    00200 #endif
    00201
    00202 typedef short           GInt16;
    00203 typedef unsigned short  GUInt16;
    00204 typedef unsigned char   GByte;
    00205 /* hack for PDF driver and poppler >= 0.15.0 that defines incompatible "typedef bool GBool" */
    00206 /* in include/poppler/goo/gtypes.h */
    00207 #ifndef CPL_GBOOL_DEFINED
    00208 #define CPL_GBOOL_DEFINED
    00209 typedef int             GBool;
    00210 #endif
    00211
    00212 /* -------------------------------------------------------------------- */
    00213 /*      64bit support                                                   */
    00214 /* -------------------------------------------------------------------- */
    00215
    00216 #if defined(WIN32) && defined(_MSC_VER)
    00217
    00218 #define VSI_LARGE_API_SUPPORTED
    00219 typedef __int64          GIntBig;
    00220 typedef unsigned __int64 GUIntBig;
    00221
    00222 #define GINTBIG_MIN     ((GIntBig)(0x80000000) << 32)
    00223 #define GINTBIG_MAX     (((GIntBig)(0x7FFFFFFF) << 32) | 0xFFFFFFFFU)
    00224
    00225 #elif HAVE_LONG_LONG
    00226
    00227 typedef long long        GIntBig;
    00228 typedef unsigned long long GUIntBig;
    00229
    00230 #define GINTBIG_MIN     ((GIntBig)(0x80000000) << 32)
    00231 #define GINTBIG_MAX     (((GIntBig)(0x7FFFFFFF) << 32) | 0xFFFFFFFFU)
    00232
    00233 #else
    00234
    00235 typedef long             GIntBig;
    00236 typedef unsigned long    GUIntBig;
    00237
    00238 #define GINTBIG_MIN     INT_MIN
    00239 #define GINTBIG_MAX     INT_MAX
    00240 #endif
    00241
    00242 #if SIZEOF_VOIDP == 8
    00243 typedef GIntBig          GPtrDiff_t;
    00244 #else
    00245 typedef int              GPtrDiff_t;
    00246 #endif
    00247
    00248 #if defined(__MSVCRT__) || (defined(WIN32) && defined(_MSC_VER))
    00249   #define CPL_FRMT_GB_WITHOUT_PREFIX     "I64"
    00250 #elif HAVE_LONG_LONG
    00251   #define CPL_FRMT_GB_WITHOUT_PREFIX     "ll"
    00252 #else
    00253   #define CPL_FRMT_GB_WITHOUT_PREFIX     "l"
    00254 #endif
    00255
    00256 #define CPL_FRMT_GIB     "%" CPL_FRMT_GB_WITHOUT_PREFIX "d"
    00257 #define CPL_FRMT_GUIB    "%" CPL_FRMT_GB_WITHOUT_PREFIX "u"
    00258
    00259 /* Workaround VC6 bug */
    00260 #if defined(_MSC_VER) && (_MSC_VER <= 1200)
    00261 #define GUINTBIG_TO_DOUBLE(x) (double)(GIntBig)(x)
    00262 #else
    00263 #define GUINTBIG_TO_DOUBLE(x) (double)(x)
    00264 #endif
    00265
    00266 /* ==================================================================== */
    00267 /*      Other standard services.                                        */
    00268 /* ==================================================================== */
    00269 #ifdef __cplusplus
    00270 #  define CPL_C_START           extern "C" {
    00271 #  define CPL_C_END             }
    00272 #else
    00273 #  define CPL_C_START
    00274 #  define CPL_C_END
    00275 #endif
    00276
    00277 #ifndef CPL_DLL
    00278 #if defined(_MSC_VER) && !defined(CPL_DISABLE_DLL)
    00279 #  define CPL_DLL     __declspec(dllexport)
    00280 #else
    00281 #  if defined(USE_GCC_VISIBILITY_FLAG)
    00282 #    define CPL_DLL     __attribute__ ((visibility("default")))
    00283 #  else
    00284 #    define CPL_DLL
    00285 #  endif
    00286 #endif
    00287 #endif
    00288
    00289 /* Should optional (normally private) interfaces be exported? */
    00290 #ifdef CPL_OPTIONAL_APIS
    00291 #  define CPL_ODLL CPL_DLL
    00292 #else
    00293 #  define CPL_ODLL
    00294 #endif
    00295
    00296 #ifndef CPL_STDCALL
    00297 #if defined(_MSC_VER) && !defined(CPL_DISABLE_STDCALL)
    00298 #  define CPL_STDCALL     __stdcall
    00299 #else
    00300 #  define CPL_STDCALL
    00301 #endif
    00302 #endif
    00303
    00304 #ifdef _MSC_VER
    00305 #  define FORCE_CDECL  __cdecl
    00306 #else
    00307 #  define FORCE_CDECL
    00308 #endif
    00309
    00310 /* TODO : support for other compilers needed */
    00311 #if (defined(__GNUC__) && !defined(__NO_INLINE__)) || defined(_MSC_VER)
    00312 #define HAS_CPL_INLINE  1
    00313 #define CPL_INLINE __inline
    00314 #elif defined(__SUNPRO_CC)
    00315 #define HAS_CPL_INLINE  1
    00316 #define CPL_INLINE inline
    00317 #else
    00318 #define CPL_INLINE
    00319 #endif
    00320
    00321 #ifndef NULL
    00322 #  define NULL  0
    00323 #endif
    00324
    00325 #ifndef FALSE
    00326 #  define FALSE 0
    00327 #endif
    00328
    00329 #ifndef TRUE
    00330 #  define TRUE  1
    00331 #endif
    00332
    00333 #ifndef MAX
    00334 #  define MIN(a,b)      ((a<b) ? a : b)
    00335 #  define MAX(a,b)      ((a>b) ? a : b)
    00336 #endif
    00337
    00338 #ifndef ABS
    00339 #  define ABS(x)        ((x<0) ? (-1*(x)) : x)
    00340 #endif
    00341
    00342 #ifndef M_PI
    00343 # define M_PI           3.14159265358979323846  /* pi */
    00344 #endif
    00345
    00346 /* -------------------------------------------------------------------- */
    00347 /*      Macro to test equality of two floating point values.            */
    00348 /*      We use fabs() function instead of ABS() macro to avoid side     */
    00349 /*      effects.                                                        */
    00350 /* -------------------------------------------------------------------- */
    00351 #ifndef CPLIsEqual
    00352 #  define CPLIsEqual(x,y) (fabs((x) - (y)) < 0.0000000000001)
    00353 #endif
    00354
    00355 /* -------------------------------------------------------------------- */
    00356 /*      Provide macros for case insensitive string comparisons.         */
    00357 /* -------------------------------------------------------------------- */
    00358 #ifndef EQUAL
    00359 #  if defined(WIN32) || defined(WIN32CE)
    00360 #    define STRCASECMP(a,b)         (stricmp(a,b))
    00361 #    define STRNCASECMP(a,b,n)      (strnicmp(a,b,n))
    00362 #  else
    00363 #    define STRCASECMP(a,b)         (strcasecmp(a,b))
    00364 #    define STRNCASECMP(a,b,n)      (strncasecmp(a,b,n))
    00365 #  endif
    00366 #  define EQUALN(a,b,n)           (STRNCASECMP(a,b,n)==0)
    00367 #  define EQUAL(a,b)              (STRCASECMP(a,b)==0)
    00368 #endif
    00369
    00370 #ifdef macos_pre10
    00371 int strcasecmp(char * str1, char * str2);
    00372 int strncasecmp(char * str1, char * str2, int len);
    00373 char * strdup (char *instr);
    00374 #endif
    00375
    00376 #ifndef CPL_THREADLOCAL
    00377 #  define CPL_THREADLOCAL
    00378 #endif
    00379
    00380 /* -------------------------------------------------------------------- */
    00381 /*      Handle isnan() and isinf().  Note that isinf() and isnan()      */
    00382 /*      are supposed to be macros according to C99, defined in math.h   */
    00383 /*      Some systems (ie. Tru64) don't have isinf() at all, so if       */
    00384 /*      the macro is not defined we just assume nothing is infinite.    */
    00385 /*      This may mean we have no real CPLIsInf() on systems with isinf()*/
    00386 /*      function but no corresponding macro, but I can live with        */
    00387 /*      that since it isn't that important a test.                      */
    00388 /* -------------------------------------------------------------------- */
    00389 #ifdef _MSC_VER
    00390 #  include <float.h>
    00391 #  define CPLIsNan(x) _isnan(x)
    00392 #  define CPLIsInf(x) (!_isnan(x) && !_finite(x))
    00393 #  define CPLIsFinite(x) _finite(x)
    00394 #else
    00395 #  define CPLIsNan(x) isnan(x)
    00396 #  ifdef isinf
    00397 #    define CPLIsInf(x) isinf(x)
    00398 #    define CPLIsFinite(x) (!isnan(x) && !isinf(x))
    00399 #  else
    00400 #    define CPLIsInf(x)    FALSE
    00401 #    define CPLIsFinite(x) (!isnan(x))
    00402 #  endif
    00403 #endif
    00404
    00405 /*---------------------------------------------------------------------
    00406  *                         CPL_LSB and CPL_MSB
    00407  * Only one of these 2 macros should be defined and specifies the byte
    00408  * ordering for the current platform.
    00409  * This should be defined in the Makefile, but if it is not then
    00410  * the default is CPL_LSB (Intel ordering, LSB first).
    00411  *--------------------------------------------------------------------*/
    00412 #if defined(WORDS_BIGENDIAN) && !defined(CPL_MSB) && !defined(CPL_LSB)
    00413 #  define CPL_MSB
    00414 #endif
    00415
    00416 #if ! ( defined(CPL_LSB) || defined(CPL_MSB) )
    00417 #define CPL_LSB
    00418 #endif
    00419
    00420 #if defined(CPL_LSB)
    00421 #  define CPL_IS_LSB 1
    00422 #else
    00423 #  define CPL_IS_LSB 0
    00424 #endif
    00425
    00426 /*---------------------------------------------------------------------
    00427  *        Little endian <==> big endian byte swap macros.
    00428  *--------------------------------------------------------------------*/
    00429
    00430 #define CPL_SWAP16(x) \
    00431         ((GUInt16)( \
    00432             (((GUInt16)(x) & 0x00ffU) << 8) | \
    00433             (((GUInt16)(x) & 0xff00U) >> 8) ))
    00434
    00435 #define CPL_SWAP16PTR(x) \
    00436 {                                                                 \
    00437     GByte       byTemp, *_pabyDataT = (GByte *) (x);              \
    00438                                                                   \
    00439     byTemp = _pabyDataT[0];                                       \
    00440     _pabyDataT[0] = _pabyDataT[1];                                \
    00441     _pabyDataT[1] = byTemp;                                       \
    00442 }
    00443
    00444 #define CPL_SWAP32(x) \
    00445         ((GUInt32)( \
    00446             (((GUInt32)(x) & (GUInt32)0x000000ffUL) << 24) | \
    00447             (((GUInt32)(x) & (GUInt32)0x0000ff00UL) <<  8) | \
    00448             (((GUInt32)(x) & (GUInt32)0x00ff0000UL) >>  8) | \
    00449             (((GUInt32)(x) & (GUInt32)0xff000000UL) >> 24) ))
    00450
    00451 #define CPL_SWAP32PTR(x) \
    00452 {                                                                 \
    00453     GByte       byTemp, *_pabyDataT = (GByte *) (x);              \
    00454                                                                   \
    00455     byTemp = _pabyDataT[0];                                       \
    00456     _pabyDataT[0] = _pabyDataT[3];                                \
    00457     _pabyDataT[3] = byTemp;                                       \
    00458     byTemp = _pabyDataT[1];                                       \
    00459     _pabyDataT[1] = _pabyDataT[2];                                \
    00460     _pabyDataT[2] = byTemp;                                       \
    00461 }
    00462
    00463 #define CPL_SWAP64PTR(x) \
    00464 {                                                                 \
    00465     GByte       byTemp, *_pabyDataT = (GByte *) (x);              \
    00466                                                                   \
    00467     byTemp = _pabyDataT[0];                                       \
    00468     _pabyDataT[0] = _pabyDataT[7];                                \
    00469     _pabyDataT[7] = byTemp;                                       \
    00470     byTemp = _pabyDataT[1];                                       \
    00471     _pabyDataT[1] = _pabyDataT[6];                                \
    00472     _pabyDataT[6] = byTemp;                                       \
    00473     byTemp = _pabyDataT[2];                                       \
    00474     _pabyDataT[2] = _pabyDataT[5];                                \
    00475     _pabyDataT[5] = byTemp;                                       \
    00476     byTemp = _pabyDataT[3];                                       \
    00477     _pabyDataT[3] = _pabyDataT[4];                                \
    00478     _pabyDataT[4] = byTemp;                                       \
    00479 }
    00480
    00481
    00482 /* Until we have a safe 64 bits integer data type defined, we'll replace
    00483  * this version of the CPL_SWAP64() macro with a less efficient one.
    00484  */
    00485 /*
    00486 #define CPL_SWAP64(x) \
    00487         ((uint64)( \
    00488             (uint64)(((uint64)(x) & (uint64)0x00000000000000ffULL) << 56) | \
    00489             (uint64)(((uint64)(x) & (uint64)0x000000000000ff00ULL) << 40) | \
    00490             (uint64)(((uint64)(x) & (uint64)0x0000000000ff0000ULL) << 24) | \
    00491             (uint64)(((uint64)(x) & (uint64)0x00000000ff000000ULL) << 8) | \
    00492             (uint64)(((uint64)(x) & (uint64)0x000000ff00000000ULL) >> 8) | \
    00493             (uint64)(((uint64)(x) & (uint64)0x0000ff0000000000ULL) >> 24) | \
    00494             (uint64)(((uint64)(x) & (uint64)0x00ff000000000000ULL) >> 40) | \
    00495             (uint64)(((uint64)(x) & (uint64)0xff00000000000000ULL) >> 56) ))
    00496 */
    00497
    00498 #define CPL_SWAPDOUBLE(p) CPL_SWAP64PTR(p)
    00499
    00500 #ifdef CPL_MSB
    00501 #  define CPL_MSBWORD16(x)      (x)
    00502 #  define CPL_LSBWORD16(x)      CPL_SWAP16(x)
    00503 #  define CPL_MSBWORD32(x)      (x)
    00504 #  define CPL_LSBWORD32(x)      CPL_SWAP32(x)
    00505 #  define CPL_MSBPTR16(x)
    00506 #  define CPL_LSBPTR16(x)       CPL_SWAP16PTR(x)
    00507 #  define CPL_MSBPTR32(x)
    00508 #  define CPL_LSBPTR32(x)       CPL_SWAP32PTR(x)
    00509 #  define CPL_MSBPTR64(x)
    00510 #  define CPL_LSBPTR64(x)       CPL_SWAP64PTR(x)
    00511 #else
    00512 #  define CPL_LSBWORD16(x)      (x)
    00513 #  define CPL_MSBWORD16(x)      CPL_SWAP16(x)
    00514 #  define CPL_LSBWORD32(x)      (x)
    00515 #  define CPL_MSBWORD32(x)      CPL_SWAP32(x)
    00516 #  define CPL_LSBPTR16(x)
    00517 #  define CPL_MSBPTR16(x)       CPL_SWAP16PTR(x)
    00518 #  define CPL_LSBPTR32(x)
    00519 #  define CPL_MSBPTR32(x)       CPL_SWAP32PTR(x)
    00520 #  define CPL_LSBPTR64(x)
    00521 #  define CPL_MSBPTR64(x)       CPL_SWAP64PTR(x)
    00522 #endif
    00523
    00525 #define CPL_LSBINT16PTR(x)    ((*(GByte*)(x)) | ((*(GByte*)((x)+1)) << 8))
    00526
    00528 #define CPL_LSBINT32PTR(x)    ((*(GByte*)(x)) | ((*(GByte*)((x)+1)) << 8) | \
    00529                               ((*(GByte*)((x)+2)) << 16) | ((*(GByte*)((x)+3)) << 24))
    00530
    00532 #define CPL_LSBSINT16PTR(x) ((GInt16) CPL_LSBINT16PTR(x))
    00533
    00535 #define CPL_LSBUINT16PTR(x) ((GUInt16)CPL_LSBINT16PTR(x))
    00536
    00538 #define CPL_LSBSINT32PTR(x) ((GInt32) CPL_LSBINT32PTR(x))
    00539
    00541 #define CPL_LSBUINT32PTR(x) ((GUInt32)CPL_LSBINT32PTR(x))
    00542
    00543
    00544 /* Utility macro to explicitly mark intentionally unreferenced parameters. */
    00545 #ifndef UNREFERENCED_PARAM
    00546 #  ifdef UNREFERENCED_PARAMETER /* May be defined by Windows API */
    00547 #    define UNREFERENCED_PARAM(param) UNREFERENCED_PARAMETER(param)
    00548 #  else
    00549 #    define UNREFERENCED_PARAM(param) ((void)param)
    00550 #  endif /* UNREFERENCED_PARAMETER */
    00551 #endif /* UNREFERENCED_PARAM */
    00552
    00553 /***********************************************************************
    00554  * Define CPL_CVSID() macro.  It can be disabled during a build by
    00555  * defining DISABLE_CPLID in the compiler options.
    00556  *
    00557  * The cvsid_aw() function is just there to prevent reports of cpl_cvsid()
    00558  * being unused.
    00559  */
    00560
    00561 #ifndef DISABLE_CVSID
    00562 #if defined(__GNUC__) && __GNUC__ >= 4
    00563 #  define CPL_CVSID(string)     static char cpl_cvsid[] __attribute__((used)) = string;
    00564 #else
    00565 #  define CPL_CVSID(string)     static char cpl_cvsid[] = string; \
    00566 static char *cvsid_aw() { return( cvsid_aw() ? ((char *) NULL) : cpl_cvsid ); }
    00567 #endif
    00568 #else
    00569 #  define CPL_CVSID(string)
    00570 #endif
    00571
    00572 /* Null terminated variadic */
    00573 #if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP)
    00574 #   define CPL_NULL_TERMINATED     __attribute__((__sentinel__))
    00575 #else
    00576 #   define CPL_NULL_TERMINATED
    00577 #endif
    00578
    00579 #if defined(__GNUC__) && __GNUC__ >= 3 && !defined(DOXYGEN_SKIP)
    00580 #define CPL_PRINT_FUNC_FORMAT( format_idx, arg_idx )  __attribute__((__format__ (__printf__, format_idx, arg_idx)))
    00581 #else
    00582 #define CPL_PRINT_FUNC_FORMAT( format_idx, arg_idx )
    00583 #endif
    00584
    00585 #if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP)
    00586 #define CPL_WARN_UNUSED_RESULT                        __attribute__((warn_unused_result))
    00587 #else
    00588 #define CPL_WARN_UNUSED_RESULT
    00589 #endif
    00590
    00591 #if defined(__GNUC__) && __GNUC__ >= 4
    00592 #  define CPL_UNUSED __attribute((__unused__))
    00593 #else
    00594 /* TODO: add cases for other compilers */
    00595 #  define CPL_UNUSED
    00596 #endif
    00597
    00598 #if defined(__GNUC__) && __GNUC__ >= 3 && !defined(DOXYGEN_SKIP)
    00599 #define CPL_NO_RETURN                                __attribute__((noreturn))
    00600 #else
    00601 #define CPL_NO_RETURN
    00602 #endif
    00603
    00604 #if !defined(DOXYGEN_SKIP)
    00605 #if defined(__has_extension)
    00606   #if __has_extension(attribute_deprecated_with_message)
    00607     /* Clang extension */
    00608     #define CPL_WARN_DEPRECATED(x)                       __attribute__ ((deprecated(x)))
    00609   #else
    00610     #define CPL_WARN_DEPRECATED(x)
    00611   #endif
    00612 #elif defined(__GNUC__)
    00613     #define CPL_WARN_DEPRECATED(x)                       __attribute__ ((deprecated))
    00614 #else
    00615   #define CPL_WARN_DEPRECATED(x)
    00616 #endif
    00617 #endif
    00618
    00619 #ifdef WARN_STANDARD_PRINTF
    00620 int vsnprintf(char *str, size_t size, const char* fmt, va_list args) CPL_WARN_DEPRECATED("Use CPLvsnprintf() instead");
    00621 int snprintf(char *str, size_t size, const char* fmt, ...) CPL_PRINT_FUNC_FORMAT(3,4) CPL_WARN_DEPRECATED("Use CPLsnprintf() instead");
    00622 int sprintf(char *str, const char* fmt, ...) CPL_PRINT_FUNC_FORMAT(2, 3) CPL_WARN_DEPRECATED("Use CPLsprintf() instead");
    00623 #endif
    00624
    00625 #endif /* ndef CPL_BASE_H_INCLUDED */

Generated for GDAL by 1.7.1.