deploy: 40a62947d3

api/basic_json/unflatten.md

@@ -36,8 +36,9 @@ The function can throw the following exceptions:
 - Throws [`parse_error.109`](../../home/exceptions.md#jsonexceptionparse_error109) if an array index in a key is not a
   number; example: `"array index 'one' is not a number"`
 - Throws [`out_of_range.404`](../../home/exceptions.md#jsonexceptionout_of_range404) if a level becomes an array
-  (because one of its keys is `0`) and another key at that level cannot be an array index; example:
-  `"unresolved reference token 'x'"`
+  (because one of its keys is `0`) and another key at that level begins with a digit but is not a valid array index
+  (such as `1a`), or is `-`; example:
+  `"unresolved reference token '-'"`
 
 ## Complexity
 
@@ -63,13 +64,57 @@ Apart from these two cases, for a JSON value `j`, the following is always true:
     The following code shows how a flattened JSON object is unflattened into the original nested JSON object.
     
     ```cpp
-    --8<-- "examples/unflatten.cpp"
+    #include <iostream>
+    #include <iomanip>
+    #include <nlohmann/json.hpp>
+    
+    using json = nlohmann::json;
+    
+    int main()
+    {
+        // create JSON value
+        json j_flattened =
+        {
+            {"/answer/everything", 42},
+            {"/happy", true},
+            {"/list/0", 1},
+            {"/list/1", 0},
+            {"/list/2", 2},
+            {"/name", "Niels"},
+            {"/nothing", nullptr},
+            {"/object/currency", "USD"},
+            {"/object/value", 42.99},
+            {"/pi", 3.141}
+        };
+    
+        // call unflatten()
+        std::cout << std::setw(4) << j_flattened.unflatten() << '\n';
+    }
+    
     ```
     
     Output:
     
     ```json
-    --8<-- "examples/unflatten.output"
+    {
+        "answer": {
+            "everything": 42
+        },
+        "happy": true,
+        "list": [
+            1,
+            0,
+            2
+        ],
+        "name": "Niels",
+        "nothing": null,
+        "object": {
+            "currency": "USD",
+            "value": 42.99
+        },
+        "pi": 3.141
+    }
+    
     ```
 
 ## See also
@@ -80,3 +125,6 @@ Apart from these two cases, for a JSON value `j`, the following is always true:
 
 - Added in version 2.0.0.
 - Made the array/object decision independent of the object's iteration order in version 3.13.0.
+- Throws [`parse_error.109`](../../home/exceptions.md#jsonexceptionparse_error109) instead of
+  [`out_of_range.404`](../../home/exceptions.md#jsonexceptionout_of_range404) for a one-character array index that is
+  not a digit (e.g., `/x`) in version 3.13.0, as it already did for longer ones.