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)
163#if defined(HAVE_LIBDBMALLOC) && defined(HAVE_DBMALLOC_H) && defined(DEBUG)
165# include <dbmalloc.h>
168#if !defined(DBMALLOC) && defined(HAVE_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)
192# if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L)
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"
292#ifdef GDAL_COMPILATION
295typedef uintptr_t GUIntptr_t;
296#elif SIZEOF_VOIDP == 8
299typedef 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)
350# if defined(USE_GCC_VISIBILITY_FLAG)
351# define CPL_DLL __attribute__ ((visibility("default")))
352# if !defined(__MINGW32__)
353# define CPL_INTERNAL __attribute__((visibility("hidden")))
367#ifdef CPL_OPTIONAL_APIS
368# define CPL_ODLL CPL_DLL
375#if defined(_MSC_VER) && !defined(CPL_DISABLE_STDCALL)
376# define CPL_STDCALL __stdcall
384# define FORCE_CDECL __cdecl
392#if (defined(__GNUC__) && !defined(__NO_INLINE__)) || defined(_MSC_VER)
393#define HAS_CPL_INLINE 1
394#define CPL_INLINE __inline
395#elif defined(__SUNPRO_CC)
396#define HAS_CPL_INLINE 1
397#define CPL_INLINE inline
405# define MIN(a,b) (((a)<(b)) ? (a) : (b))
407# define MAX(a,b) (((a)>(b)) ? (a) : (b))
412# define ABS(x) (((x)<0) ? (-1*(x)) : (x))
417# define M_PI 3.14159265358979323846
428# define CPLIsEqual(x,y) (fabs((x) - (y)) < 0.0000000000001)
437#if defined(AFL_FRIENDLY) && defined(__GNUC__)
439static inline int CPL_afl_friendly_memcmp(
const void* ptr1,
const void* ptr2,
size_t len)
440 __attribute__((always_inline));
442static inline int CPL_afl_friendly_memcmp(
const void* ptr1,
const void* ptr2,
size_t len)
444 const unsigned char* bptr1 = (
const unsigned char*)ptr1;
445 const unsigned char* bptr2 = (
const unsigned char*)ptr2;
448 unsigned char b1 = *(bptr1++);
449 unsigned char b2 = *(bptr2++);
450 if( b1 != b2 )
return b1 - b2;
455static inline int CPL_afl_friendly_strcmp(
const char* ptr1,
const char* ptr2)
456 __attribute__((always_inline));
458static inline int CPL_afl_friendly_strcmp(
const char* ptr1,
const char* ptr2)
460 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
461 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
464 unsigned char ch1 = *(usptr1++);
465 unsigned char ch2 = *(usptr2++);
466 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
470static inline int CPL_afl_friendly_strncmp(
const char* ptr1,
const char* ptr2,
size_t len)
471 __attribute__((always_inline));
473static inline int CPL_afl_friendly_strncmp(
const char* ptr1,
const char* ptr2,
size_t len)
475 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
476 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
479 unsigned char ch1 = *(usptr1++);
480 unsigned char ch2 = *(usptr2++);
481 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
486static inline int CPL_afl_friendly_strcasecmp(
const char* ptr1,
const char* ptr2)
487 __attribute__((always_inline));
489static inline int CPL_afl_friendly_strcasecmp(
const char* ptr1,
const char* ptr2)
491 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
492 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
495 unsigned char ch1 = *(usptr1++);
496 unsigned char ch2 = *(usptr2++);
497 ch1 = (
unsigned char)toupper(ch1);
498 ch2 = (
unsigned char)toupper(ch2);
499 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
503static inline int CPL_afl_friendly_strncasecmp(
const char* ptr1,
const char* ptr2,
size_t len)
504 __attribute__((always_inline));
506static inline int CPL_afl_friendly_strncasecmp(
const char* ptr1,
const char* ptr2,
size_t len)
508 const unsigned char* usptr1 = (
const unsigned char*)ptr1;
509 const unsigned char* usptr2 = (
const unsigned char*)ptr2;
512 unsigned char ch1 = *(usptr1++);
513 unsigned char ch2 = *(usptr2++);
514 ch1 = (
unsigned char)toupper(ch1);
515 ch2 = (
unsigned char)toupper(ch2);
516 if( ch1 == 0 || ch1 != ch2 )
return ch1 - ch2;
521static inline char* CPL_afl_friendly_strstr(
const char* haystack,
const char* needle)
522 __attribute__((always_inline));
524static inline char* CPL_afl_friendly_strstr(
const char* haystack,
const char* needle)
526 const char* ptr_haystack = haystack;
529 const char* ptr_haystack2 = ptr_haystack;
530 const char* ptr_needle = needle;
533 char ch1 = *(ptr_haystack2++);
534 char ch2 = *(ptr_needle++);
536 return (
char*)ptr_haystack;
540 if( *ptr_haystack == 0 )
548#define memcmp CPL_afl_friendly_memcmp
549#define strcmp CPL_afl_friendly_strcmp
550#define strncmp CPL_afl_friendly_strncmp
551#define strcasecmp CPL_afl_friendly_strcasecmp
552#define strncasecmp CPL_afl_friendly_strncasecmp
553#define strstr CPL_afl_friendly_strstr
558# define STRCASECMP(a,b) (stricmp(a,b))
559# define STRNCASECMP(a,b,n) (strnicmp(a,b,n))
562# define STRCASECMP(a,b) (strcasecmp(a,b))
564# define STRNCASECMP(a,b,n) (strncasecmp(a,b,n))
567# define EQUALN(a,b,n) (STRNCASECMP(a,b,n)==0)
569# define EQUAL(a,b) (STRCASECMP(a,b)==0)
576#ifndef STARTS_WITH_CI
578#define STARTS_WITH(a,b) (strncmp(a,b,strlen(b)) == 0)
580#define STARTS_WITH_CI(a,b) EQUALN(a,b,strlen(b))
584#ifndef CPL_THREADLOCAL
585# define CPL_THREADLOCAL
600# define CPLIsNan(x) _isnan(x)
601# define CPLIsInf(x) (!_isnan(x) && !_finite(x))
602# define CPLIsFinite(x) _finite(x)
603#elif defined(__GNUC__) && ( __GNUC__ > 4 || ( __GNUC__ == 4 && __GNUC_MINOR__ >= 4 ) )
606# define CPLIsNan(x) __builtin_isnan(x)
607# define CPLIsInf(x) __builtin_isinf(x)
608# define CPLIsFinite(x) __builtin_isfinite(x)
609#elif defined(__cplusplus) && defined(HAVE_STD_IS_NAN) && HAVE_STD_IS_NAN
614static inline int CPLIsNan(
float f) {
return std::isnan(f); }
615static inline int CPLIsNan(
double f) {
return std::isnan(f); }
616static inline int CPLIsInf(
float f) {
return std::isinf(f); }
617static inline int CPLIsInf(
double f) {
return std::isinf(f); }
618static inline int CPLIsFinite(
float f) {
return std::isfinite(f); }
619static inline int CPLIsFinite(
double f) {
return std::isfinite(f); }
623#if defined(__cplusplus) && defined(__GNUC__) && defined(__linux) && !defined(__ANDROID__) && !defined(CPL_SUPRESS_CPLUSPLUS)
627static inline int CPLIsNan(
float f) {
return __isnanf(f); }
628static inline int CPLIsNan(
double f) {
return __isnan(f); }
629static inline int CPLIsInf(
float f) {
return __isinff(f); }
630static inline int CPLIsInf(
double f) {
return __isinf(f); }
631static inline int CPLIsFinite(
float f) {
return !__isnanf(f) && !__isinff(f); }
632static inline int CPLIsFinite(
double f) {
return !__isnan(f) && !__isinf(f); }
635# define CPLIsNan(x) isnan(x)
636# if defined(isinf) || defined(__FreeBSD__)
638# define CPLIsInf(x) isinf(x)
640# define CPLIsFinite(x) (!isnan(x) && !isinf(x))
641# elif defined(__sun__)
643# define CPLIsInf(x) (!finite(x) && !isnan(x))
644# define CPLIsFinite(x) finite(x)
646# define CPLIsInf(x) (0)
647# define CPLIsFinite(x) (!isnan(x))
660#if defined(WORDS_BIGENDIAN) && !defined(CPL_MSB) && !defined(CPL_LSB)
664#if ! ( defined(CPL_LSB) || defined(CPL_MSB) )
675#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
680template <
bool b>
struct CPLStaticAssert {};
681template<>
struct CPLStaticAssert<true>
683 static void my_function() {}
688#define CPL_STATIC_ASSERT(x) CPLStaticAssert<x>::my_function()
689#define CPL_STATIC_ASSERT_IF_AVAILABLE(x) CPL_STATIC_ASSERT(x)
693#define CPL_STATIC_ASSERT_IF_AVAILABLE(x)
703#define CPL_SWAP16(x) CPL_STATIC_CAST(GUInt16, (CPL_STATIC_CAST(GUInt16, x) << 8) | (CPL_STATIC_CAST(GUInt16, x) >> 8) )
705#if defined(HAVE_GCC_BSWAP) && (defined(__i386__) || defined(__x86_64__))
709#include <x86intrin.h>
711#define CPL_SWAP32(x) CPL_STATIC_CAST(GUInt32, __builtin_bswap32(CPL_STATIC_CAST(GUInt32, x)))
713#define CPL_SWAP64(x) CPL_STATIC_CAST(GUInt64, __builtin_bswap64(CPL_STATIC_CAST(GUInt64, x)))
714#elif defined(_MSC_VER)
715#define CPL_SWAP32(x) CPL_STATIC_CAST(GUInt32, _byteswap_ulong(CPL_STATIC_CAST(GUInt32, x)))
716#define CPL_SWAP64(x) CPL_STATIC_CAST(GUInt64, _byteswap_uint64(CPL_STATIC_CAST(GUInt64, x)))
719#define CPL_SWAP32(x) \
720 CPL_STATIC_CAST(GUInt32, \
721 ((CPL_STATIC_CAST(GUInt32, x) & 0x000000ffU) << 24) | \
722 ((CPL_STATIC_CAST(GUInt32, x) & 0x0000ff00U) << 8) | \
723 ((CPL_STATIC_CAST(GUInt32, x) & 0x00ff0000U) >> 8) | \
724 ((CPL_STATIC_CAST(GUInt32, x) & 0xff000000U) >> 24) )
727#define CPL_SWAP64(x) \
728 ((CPL_STATIC_CAST(GUInt64, CPL_SWAP32(CPL_STATIC_CAST(GUInt32, x))) << 32) | \
729 (CPL_STATIC_CAST(GUInt64, CPL_SWAP32(CPL_STATIC_CAST(GUInt32, CPL_STATIC_CAST(GUInt64, x) >> 32)))))
734#define CPL_SWAP16PTR(x) \
736 GByte byTemp, *_pabyDataT = CPL_REINTERPRET_CAST(GByte*, x); \
737 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 2); \
739 byTemp = _pabyDataT[0]; \
740 _pabyDataT[0] = _pabyDataT[1]; \
741 _pabyDataT[1] = byTemp; \
744#if defined(MAKE_SANITIZE_HAPPY) || !(defined(__i386__) || defined(__x86_64__) || defined(_M_IX86) || defined(_M_X64))
747#define CPL_SWAP32PTR(x) \
749 GByte byTemp, *_pabyDataT = CPL_REINTERPRET_CAST(GByte*, x); \
750 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4); \
752 byTemp = _pabyDataT[0]; \
753 _pabyDataT[0] = _pabyDataT[3]; \
754 _pabyDataT[3] = byTemp; \
755 byTemp = _pabyDataT[1]; \
756 _pabyDataT[1] = _pabyDataT[2]; \
757 _pabyDataT[2] = byTemp; \
761#define CPL_SWAP64PTR(x) \
763 GByte byTemp, *_pabyDataT = CPL_REINTERPRET_CAST(GByte*, x); \
764 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8); \
766 byTemp = _pabyDataT[0]; \
767 _pabyDataT[0] = _pabyDataT[7]; \
768 _pabyDataT[7] = byTemp; \
769 byTemp = _pabyDataT[1]; \
770 _pabyDataT[1] = _pabyDataT[6]; \
771 _pabyDataT[6] = byTemp; \
772 byTemp = _pabyDataT[2]; \
773 _pabyDataT[2] = _pabyDataT[5]; \
774 _pabyDataT[5] = byTemp; \
775 byTemp = _pabyDataT[3]; \
776 _pabyDataT[3] = _pabyDataT[4]; \
777 _pabyDataT[4] = byTemp; \
783#define CPL_SWAP32PTR(x) \
787 memcpy(&_n32, _lx, 4); \
788 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4); \
789 _n32 = CPL_SWAP32(_n32); \
790 memcpy(_lx, &_n32, 4); \
794#define CPL_SWAP64PTR(x) \
798 memcpy(&_n64, _lx, 8); \
799 CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8); \
800 _n64 = CPL_SWAP64(_n64); \
801 memcpy(_lx, &_n64, 8); \
807#define CPL_SWAPDOUBLE(p) CPL_SWAP64PTR(p)
810# define CPL_MSBWORD16(x) (x)
811# define CPL_LSBWORD16(x) CPL_SWAP16(x)
812# define CPL_MSBWORD32(x) (x)
813# define CPL_LSBWORD32(x) CPL_SWAP32(x)
814# define CPL_MSBPTR16(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 2)
815# define CPL_LSBPTR16(x) CPL_SWAP16PTR(x)
816# define CPL_MSBPTR32(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4)
817# define CPL_LSBPTR32(x) CPL_SWAP32PTR(x)
818# define CPL_MSBPTR64(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8)
819# define CPL_LSBPTR64(x) CPL_SWAP64PTR(x)
822# define CPL_LSBWORD16(x) (x)
824# define CPL_MSBWORD16(x) CPL_SWAP16(x)
826# define CPL_LSBWORD32(x) (x)
828# define CPL_MSBWORD32(x) CPL_SWAP32(x)
830# define CPL_LSBPTR16(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 2)
832# define CPL_MSBPTR16(x) CPL_SWAP16PTR(x)
834# define CPL_LSBPTR32(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 4)
836# define CPL_MSBPTR32(x) CPL_SWAP32PTR(x)
838# define CPL_LSBPTR64(x) CPL_STATIC_ASSERT_IF_AVAILABLE(sizeof(*(x)) == 1 || sizeof(*(x)) == 8)
840# define CPL_MSBPTR64(x) CPL_SWAP64PTR(x)
846#define CPL_LSBINT16PTR(x) ((*CPL_REINTERPRET_CAST(const GByte*, x)) | (*((CPL_REINTERPRET_CAST(const GByte*, x))+1) << 8))
851#define CPL_LSBINT32PTR(x) ((*CPL_REINTERPRET_CAST(const GByte*, x)) | (*((CPL_REINTERPRET_CAST(const GByte*, x))+1) << 8) | \
852 (*((CPL_REINTERPRET_CAST(const GByte*, x))+2) << 16) | (*((CPL_REINTERPRET_CAST(const GByte*, x))+3) << 24))
855#define CPL_LSBSINT16PTR(x) CPL_STATIC_CAST(GInt16,CPL_LSBINT16PTR(x))
858#define CPL_LSBUINT16PTR(x) CPL_STATIC_CAST(GUInt16, CPL_LSBINT16PTR(x))
861#define CPL_LSBSINT32PTR(x) CPL_STATIC_CAST(GInt32, CPL_LSBINT32PTR(x))
864#define CPL_LSBUINT32PTR(x) CPL_STATIC_CAST(GUInt32, CPL_LSBINT32PTR(x))
868#ifndef UNREFERENCED_PARAM
869# ifdef UNREFERENCED_PARAMETER
870# define UNREFERENCED_PARAM(param) UNREFERENCED_PARAMETER(param)
872# define UNREFERENCED_PARAM(param) ((void)param)
887#if defined(__GNUC__) && __GNUC__ >= 4
888# define CPL_CVSID(string) static const char cpl_cvsid[] __attribute__((used)) = string;
890# define CPL_CVSID(string) static const char cpl_cvsid[] = string; \
891static const char *cvsid_aw() { return( cvsid_aw() ? NULL : cpl_cvsid ); }
894# define CPL_CVSID(string)
899#if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP) && !(defined(__MINGW64__) && __GNUC__ == 4 && __GNUC_MINOR__ == 6)
901# define CPL_NULL_TERMINATED __attribute__((__sentinel__))
904# define CPL_NULL_TERMINATED
907#if defined(__GNUC__) && __GNUC__ >= 3 && !defined(DOXYGEN_SKIP)
909#define CPL_PRINT_FUNC_FORMAT( format_idx, arg_idx ) __attribute__((__format__ (__printf__, format_idx, arg_idx)))
911#define CPL_SCAN_FUNC_FORMAT( format_idx, arg_idx ) __attribute__((__format__ (__scanf__, format_idx, arg_idx)))
914#define CPL_PRINT_FUNC_FORMAT( format_idx, arg_idx )
916#define CPL_SCAN_FUNC_FORMAT( format_idx, arg_idx )
919#if defined(_MSC_VER) && (defined(GDAL_COMPILATION) || defined(CPL_ENABLE_MSVC_ANNOTATIONS))
923# define CPL_FORMAT_STRING(arg) _Printf_format_string_ arg
926# define CPL_SCANF_FORMAT_STRING(arg) _Scanf_format_string_ arg
929# define CPL_FORMAT_STRING(arg) arg
931# define CPL_SCANF_FORMAT_STRING(arg) arg
934#if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP)
936#define CPL_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
939#define CPL_WARN_UNUSED_RESULT
942#if defined(__GNUC__) && __GNUC__ >= 4
944# define CPL_UNUSED __attribute((__unused__))
951#if defined(__GNUC__) && __GNUC__ >= 3 && !defined(DOXYGEN_SKIP)
953#define CPL_NO_RETURN __attribute__((noreturn))
961#ifndef __has_attribute
962 #define __has_attribute(x) 0
967#if ((defined(__GNUC__) && (__GNUC__ >= 5 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 9))) || __has_attribute(returns_nonnull)) && !defined(DOXYGEN_SKIP) && !defined(__INTEL_COMPILER)
969# define CPL_RETURNS_NONNULL __attribute__((returns_nonnull))
972# define CPL_RETURNS_NONNULL
975#if defined(__GNUC__) && __GNUC__ >= 4 && !defined(DOXYGEN_SKIP)
977#define CPL_RESTRICT __restrict__
983#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
987# define CPL_OVERRIDE override
990# define CPL_FINAL final
997# define CPL_DISALLOW_COPY_ASSIGN(ClassName) \
998 ClassName( const ClassName & ) = delete; \
999 ClassName &operator=( const ClassName & ) = delete;
1003#if !defined(DOXYGEN_SKIP)
1004#if defined(__has_extension)
1005 #if __has_extension(attribute_deprecated_with_message)
1007 #define CPL_WARN_DEPRECATED(x) __attribute__ ((deprecated(x)))
1009 #define CPL_WARN_DEPRECATED(x)
1011#elif defined(__GNUC__)
1012 #define CPL_WARN_DEPRECATED(x) __attribute__ ((deprecated))
1014 #define CPL_WARN_DEPRECATED(x)
1018#if !defined(_MSC_VER) && !defined(__APPLE__) && !defined(_FORTIFY_SOURCE)
1020# if defined(GDAL_COMPILATION) && defined(WARN_STANDARD_PRINTF)
1021int vsnprintf(
char *str,
size_t size,
const char* fmt, va_list args)
1022 CPL_WARN_DEPRECATED(
"Use CPLvsnprintf() instead");
1023int snprintf(
char *str,
size_t size,
const char* fmt, ...)
1026int sprintf(
char *str, const
char* fmt, ...)
1029# elif defined(GDAL_COMPILATION) && !defined(DONT_DEPRECATE_SPRINTF)
1030int sprintf(
char *str,
const char* fmt, ...)
1032 CPL_WARN_DEPRECATED("Use snprintf() or
CPLsnprintf() instead");
1037#if defined(MAKE_SANITIZE_HAPPY) || !(defined(__i386__) || defined(__x86_64__) || defined(_M_IX86) || defined(_M_X64))
1039#define CPL_CPU_REQUIRES_ALIGNED_ACCESS
1043#if defined(__cplusplus)
1045#define CPL_ARRAYSIZE(array) \
1046 ((sizeof(array) / sizeof(*(array))) / \
1047 static_cast<size_t>(!(sizeof(array) % sizeof(*(array)))))
1050template<
class T>
static void CPL_IGNORE_RET_VAL(T) {}
1051inline static bool CPL_TO_BOOL(
int x) {
return x != 0; }
1056#if (((__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)) || (defined(__clang__) && __clang_major__ >= 3)) && !defined(_MSC_VER))
1057#define HAVE_GCC_DIAGNOSTIC_PUSH
1060#if ((__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 2)) && !defined(_MSC_VER))
1061#define HAVE_GCC_SYSTEM_HEADER
1064#if ((defined(__clang__) && (__clang_major__ > 3 || (__clang_major__ == 3 && __clang_minor__ >=7))) || __GNUC__ >= 7)
1066# define CPL_FALLTHROUGH [[clang::fallthrough]];
1069# define CPL_FALLTHROUGH
1077#if defined(__cplusplus) && defined(DEBUG_BOOL) && !defined(DO_NOT_USE_DEBUG_BOOL) && !defined(CPL_SUPRESS_CPLUSPLUS)
1079class MSVCPedanticBool
1082 friend bool operator== (
const bool& one,
const MSVCPedanticBool& other);
1083 friend bool operator!= (
const bool& one,
const MSVCPedanticBool& other);
1086 MSVCPedanticBool(
int bIn);
1091 MSVCPedanticBool() {}
1092 MSVCPedanticBool(
bool bIn) : b(bIn) {}
1093 MSVCPedanticBool(
const MSVCPedanticBool& other) : b(other.b) {}
1095 MSVCPedanticBool& operator= (
const MSVCPedanticBool& other) { b = other.b;
return *
this; }
1096 MSVCPedanticBool& operator&= (
const MSVCPedanticBool& other) { b &= other.b;
return *
this; }
1097 MSVCPedanticBool& operator|= (
const MSVCPedanticBool& other) { b |= other.b;
return *
this; }
1099 bool operator== (
const bool& other)
const {
return b == other; }
1100 bool operator!= (
const bool& other)
const {
return b != other; }
1101 bool operator< (
const bool& other)
const {
return b < other; }
1102 bool operator== (
const MSVCPedanticBool& other)
const {
return b == other.b; }
1103 bool operator!= (
const MSVCPedanticBool& other)
const {
return b != other.b; }
1104 bool operator< (
const MSVCPedanticBool& other)
const {
return b < other.b; }
1106 bool operator! ()
const {
return !b; }
1107 operator bool()
const {
return b; }
1108 operator int()
const {
return b; }
1109 operator GIntBig()
const {
return b; }
1112inline bool operator== (
const bool& one,
const MSVCPedanticBool& other) {
return one == other.b; }
1113inline bool operator!= (
const bool& one,
const MSVCPedanticBool& other) {
return one != other.b; }
1125#include <functional>
1129#include <unordered_map>
1131#include <unordered_set>
1143#define EMULATED_BOOL int
1146#define bool MSVCPedanticBool
1150#define VOLATILE_BOOL bool
1162#define EMULATED_BOOL bool
1163#define VOLATILE_BOOL volatile bool
1167#if __clang_major__ >= 4 || (__clang_major__ == 3 && __clang_minor__ >= 8)
1168#define CPL_NOSANITIZE_UNSIGNED_INT_OVERFLOW __attribute__((no_sanitize("unsigned-integer-overflow")))
1170#define CPL_NOSANITIZE_UNSIGNED_INT_OVERFLOW
1175#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
1176#define CPL_NULLPTR nullptr
1178#define CPL_NULLPTR NULL
1187#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS) && !defined(DOXYGEN_SKIP)
unsigned long long GUIntBig
Large unsigned integer type (generally 64-bit unsigned integer type).
Definition: cpl_port.h:251
short GInt16
Int16 type.
Definition: cpl_port.h:211
#define CPL_C_END
Macro to end a block of C symbols.
Definition: cpl_port.h:339
#define CPL_C_START
Macro to start a block of C symbols.
Definition: cpl_port.h:337
GIntBig GInt64
Signed 64 bit integer type.
Definition: cpl_port.h:267
int GBool
Type for boolean values (alias to int)
Definition: cpl_port.h:223
unsigned int GUInt32
Unsigned int32 type.
Definition: cpl_port.h:207
#define CPL_PRINT_FUNC_FORMAT(format_idx, arg_idx)
Tag a function to have printf() formatting.
Definition: cpl_port.h:914
GIntBig GPtrDiff_t
Integer type large enough to hold the difference between 2 addresses.
Definition: cpl_port.h:286
char ** CSLConstList
Type of a constant null-terminated list of nul terminated strings.
Definition: cpl_port.h:1194
GUIntBig GUInt64
Unsigned 64 bit integer type.
Definition: cpl_port.h:269
unsigned short GUInt16
Unsigned int16 type.
Definition: cpl_port.h:213
unsigned char GByte
Unsigned byte type.
Definition: cpl_port.h:215
int GInt32
Int32 type.
Definition: cpl_port.h:205
long long GIntBig
Large signed integer type (generally 64-bit integer type).
Definition: cpl_port.h:248
int CPLsnprintf(char *str, size_t size, const char *fmt,...)
snprintf() wrapper that is not sensitive to LC_NUMERIC settings.
Definition: cpl_string.cpp:1337