2015-06-21 22:43:30 +03:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" >
< head >
< meta http-equiv = "Content-Type" content = "text/xhtml;charset=UTF-8" / >
< meta http-equiv = "X-UA-Compatible" content = "IE=9" / >
< meta name = "generator" content = "Doxygen 1.8.9.1" / >
< title > JSON for Modern C++: nlohmann::basic_json::basic_json< / title >
< link href = "tabs.css" rel = "stylesheet" type = "text/css" / >
< script type = "text/javascript" src = "jquery.js" > < / script >
< script type = "text/javascript" src = "dynsections.js" > < / script >
< link href = "navtree.css" rel = "stylesheet" type = "text/css" / >
< script type = "text/javascript" src = "resize.js" > < / script >
< script type = "text/javascript" src = "navtreedata.js" > < / script >
< script type = "text/javascript" src = "navtree.js" > < / script >
< script type = "text/javascript" >
$(document).ready(initResizable);
$(window).load(resizeHeight);
< / script >
< link href = "search/search.css" rel = "stylesheet" type = "text/css" / >
< script type = "text/javascript" src = "search/searchdata.js" > < / script >
< script type = "text/javascript" src = "search/search.js" > < / script >
< script type = "text/javascript" >
$(document).ready(function() { init_search(); });
< / script >
< link href = "doxygen.css" rel = "stylesheet" type = "text/css" / >
< link href = "mylayout.css" rel = "stylesheet" type = "text/css" / >
< / head >
< body >
< div id = "top" > <!-- do not remove this div, it is closed by doxygen! -->
< div id = "titlearea" >
< table cellspacing = "0" cellpadding = "0" >
< tbody >
< tr style = "height: 56px;" >
< td style = "padding-left: 0.5em;" >
< div id = "projectname" > JSON for Modern C++
  < span id = "projectnumber" > 3.0< / span >
