From 82b8f1729dd2d0d1e574628e82261e2a21809a96 Mon Sep 17 00:00:00 2001 From: Max Hilbrunner Date: Fri, 2 Feb 2018 05:32:12 +0100 Subject: [DOCS] parse_json: Objects do not keep key order Document JSON not guaranteeing key order. --- doc/classes/JSONParseResult.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc/classes/JSONParseResult.xml') 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 @@ 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: -- cgit v1.2.3