pointer.h File Reference

#include "document.h"
#include "internal/itoa.h"

Include dependency graph for pointer.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	GenericPointer< ValueType, Allocator >
	Represents a JSON Pointer. Use Pointer for UTF8 encoding and default allocator. More...
struct	GenericPointer< ValueType, Allocator >::Token
	A token is the basic units of internal representation. More...
class	GenericPointer< ValueType, Allocator >::PercentEncodeStream< OutputStream >
	A helper stream to encode character (UTF-8 code unit) into percent-encoded sequence. More...

Typedefs
typedef GenericPointer< Value >	Pointer
	GenericPointer for Value (UTF-8, default allocator). More...

Enumerations
enum	PointerParseErrorCode {   kPointerParseErrorNone = 0, kPointerParseErrorTokenMustBeginWithSolidus, kPointerParseErrorInvalidEscape, kPointerParseErrorInvalidPercentEncoding,   kPointerParseErrorCharacterMustPercentEncode }
	Error code of parsing. More...

Variables
static RAPIDJSON_NAMESPACE_BEGIN const SizeType	kPointerInvalidIndex = ~SizeType(0)
	Represents an invalid index in GenericPointer::Token. More...

Helper functions for GenericPointer
const GenericPointer< typename T::ValueType > &	pointer
const GenericPointer< typename T::ValueType > T2	defaultValue
const GenericPointer< typename T::ValueType > T2 T::AllocatorType &	a
const CharType(&	source )[N]
const GenericPointer< typename T::ValueType > T2	value
template<typename T >
T::ValueType &	CreateValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N>
T::ValueType &	CreateValueByPointer (T &root, const CharType(&source)[N], typename T::AllocatorType &a)
template<typename DocumentType >
DocumentType::ValueType &	CreateValueByPointer (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer)
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	CreateValueByPointer (DocumentType &document, const CharType(&source)[N])
template<typename T >
T::ValueType *	GetValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer, size_t *unresolvedTokenIndex=0)
template<typename T >
const T::ValueType *	GetValueByPointer (const T &root, const GenericPointer< typename T::ValueType > &pointer, size_t *unresolvedTokenIndex=0)
template<typename T , typename CharType , size_t N>
T::ValueType *	GetValueByPointer (T &root, const CharType(&source)[N], size_t *unresolvedTokenIndex=0)
template<typename T , typename CharType , size_t N>
const T::ValueType *	GetValueByPointer (const T &root, const CharType(&source)[N], size_t *unresolvedTokenIndex=0)
template<typename T >
T::ValueType &	GetValueByPointerWithDefault (T &root, const GenericPointer< typename T::ValueType > &pointer, const typename T::ValueType &defaultValue, typename T::AllocatorType &a)
template<typename T >
T::ValueType &	GetValueByPointerWithDefault (T &root, const GenericPointer< typename T::ValueType > &pointer, const typename T::Ch *defaultValue, typename T::AllocatorType &a)
template<typename T , typename T2 >
	RAPIDJSON_DISABLEIF_RETURN ((internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >),(typename T::ValueType &)) GetValueByPointerWithDefault(T &root
template<typename T , typename CharType , size_t N>
T::ValueType &	GetValueByPointerWithDefault (T &root, const CharType(&source)[N], const typename T::ValueType &defaultValue, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N>
T::ValueType &	GetValueByPointerWithDefault (T &root, const CharType(&source)[N], const typename T::Ch *defaultValue, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N, typename T2 >
	RAPIDJSON_DISABLEIF_RETURN ((internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >),(typename T::ValueType &)) GetValueByPointerWithDefault(T &root
template<typename DocumentType >
DocumentType::ValueType &	GetValueByPointerWithDefault (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer, const typename DocumentType::ValueType &defaultValue)
template<typename DocumentType >
DocumentType::ValueType &	GetValueByPointerWithDefault (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer, const typename DocumentType::Ch *defaultValue)
template<typename DocumentType , typename T2 >
	RAPIDJSON_DISABLEIF_RETURN ((internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >),(typename DocumentType::ValueType &)) GetValueByPointerWithDefault(DocumentType &document
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	GetValueByPointerWithDefault (DocumentType &document, const CharType(&source)[N], const typename DocumentType::ValueType &defaultValue)
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	GetValueByPointerWithDefault (DocumentType &document, const CharType(&source)[N], const typename DocumentType::Ch *defaultValue)
template<typename DocumentType , typename CharType , size_t N, typename T2 >
	RAPIDJSON_DISABLEIF_RETURN ((internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >),(typename DocumentType::ValueType &)) GetValueByPointerWithDefault(DocumentType &document
template<typename T >
T::ValueType &	SetValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer, typename T::ValueType &value, typename T::AllocatorType &a)
template<typename T >
T::ValueType &	SetValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer, const typename T::ValueType &value, typename T::AllocatorType &a)
template<typename T >
T::ValueType &	SetValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer, const typename T::Ch *value, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N>
T::ValueType &	SetValueByPointer (T &root, const CharType(&source)[N], typename T::ValueType &value, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N>
T::ValueType &	SetValueByPointer (T &root, const CharType(&source)[N], const typename T::ValueType &value, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N>
T::ValueType &	SetValueByPointer (T &root, const CharType(&source)[N], const typename T::Ch *value, typename T::AllocatorType &a)
template<typename DocumentType >
DocumentType::ValueType &	SetValueByPointer (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer, typename DocumentType::ValueType &value)
template<typename DocumentType >
DocumentType::ValueType &	SetValueByPointer (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer, const typename DocumentType::ValueType &value)
template<typename DocumentType >
DocumentType::ValueType &	SetValueByPointer (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer, const typename DocumentType::Ch *value)
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	SetValueByPointer (DocumentType &document, const CharType(&source)[N], typename DocumentType::ValueType &value)
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	SetValueByPointer (DocumentType &document, const CharType(&source)[N], const typename DocumentType::ValueType &value)
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	SetValueByPointer (DocumentType &document, const CharType(&source)[N], const typename DocumentType::Ch *value)
template<typename T >
T::ValueType &	SwapValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer, typename T::ValueType &value, typename T::AllocatorType &a)
template<typename T , typename CharType , size_t N>
T::ValueType &	SwapValueByPointer (T &root, const CharType(&source)[N], typename T::ValueType &value, typename T::AllocatorType &a)
template<typename DocumentType >
DocumentType::ValueType &	SwapValueByPointer (DocumentType &document, const GenericPointer< typename DocumentType::ValueType > &pointer, typename DocumentType::ValueType &value)
template<typename DocumentType , typename CharType , size_t N>
DocumentType::ValueType &	SwapValueByPointer (DocumentType &document, const CharType(&source)[N], typename DocumentType::ValueType &value)
template<typename T >
bool	EraseValueByPointer (T &root, const GenericPointer< typename T::ValueType > &pointer)
template<typename T , typename CharType , size_t N>
bool	EraseValueByPointer (T &root, const CharType(&source)[N])

Typedef Documentation

Pointer

typedef GenericPointer<Value> Pointer

GenericPointer for Value (UTF-8, default allocator).

Definition at line 1109 of file pointer.h.

Function Documentation

CreateValueByPointer() [1/4]

T::ValueType& CreateValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		typename T::AllocatorType &	a
	)

Definition at line 1117 of file pointer.h.

                                                                                                                                   {
    return pointer.Create(root, a);
}

CreateValueByPointer() [2/4]

T::ValueType& CreateValueByPointer	(	T &	root,
		const CharType(&)	source[N],
		typename T::AllocatorType &	a
	)

Definition at line 1122 of file pointer.h.

                                                                                                           {
    return GenericPointer<typename T::ValueType>(source, N - 1).Create(root, a);
}

CreateValueByPointer() [3/4]

DocumentType::ValueType& CreateValueByPointer	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer
	)

Definition at line 1129 of file pointer.h.

                                                                                                                                            {
    return pointer.Create(document);
}

CreateValueByPointer() [4/4]

DocumentType::ValueType& CreateValueByPointer	(	DocumentType &	document,
		const CharType(&)	source[N]
	)

Definition at line 1134 of file pointer.h.

                                                                                                         {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).Create(document);
}

EraseValueByPointer() [1/2]

bool EraseValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer
	)

Definition at line 1397 of file pointer.h.

                                                                                      {
    return pointer.Erase(root);
}

EraseValueByPointer() [2/2]

bool EraseValueByPointer	(	T &	root,
		const CharType(&)	source[N]
	)

Definition at line 1402 of file pointer.h.

                                                              {
    return GenericPointer<typename T::ValueType>(source, N - 1).Erase(root);
}

GetValueByPointer() [1/4]

T::ValueType* GetValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		size_t *	unresolvedTokenIndex = 0
	)

