bes
Updated for version 3.20.6
cmr_module/rapidjson/rapidjson.h
Go to the documentation of this file.
1
// Tencent is pleased to support the open source community by making RapidJSON available.
2
//
3
// Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved.
4
//
5
// Licensed under the MIT License (the "License"); you may not use this file except
6
// in compliance with the License. You may obtain a copy of the License at
7
//
8
// http://opensource.org/licenses/MIT
9
//
10
// Unless required by applicable law or agreed to in writing, software distributed
11
// under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
12
// CONDITIONS OF ANY KIND, either express or implied. See the License for the
13
// specific language governing permissions and limitations under the License.
14
15
#ifndef RAPIDJSON_RAPIDJSON_H_
16
#define RAPIDJSON_RAPIDJSON_H_
17
39
#include <cstdlib>
// malloc(), realloc(), free(), size_t
40
#include <cstring>
// memset(), memcpy(), memmove(), memcmp()
41
43
// RAPIDJSON_VERSION_STRING
44
//
45
// ALWAYS synchronize the following 3 macros with corresponding variables in /CMakeLists.txt.
46
//
47
49
// token stringification
50
#define RAPIDJSON_STRINGIFY(x) RAPIDJSON_DO_STRINGIFY(x)
51
#define RAPIDJSON_DO_STRINGIFY(x) #x
52
70
#define RAPIDJSON_MAJOR_VERSION 1
71
#define RAPIDJSON_MINOR_VERSION 1
72
#define RAPIDJSON_PATCH_VERSION 0
73
#define RAPIDJSON_VERSION_STRING \
74
RAPIDJSON_STRINGIFY(RAPIDJSON_MAJOR_VERSION.RAPIDJSON_MINOR_VERSION.RAPIDJSON_PATCH_VERSION)
75
77
// RAPIDJSON_NAMESPACE_(BEGIN|END)
112
#ifndef RAPIDJSON_NAMESPACE
113
#define RAPIDJSON_NAMESPACE rapidjson
114
#endif
115
#ifndef RAPIDJSON_NAMESPACE_BEGIN
116
#define RAPIDJSON_NAMESPACE_BEGIN namespace RAPIDJSON_NAMESPACE {
117
#endif
118
#ifndef RAPIDJSON_NAMESPACE_END
119
#define RAPIDJSON_NAMESPACE_END }
120
#endif
121
123
// RAPIDJSON_HAS_STDSTRING
124
125
#ifndef RAPIDJSON_HAS_STDSTRING
126
#ifdef RAPIDJSON_DOXYGEN_RUNNING
127
#define RAPIDJSON_HAS_STDSTRING 1 // force generation of documentation
128
#else
129
#define RAPIDJSON_HAS_STDSTRING 0 // no std::string support by default
130
#endif
131
141
#endif // !defined(RAPIDJSON_HAS_STDSTRING)
142
143
#if RAPIDJSON_HAS_STDSTRING
144
#include <string>
145
#endif // RAPIDJSON_HAS_STDSTRING
146
148
// RAPIDJSON_NO_INT64DEFINE
149
160
#ifndef RAPIDJSON_NO_INT64DEFINE
161
#if defined(_MSC_VER) && (_MSC_VER < 1800) // Visual Studio 2013
163
#include "msinttypes/stdint.h"
164
#include "msinttypes/inttypes.h"
165
#else
166
// Other compilers should have this.
167
#include <stdint.h>
168
#include <inttypes.h>
169
#endif
170
#ifdef RAPIDJSON_DOXYGEN_RUNNING
172
#define RAPIDJSON_NO_INT64DEFINE
173
#endif
174
#endif // RAPIDJSON_NO_INT64TYPEDEF
175
177
// RAPIDJSON_FORCEINLINE
178
179
#ifndef RAPIDJSON_FORCEINLINE
180
#if defined(_MSC_VER) && defined(NDEBUG)
182
#define RAPIDJSON_FORCEINLINE __forceinline
183
#elif defined(__GNUC__) && __GNUC__ >= 4 && defined(NDEBUG)
184
#define RAPIDJSON_FORCEINLINE __attribute__((always_inline))
185
#else
186
#define RAPIDJSON_FORCEINLINE
187
#endif
188
#endif // RAPIDJSON_FORCEINLINE
190
192
// RAPIDJSON_ENDIAN
193
#define RAPIDJSON_LITTLEENDIAN 0
194
#define RAPIDJSON_BIGENDIAN 1
195
196
209
#ifndef RAPIDJSON_ENDIAN
210
// Detect with GCC 4.6's macro
211
# ifdef __BYTE_ORDER__
212
# if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
213
# define RAPIDJSON_ENDIAN RAPIDJSON_LITTLEENDIAN
214
# elif __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
215
# define RAPIDJSON_ENDIAN RAPIDJSON_BIGENDIAN
216
# else
217
# error Unknown machine endianess detected. User needs to define RAPIDJSON_ENDIAN.
218
# endif // __BYTE_ORDER__
219
// Detect with GLIBC's endian.h
220
# elif defined(__GLIBC__)
221
# include <endian.h>
222
# if (__BYTE_ORDER == __LITTLE_ENDIAN)
223
# define RAPIDJSON_ENDIAN RAPIDJSON_LITTLEENDIAN
224
# elif (__BYTE_ORDER == __BIG_ENDIAN)
225
# define RAPIDJSON_ENDIAN RAPIDJSON_BIGENDIAN
226
# else
227
# error Unknown machine endianess detected. User needs to define RAPIDJSON_ENDIAN.
228
# endif // __GLIBC__
229
// Detect with _LITTLE_ENDIAN and _BIG_ENDIAN macro
230
# elif defined(_LITTLE_ENDIAN) && !defined(_BIG_ENDIAN)
231
# define RAPIDJSON_ENDIAN RAPIDJSON_LITTLEENDIAN
232
# elif defined(_BIG_ENDIAN) && !defined(_LITTLE_ENDIAN)
233
# define RAPIDJSON_ENDIAN RAPIDJSON_BIGENDIAN
234
// Detect with architecture macros
235
# elif defined(__sparc) || defined(__sparc__) || defined(_POWER) || defined(__powerpc__) || defined(__ppc__) || defined(__hpux) || defined(__hppa) || defined(_MIPSEB) || defined(_POWER) || defined(__s390__)
236
# define RAPIDJSON_ENDIAN RAPIDJSON_BIGENDIAN
237
# elif defined(__i386__) || defined(__alpha__) || defined(__ia64) || defined(__ia64__) || defined(_M_IX86) || defined(_M_IA64) || defined(_M_ALPHA) || defined(__amd64) || defined(__amd64__) || defined(_M_AMD64) || defined(__x86_64) || defined(__x86_64__) || defined(_M_X64) || defined(__bfin__)
238
# define RAPIDJSON_ENDIAN RAPIDJSON_LITTLEENDIAN
239
# elif defined(_MSC_VER) && defined(_M_ARM)
240
# define RAPIDJSON_ENDIAN RAPIDJSON_LITTLEENDIAN
241
# elif defined(RAPIDJSON_DOXYGEN_RUNNING)
242
# define RAPIDJSON_ENDIAN
243
# else
244
# error Unknown machine endianess detected. User needs to define RAPIDJSON_ENDIAN.
245
# endif
246
#endif // RAPIDJSON_ENDIAN
247
249
// RAPIDJSON_64BIT
250
252
#ifndef RAPIDJSON_64BIT
253
#if defined(__LP64__) || (defined(__x86_64__) && defined(__ILP32__)) || defined(_WIN64) || defined(__EMSCRIPTEN__)
254
#define RAPIDJSON_64BIT 1
255
#else
256
#define RAPIDJSON_64BIT 0
257
#endif
258
#endif // RAPIDJSON_64BIT
259
261
// RAPIDJSON_ALIGN
262
264
271
#ifndef RAPIDJSON_ALIGN
272
#if RAPIDJSON_64BIT == 1
273
#define RAPIDJSON_ALIGN(x) (((x) + static_cast<uint64_t>(7u)) & ~static_cast<uint64_t>(7u))
274
#else
275
#define RAPIDJSON_ALIGN(x) (((x) + 3u) & ~3u)
276
#endif
277
#endif
278
280
// RAPIDJSON_UINT64_C2
281
283
288
#ifndef RAPIDJSON_UINT64_C2
289
#define RAPIDJSON_UINT64_C2(high32, low32) ((static_cast<uint64_t>(high32) << 32) | static_cast<uint64_t>(low32))
290
#endif
291
293
// RAPIDJSON_48BITPOINTER_OPTIMIZATION
294
296
303
#ifndef RAPIDJSON_48BITPOINTER_OPTIMIZATION
304
#if defined(__amd64__) || defined(__amd64) || defined(__x86_64__) || defined(__x86_64) || defined(_M_X64) || defined(_M_AMD64)
305
#define RAPIDJSON_48BITPOINTER_OPTIMIZATION 1
306
#else
307
#define RAPIDJSON_48BITPOINTER_OPTIMIZATION 0
308
#endif
309
#endif // RAPIDJSON_48BITPOINTER_OPTIMIZATION
310
311
#if RAPIDJSON_48BITPOINTER_OPTIMIZATION == 1
312
#if RAPIDJSON_64BIT != 1
313
#error RAPIDJSON_48BITPOINTER_OPTIMIZATION can only be set to 1 when RAPIDJSON_64BIT=1
314
#endif
315
#define RAPIDJSON_SETPOINTER(type, p, x) (p = reinterpret_cast<type *>((reinterpret_cast<uintptr_t>(p) & static_cast<uintptr_t>(RAPIDJSON_UINT64_C2(0xFFFF0000, 0x00000000))) | reinterpret_cast<uintptr_t>(reinterpret_cast<const void*>(x))))
316
#define RAPIDJSON_GETPOINTER(type, p) (reinterpret_cast<type *>(reinterpret_cast<uintptr_t>(p) & static_cast<uintptr_t>(RAPIDJSON_UINT64_C2(0x0000FFFF, 0xFFFFFFFF))))
317
#else
318
#define RAPIDJSON_SETPOINTER(type, p, x) (p = (x))
319
#define RAPIDJSON_GETPOINTER(type, p) (p)
320
#endif
321
323
// RAPIDJSON_SSE2/RAPIDJSON_SSE42/RAPIDJSON_SIMD
324
347
#if defined(RAPIDJSON_SSE2) || defined(RAPIDJSON_SSE42) \
348
|| defined(RAPIDJSON_DOXYGEN_RUNNING)
349
#define RAPIDJSON_SIMD
350
#endif
351
353
// RAPIDJSON_NO_SIZETYPEDEFINE
354
355
#ifndef RAPIDJSON_NO_SIZETYPEDEFINE
356
371
#ifdef RAPIDJSON_DOXYGEN_RUNNING
372
#define RAPIDJSON_NO_SIZETYPEDEFINE
373
#endif
374
RAPIDJSON_NAMESPACE_BEGIN
376
380
typedef
unsigned
SizeType
;
381
RAPIDJSON_NAMESPACE_END
382
#endif
383
384
// always import std::size_t to rapidjson namespace
385
RAPIDJSON_NAMESPACE_BEGIN
386
using
std::size_t;
387
RAPIDJSON_NAMESPACE_END
388
390
// RAPIDJSON_ASSERT
391
393
400
#ifndef RAPIDJSON_ASSERT
401
#include <cassert>
402
#define RAPIDJSON_ASSERT(x) assert(x)
403
#endif // RAPIDJSON_ASSERT
404
406
// RAPIDJSON_STATIC_ASSERT
407
408
// Adopt from boost
409
#ifndef RAPIDJSON_STATIC_ASSERT
410
#ifndef __clang__
411
#endif
413
RAPIDJSON_NAMESPACE_BEGIN
414
template
<
bool
x>
struct
STATIC_ASSERTION_FAILURE;
415
template
<>
struct
STATIC_ASSERTION_FAILURE<true> {
enum
{ value = 1 }; };
416
template
<
int
x>
struct
StaticAssertTest {};
417
RAPIDJSON_NAMESPACE_END
418
419
#define RAPIDJSON_JOIN(X, Y) RAPIDJSON_DO_JOIN(X, Y)
420
#define RAPIDJSON_DO_JOIN(X, Y) RAPIDJSON_DO_JOIN2(X, Y)
421
#define RAPIDJSON_DO_JOIN2(X, Y) X##Y
422
423
#if defined(__GNUC__)
424
#define RAPIDJSON_STATIC_ASSERT_UNUSED_ATTRIBUTE __attribute__((unused))
425
#else
426
#define RAPIDJSON_STATIC_ASSERT_UNUSED_ATTRIBUTE
427
#endif
428
#ifndef __clang__
429
#endif
431
437
#define RAPIDJSON_STATIC_ASSERT(x) \
438
typedef ::RAPIDJSON_NAMESPACE::StaticAssertTest< \
439
sizeof(::RAPIDJSON_NAMESPACE::STATIC_ASSERTION_FAILURE<bool(x) >)> \
440
RAPIDJSON_JOIN(StaticAssertTypedef, __LINE__) RAPIDJSON_STATIC_ASSERT_UNUSED_ATTRIBUTE
441
#endif
442
444
// RAPIDJSON_LIKELY, RAPIDJSON_UNLIKELY
445
447
451
#ifndef RAPIDJSON_LIKELY
452
#if defined(__GNUC__) || defined(__clang__)
453
#define RAPIDJSON_LIKELY(x) __builtin_expect(!!(x), 1)
454
#else
455
#define RAPIDJSON_LIKELY(x) (x)
456
#endif
457
#endif
458
460
464
#ifndef RAPIDJSON_UNLIKELY
465
#if defined(__GNUC__) || defined(__clang__)
466
#define RAPIDJSON_UNLIKELY(x) __builtin_expect(!!(x), 0)
467
#else
468
#define RAPIDJSON_UNLIKELY(x) (x)
469
#endif
470
#endif
471
473
// Helpers
474
476
477
#define RAPIDJSON_MULTILINEMACRO_BEGIN do {
478
#define RAPIDJSON_MULTILINEMACRO_END \
479
} while((void)0, 0)
480
481
// adopted from Boost
482
#define RAPIDJSON_VERSION_CODE(x,y,z) \
483
(((x)*100000) + ((y)*100) + (z))
484
486
// RAPIDJSON_DIAG_PUSH/POP, RAPIDJSON_DIAG_OFF
487
488
#if defined(__GNUC__)
489
#define RAPIDJSON_GNUC \
490
RAPIDJSON_VERSION_CODE(__GNUC__,__GNUC_MINOR__,__GNUC_PATCHLEVEL__)
491
#endif
492
493
#if defined(__clang__) || (defined(RAPIDJSON_GNUC) && RAPIDJSON_GNUC >= RAPIDJSON_VERSION_CODE(4,2,0))
494
495
#define RAPIDJSON_PRAGMA(x) _Pragma(RAPIDJSON_STRINGIFY(x))
496
#define RAPIDJSON_DIAG_PRAGMA(x) RAPIDJSON_PRAGMA(GCC diagnostic x)
497
#define RAPIDJSON_DIAG_OFF(x) \
498
RAPIDJSON_DIAG_PRAGMA(ignored RAPIDJSON_STRINGIFY(RAPIDJSON_JOIN(-W,x)))
499
500
// push/pop support in Clang and GCC>=4.6
501
#if defined(__clang__) || (defined(RAPIDJSON_GNUC) && RAPIDJSON_GNUC >= RAPIDJSON_VERSION_CODE(4,6,0))
502
#define RAPIDJSON_DIAG_PUSH RAPIDJSON_DIAG_PRAGMA(push)
503
#define RAPIDJSON_DIAG_POP RAPIDJSON_DIAG_PRAGMA(pop)
504
#else // GCC >= 4.2, < 4.6
505
#define RAPIDJSON_DIAG_PUSH
/* ignored */
506
#define RAPIDJSON_DIAG_POP
/* ignored */
507
#endif
508
509
#elif defined(_MSC_VER)
510
511
// pragma (MSVC specific)
512
#define RAPIDJSON_PRAGMA(x) __pragma(x)
513
#define RAPIDJSON_DIAG_PRAGMA(x) RAPIDJSON_PRAGMA(warning(x))
514
515
#define RAPIDJSON_DIAG_OFF(x) RAPIDJSON_DIAG_PRAGMA(disable: x)
516
#define RAPIDJSON_DIAG_PUSH RAPIDJSON_DIAG_PRAGMA(push)
517
#define RAPIDJSON_DIAG_POP RAPIDJSON_DIAG_PRAGMA(pop)
518
519
#else
520
521
#define RAPIDJSON_DIAG_OFF(x)
/* ignored */
522
#define RAPIDJSON_DIAG_PUSH
/* ignored */
523
#define RAPIDJSON_DIAG_POP
/* ignored */
524
525
#endif // RAPIDJSON_DIAG_*
526
528
// C++11 features
529
530
#ifndef RAPIDJSON_HAS_CXX11_RVALUE_REFS
531
#if defined(__clang__)
532
#if __has_feature(cxx_rvalue_references) && \
533
(defined(_LIBCPP_VERSION) || defined(__GLIBCXX__) && __GLIBCXX__ >= 20080306)
534
#define RAPIDJSON_HAS_CXX11_RVALUE_REFS 1
535
#else
536
#define RAPIDJSON_HAS_CXX11_RVALUE_REFS 0
537
#endif
538
#elif (defined(RAPIDJSON_GNUC) && (RAPIDJSON_GNUC >= RAPIDJSON_VERSION_CODE(4,3,0)) && defined(__GXX_EXPERIMENTAL_CXX0X__)) || \
539
(defined(_MSC_VER) && _MSC_VER >= 1600)
540
541
#define RAPIDJSON_HAS_CXX11_RVALUE_REFS 1
542
#else
543
#define RAPIDJSON_HAS_CXX11_RVALUE_REFS 0
544
#endif
545
#endif // RAPIDJSON_HAS_CXX11_RVALUE_REFS
546
547
#ifndef RAPIDJSON_HAS_CXX11_NOEXCEPT
548
#if defined(__clang__)
549
#define RAPIDJSON_HAS_CXX11_NOEXCEPT __has_feature(cxx_noexcept)
550
#elif (defined(RAPIDJSON_GNUC) && (RAPIDJSON_GNUC >= RAPIDJSON_VERSION_CODE(4,6,0)) && defined(__GXX_EXPERIMENTAL_CXX0X__))
551
// (defined(_MSC_VER) && _MSC_VER >= ????) // not yet supported
552
#define RAPIDJSON_HAS_CXX11_NOEXCEPT 1
553
#else
554
#define RAPIDJSON_HAS_CXX11_NOEXCEPT 0
555
#endif
556
#endif
557
#if RAPIDJSON_HAS_CXX11_NOEXCEPT
558
#define RAPIDJSON_NOEXCEPT noexcept
559
#else
560
#define RAPIDJSON_NOEXCEPT
/* noexcept */
561
#endif // RAPIDJSON_HAS_CXX11_NOEXCEPT
562
563
// no automatic detection, yet
564
#ifndef RAPIDJSON_HAS_CXX11_TYPETRAITS
565
#define RAPIDJSON_HAS_CXX11_TYPETRAITS 0
566
#endif
567
568
#ifndef RAPIDJSON_HAS_CXX11_RANGE_FOR
569
#if defined(__clang__)
570
#define RAPIDJSON_HAS_CXX11_RANGE_FOR __has_feature(cxx_range_for)
571
#elif (defined(RAPIDJSON_GNUC) && (RAPIDJSON_GNUC >= RAPIDJSON_VERSION_CODE(4,3,0)) && defined(__GXX_EXPERIMENTAL_CXX0X__)) || \
572
(defined(_MSC_VER) && _MSC_VER >= 1700)
573
#define RAPIDJSON_HAS_CXX11_RANGE_FOR 1
574
#else
575
#define RAPIDJSON_HAS_CXX11_RANGE_FOR 0
576
#endif
577
#endif // RAPIDJSON_HAS_CXX11_RANGE_FOR
578
580
582
// new/delete
583
584
#ifndef RAPIDJSON_NEW
585
#define RAPIDJSON_NEW(x) new x
587
#endif
588
#ifndef RAPIDJSON_DELETE
589
#define RAPIDJSON_DELETE(x) delete x
591
#endif
592
594
// Type
595
600
RAPIDJSON_NAMESPACE_BEGIN
601
603
enum
Type
{
604
kNullType
= 0,
605
kFalseType
= 1,
606
kTrueType
= 2,
607
kObjectType
= 3,
608
kArrayType
= 4,
609
kStringType
= 5,
610
kNumberType
= 6
611
};
612
613
RAPIDJSON_NAMESPACE_END
614
615
#endif // RAPIDJSON_RAPIDJSON_H_
kStringType
@ kStringType
string
Definition:
cmr_module/rapidjson/rapidjson.h:609
kTrueType
@ kTrueType
true
Definition:
cmr_module/rapidjson/rapidjson.h:606
kArrayType
@ kArrayType
array
Definition:
cmr_module/rapidjson/rapidjson.h:608
Type
Type
Type of JSON value.
Definition:
cmr_module/rapidjson/rapidjson.h:603
kObjectType
@ kObjectType
object
Definition:
cmr_module/rapidjson/rapidjson.h:607
kFalseType
@ kFalseType
false
Definition:
cmr_module/rapidjson/rapidjson.h:605
kNumberType
@ kNumberType
number
Definition:
cmr_module/rapidjson/rapidjson.h:610
SizeType
RAPIDJSON_NAMESPACE_BEGIN typedef unsigned SizeType
Size type (for string lengths, array sizes, etc.)
Definition:
cmr_module/rapidjson/rapidjson.h:380
kNullType
@ kNullType
null
Definition:
cmr_module/rapidjson/rapidjson.h:604
RAPIDJSON_NAMESPACE_END
#define RAPIDJSON_NAMESPACE_END
provide custom rapidjson namespace (closing expression)
Definition:
cmr_module/rapidjson/rapidjson.h:119
RAPIDJSON_NAMESPACE_BEGIN
#define RAPIDJSON_NAMESPACE_BEGIN
provide custom rapidjson namespace (opening expression)
Definition:
cmr_module/rapidjson/rapidjson.h:116
modules
cmr_module
rapidjson
rapidjson.h
Generated by
1.8.17