llList2Json
Revision as of 11:32, 9 June 2014 by Maestro Linden (talk | contribs) (Being more specific about how json type is set in the output, in lieu of BUG-6284)
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llList2Json( string type, list values );| ? | Function ID |
| 0.0 | Forced Delay |
| Energy |
This function takes a list and returns a JSON string of that list as either a json object or json array.
Returns a string that is either values serialized as a JSON type, or if an error was encountered JSON_INVALID.
| • string | type | |||
| • list | values |
To convert a json formatted string into a list use llJson2List.
Specification
- If type is JSON_OBJECT the list must be a strided list of key, value pairs and a string representing a json object will be returned.
- If type is JSON_ARRAY then a string representing a json array will be returned.
- If type is any other string then JSON_INVALID will be returned.
- Json types from the input list are inferred from the LSL data type
- integer and float types are encoded as JSON_NUMBER
- "true" and "false" are encoded as JSON_TRUE and JSON_FALSE, respectively
- "null" is encoded as JSON_NULL
- properly-formatted json strings in the input are kept as-is (will either be JSON_STRING, JSON_OBJECT, or JSON_ARRAY)
- all other strings encoded as JSON_STRING
| 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" |  |
Caveats
- Note that string values items are interpreted as JSON, not LSL, strings. Quotation marks, if required, must be added explicitly. For example,
llJson2List(llList2Json(JSON_ARRAY, ["bacon", "true", "false", "null"]))returns the LSL list["bacon", JSON_TRUE, JSON_FALSE, JSON_NULL], whilellJson2List(llList2Json(JSON_ARRAY, ["\"bacon\"", "\"true\"", "\"false\"", "\"null\""]))returns the LSL list["bacon", "true", "false", "null"]
Examples
See Also
Constants
| • | JSON_ARRAY | |||
| • | JSON_OBJECT | |||
| • | JSON_INVALID |
Functions
| • | llJson2List | |||
| • | llJsonGetValue | |||
| • | llJsonSetValue | |||
| • | llJsonValueType |
Articles
| • | Typecast |
Deep Notes
History
Date of Release 20/05/2013
Search JIRA for related Issues
Signature |
|---|
function string llList2Json( string type, list values ); |
Haiku |
|---|
|
Their ships list to port
Listen to Jason
|