29cd970b94
* 🔥 consolidate documentation * ♻️ overwork std specializations * 🚚 move images files to mkdocs * ♻️ fix URLs * 🔧 tweak MkDocs configuration * 🔧 add namespaces * 📝 document deprecations * 📝 document documentation generation * 🚸 improve search * 🚸 add examples * 🚧 start adding documentation for macros * 📝 add note for https://github.com/nlohmann/json/issues/874#issuecomment-1001699139 * 📝 overwork example handling * 📝 fix Markdown tables
1.6 KiB
1.6 KiB
nlohmann::basic_json::array
static basic_json array(initializer_list_t init = {});
Creates a JSON array value from a given initializer list. That is, given a list of values a, b, c, creates the JSON
value #!json [a, b, c]. If the initializer list is empty, the empty array #!json [] is created.
Parameters
init(in)- initializer list with JSON values to create an array from (optional)
Return value
JSON array value
Exception safety
Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
Complexity
Linear in the size of init.
Notes
This function is only needed to express two edge cases that cannot be realized with the initializer list constructor
(basic_json(initializer_list_t, bool, value_t)). These cases are:
- creating an array whose elements are all pairs whose first element is a string -- in this case, the initializer list constructor would create an object, taking the first elements as keys
- creating an empty array -- passing the empty initializer list to the initializer list constructor yields an empty object
Examples
??? example
The following code shows an example for the `array` function.
```cpp
--8<-- "examples/array.cpp"
```
Output:
```json
--8<-- "examples/array.output"
```
See also
basic_json(initializer_list_t)- create a JSON value from an initializer listobject- create a JSON object value from an initializer list
Version history
- Added in version 1.0.0.