Definition at line 1141 of file pointer.h.

                                                                                                                                      {
    return pointer.Get(root, unresolvedTokenIndex);
}

GetValueByPointer() [2/4]

const T::ValueType* GetValueByPointer	(	const T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		size_t *	unresolvedTokenIndex = 0
	)

Definition at line 1146 of file pointer.h.

                                                                                                                                                  {
    return pointer.Get(root, unresolvedTokenIndex);
}

GetValueByPointer() [3/4]

T::ValueType* GetValueByPointer	(	T &	root,
		const CharType(&)	source[N],
		size_t *	unresolvedTokenIndex = 0
	)

Definition at line 1151 of file pointer.h.

                                                                                                               {
    return GenericPointer<typename T::ValueType>(source, N - 1).Get(root, unresolvedTokenIndex);
}

GetValueByPointer() [4/4]

const T::ValueType* GetValueByPointer	(	const T &	root,
		const CharType(&)	source[N],
		size_t *	unresolvedTokenIndex = 0
	)

Definition at line 1156 of file pointer.h.

                                                                                                                          {
    return GenericPointer<typename T::ValueType>(source, N - 1).Get(root, unresolvedTokenIndex);
}

GetValueByPointerWithDefault() [1/8]

T::ValueType& GetValueByPointerWithDefault	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		const typename T::ValueType &	defaultValue,
		typename T::AllocatorType &	a
	)

