32 #ifndef CPL_BASE_H_INCLUDED
33 #define CPL_BASE_H_INCLUDED
45 #if defined(_WIN32) && !defined(WIN32)
49 #if defined(_WINDOWS) && !defined(WIN32)
58 # ifndef _CRT_SECURE_NO_DEPRECATE
59 # define _CRT_SECURE_NO_DEPRECATE
61 # ifndef _CRT_NONSTDC_NO_DEPRECATE
62 # define _CRT_NONSTDC_NO_DEPRECATE
66 #include "cpl_config.h"
73 #if !defined(SIZEOF_INT) || SIZEOF_INT != 4
74 #error "Unexpected value for SIZEOF_INT"
77 #if !defined(SIZEOF_UNSIGNED_LONG) || (SIZEOF_UNSIGNED_LONG != 4 && SIZEOF_UNSIGNED_LONG != 8)
78 #error "Unexpected value for SIZEOF_UNSIGNED_LONG"
81 #if !defined(SIZEOF_VOIDP) || (SIZEOF_VOIDP != 4 && SIZEOF_VOIDP != 8)
82 #error "Unexpected value for SIZEOF_VOIDP"
95 #if defined(VSI_NEED_LARGEFILE64_SOURCE) && !defined(_LARGEFILE64_SOURCE)
96 # define _LARGEFILE64_SOURCE 1
105 #if defined(HAVE_ICONV)
106 # define CPL_RECODE_ICONV
109 #define CPL_RECODE_STUB
119 #if defined(__MINGW32__)
120 #ifndef __MSVCRT_VERSION__
121 #define __MSVCRT_VERSION__ 0x0700
126 #if defined(GDAL_COMPILATION) && defined(__sun__) && (__STDC_VERSION__ + 0) >= 201112L && (_XOPEN_SOURCE + 0) < 600
130 #define _XOPEN_SOURCE 600
147 #if defined(HAVE_ERRNO_H)
160 # include <strings.h>
163 #if defined(HAVE_LIBDBMALLOC) && defined(HAVE_DBMALLOC_H) && defined(DEBUG)
165 # include <dbmalloc.h>
168 #if !defined(DBMALLOC) && defined(HAVE_DMALLOC_H)
170 # include <dmalloc.h>
185 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
186 # if !(__cplusplus >= 201103L || (defined(_MSC_VER) && _MSC_VER >= 1900))
187 # error Must have C++11 or newer.
189 # if __cplusplus >= 201402L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201402L)
190 # define HAVE_CXX14 1
192 # if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L)
193 # define HAVE_CXX17 1
200 #if UINT_MAX == 65535
218 #ifndef CPL_GBOOL_DEFINED
220 #define CPL_GBOOL_DEFINED
228 #define CPL_STATIC_CAST(type, expr) static_cast<type>(expr)
229 #define CPL_REINTERPRET_CAST(type, expr) reinterpret_cast<type>(expr)
231 #define CPL_STATIC_CAST(type, expr) ((type)(expr))
232 #define CPL_REINTERPRET_CAST(type, expr) ((type)(expr))
240 #if defined(WIN32) && defined(_MSC_VER)
241 #define VSI_LARGE_API_SUPPORTED
254 #define GINTBIG_MIN (CPL_STATIC_CAST(GIntBig, 0x80000000) << 32)
256 #define GINTBIG_MAX ((CPL_STATIC_CAST(GIntBig, 0x7FFFFFFF) << 32) | 0xFFFFFFFFU)
258 #define GUINTBIG_MAX ((CPL_STATIC_CAST(GUIntBig, 0xFFFFFFFFU) << 32) | 0xFFFFFFFFU)
261 #define CPL_HAS_GINT64 1
272 #define GINT64_MIN GINTBIG_MIN
274 #define GINT64_MAX GINTBIG_MAX
276 #define GUINT64_MAX GUINTBIG_MAX
280 #error "64bit integer support required"
284 #if SIZEOF_VOIDP == 8
292 #ifdef GDAL_COMPILATION
295 typedef uintptr_t GUIntptr_t;
296 #elif SIZEOF_VOIDP == 8
299 typedef unsigned int GUIntptr_t;
302 #define CPL_IS_ALIGNED(ptr, quant) ((CPL_REINTERPRET_CAST(GUIntptr_t, CPL_STATIC_CAST(const void*, ptr)) % (quant)) == 0)
306 #if defined(__MSVCRT__) || (defined(WIN32) && defined(_MSC_VER))
307 #define CPL_FRMT_GB_WITHOUT_PREFIX "I64"
310 #define CPL_FRMT_GB_WITHOUT_PREFIX "ll"
312 #define CPL_FRMT_GB_WITHOUT_PREFIX "l"
316 #define CPL_FRMT_GIB "%" CPL_FRMT_GB_WITHOUT_PREFIX "d"
318 #define CPL_FRMT_GUIB "%" CPL_FRMT_GB_WITHOUT_PREFIX "u"
321 #define GUINTBIG_TO_DOUBLE(x) CPL_STATIC_CAST(double, x)
325 #ifdef COMPAT_WITH_ICC_CONVERSION_CHECK
326 #define CPL_INT64_FITS_ON_INT32(x) ((x) >= INT_MIN && (x) <= INT_MAX)
328 #define CPL_INT64_FITS_ON_INT32(x) (CPL_STATIC_CAST(GIntBig, CPL_STATIC_CAST(int, x)) == (x))
337 # define CPL_C_START extern "C" {
346 #if defined(_MSC_VER) && !defined(CPL_DISABLE_DLL)
347 # define CPL_DLL __declspec(dllexport)
349 # if defined(USE_GCC_VISIBILITY_FLAG)
350 # define CPL_DLL __attribute__ ((visibility("default")))
359 #ifdef CPL_OPTIONAL_APIS
360 # define CPL_ODLL CPL_DLL
367 #if defined(_MSC_VER) && !defined(CPL_DISABLE_STDCALL)
368 # define CPL_STDCALL __stdcall
376 # define FORCE_CDECL __cdecl
384 #if (defined(__GNUC__) && !defined(__NO_INLINE__)) || defined(_MSC_VER)
385 #define HAS_CPL_INLINE 1
386 #define CPL_INLINE __inline
387 #elif defined(__SUNPRO_CC)
388 #define HAS_CPL_INLINE 1
389 #define CPL_INLINE inline
397 # define MIN(a,b) (((a)<(b)) ? (a) : (b))
399 # define MAX(a,b) (((a)>(b)) ? (a) : (b))
404 # define ABS(x) (((x)<0) ? (-1*(x)) : (x))
409 # define M_PI 3.14159265358979323846
420 # define CPLIsEqual(x,y) (fabs((x) - (y)) < 0.0000000000001)
429 #if defined(AFL_FRIENDLY) && defined(__GNUC__)
431 static inline int CPL_afl_friendly_memcmp(
const void* ptr1,
const void* ptr2,
size_t len)
432 __attribute__((always_inline));
434 static inline int CPL_afl_friendly_memcmp(
const void* ptr1,
const void* ptr2,
size_t len)
436 const unsigned char* bptr1 = (
const unsigned char*)ptr1;
437 const unsigned char* bptr2 = (
const unsigned char*)ptr2;
440 unsigned char b1 = *(bptr1++);
441 unsigned char b2 = *(bptr2++);
442 if( b1 != b2 )
return b1 - b2;
447 static inline int CPL_afl_friendly_strcmp(
const char* ptr1,
const char* ptr2)
448 __attribute__((always_inline));
450 static inline int CPL_afl_friendly_strcmp(
const char* ptr1,
const char* ptr2)
452 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
453 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
456 unsigned char ch1 = *(usptr1++);
457 unsigned char ch2 = *(usptr2++);
458 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
462 static inline int CPL_afl_friendly_strncmp(
const char* ptr1,
const char* ptr2,
size_t len)
463 __attribute__((always_inline));
465 static inline int CPL_afl_friendly_strncmp(
const char* ptr1,
const char* ptr2,
size_t len)
467 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
468 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
471 unsigned char ch1 = *(usptr1++);
472 unsigned char ch2 = *(usptr2++);
473 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
478 static inline int CPL_afl_friendly_strcasecmp(
const char* ptr1,
const char* ptr2)
479 __attribute__((always_inline));
481 static inline int CPL_afl_friendly_strcasecmp(
const char* ptr1,
const char* ptr2)
483 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
484 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
487 unsigned char ch1 = *(usptr1++);
488 unsigned char ch2 = *(usptr2++);
489 ch1 = (
unsigned char)toupper(ch1);
490 ch2 = (
unsigned char)toupper(ch2);
491 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
495 static inline int CPL_afl_friendly_strncasecmp(
const char* ptr1,
const char* ptr2,
size_t len)
496 __attribute__((always_inline));
498 static inline int CPL_afl_friendly_strncasecmp(
const char* ptr1,
const char* ptr2,
size_t len)
500 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
501 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
504 unsigned char ch1 = *(usptr1++);
505 unsigned char ch2 = *(usptr2++);
506 ch1 = (
unsigned char)toupper(ch1);
507 ch2 = (
unsigned char)toupper(ch2);
508 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
513 static inline char* CPL_afl_friendly_strstr(
const char* haystack,
const char* needle)
514 __attribute__((always_inline));
516 static inline char* CPL_afl_friendly_strstr(
const char* haystack,
const char* needle)
518 const char* ptr_haystack = haystack;
521 const char* ptr_haystack2 = ptr_haystack;
522 const char* ptr_needle = needle;
525 char ch1 = *(ptr_haystack2++);
526 char ch2 = *(ptr_needle++);
528 return (
char*)ptr_haystack;
532 if( *ptr_haystack == 0 )
540 #define memcmp CPL_afl_friendly_memcmp
541 #define strcmp CPL_afl_friendly_strcmp
542 #define strncmp CPL_afl_friendly_strncmp
543 #define strcasecmp CPL_afl_friendly_strcasecmp
544 #define strncasecmp CPL_afl_friendly_strncasecmp
545 #define strstr CPL_afl_friendly_strstr
550 # define STRCASECMP(a,b) (stricmp(a,b))
551 # define STRNCASECMP(a,b,n) (strnicmp(a,b,n))
554 # define STRCASECMP(a,b) (strcasecmp(a,b))
556 # define STRNCASECMP(a,b,n) (strncasecmp(a,b,n))
559 # define EQUALN(a,b,n) (STRNCASECMP(a,b,n)==0)
561 # define EQUAL(a,b) (STRCASECMP(a,b)==0)
568 #ifndef STARTS_WITH_CI
570 #define STARTS_WITH(a,b) (strncmp(a,b,strlen(b)) == 0)
572 #define STARTS_WITH_CI(a,b) EQUALN(a,b,strlen(b))
576 #ifndef CPL_THREADLOCAL
577 # define CPL_THREADLOCAL
592 # define CPLIsNan(x) _isnan(x)
593 # define CPLIsInf(x) (!_isnan(x) && !_finite(x))
594 # define CPLIsFinite(x) _finite(x)
595 #elif defined(__GNUC__) && ( __GNUC__ > 4 || ( __GNUC__ == 4 && __GNUC_MINOR__ >= 4 ) )
598 # define CPLIsNan(x) __builtin_isnan(x)
599 # define CPLIsInf(x) __builtin_isinf(x)
600 # define CPLIsFinite(x) __builtin_isfinite(x)
601 #elif defined(__cplusplus) && defined(HAVE_STD_IS_NAN) && HAVE_STD_IS_NAN
606 static inline int CPLIsNan(
float f) {
return std::isnan(f); }
607 static inline int CPLIsNan(
double f) {
return std::isnan(f); }
608 static inline int CPLIsInf(
float f) {
return std::isinf(f); }
609 static inline int CPLIsInf(
double f) {
return std::isinf(f); }
610 static inline int CPLIsFinite(
float f) {
return std::isfinite(f); }
611 static inline int CPLIsFinite(
double f) {
return std::isfinite(f); }
615 #if defined(__cplusplus) && defined(__GNUC__) && defined(__linux) && !defined(__ANDROID__) && !defined(CPL_SUPRESS_CPLUSPLUS)
619 static inline int CPLIsNan(
float f) {
return __isnanf(f); }
620 static inline int CPLIsNan(
double f) {
return __isnan(f); }
621 static inline int CPLIsInf(
float f) {
return __isinff(f); }
622 static inline int CPLIsInf(
double f) {
return __isinf(f); }
623 static inline int CPLIsFinite(
float f) {
return !__isnanf(f) && !__isinff(f); }
624 static inline int CPLIsFinite(
double f) {
return !__isnan(f) && !__isinf(f); }
627 # define CPLIsNan(x) isnan(x)
628 # if defined(isinf) || defined(__FreeBSD__)
630 # define CPLIsInf(x) isinf(x)
632 # define CPLIsFinite(x) (!isnan(x) && !isinf(x))
633 # elif defined(__sun__)
635 # define CPLIsInf(x) (!finite(x) && !isnan(x))
636 # define CPLIsFinite(x) finite(x)
638 # define CPLIsInf(x) (0)
639 # define CPLIsFinite(x) (!isnan(x))
652 #if defined(WORDS_BIGENDIAN) && !defined(CPL_MSB) && !defined(CPL_LSB)
656 #if ! ( defined(CPL_LSB) || defined(CPL_MSB) )
661 # define CPL_IS_LSB 1
663 # define CPL_IS_LSB 0
667 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
672 template <
bool b>
struct CPLStaticAssert {};
673 template<>
struct CPLStaticAssert<true>
675 static void my_function() {}
680 #define CPL_STATIC_ASSERT(x) CPLStaticAssert<x>::my_function()
681 #define CPL_STATIC_ASSERT_IF_AVAILABLE(x) CPL_STATIC_ASSERT(x)
685 #define CPL_STATIC_ASSERT_IF_AVAILABLE(x)
695 #define CPL_SWAP16(x) CPL_STATIC_CAST(GUInt16, (CPL_STATIC_CAST(GUInt16, x) << 8) | (CPL_STATIC_CAST(GUInt16, x) >> 8) )
697 #if defined(HAVE_GCC_BSWAP) && (defined(__i386__) || defined(__x86_64__))
701 #include <x86intrin.h>
703 #define CPL_SWAP32(x) CPL_STATIC_CAST(GUInt32, __builtin_bswap32(CPL_STATIC_CAST(GUInt32, x)))
705 #define CPL_SWAP64(x) CPL_STATIC_CAST(GUInt64, __builtin_bswap64(CPL_STATIC_CAST(GUInt64, x)))
706 #elif defined(_MSC_VER)
707 #define CPL_SWAP32(x) CPL_STATIC_CAST(GUInt32, _byteswap_ulong(CPL_STATIC_CAST(GUInt32, x)))
708 #define CPL_SWAP64(x) CPL_STATIC_CAST(GUInt64, _byteswap_uint64(CPL_STATIC_CAST(GUInt64, x)))
711 #define CPL_SWAP32(x) \
712 CPL_STATIC_CAST(GUInt32, \
713 ((CPL_STATIC_CAST(GUInt32, x) & 0x000000ffU) << 24) | \
714 ((CPL_STATIC_CAST(GUInt32, x) & 0x0000ff00U) << 8) | \
715 ((CPL_STATIC_CAST(GUInt32, x) & 0x00ff0000U) >> 8) | \
716 ((CPL_STATIC_CAST(GUInt32, x) & 0xff000000U) >> 24) )
719 #define CPL_SWAP64(x) \
720 ((CPL_STATIC_CAST(GUInt64, CPL_SWAP32(CPL_STATIC_CAST(GUInt32, x))) << 32) | \
721 (CPL_STATIC_CAST(GUInt64, CPL_SWAP32(CPL_STATIC_CAST(GUInt32, CPL_STATIC_CAST(GUInt64, x) >> 32)))))
726 #define CPL_SWAP16PTR(x) \
728 GByte byTemp, *_pabyDataT = CPL_REINTERPRET_CAST(GByte*, x); \
729 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 2); \
731 byTemp = _pabyDataT[0]; \
732 _pabyDataT[0] = _pabyDataT[1]; \
733 _pabyDataT[1] = byTemp; \
736 #if defined(MAKE_SANITIZE_HAPPY) || !(defined(__i386__) || defined(__x86_64__) || defined(_M_IX86) || defined(_M_X64))
739 #define CPL_SWAP32PTR(x) \
741 GByte byTemp, *_pabyDataT = CPL_REINTERPRET_CAST(GByte*, x); \
742 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4); \
744 byTemp = _pabyDataT[0]; \
745 _pabyDataT[0] = _pabyDataT[3]; \
746 _pabyDataT[3] = byTemp; \
747 byTemp = _pabyDataT[1]; \
748 _pabyDataT[1] = _pabyDataT[2]; \
749 _pabyDataT[2] = byTemp; \
753 #define CPL_SWAP64PTR(x) \
755 GByte byTemp, *_pabyDataT = CPL_REINTERPRET_CAST(GByte*, x); \
756 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8); \
758 byTemp = _pabyDataT[0]; \
759 _pabyDataT[0] = _pabyDataT[7]; \
760 _pabyDataT[7] = byTemp; \
761 byTemp = _pabyDataT[1]; \
762 _pabyDataT[1] = _pabyDataT[6]; \
763 _pabyDataT[6] = byTemp; \
764 byTemp = _pabyDataT[2]; \
765 _pabyDataT[2] = _pabyDataT[5]; \
766 _pabyDataT[5] = byTemp; \
767 byTemp = _pabyDataT[3]; \
768 _pabyDataT[3] = _pabyDataT[4]; \
769 _pabyDataT[4] = byTemp; \
775 #define CPL_SWAP32PTR(x) \
779 memcpy(&_n32, _lx, 4); \
780 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4); \
781 _n32 = CPL_SWAP32(_n32); \
782 memcpy(_lx, &_n32, 4); \
786 #define CPL_SWAP64PTR(x) \
790 memcpy(&_n64, _lx, 8); \
791 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8); \
792 _n64 = CPL_SWAP64(_n64); \
793 memcpy(_lx, &_n64, 8); \
799 #define CPL_SWAPDOUBLE(p) CPL_SWAP64PTR(p)
802 # define CPL_MSBWORD16(x) (x)
803 # define CPL_LSBWORD16(x) CPL_SWAP16(x)
804 # define CPL_MSBWORD32(x) (x)
805 # define CPL_LSBWORD32(x) CPL_SWAP32(x)
806 # define CPL_MSBPTR16(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 2)
807 # define CPL_LSBPTR16(x) CPL_SWAP16PTR(x)
808 # define CPL_MSBPTR32(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4)
809 # define CPL_LSBPTR32(x) CPL_SWAP32PTR(x)
810 # define CPL_MSBPTR64(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8)
811 # define CPL_LSBPTR64(x) CPL_SWAP64PTR(x)
814 # define CPL_LSBWORD16(x) (x)
816 # define CPL_MSBWORD16(x) CPL_SWAP16(x)
818 # define CPL_LSBWORD32(x) (x)
820 # define CPL_MSBWORD32(x) CPL_SWAP32(x)
822 # define CPL_LSBPTR16(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 2)
824 # define CPL_MSBPTR16(x) CPL_SWAP16PTR(x)
826 # define CPL_LSBPTR32(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4)
828 # define CPL_MSBPTR32(x) CPL_SWAP32PTR(x)
830 # define CPL_LSBPTR64(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8)
832 # define CPL_MSBPTR64(x) CPL_SWAP64PTR(x)
838 #define CPL_LSBINT16PTR(x) ((*CPL_REINTERPRET_CAST(const GByte*, x)) | (*((CPL_REINTERPRET_CAST(const GByte*, x))+1) << 8))
843 #define CPL_LSBINT32PTR(x) ((*CPL_REINTERPRET_CAST(const GByte*, x)) | (*((CPL_REINTERPRET_CAST(const GByte*, x))+1) << 8) | \
844 (*((CPL_REINTERPRET_CAST(const GByte*, x))+2) << 16) | (*((CPL_REINTERPRET_CAST(const GByte*, x))+3) << 24))
847 #define CPL_LSBSINT16PTR(x) CPL_STATIC_CAST(GInt16,CPL_LSBINT16PTR(x))
850 #define CPL_LSBUINT16PTR(x) CPL_STATIC_CAST(GUInt16, CPL_LSBINT16PTR(x))
853 #define CPL_LSBSINT32PTR(x) CPL_STATIC_CAST(GInt32, CPL_LSBINT32PTR(x))
856 #define CPL_LSBUINT32PTR(x) CPL_STATIC_CAST(GUInt32, CPL_LSBINT32PTR(x))
860 #ifndef UNREFERENCED_PARAM
861 # ifdef UNREFERENCED_PARAMETER
862 # define UNREFERENCED_PARAM(param) UNREFERENCED_PARAMETER(param)
864 # define UNREFERENCED_PARAM(param) ((void)param)
878 #ifndef DISABLE_CVSID
879 #if defined(__GNUC__) && __GNUC__ >= 4
880 # define CPL_CVSID(string) static const char cpl_cvsid[] __attribute__((used)) = string;
882 # define CPL_CVSID(string) static const char cpl_cvsid[] = string; \
883 static const char *cvsid_aw() { return( cvsid_aw() ? NULL : cpl_cvsid ); }
886 # define CPL_CVSID(string)
891 #if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP) && !(defined(__MINGW64__) && __GNUC__ == 4 && __GNUC_MINOR__ == 6)
893 # define CPL_NULL_TERMINATED __attribute__((__sentinel__))
896 # define CPL_NULL_TERMINATED
899 #if defined(__GNUC__) && __GNUC__ >= 3 && !defined(DOXYGEN_SKIP)
901 #define CPL_PRINT_FUNC_FORMAT( format_idx, arg_idx ) __attribute__((__format__ (__printf__, format_idx, arg_idx)))
903 #define CPL_SCAN_FUNC_FORMAT( format_idx, arg_idx ) __attribute__((__format__ (__scanf__, format_idx, arg_idx)))
906 #define CPL_PRINT_FUNC_FORMAT( format_idx, arg_idx )
908 #define CPL_SCAN_FUNC_FORMAT( format_idx, arg_idx )
911 #if defined(_MSC_VER) && (defined(GDAL_COMPILATION) || defined(CPL_ENABLE_MSVC_ANNOTATIONS))
915 # define CPL_FORMAT_STRING(arg) _Printf_format_string_ arg
918 # define CPL_SCANF_FORMAT_STRING(arg) _Scanf_format_string_ arg
921 # define CPL_FORMAT_STRING(arg) arg
923 # define CPL_SCANF_FORMAT_STRING(arg) arg
926 #if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP)
928 #define CPL_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
931 #define CPL_WARN_UNUSED_RESULT
934 #if defined(__GNUC__) && __GNUC__ >= 4
936 # define CPL_UNUSED __attribute((__unused__))
943 #if defined(__GNUC__) && __GNUC__ >= 3 && !defined(DOXYGEN_SKIP)
945 #define CPL_NO_RETURN __attribute__((noreturn))
948 #define CPL_NO_RETURN
953 #ifndef __has_attribute
954 #define __has_attribute(x) 0 // Compatibility with non-clang compilers.
959 #if ((defined(__GNUC__) && (__GNUC__ >= 5 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 9))) || __has_attribute(returns_nonnull)) && !defined(DOXYGEN_SKIP) && !defined(__INTEL_COMPILER)
961 # define CPL_RETURNS_NONNULL __attribute__((returns_nonnull))
964 # define CPL_RETURNS_NONNULL
967 #if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP)
969 #define CPL_RESTRICT __restrict__
975 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
979 # define CPL_OVERRIDE override
982 # define CPL_FINAL final
989 # define CPL_DISALLOW_COPY_ASSIGN(ClassName) \
990 ClassName( const ClassName & ) = delete; \
991 ClassName &operator=( const ClassName & ) = delete;
995 #if !defined(DOXYGEN_SKIP)
996 #if defined(__has_extension)
997 #if __has_extension(attribute_deprecated_with_message)
999 #define CPL_WARN_DEPRECATED(x) __attribute__ ((deprecated(x)))
1001 #define CPL_WARN_DEPRECATED(x)
1003 #elif defined(__GNUC__)
1004 #define CPL_WARN_DEPRECATED(x) __attribute__ ((deprecated))
1006 #define CPL_WARN_DEPRECATED(x)
1010 #if !defined(_MSC_VER) && !defined(__APPLE__) && !defined(_FORTIFY_SOURCE)
1012 # if defined(GDAL_COMPILATION) && defined(WARN_STANDARD_PRINTF)
1013 int vsnprintf(
char *str,
size_t size,
const char* fmt, va_list args)
1014 CPL_WARN_DEPRECATED(
"Use CPLvsnprintf() instead");
1015 int snprintf(
char *str,
size_t size,
const char* fmt, ...)
1018 int sprintf(
char *str, const
char* fmt, ...)
1021 # elif defined(GDAL_COMPILATION) && !defined(DONT_DEPRECATE_SPRINTF)
1022 int sprintf(
char *str,
const char* fmt, ...)
1024 CPL_WARN_DEPRECATED("Use snprintf() or
CPLsnprintf() instead");
1029 #if defined(MAKE_SANITIZE_HAPPY) || !(defined(__i386__) || defined(__x86_64__) || defined(_M_IX86) || defined(_M_X64))
1031 #define CPL_CPU_REQUIRES_ALIGNED_ACCESS
1035 #if defined(__cplusplus)
1037 #define CPL_ARRAYSIZE(array) \
1038 ((sizeof(array) / sizeof(*(array))) / \
1039 static_cast<size_t>(!(sizeof(array) % sizeof(*(array)))))
1042 template<
class T>
static void CPL_IGNORE_RET_VAL(T) {}
1043 inline static bool CPL_TO_BOOL(
int x) {
return x != 0; }
1048 #if (((__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)) || (defined(__clang__) && __clang_major__ >= 3)) && !defined(_MSC_VER))
1049 #define HAVE_GCC_DIAGNOSTIC_PUSH
1052 #if ((__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 2)) && !defined(_MSC_VER))
1053 #define HAVE_GCC_SYSTEM_HEADER
1056 #if ((defined(__clang__) && (__clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >=7))) || __GNUC__ >= 7)
1058 # define CPL_FALLTHROUGH [[clang::fallthrough]];
1061 # define CPL_FALLTHROUGH
1069 #if defined(__cplusplus) && defined(DEBUG_BOOL) && !defined(DO_NOT_USE_DEBUG_BOOL) && !defined(CPL_SUPRESS_CPLUSPLUS)
1071 class MSVCPedanticBool
1074 friend bool operator== (
const bool& one,
const MSVCPedanticBool& other);
1075 friend bool operator!= (
const bool& one,
const MSVCPedanticBool& other);
1078 MSVCPedanticBool(
int bIn);
1083 MSVCPedanticBool() {}
1084 MSVCPedanticBool(
bool bIn) : b(bIn) {}
1085 MSVCPedanticBool(
const MSVCPedanticBool& other) : b(other.b) {}
1087 MSVCPedanticBool& operator= (
const MSVCPedanticBool& other) { b = other.b;
return *
this; }
1088 MSVCPedanticBool& operator&= (
const MSVCPedanticBool& other) { b &= other.b;
return *
this; }
1089 MSVCPedanticBool& operator|= (
const MSVCPedanticBool& other) { b |= other.b;
return *
this; }
1091 bool operator== (
const bool& other)
const {
return b == other; }
1092 bool operator!= (
const bool& other)
const {
return b != other; }
1093 bool operator< (
const bool& other)
const {
return b < other; }
1094 bool operator== (
const MSVCPedanticBool& other)
const {
return b == other.b; }
1095 bool operator!= (
const MSVCPedanticBool& other)
const {
return b != other.b; }
1096 bool operator< (
const MSVCPedanticBool& other)
const {
return b < other.b; }
1098 bool operator! ()
const {
return !b; }
1099 operator bool()
const {
return b; }
1100 operator int()
const {
return b; }
1101 operator GIntBig()
const {
return b; }
1104 inline bool operator== (
const bool& one,
const MSVCPedanticBool& other) {
return one == other.b; }
1105 inline bool operator!= (
const bool& one,
const MSVCPedanticBool& other) {
return one != other.b; }
1116 #include <algorithm>
1117 #include <functional>
1121 #include <unordered_map>
1123 #include <unordered_set>
1135 #define EMULATED_BOOL int
1138 #define bool MSVCPedanticBool
1142 #define VOLATILE_BOOL bool
1154 #define EMULATED_BOOL bool
1155 #define VOLATILE_BOOL volatile bool
1159 #if __clang_major__ >= 4 || (__clang_major__ == 3 && __clang_minor__ >= 8)
1160 #define CPL_NOSANITIZE_UNSIGNED_INT_OVERFLOW __attribute__((no_sanitize("unsigned-integer-overflow")))
1162 #define CPL_NOSANITIZE_UNSIGNED_INT_OVERFLOW
1167 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
1168 #define CPL_NULLPTR nullptr
1170 #define CPL_NULLPTR NULL
1179 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS) && !defined(DOXYGEN_SKIP)