f5836b40d4
For the time being we don't support writing a description for those, preferring
having all details in the method's description.
Using self-closing tags saves half the lines, and prevents contributors from
thinking that they should write the argument or return documentation there.
(cherry picked from commit 7adf4cc9b5)
55 lines
2.0 KiB
XML
55 lines
2.0 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="JSON" inherits="Object" version="3.4">
|
|
<brief_description>
|
|
Helper class for parsing JSON data.
|
|
</brief_description>
|
|
<description>
|
|
Helper class for parsing JSON data. For usage example and other important hints, see [JSONParseResult].
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="parse">
|
|
<return type="JSONParseResult" />
|
|
<argument index="0" name="json" type="String" />
|
|
<description>
|
|
Parses a JSON-encoded string and returns a [JSONParseResult] containing the result.
|
|
</description>
|
|
</method>
|
|
<method name="print">
|
|
<return type="String" />
|
|
<argument index="0" name="value" type="Variant" />
|
|
<argument index="1" name="indent" type="String" default="""" />
|
|
<argument index="2" name="sort_keys" type="bool" default="false" />
|
|
<description>
|
|
Converts a [Variant] var to JSON text and returns the result. Useful for serializing data to store or send over the network.
|
|
[b]Note:[/b] The JSON specification does not define integer or float types, but only a [i]number[/i] type. Therefore, converting a Variant to JSON text will convert all numerical values to [float] types.
|
|
Use [code]indent[/code] parameter to pretty print the output.
|
|
[b]Example output:[/b]
|
|
[codeblock]
|
|
## JSON.print(my_dictionary)
|
|
{"name":"my_dictionary","version":"1.0.0","entities":[{"name":"entity_0","value":"value_0"},{"name":"entity_1","value":"value_1"}]}
|
|
|
|
## JSON.print(my_dictionary, "\t")
|
|
{
|
|
"name": "my_dictionary",
|
|
"version": "1.0.0",
|
|
"entities": [
|
|
{
|
|
"name": "entity_0",
|
|
"value": "value_0"
|
|
},
|
|
{
|
|
"name": "entity_1",
|
|
"value": "value_1"
|
|
}
|
|
]
|
|
}
|
|
[/codeblock]
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<constants>
|
|
</constants>
|
|
</class>
|