Definition at line 1163 of file pointer.h.

                                                                                                                                                                                    {
    return pointer.GetWithDefault(root, defaultValue, a);
}

Here is the caller graph for this function:

GetValueByPointerWithDefault() [2/8]

T::ValueType& GetValueByPointerWithDefault	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		const typename T::Ch *	defaultValue,
		typename T::AllocatorType &	a
	)

Definition at line 1168 of file pointer.h.

                                                                                                                                                                             {
    return pointer.GetWithDefault(root, defaultValue, a);
}

Here is the call graph for this function:

GetValueByPointerWithDefault() [3/8]

T::ValueType& GetValueByPointerWithDefault	(	T &	root,
		const CharType(&)	source[N],
		const typename T::ValueType &	defaultValue,
		typename T::AllocatorType &	a
	)

Definition at line 1186 of file pointer.h.

                                                                                                                                                            {
    return GenericPointer<typename T::ValueType>(source, N - 1).GetWithDefault(root, defaultValue, a);
}

GetValueByPointerWithDefault() [4/8]

T::ValueType& GetValueByPointerWithDefault	(	T &	root,
		const CharType(&)	source[N],
		const typename T::Ch *	defaultValue,
		typename T::AllocatorType &	a
	)

Definition at line 1191 of file pointer.h.

                                                                                                                                                     {
    return GenericPointer<typename T::ValueType>(source, N - 1).GetWithDefault(root, defaultValue, a);
}

Here is the call graph for this function:

GetValueByPointerWithDefault() [5/8]

DocumentType::ValueType& GetValueByPointerWithDefault	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer,
		const typename DocumentType::ValueType &	defaultValue
	)

Definition at line 1211 of file pointer.h.

                                                                                                                                                                                                        {
    return pointer.GetWithDefault(document, defaultValue);
}

GetValueByPointerWithDefault() [6/8]

DocumentType::ValueType& GetValueByPointerWithDefault	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer,
		const typename DocumentType::Ch *	defaultValue
	)

Definition at line 1216 of file pointer.h.

                                                                                                                                                                                                 {
    return pointer.GetWithDefault(document, defaultValue);
}

