JSON for Modern C++ 2.1.1
Loading...
Searching...
No Matches

◆ object()

template<template< typename U, typename V, typename... Args > class ObjectType = std::map, template< typename U, typename... Args > class ArrayType = std::vector, class StringType = std::string, class BooleanType = bool, class NumberIntegerType = std::int64_t, class NumberUnsignedType = std::uint64_t, class NumberFloatType = double, template< typename U > class AllocatorType = std::allocator, template< typename T, typename SFINAE=void > class JSONSerializer = adl_serializer>
static basic_json nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer >::object ( std::initializer_list< basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer > >  init = std::initializer_list<basic_jsonObjectTypeArrayTypeStringTypeBooleanTypeNumberIntegerTypeNumberUnsignedTypeNumberFloatTypeAllocatorTypeJSONSerializer >>())
inlinestatic

Creates a JSON object value from a given initializer list. The initializer lists elements must be pairs, and their first elements must be strings. If the initializer list is empty, the empty object {} is created.

Note
This function is only added for symmetry reasons. In contrast to the related function array(std::initializer_list<basic_json>), there are no cases which can only be expressed by this function. That is, any initializer list init can also be passed to the initializer list constructor basic_json(std::initializer_list<basic_json>, bool, value_t).
Parameters
[in]initinitializer list to create an object from (optional)
Returns
JSON object value
Exceptions
std::domain_errorif init is not a pair whose first elements are strings; thrown by basic_json(std::initializer_list<basic_json>, bool, value_t)
Complexity\n Linear in the size of init.
Example\n The following code shows an example for the object
function.
1#include <json.hpp>
2
3using json = nlohmann::json;
4
5int main()
6{
7 // create JSON objects
10 json j_list_of_pairs = json::object({ {"one", 1}, {"two", 2} });
11 //json j_invalid_list = json::object({ "one", 1 }); // would throw
12
13 // serialize the JSON objects
14 std::cout << j_no_init_list << '\n';
15 std::cout << j_empty_init_list << '\n';
16 std::cout << j_list_of_pairs << '\n';
17}
static basic_json array(std::initializer_list< basic_json > init=std::initializer_list< basic_json >())
explicitly create an array from an initializer list
Definition json.hpp:2165
static basic_json object(std::initializer_list< basic_json > init=std::initializer_list< basic_json >())
explicitly create an object from an initializer list
Definition json.hpp:2205
a class to store JSON values
Definition json.hpp:1040
basic_json<> json
default JSON class
Definition json.hpp:12369

Output (play with this example online):
{}
{}
{"one":1,"two":2}

The example code above can be translated with
g++ -std=c++11 -Isrc doc/examples/object.cpp -o object 
See also
basic_json(std::initializer_list<basic_json>, bool, value_t) – create a JSON value from an initializer list
array(std::initializer_list<basic_json>) – create a JSON array value from an initializer list
Since
version 1.0.0

Definition at line 2205 of file json.hpp.