JSON ARRAY

From Second Life Wiki
Jump to navigation Jump to search

Description

Constant: string JSON_ARRAY = "﷒";

The string constant JSON_ARRAY has the value "﷒"

Used with the llList2Json function to indicate that the provided list (which may be empty) is to be used to encode and return a string serialization of a Json array.

Also a possible return value for the llJsonValueType function that indicates the Json data type of at the specifier location within a given Json text is, in fact, a Json array.

Related Articles

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.

Functions

•  llList2Json
•  llJsonValueType

Examples

Showing usage to form a Json array:

string jsonText;

default
{
	state_entry()
	{
		jsonText = llList2Json(JSON_ARRAY, ["A", 3, "B", <1.0,1.0,1.0>, "C", "A phrase", "D", PI]);
	}
	touch_start(integer total_number)
	{
		// In the resulting Json array, all Values are separated by a comma (,).
		llOwnerSay(jsonText); //  ["A",3,"B","<1.000000, 1.000000, 1.000000>","C","A phrase","D",3.141593]
	}
}

Showing usage to determine if a Value within a Json text is an array:

string jsonText;

default
{
	state_entry()
	{
		// Set jsonText to [3,{"A":77,"B":66},"A phrase"]
		// A Json array whose second element is a Json object
		jsonText = "[3,{\"A\":77,\"B\":66},\"A phrase\"]";
		llOwnerSay(jsonText);
	}
	touch_start(integer total_number)
	{
		// Test the entirety of the Json text to see if it's an array
		// Note use of the empty list for this
		if (llJsonValueType(jsonText, []) == JSON_ARRAY)
		{
			llOwnerSay("The supplied string is a Json array."); // TRUE
		} else {
			llOwnerSay("The supplied string is not a Json array.");
		}

		// Test second element of the array
		if (llJsonValueType(jsonText, [1]) == JSON_ARRAY)
		{
			llOwnerSay("The second element of the array is a Json array.");
		} else {
			llOwnerSay("The second element of the array is not a Json array."); // TRUE
		}
	}
}

Deep Notes

Search JIRA for related Issues

Signature

string JSON_ARRAY = "﷒";