Here is the call graph for this function:

GetValueByPointerWithDefault() [7/8]

DocumentType::ValueType& GetValueByPointerWithDefault	(	DocumentType &	document,
		const CharType(&)	source[N],
		const typename DocumentType::ValueType &	defaultValue
	)

Definition at line 1234 of file pointer.h.

                                                                                                                                                                     {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).GetWithDefault(document, defaultValue);
}

GetValueByPointerWithDefault() [8/8]

DocumentType::ValueType& GetValueByPointerWithDefault	(	DocumentType &	document,
		const CharType(&)	source[N],
		const typename DocumentType::Ch *	defaultValue
	)

Definition at line 1239 of file pointer.h.

                                                                                                                                                              {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).GetWithDefault(document, defaultValue);
}

Here is the call graph for this function:

RAPIDJSON_DISABLEIF_RETURN() [1/4]

RAPIDJSON_DISABLEIF_RETURN	(	(internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >)	,
		(typename T::ValueType &)
	)		&

Here is the caller graph for this function:

RAPIDJSON_DISABLEIF_RETURN() [2/4]

RAPIDJSON_DISABLEIF_RETURN	(	(internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >)	,
		(typename T::ValueType &)
	)		&

RAPIDJSON_DISABLEIF_RETURN() [3/4]

RAPIDJSON_DISABLEIF_RETURN	(	(internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >)	,
		(typename DocumentType::ValueType &)
	)		&

RAPIDJSON_DISABLEIF_RETURN() [4/4]

RAPIDJSON_DISABLEIF_RETURN	(	(internal::OrExpr< internal::IsPointer< T2 >, internal::IsGenericValue< T2 > >)	,
		(typename DocumentType::ValueType &)
	)		&

SetValueByPointer() [1/12]

T::ValueType& SetValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		typename T::ValueType &	value,
		typename T::AllocatorType &	a
	)

Definition at line 1259 of file pointer.h.

                                                                                                                                                            {
    return pointer.Set(root, value, a);
}

Here is the caller graph for this function:

SetValueByPointer() [2/12]

T::ValueType& SetValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		const typename T::ValueType &	value,
		typename T::AllocatorType &	a
	)

Definition at line 1264 of file pointer.h.

                                                                                                                                                                  {
    return pointer.Set(root, value, a);
}

SetValueByPointer() [3/12]

T::ValueType& SetValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		const typename T::Ch *	value,
		typename T::AllocatorType &	a
	)

Definition at line 1269 of file pointer.h.

                                                                                                                                                           {
    return pointer.Set(root, value, a);
}

Here is the call graph for this function:

SetValueByPointer() [4/12]

T::ValueType& SetValueByPointer	(	T &	root,
		const CharType(&)	source[N],
		typename T::ValueType &	value,
		typename T::AllocatorType &	a
	)

Definition at line 1287 of file pointer.h.

                                                                                                                                    {
    return GenericPointer<typename T::ValueType>(source, N - 1).Set(root, value, a);
}

SetValueByPointer() [5/12]

T::ValueType& SetValueByPointer	(	T &	root,
		const CharType(&)	source[N],
		const typename T::ValueType &	value,
		typename T::AllocatorType &	a
	)

Definition at line 1292 of file pointer.h.

                                                                                                                                          {
    return GenericPointer<typename T::ValueType>(source, N - 1).Set(root, value, a);
}

SetValueByPointer() [6/12]

T::ValueType& SetValueByPointer	(	T &	root,
		const CharType(&)	source[N],
		const typename T::Ch *	value,
		typename T::AllocatorType &	a
	)

Definition at line 1297 of file pointer.h.

                                                                                                                                   {
    return GenericPointer<typename T::ValueType>(source, N - 1).Set(root, value, a);
}

Here is the call graph for this function:

SetValueByPointer() [7/12]

DocumentType::ValueType& SetValueByPointer	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer,
		typename DocumentType::ValueType &	value
	)

Definition at line 1317 of file pointer.h.

                                                                                                                                                                                {
    return pointer.Set(document, value);
}

SetValueByPointer() [8/12]

