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/@GDScript.xml | 1 + 1 file changed, 1 insertion(+) (limited to 'doc/classes/@GDScript.xml') diff --git a/doc/classes/@GDScript.xml b/doc/classes/@GDScript.xml index d4bd937f49..4e9a6a5fc0 100644 --- a/doc/classes/@GDScript.xml +++ b/doc/classes/@GDScript.xml @@ -608,6 +608,7 @@ Parse JSON text to a Variant (use [method typeof] to check if it is what you expect). 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: [codeblock] p = parse_json('["a", "b", "c"]') if typeof(p) == TYPE_ARRAY: -- cgit v1.2.3