Configuration macros for library features. More...

Macros
#define	RAPIDJSON_48BITPOINTER_OPTIMIZATION 0
	Use only lower 48-bit address for some pointers. More...

#define	RAPIDJSON_ALIGN(x) (((x) + 3u) & ~3u)
	Data alignment of the machine. More...

#define	RAPIDJSON_ASSERT(x) assert(x)
	Assertion. More...

#define	RAPIDJSON_HAS_STDSTRING 0
	Enable RapidJSON support for `std::string`. More...

#define	RAPIDJSON_LIKELY(x) (x)
	Compiler branching hint for expression with high probability to be true. More...

#define	RAPIDJSON_MAJOR_VERSION 1
	Major version of RapidJSON in integer. More...

#define	RAPIDJSON_MINOR_VERSION 1
	Minor version of RapidJSON in integer. More...

#define	RAPIDJSON_NAMESPACE rapidjson
	provide custom rapidjson namespace More...

#define	RAPIDJSON_NAMESPACE_BEGIN namespace RAPIDJSON_NAMESPACE {
	provide custom rapidjson namespace (opening expression) More...

#define	RAPIDJSON_NAMESPACE_END }
	provide custom rapidjson namespace (closing expression) More...

#define	RAPIDJSON_PATCH_VERSION 0
	Patch version of RapidJSON in integer. More...

#define	RAPIDJSON_UNLIKELY(x) (x)
	Compiler branching hint for expression with low probability to be true. More...

#define	RAPIDJSON_VERSION_STRING RAPIDJSON_STRINGIFY(RAPIDJSON_MAJOR_VERSION.RAPIDJSON_MINOR_VERSION.RAPIDJSON_PATCH_VERSION)
	Version of RapidJSON in "<major>.<minor>.<patch>" string format. More...

Detailed Description

Configuration macros for library features.

Some RapidJSON features are configurable to adapt the library to a wide variety of platforms, environments and usage scenarios. Most of the features can be configured in terms of overriden or predefined preprocessor macros at compile-time.

Some additional customization is available in the RapidJSON error handling APIs.

Note: These macros should be given on the compiler command-line (where applicable) to avoid inconsistent values when compiling different translation units of a single application.

Macro Definition Documentation

#define RAPIDJSON_48BITPOINTER_OPTIMIZATION 0

Use only lower 48-bit address for some pointers.

This optimization uses the fact that current X86-64 architecture only implement lower 48-bit virtual address. The higher 16-bit can be used for storing other data. GenericValue uses this optimization to reduce its size form 24 bytes to 16 bytes in 64-bit architecture.

Definition at line 312 of file rapidjson.h.

#define RAPIDJSON_ALIGN ( x ) (((x) + 3u) & ~3u)

Data alignment of the machine.

Parameters

x	pointer to align

Some machines require strict data alignment. Currently the default uses 4 bytes alignment on 32-bit platforms and 8 bytes alignment for 64-bit platforms. User can customize by defining the RAPIDJSON_ALIGN function macro.

Definition at line 280 of file rapidjson.h.

#define RAPIDJSON_ASSERT ( x ) assert(x)

Assertion.

By default, rapidjson uses C assert() for internal assertions. User can override it by defining RAPIDJSON_ASSERT(x) macro.

Note: Parsing errors are handled and can be customized by the RapidJSON error handling APIs.

Definition at line 411 of file rapidjson.h.

#define RAPIDJSON_HAS_STDSTRING 0

Enable RapidJSON support for std::string.

By defining this preprocessor symbol to 1, several convenience functions for using rapidjson::GenericValue with std::string are enabled, especially for construction and comparison.

#define RAPIDJSON_LIKELY ( x ) (x)

Compiler branching hint for expression with high probability to be true.

Parameters

x	Boolean expression likely to be true.

Definition at line 468 of file rapidjson.h.

#define RAPIDJSON_MAJOR_VERSION 1

Major version of RapidJSON in integer.

Definition at line 75 of file rapidjson.h.

#define RAPIDJSON_MINOR_VERSION 1

Minor version of RapidJSON in integer.

Definition at line 76 of file rapidjson.h.

#define RAPIDJSON_NAMESPACE rapidjson

provide custom rapidjson namespace

In order to avoid symbol clashes and/or "One Definition Rule" errors between multiple inclusions of (different versions of) RapidJSON in a single binary, users can customize the name of the main RapidJSON namespace.

In case of a single nesting level, defining RAPIDJSON_NAMESPACE to a custom name (e.g. MyRapidJSON) is sufficient. If multiple levels are needed, both RAPIDJSON_NAMESPACE_BEGIN and RAPIDJSON_NAMESPACE_END need to be defined as well:

 // in some .cpp file
 #define RAPIDJSON_NAMESPACE my::rapidjson
 #define RAPIDJSON_NAMESPACE_BEGIN namespace my { namespace rapidjson {
 #define RAPIDJSON_NAMESPACE_END   } }
 #include "rapidjson/..."