DocumentType::ValueType& SetValueByPointer	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer,
		const typename DocumentType::ValueType &	value
	)

Definition at line 1322 of file pointer.h.

                                                                                                                                                                                      {
    return pointer.Set(document, value);
}

SetValueByPointer() [9/12]

DocumentType::ValueType& SetValueByPointer	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer,
		const typename DocumentType::Ch *	value
	)

Definition at line 1327 of file pointer.h.

                                                                                                                                                                               {
    return pointer.Set(document, value);
}

Here is the call graph for this function:

SetValueByPointer() [10/12]

DocumentType::ValueType& SetValueByPointer	(	DocumentType &	document,
		const CharType(&)	source[N],
		typename DocumentType::ValueType &	value
	)

Definition at line 1345 of file pointer.h.

                                                                                                                                             {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).Set(document, value);
}

SetValueByPointer() [11/12]

DocumentType::ValueType& SetValueByPointer	(	DocumentType &	document,
		const CharType(&)	source[N],
		const typename DocumentType::ValueType &	value
	)

Definition at line 1350 of file pointer.h.

                                                                                                                                                   {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).Set(document, value);
}

SetValueByPointer() [12/12]

DocumentType::ValueType& SetValueByPointer	(	DocumentType &	document,
		const CharType(&)	source[N],
		const typename DocumentType::Ch *	value
	)

Definition at line 1355 of file pointer.h.

                                                                                                                                            {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).Set(document, value);
}

Here is the call graph for this function:

SwapValueByPointer() [1/4]

T::ValueType& SwapValueByPointer	(	T &	root,
		const GenericPointer< typename T::ValueType > &	pointer,
		typename T::ValueType &	value,
		typename T::AllocatorType &	a
	)

Definition at line 1375 of file pointer.h.

                                                                                                                                                             {
    return pointer.Swap(root, value, a);
}

Here is the call graph for this function:

SwapValueByPointer() [2/4]

T::ValueType& SwapValueByPointer	(	T &	root,
		const CharType(&)	source[N],
		typename T::ValueType &	value,
		typename T::AllocatorType &	a
	)

Definition at line 1380 of file pointer.h.

                                                                                                                                     {
    return GenericPointer<typename T::ValueType>(source, N - 1).Swap(root, value, a);
}

Here is the call graph for this function:

SwapValueByPointer() [3/4]

DocumentType::ValueType& SwapValueByPointer	(	DocumentType &	document,
		const GenericPointer< typename DocumentType::ValueType > &	pointer,
		typename DocumentType::ValueType &	value
	)

Definition at line 1385 of file pointer.h.

                                                                                                                                                                                 {
    return pointer.Swap(document, value);
}

Here is the call graph for this function:

SwapValueByPointer() [4/4]

DocumentType::ValueType& SwapValueByPointer	(	DocumentType &	document,
		const CharType(&)	source[N],
		typename DocumentType::ValueType &	value
	)

Definition at line 1390 of file pointer.h.

                                                                                                                                              {
    return GenericPointer<typename DocumentType::ValueType>(source, N - 1).Swap(document, value);
}

Here is the call graph for this function:

Variable Documentation

a

const GenericPointer< typename T::ValueType > T2 T::AllocatorType & a

Initial value:

{
    return pointer.GetWithDefault(root, defaultValue, a)

Definition at line 1181 of file pointer.h.

defaultValue

const GenericPointer< typename DocumentType::ValueType > T2 defaultValue

Initial value:

{
    return pointer.GetWithDefault(document, defaultValue)

Definition at line 1181 of file pointer.h.

kPointerInvalidIndex

RAPIDJSON_NAMESPACE_BEGIN const SizeType kPointerInvalidIndex = ~SizeType(0)

static

Represents an invalid index in GenericPointer::Token.

Definition at line 31 of file pointer.h.

pointer

const GenericPointer< typename DocumentType::ValueType > & pointer

Definition at line 1181 of file pointer.h.

source

const CharType(& source

Definition at line 1204 of file pointer.h.

value

const GenericPointer< typename DocumentType::ValueType > T2 value

Initial value:

{
    return pointer.Set(document, value)

Definition at line 1282 of file pointer.h.