summaryrefslogtreecommitdiff
path: root/doc/classes/JSONParseResult.xml
diff options
context:
space:
mode:
authorRĂ©mi Verschelde <rverschelde@gmail.com>2018-02-12 08:03:53 +0100
committerGitHub <noreply@github.com>2018-02-12 08:03:53 +0100
commit889b9b6dcec7b4b9ae5ac2d01f98a2cde993dae7 (patch)
tree50d78d91d38361dedf1419860163627bee8d23aa /doc/classes/JSONParseResult.xml
parent6e4106ace6958e0aa3d934a5bfc53a30fa22064d (diff)
parent82b8f1729dd2d0d1e574628e82261e2a21809a96 (diff)
Merge pull request #16306 from mhilbrunner/mhilbrunner-docs-json-keyorder
[DOCS] parse_json: Objects do not keep key order
Diffstat (limited to 'doc/classes/JSONParseResult.xml')
-rw-r--r--doc/classes/JSONParseResult.xml3
1 files changed, 2 insertions, 1 deletions
diff --git a/doc/classes/JSONParseResult.xml b/doc/classes/JSONParseResult.xml
index 424720a871..0e8d9b66fa 100644
--- a/doc/classes/JSONParseResult.xml
+++ b/doc/classes/JSONParseResult.xml
@@ -24,7 +24,8 @@
</member>
<member name="result" type="Variant" setter="set_result" getter="get_result">
A [Variant] containing the parsed JSON. Use typeof() to check if it is what you expect. For example, if JSON source starts with curly braces ([code]{}[/code]) a [Dictionary] will be returned, if JSON source starts with braces ([code][][/code]) an [Array] will be returned.
- [i]Be aware that the JSON specification does not define integer or float types, but only a number type. Therefore, parsing a JSON text will convert all numerical values to float types.[/i]
+ [i]Be aware that the JSON specification does not define integer or float types, but only a number type. Therefore, parsing a JSON text will convert all numerical values to float types.
+ Note that JSON objects do not preserve key order like Godot dictionaries, thus you should not rely on keys being in a certain order if a dictionary is constructed from JSON. In contrast, JSON arrays retain the order of their elements:[/i]
[codeblock]
p = JSON.parse('["hello", "world", "!"]')
if typeof(p) == TYPE_ARRAY: