Skip to content
lsl.devlsl.devLSL Dev

JSON NULL

Looking for the current API? Open the JSON_NULL reference →

Wiki description

Return value for llJsonValueType function indicating the Json data type of a given address specifier in a given string-serialized JSON text.
Also the return string value for llJsonGetValue function when the bare word 'null' is at the given address specifier in a given string-serialized JSON text.
Also used to encode the bare word 'null' within a Json text to signify an empty, valueless placeholder Value at that location (the empty LSL String, "", can be used as well for that).

Examples

// Showing usage of JSON_NULL
// within a Json text string
string jText;

default
{
    state_entry(){
        jText = llList2Json(JSON_OBJECT, ["A", 4, "B", 5]);
        llOwnerSay(jText); // jText is '{"A":4,"B":5}'
        llOwnerSay(llJsonGetValue(jText, ["B"])); // The string "5"
        jText = llJsonSetValue(jText, ["B"], JSON_NULL);
        llOwnerSay(jText); // jText is now '{"A":4,"B":null}'
        llOwnerSay(llJsonGetValue(jText, ["B"])); // The Unicode value of JSON_NULL

        }
}

See also: constants

Type Flags Value Unicode Integer URL Encoded HTML Encoded Description
JSON_INVALID ﷐ U+FDDO 64976 "%EF%B7%90"  Value returned when inputs are not well formed.
JSON_OBJECT ﷑ U+FDD1 64977 "%EF%B7%91" 
JSON_ARRAY ﷒ U+FDD2 64978 "%EF%B7%92" 
JSON_NUMBER ﷓ U+FDD3 64979 "%EF%B7%93" 
JSON_STRING ﷔ U+FDD4 64980 "%EF%B7%94" 
JSON_NULL ﷕ U+FDD5 64981 "%EF%B7%95" 
JSON_TRUE ﷖ U+FDD6 64982 "%EF%B7%96" 
JSON_FALSE ﷗ U+FDD7 64983 "%EF%B7%97" 
JSON_DELETE ﷘ U+FDD8 64984 "%EF%B7%98"  Used with llJsonSetValue to remove a key-value pair.

See also: functions

llJsonValueType
llJsonGetValue

Shared wiki helpers

The original page also injects shared parameter notes, caveats or issue information through these helpers. Their conditional MediaWiki logic is not reproduced here; inspect the preserved helper source for additional material.

Template:Issues/BUG-3692

Original shared helper source (conditional wiki logic is not evaluated)
{{Issues|BUG-3692|type=bug|<s>[[JSON_NULL]] may be deceptively returned instead of [[JSON_INVALID]] when [http://tools.ietf.org/html/rfc4627 noncompliant Json text] is encountered by either [[llJsonValueType]] or [[llJsonGetValue]].</s> Fixed with release 13.09.21.281328.|dnc=*}}
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.