< / div >
< / td >
< / tr >
< / tbody >
< / table >
< / div >
<!-- end header part -->
<!-- Generated by Doxygen 1.8.9.1 -->
< script type = "text/javascript" >
var searchBox = new SearchBox("searchBox", "search",false,'Search');
< / script >
< div id = "navrow1" class = "tabs" >
< ul class = "tablist" >
< li > < a href = "index.html" > < span > Main  Page< / span > < / a > < / li >
2015-06-21 23:59:12 +03:00
< li > < a href = "pages.html" > < span > Related  Pages< / span > < / a > < / li >
2015-06-21 22:43:30 +03:00
< li > < a href = "annotated.html" > < span > Classes< / span > < / a > < / li >
< li >
< div id = "MSearchBox" class = "MSearchBoxInactive" >
< span class = "left" >
< img id = "MSearchSelect" src = "search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
< input type = "text" id = "MSearchField" value = "Search" accesskey = "S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
< / span > < span class = "right" >
< a id = "MSearchClose" href = "javascript:searchBox.CloseResultsWindow()" > < img id = "MSearchCloseImg" border = "0" src = "search/close.png" alt = "" / > < / a >
< / span >
< / div >
< / li >
< / ul >
< / div >
< / div > <!-- top -->
< div id = "side-nav" class = "ui-resizable side-nav-resizable" >
< div id = "nav-tree" >
< div id = "nav-tree-contents" >
< div id = "nav-sync" class = "sync" > < / div >
< / div >
< / div >
< div id = "splitbar" style = "-moz-user-select:none;"
class="ui-resizable-handle">
< / div >
< / div >
< script type = "text/javascript" >
$(document).ready(function(){initNavTree('classnlohmann_1_1basic__json_ad7067a1a8ad2d88125915ada6d4d79b7.html','');});
< / script >
< div id = "doc-content" >
<!-- window showing the filter options -->
< div id = "MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
< / div >
<!-- iframe showing the search results (closed by default) -->
< div id = "MSearchResultsWindow" >
< iframe src = "javascript:void(0)" frameborder = "0"
name="MSearchResults" id="MSearchResults">
< / iframe >
< / div >
< div class = "contents" >
< a class = "anchor" id = "ad7067a1a8ad2d88125915ada6d4d79b7" > < / a >
< div class = "memitem" >
< div class = "memproto" >
< div class = "memtemplate" >
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 = int64_t, class NumberFloatType = double, template< typename U > class AllocatorType = std::allocator> < / div >
< div class = "memtemplate" >
template< class CompatibleArrayType , typename std::enable_if< not std::is_same< CompatibleArrayType, typename __basic_json::iterator > ::value andnot std::is_same< CompatibleArrayType, typename __basic_json::const_iterator > ::value andnot std::is_same< CompatibleArrayType, typename __basic_json::reverse_iterator > ::value andnot std::is_same< CompatibleArrayType, typename __basic_json::const_reverse_iterator > ::value andnot std::is_same< CompatibleArrayType, typename array_t::iterator > ::value andnot std::is_same< CompatibleArrayType, typename array_t::const_iterator > ::value andstd::is_constructible< basic_json, typename CompatibleArrayType::value_type > ::value, int > ::type = 0> < / div >
< table class = "mlabels" >
< tr >
< td class = "mlabels-left" >
< table class = "memname" >
< tr >
< td class = "memname" > < a class = "el" href = "classnlohmann_1_1basic__json.html" > nlohmann::basic_json< / a > ::< a class = "el" href = "classnlohmann_1_1basic__json.html" > basic_json< / a > < / td >
< td > (< / td >
< td class = "paramtype" > const CompatibleArrayType &   < / td >
< td class = "paramname" > < em > value< / em > < / td > < td > )< / td >
< td > < / td >
< / tr >
< / table >
< / td >
< td class = "mlabels-right" >
< span class = "mlabels" > < span class = "mlabel" > inline< / span > < / span > < / td >
< / tr >
< / table >
< / div > < div class = "memdoc" >
< p > Create an array JSON value with a given content. This constructor allows any type that can be used to construct values of type < a class = "el" href = "classnlohmann_1_1basic__json_ac82abedf356d252e0589850c3d8b35ba.html#ac82abedf356d252e0589850c3d8b35ba" > array_t< / a > . Examples include the types < code > std::vector< / code > , < code > std::list< / code > , and < code > std::set< / code > .< / p >
< dl class = "tparams" > < dt > Template Parameters< / dt > < dd >
< table class = "tparams" >
< tr > < td class = "paramname" > CompatibleArrayType< / td > < td > an object type whose < code > value_type< / code > is compatible to < a class = "el" href = "classnlohmann_1_1basic__json_ac82abedf356d252e0589850c3d8b35ba.html#ac82abedf356d252e0589850c3d8b35ba" > array_t< / a > < / td > < / tr >
< / table >
< / dd >
< / dl >
< dl class = "params" > < dt > Parameters< / dt > < dd >
< table class = "params" >
2015-06-21 23:59:12 +03:00
< tr > < td class = "paramdir" > [in]< / td > < td class = "paramname" > value< / td > < td > a value for the array< / td > < / tr >
2015-06-21 22:43:30 +03:00
< / table >
< / dd >
< / dl >
< dl class = "section user" > < dt > Complexity< / dt > < dd > Linear in the size of the passed < em > value< / em > .< / dd > < / dl >
< dl class = "exception" > < dt > Exceptions< / dt > < dd >
< table class = "exception" >
< tr > < td class = "paramname" > std::bad_alloc< / td > < td > if allocation for array value fails (thrown by the constructor of < a class = "el" href = "unionnlohmann_1_1basic__json_1_1json__value.html" > json_value< / a > )< / td > < / tr >
< / table >
< / dd >
< / dl >
< dl class = "section user" > < dt > Example< / dt > < dd > The following code shows the constructor with several compatible array type parameters. < div class = "fragment" > < div class = "line" > < a name = "l00001" > < / a > < span class = "lineno" > 1< / span >   < span class = "preprocessor" > #include < json.hpp> < / span > < / div >
< div class = "line" > < a name = "l00002" > < / a > < span class = "lineno" > 2< / span >   < span class = "preprocessor" > #include < deque> < / span > < / div >
< div class = "line" > < a name = "l00003" > < / a > < span class = "lineno" > 3< / span >   < span class = "preprocessor" > #include < list> < / span > < / div >
< div class = "line" > < a name = "l00004" > < / a > < span class = "lineno" > 4< / span >   < span class = "preprocessor" > #include < forward_list> < / span > < / div >
< div class = "line" > < a name = "l00005" > < / a > < span class = "lineno" > 5< / span >   < span class = "preprocessor" > #include < set> < / span > < / div >
< div class = "line" > < a name = "l00006" > < / a > < span class = "lineno" > 6< / span >   < span class = "preprocessor" > #include < unordered_set> < / span > < / div >
< div class = "line" > < a name = "l00007" > < / a > < span class = "lineno" > 7< / span >   < / div >
< div class = "line" > < a name = "l00008" > < / a > < span class = "lineno" > 8< / span >   < span class = "keyword" > using namespace < / span > < a class = "code" href = "namespacenlohmann.html" > nlohmann< / a > ;< / div >
< div class = "line" > < a name = "l00009" > < / a > < span class = "lineno" > 9< / span >   < / div >
< div class = "line" > < a name = "l00010" > < / a > < span class = "lineno" > 10< / span >   < span class = "keywordtype" > int< / span > main()< / div >
< div class = "line" > < a name = "l00011" > < / a > < span class = "lineno" > 11< / span >   {< / div >
< div class = "line" > < a name = "l00012" > < / a > < span class = "lineno" > 12< / span >   < span class = "comment" > // create an array from std::vector< / span > < / div >
< div class = "line" > < a name = "l00013" > < / a > < span class = "lineno" > 13< / span >   std::vector< int> c_vector {1, 2, 3, 4};< / div >
< div class = "line" > < a name = "l00014" > < / a > < span class = "lineno" > 14< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_vec(c_vector);< / div >
< div class = "line" > < a name = "l00015" > < / a > < span class = "lineno" > 15< / span >   < / div >
< div class = "line" > < a name = "l00016" > < / a > < span class = "lineno" > 16< / span >   < span class = "comment" > // create an array from std::deque< / span > < / div >
< div class = "line" > < a name = "l00017" > < / a > < span class = "lineno" > 17< / span >   std::deque< double> c_deque {1.2, 2.3, 3.4, 5.6};< / div >
< div class = "line" > < a name = "l00018" > < / a > < span class = "lineno" > 18< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_deque(c_deque);< / div >
< div class = "line" > < a name = "l00019" > < / a > < span class = "lineno" > 19< / span >   < / div >
< div class = "line" > < a name = "l00020" > < / a > < span class = "lineno" > 20< / span >   < span class = "comment" > // create an array from std::list< / span > < / div >
< div class = "line" > < a name = "l00021" > < / a > < span class = "lineno" > 21< / span >   std::list< bool> c_list {< span class = "keyword" > true< / span > , < span class = "keyword" > true< / span > , < span class = "keyword" > false< / span > , < span class = "keyword" > true< / span > };< / div >
< div class = "line" > < a name = "l00022" > < / a > < span class = "lineno" > 22< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_list(c_list);< / div >
< div class = "line" > < a name = "l00023" > < / a > < span class = "lineno" > 23< / span >   < / div >
< div class = "line" > < a name = "l00024" > < / a > < span class = "lineno" > 24< / span >   < span class = "comment" > // create an array from std::forward_list< / span > < / div >
< div class = "line" > < a name = "l00025" > < / a > < span class = "lineno" > 25< / span >   std::forward_list< int64_t> c_flist {12345678909876, 23456789098765, 34567890987654, 45678909876543};< / div >
< div class = "line" > < a name = "l00026" > < / a > < span class = "lineno" > 26< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_flist(c_flist);< / div >
< div class = "line" > < a name = "l00027" > < / a > < span class = "lineno" > 27< / span >   < / div >
< div class = "line" > < a name = "l00028" > < / a > < span class = "lineno" > 28< / span >   < span class = "comment" > // create an array from std::array< / span > < / div >
< div class = "line" > < a name = "l00029" > < / a > < span class = "lineno" > 29< / span >   std::array< unsigned long, 4> c_array {{1, 2, 3, 4}};< / div >
< div class = "line" > < a name = "l00030" > < / a > < span class = "lineno" > 30< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_array(c_array);< / div >
< div class = "line" > < a name = "l00031" > < / a > < span class = "lineno" > 31< / span >   < / div >
< div class = "line" > < a name = "l00032" > < / a > < span class = "lineno" > 32< / span >   < span class = "comment" > // create an array from std::set< / span > < / div >
< div class = "line" > < a name = "l00033" > < / a > < span class = "lineno" > 33< / span >   std::set< std::string> c_set {< span class = "stringliteral" > " one" < / span > , < span class = "stringliteral" > " two" < / span > , < span class = "stringliteral" > " three" < / span > , < span class = "stringliteral" > " four" < / span > , < span class = "stringliteral" > " one" < / span > };< / div >
< div class = "line" > < a name = "l00034" > < / a > < span class = "lineno" > 34< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_set(c_set); < span class = "comment" > // only one entry for " one" is used< / span > < / div >
< div class = "line" > < a name = "l00035" > < / a > < span class = "lineno" > 35< / span >   < / div >
< div class = "line" > < a name = "l00036" > < / a > < span class = "lineno" > 36< / span >   < span class = "comment" > // create an array from std::unordered_set< / span > < / div >
< div class = "line" > < a name = "l00037" > < / a > < span class = "lineno" > 37< / span >   std::unordered_set< std::string> c_uset {< span class = "stringliteral" > " one" < / span > , < span class = "stringliteral" > " two" < / span > , < span class = "stringliteral" > " three" < / span > , < span class = "stringliteral" > " four" < / span > , < span class = "stringliteral" > " one" < / span > };< / div >
< div class = "line" > < a name = "l00038" > < / a > < span class = "lineno" > 38< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_uset(c_uset); < span class = "comment" > // only one entry for " one" is used< / span > < / div >
< div class = "line" > < a name = "l00039" > < / a > < span class = "lineno" > 39< / span >   < / div >
< div class = "line" > < a name = "l00040" > < / a > < span class = "lineno" > 40< / span >   < span class = "comment" > // create an array from std::multiset< / span > < / div >
< div class = "line" > < a name = "l00041" > < / a > < span class = "lineno" > 41< / span >   std::multiset< std::string> c_mset {< span class = "stringliteral" > " one" < / span > , < span class = "stringliteral" > " two" < / span > , < span class = "stringliteral" > " one" < / span > , < span class = "stringliteral" > " four" < / span > };< / div >
< div class = "line" > < a name = "l00042" > < / a > < span class = "lineno" > 42< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_mset(c_mset); < span class = "comment" > // only one entry for " one" is used< / span > < / div >
< div class = "line" > < a name = "l00043" > < / a > < span class = "lineno" > 43< / span >   < / div >
< div class = "line" > < a name = "l00044" > < / a > < span class = "lineno" > 44< / span >   < span class = "comment" > // create an array from std::unordered_multiset< / span > < / div >
< div class = "line" > < a name = "l00045" > < / a > < span class = "lineno" > 45< / span >   std::unordered_multiset< std::string> c_umset {< span class = "stringliteral" > " one" < / span > , < span class = "stringliteral" > " two" < / span > , < span class = "stringliteral" > " one" < / span > , < span class = "stringliteral" > " four" < / span > };< / div >
< div class = "line" > < a name = "l00046" > < / a > < span class = "lineno" > 46< / span >   < a class = "code" href = "classnlohmann_1_1basic__json.html" > json< / a > j_umset(c_umset); < span class = "comment" > // both entries for " one" are used< / span > < / div >
< div class = "line" > < a name = "l00047" > < / a > < span class = "lineno" > 47< / span >   < / div >
< div class = "line" > < a name = "l00048" > < / a > < span class = "lineno" > 48< / span >   < span class = "comment" > // serialize the JSON arrays< / span > < / div >
< div class = "line" > < a name = "l00049" > < / a > < span class = "lineno" > 49< / span >   std::cout < < j_vec < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00050" > < / a > < span class = "lineno" > 50< / span >   std::cout < < j_deque < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00051" > < / a > < span class = "lineno" > 51< / span >   std::cout < < j_list < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00052" > < / a > < span class = "lineno" > 52< / span >   std::cout < < j_flist < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00053" > < / a > < span class = "lineno" > 53< / span >   std::cout < < j_array < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00054" > < / a > < span class = "lineno" > 54< / span >   std::cout < < j_set < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00055" > < / a > < span class = "lineno" > 55< / span >   std::cout < < j_uset < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00056" > < / a > < span class = "lineno" > 56< / span >   std::cout < < j_mset < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00057" > < / a > < span class = "lineno" > 57< / span >   std::cout < < j_umset < < < span class = "charliteral" > ' \n' < / span > ;< / div >
< div class = "line" > < a name = "l00058" > < / a > < span class = "lineno" > 58< / span >   }< / div >
2015-06-21 23:59:12 +03:00
< div class = "ttc" id = "classnlohmann_1_1basic__json_html" > < div class = "ttname" > < a href = "classnlohmann_1_1basic__json.html" > nlohmann::basic_json< / a > < / div > < div class = "ttdoc" > a class to store JSON values < / div > < div class = "ttdef" > < b > Definition:< / b > json.hpp:121< / div > < / div >
< div class = "ttc" id = "namespacenlohmann_html" > < div class = "ttname" > < a href = "namespacenlohmann.html" > nlohmann< / a > < / div > < div class = "ttdoc" > namespace for Niels Lohmann < / div > < div class = "ttdef" > < b > Definition:< / b > json.hpp:56< / div > < / div >
2015-06-21 22:43:30 +03:00
< / div > <!-- fragment --> Output: < pre class = "fragment" > [1,2,3,4]
[1.2,2.3,3.4,5.6]
[true,true,false,true]
[12345678909876,23456789098765,34567890987654,45678909876543]
[1,2,3,4]
["four","one","three","two"]
["four","three","two","one"]
["four","one","one","two"]
["four","two","one","one"]
< / pre > The example code above can be translated with< pre class = "fragment" > g++ -std=c++11 -Isrc doc/examples/basic_json__CompatibleArrayType.cpp -o basic_json__CompatibleArrayType < / pre > .< / dd > < / dl >
< dl class = "section see" > < dt > See also< / dt > < dd > < a class = "el" href = "classnlohmann_1_1basic__json_af93e556bf708cb81b22ce223af1aa727.html#af93e556bf708cb81b22ce223af1aa727" title = "create an array (explicit) " > basic_json(const array_t& )< / a > < / dd > < / dl >
< / div >
< / div >
< / div > <!-- contents -->
< / div > <!-- doc - content -->
<!-- start footer part -->
< div id = "nav-path" class = "navpath" > <!-- id is needed for treeview function! -->
< ul >
< li class = "navelem" > < a class = "el" href = "namespacenlohmann.html" > nlohmann< / a > < / li > < li class = "navelem" > < a class = "el" href = "classnlohmann_1_1basic__json.html" > basic_json< / a > < / li >
2015-06-23 00:22:59 +03:00
< li class = "footer" > Generated on Mon Jun 22 2015 23:22:00 for JSON for Modern C++ by
2015-06-21 22:43:30 +03:00
< a href = "http://www.doxygen.org/index.html" >
< img class = "footer" src = "doxygen.png" alt = "doxygen" / > < / a > 1.8.9.1 < / li >
< / ul >
< / div >
< / body >
< / html >
