Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://open-source-parsers.github.io/jsoncpp-docs/doxygen/class_json_1_1_value.html below:

Represents a JSON value. More...

#include <json/value.h>

Represents a JSON value.

This class is a discriminated union wrapper that can represents a:

• signed integer [range: Value::minInt - Value::maxInt]
• unsigned integer (range: 0 - Value::maxUInt)
• double
• UTF-8 string
• boolean
• 'null'
• an ordered list of Value
• collection of name/value pairs (javascript object)

The type of the held value is represented by a ValueType and can be obtained using type().

Values of an objectValue or arrayValue can be accessed using operator[]() methods. Non-const methods will automatically create the a nullValue element if it does not exist. The sequence of an arrayValue will be automatically resized and initialized with nullValue. resize() can be used to enlarge or truncate an arrayValue.

The get() methods can be used to obtain default value in the case the required element does not exist.

It is possible to iterate over the list of member keys of an object using the getMemberNames() method.

Note

Value string-length fit in size_t, but keys must be < 2^30. (The reason is an implementation detail.) A #CharReader will raise an exception if a bound is exceeded to avoid security holes in your app, but the Value API does not check bounds. That is the responsibility of the caller.

Create a default Value of the given type.

This is a very useful constructor. To create an empty array, pass arrayValue. To create an empty object, pass objectValue. Another Value can then be set to this one by assignment. This is useful since clear() and resize() will not alter types.

Examples:

Represents a JSON value.

Definition: value.h:193

@ arrayValue

array value (ordered list)

Definition: value.h:114

@ objectValue

object value (collection of name/value pairs).

Definition: value.h:115

Default constructor initialization must be equivalent to: memset( this, 0, sizeof(Value) ) This optimization is used in ValueInternalMap fast allocator.

Copy til first 0. (NULL causes to seg-fault.)

Copy all, incl zeroes.

Constructs a value from a static string.

Like other value string constructor but do not duplicate the string for internal storage. The given string must remain alive after the call to this constructor.

Note

This works only for null-terminated strings. (We cannot change the size of this class, so we have nowhere to store the length, which might be computed later for various operations.)

Example of usage:

static StaticString foo("some text");

Append value to array at the end.

Equivalent to jsonvalue[jsonvalue.size()] = value;

template<>

template<>

template<>

template<>

template<>

template<>

template<>

template<>

These as specializations are type conversions, and do not have a corresponding is.

template<>

template<typename T >

The as<T> and is<T> member function templates and specializations.

Embedded zeroes could cause you trouble!

Embedded zeroes are possible.

Remove all object members and array elements.

Precondition

type() is arrayValue, objectValue, or nullValue

Postcondition

type() is unchanged

copy everything.

copy values but leave comments and source offsets in place.

Most general and efficient version of object-mutators.

Note

As stated elsewhere, behavior is undefined if (end-begin) >= 2^30

Returns

non-zero, but JSON_ASSERT if this is neither object nor nullValue.

Return true if empty array, empty object, or null; otherwise, false.

Most general and efficient version of isMember()const, get()const, and operator[]const.

Note

As stated elsewhere, behavior is undefined if (end-begin) >= 2^30

If the array contains at least index+1 elements, returns the element value, otherwise returns defaultValue.

Return the member named key if it exist, defaultValue otherwise.

Note

deep copy

key may contain embedded nulls.

Return the member named key if it exist, defaultValue otherwise.

Note

deep copy

Return the member named key if it exist, defaultValue otherwise.

Note

deep copy

Parameters

key may contain embedded nulls.

Include delimiters and embedded newlines.

Return a list of the member names.

If null, return an empty list.

Precondition

type() is objectValue or nullValue

Postcondition

if type() was nullValue, it remains nullValue

Get raw char* of string-value.

Returns

false if !string. (Seg-fault if str or end are NULL.)

Insert value in array at specific index.

template<>

template<>

template<>

template<>

template<>

template<>

template<>

template<typename T >

Return true if the object has a member named key.

Note

'key' must be null-terminated.

Return true if the object has a member named key.

Parameters

key may contain embedded nulls.

Return true if index < size().

Return !isNull()

Compare payload only, not comments etc.

Note

Overwrite existing comments. To preserve comments, use swapPayload().

Access an array element (zero based index).

If the array contains less than index element, then null value are inserted in the array so that its size is index+1. (You may need to say 'value[0u]' to get your compiler to distinguish this from the operator[] which takes a string.)

Access an array element (zero based index).

(You may need to say 'value[0u]' to get your compiler to distinguish this from the operator[] which takes a string.)

Access an object value by name, create a null member if it does not exist.

Note

Because of our implementation, keys are limited to 2^30 -1 chars. Exceeding that will cause an exception.

Access an object value by name, returns null if there is no member with that name.

Access an object value by name, create a null member if it does not exist.

If the object has no entry for that name, then the member name used to store the new entry is not duplicated. Example of use:

static const StaticString code("code");

object[code] = 1234;

Access an object value by name, create a null member if it does not exist.

Parameters

key may contain embedded nulls.

Access an object value by name, returns null if there is no member with that name.

Parameters

key may contain embedded nulls.

Remove the indexed array element.

O(n) expensive operations. Update 'removed' iff removed.

Returns

true if removed (no exceptions)

Remove and return the named member.

Do nothing if it did not exist.

Precondition

type() is objectValue or nullValue

Postcondition

type() is unchanged

Remove the named map member.

Update 'removed' iff removed.

Parameters

key may contain embedded nulls.

Returns

true iff removed (no exceptions)

Resize the array to newSize elements.

New elements are initialized to null. May only be called on nullValue or arrayValue.

Precondition

type() is arrayValue or nullValue

Postcondition

type() is arrayValue

Comments must be //... or /* ... *‍/.

Comments must be //... or /* ... *‍/.

Number of values in array or object.

Swap everything.

Swap values but leave comments and source offsets in place.

Default precision for real value for string representation.

Maximum signed int value that can be stored in a Json::Value.

Maximum signed 64 bits int value that can be stored in a Json::Value.

Maximum signed integer value that can be stored in a Json::Value.

Maximum unsigned integer value that can be stored in a Json::Value.

Maximum unsigned int value that can be stored in a Json::Value.

Maximum unsigned 64 bits int value that can be stored in a Json::Value.

Minimum signed int value that can be stored in a Json::Value.

Minimum signed 64 bits int value that can be stored in a Json::Value.

=

Json::LargestInt LargestInt

Definition: value.h:206

Json::LargestUInt LargestUInt

Definition: value.h:207

Minimum signed integer value that can be stored in a Json::Value.

{

void setComment(const char *comment, size_t len, CommentPlacement placement)

Comments must be //... or /* ... *‍/.

Definition: value.h:570

CommentPlacement placement

Definition: value.h:566

std::basic_string< char, std::char_traits< char >, Allocator< char > > String

Definition: config.h:132

The documentation for this class was generated from the following files:

• include/json/value.h
• src/lib_json/json_value.cpp

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4