<!DOCTYPE html>
<html>
<head>
<title>Changelog</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<style type="text/css">
/* GitHub stylesheet for MarkdownPad (http://markdownpad.com) */
/* Author: Nicolas Hery - http://nicolashery.com */
/* Version: b13fe65ca28d2e568c6ed5d7f06581183df8f2ff */
/* Source: https://github.com/nicolahery/markdownpad-github */

/* RESET
=============================================================================*/

html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {
  margin: 0;
  padding: 0;
  border: 0;
}

/* BODY
=============================================================================*/

body {
  font-family: Helvetica, arial, freesans, clean, sans-serif;
  font-size: 14px;
  line-height: 1.6;
  color: #333;
  background-color: #fff;
  padding: 20px;
  max-width: 960px;
  margin: 0 auto;
}

body>*:first-child {
  margin-top: 0 !important;
}

body>*:last-child {
  margin-bottom: 0 !important;
}

/* BLOCKS
=============================================================================*/

p, blockquote, ul, ol, dl, table, pre {
  margin: 15px 0;
}

/* HEADERS
=============================================================================*/

h1, h2, h3, h4, h5, h6 {
  margin: 20px 0 10px;
  padding: 0;
  font-weight: bold;
  -webkit-font-smoothing: antialiased;
}

h1 tt, h1 code, h2 tt, h2 code, h3 tt, h3 code, h4 tt, h4 code, h5 tt, h5 code, h6 tt, h6 code {
  font-size: inherit;
}

h1 {
  font-size: 28px;
  color: #000;
}

h2 {
  font-size: 24px;
  border-bottom: 1px solid #ccc;
  color: #000;
}

h3 {
  font-size: 18px;
}

h4 {
  font-size: 16px;
}

h5 {
  font-size: 14px;
}

h6 {
  color: #777;
  font-size: 14px;
}

body>h2:first-child, body>h1:first-child, body>h1:first-child+h2, body>h3:first-child, body>h4:first-child, body>h5:first-child, body>h6:first-child {
  margin-top: 0;
  padding-top: 0;
}

a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
  margin-top: 0;
  padding-top: 0;
}

h1+p, h2+p, h3+p, h4+p, h5+p, h6+p {
  margin-top: 10px;
}

/* LINKS
=============================================================================*/

a {
  color: #4183C4;
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

/* LISTS
=============================================================================*/

ul, ol {
  padding-left: 30px;
}

ul li > :first-child, 
ol li > :first-child, 
ul li ul:first-of-type, 
ol li ol:first-of-type, 
ul li ol:first-of-type, 
ol li ul:first-of-type {
  margin-top: 0px;
}

ul ul, ul ol, ol ol, ol ul {
  margin-bottom: 0;
}

dl {
  padding: 0;
}

dl dt {
  font-size: 14px;
  font-weight: bold;
  font-style: italic;
  padding: 0;
  margin: 15px 0 5px;
}

dl dt:first-child {
  padding: 0;
}

dl dt>:first-child {
  margin-top: 0px;
}

dl dt>:last-child {
  margin-bottom: 0px;
}

dl dd {
  margin: 0 0 15px;
  padding: 0 15px;
}

dl dd>:first-child {
  margin-top: 0px;
}

dl dd>:last-child {
  margin-bottom: 0px;
}

/* CODE
=============================================================================*/

pre, code, tt {
  font-size: 12px;
  font-family: Consolas, "Liberation Mono", Courier, monospace;
}

code, tt {
  margin: 0 0px;
  padding: 0px 0px;
  white-space: nowrap;
  border: 1px solid #eaeaea;
  background-color: #f8f8f8;
  border-radius: 3px;
}

pre>code {
  margin: 0;
  padding: 0;
  white-space: pre;
  border: none;
  background: transparent;
}

pre {
  background-color: #f8f8f8;
  border: 1px solid #ccc;
  font-size: 13px;
  line-height: 19px;
  overflow: auto;
  padding: 6px 10px;
  border-radius: 3px;
}

pre code, pre tt {
  background-color: transparent;
  border: none;
}

kbd {
    -moz-border-bottom-colors: none;
    -moz-border-left-colors: none;
    -moz-border-right-colors: none;
    -moz-border-top-colors: none;
    background-color: #DDDDDD;
    background-image: linear-gradient(#F1F1F1, #DDDDDD);
    background-repeat: repeat-x;
    border-color: #DDDDDD #CCCCCC #CCCCCC #DDDDDD;
    border-image: none;
    border-radius: 2px 2px 2px 2px;
    border-style: solid;
    border-width: 1px;
    font-family: "Helvetica Neue",Helvetica,Arial,sans-serif;
    line-height: 10px;
    padding: 1px 4px;
}

/* QUOTES
=============================================================================*/

blockquote {
  border-left: 4px solid #DDD;
  padding: 0 15px;
  color: #777;
}

blockquote>:first-child {
  margin-top: 0px;
}

blockquote>:last-child {
  margin-bottom: 0px;
}

/* HORIZONTAL RULES
=============================================================================*/

hr {
  clear: both;
  margin: 15px 0;
  height: 0px;
  overflow: hidden;
  border: none;
  background: transparent;
  border-bottom: 4px solid #ddd;
  padding: 0;
}

/* TABLES
=============================================================================*/

table th {
  font-weight: bold;
}

table th, table td {
  border: 1px solid #ccc;
  padding: 6px 13px;
}

table tr {
  border-top: 1px solid #ccc;
  background-color: #fff;
}

table tr:nth-child(2n) {
  background-color: #f8f8f8;
}

/* IMAGES
=============================================================================*/

img {
  max-width: 100%
}
</style>
<style type="text/css">
.highlight  { background: #ffffff; }
.highlight .c { color: #999988; font-style: italic } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { font-weight: bold } /* Keyword */
.highlight .o { font-weight: bold } /* Operator */
.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */
.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */
.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #999999 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #aaaaaa } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { font-weight: bold } /* Keyword.Constant */
.highlight .kd { font-weight: bold } /* Keyword.Declaration */
.highlight .kp { font-weight: bold } /* Keyword.Pseudo */
.highlight .kr { font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #009999 } /* Literal.Number */
.highlight .s { color: #d14 } /* Literal.String */
.highlight .na { color: #008080 } /* Name.Attribute */
.highlight .nb { color: #0086B3 } /* Name.Builtin */
.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */
.highlight .no { color: #008080 } /* Name.Constant */
.highlight .ni { color: #800080 } /* Name.Entity */
.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */
.highlight .nn { color: #555555 } /* Name.Namespace */
.highlight .nt { color: #000080 } /* Name.Tag */
.highlight .nv { color: #008080 } /* Name.Variable */
.highlight .ow { font-weight: bold } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mf { color: #009999 } /* Literal.Number.Float */
.highlight .mh { color: #009999 } /* Literal.Number.Hex */
.highlight .mi { color: #009999 } /* Literal.Number.Integer */
.highlight .mo { color: #009999 } /* Literal.Number.Oct */
.highlight .sb { color: #d14 } /* Literal.String.Backtick */
.highlight .sc { color: #d14 } /* Literal.String.Char */
.highlight .sd { color: #d14 } /* Literal.String.Doc */
.highlight .s2 { color: #d14 } /* Literal.String.Double */
.highlight .se { color: #d14 } /* Literal.String.Escape */
.highlight .sh { color: #d14 } /* Literal.String.Heredoc */
.highlight .si { color: #d14 } /* Literal.String.Interpol */
.highlight .sx { color: #d14 } /* Literal.String.Other */
.highlight .sr { color: #009926 } /* Literal.String.Regex */
.highlight .s1 { color: #d14 } /* Literal.String.Single */
.highlight .ss { color: #990073 } /* Literal.String.Symbol */
.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */
.highlight .vc { color: #008080 } /* Name.Variable.Class */
.highlight .vg { color: #008080 } /* Name.Variable.Global */
.highlight .vi { color: #008080 } /* Name.Variable.Instance */
.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */
.pl-c {
    color: #969896;
}

.pl-c1,.pl-mdh,.pl-mm,.pl-mp,.pl-mr,.pl-s1 .pl-v,.pl-s3,.pl-sc,.pl-sv {
    color: #0086b3;
}

.pl-e,.pl-en {
    color: #795da3;
}

.pl-s1 .pl-s2,.pl-smi,.pl-smp,.pl-stj,.pl-vo,.pl-vpf {
    color: #333;
}

.pl-ent {
    color: #63a35c;
}

.pl-k,.pl-s,.pl-st {
    color: #a71d5d;
}

.pl-pds,.pl-s1,.pl-s1 .pl-pse .pl-s2,.pl-sr,.pl-sr .pl-cce,.pl-sr .pl-sra,.pl-sr .pl-sre,.pl-src,.pl-v {
    color: #df5000;
}

.pl-id {
    color: #b52a1d;
}

.pl-ii {
    background-color: #b52a1d;
    color: #f8f8f8;
}

.pl-sr .pl-cce {
    color: #63a35c;
    font-weight: bold;
}

.pl-ml {
    color: #693a17;
}

.pl-mh,.pl-mh .pl-en,.pl-ms {
    color: #1d3e81;
    font-weight: bold;
}

.pl-mq {
    color: #008080;
}

.pl-mi {
    color: #333;
    font-style: italic;
}

.pl-mb {
    color: #333;
    font-weight: bold;
}

.pl-md,.pl-mdhf {
    background-color: #ffecec;
    color: #bd2c00;
}

.pl-mdht,.pl-mi1 {
    background-color: #eaffea;
    color: #55a532;
}

.pl-mdr {
    color: #795da3;
    font-weight: bold;
}

.pl-mo {
    color: #1d3e81;
}
.task-list {
padding-left:10px;
margin-bottom:0;
}

.task-list li {
    margin-left: 20px;
}

.task-list-item {
list-style-type:none;
padding-left:10px;
}

.task-list-item label {
font-weight:400;
}

.task-list-item.enabled label {
cursor:pointer;
}

.task-list-item+.task-list-item {
margin-top:3px;
}

.task-list-item-checkbox {
display:inline-block;
margin-left:-20px;
margin-right:3px;
vertical-align:1px;
}
</style>
</head>
<body>
<h2>0.98 Release</h2>

<p>Bug fixes:</p>

<ul>
<li>Fixes the noexcept specification (required for Visual Studio 2015 and later.) Fix
contributed by Rupert Steel.</li>
<li>Fixes bug with proxy operator== when comparing object member values,
such as in val["field"] == json("abc")</li>
</ul>

<p>Enhancements:</p>

<ul>
<li><p>Refines error codes and improves error messages</p></li>
<li><p>Renames <code>json_reader</code> method <code>read</code> to <code>read_next</code>, reflecting the fact that it supports reading a sequence of JSON texts from a stream. The <br>
former name is deprecated but still works.</p></li>
<li><p>Adds <code>json_reader</code> method <code>check_done</code> that throws if there are unconsumed non-whitespace characters after one or more calls to <code>read_next</code>.</p></li>
<li><p>Adds getter and setter <code>max_depth</code> methods to allow setting the maximum JSON parse tree depth if desired, by default<br>
it is arbitrarily large (limited by heap memory.)</p></li>
<li><p>Modifies <code>json</code> static methods <code>parse_string</code>, <code>parse_file</code>, and <code>parse_stream</code> behaviour to throw if there are unconsumed non-whitespace characters after reading one JSON text.  </p></li>
</ul>

<p>Changes to extensions:</p>

<ul>
<li>Changes the top level namespace for the extensions from <code>jsoncons_ext</code> to <code>jsoncons</code>, e.g. <code>jsoncons_ext::csv::csv_reader</code> becomes <code>jsoncons::csv::csv_reader</code>
</li>
<li>Modifies csv_reader and csv_serializer so that the constructors are passed parameters in a <code>csv_parameters</code> object rather than a <code>json</code> object.</li>
<li>Adds more options to csv_reader</li>
</ul>

<h2>0.97.2 Release</h2>

<ul>
<li>Incorporates test suite files from <a href="http://www.json.org/JSON_checker/">http://www.json.org/JSON_checker/</a> into test suite</li>
<li>The <code>jsoncons</code> parser accepts all of the JSON_checker files that its supposed to accept.</li>
<li>Failures to reject incorrect exponential notation (e.g. [0e+-1]) have been fixed.</li>
<li>
<p>The <code>jsoncons</code> parser now rejects all of the JSON_checker files that its supposed to reject except ones with stuff after the end of the document, e.g.</p>

<p>["Extra close"]]</p>

<p>(Currently the <code>jsoncons</code> parser stops after reading a complete JSON text, and supports reading a sequence of JSON texts.)  </p>
</li>
<li><p>Incorporates a fix to operator== on json objects, contributed by Alex Merry</p></li>
</ul>

<h2>0.97.1 Release</h2>

<ul>
<li>"Transforming JSON with filters" example fixed</li>
<li>Added a class-specific in-place new to the json class that is implemented in terms of the global version (required to create json objects with placement new operator.)</li>
<li>Reorganized header files, removing unnecessary includes. </li>
<li>Incorporates validation contributed by Alex Merry for ensuring that there is an object or array on parse head.</li>
<li>Incorporates fix contributed by Milan Burda for “Switch case is in protected scope” clang build error</li>
</ul>

<h2>0.97 Release</h2>

<ul>
<li>Reversion of 0.96 change:</li>
</ul>

<p>The virtual methods <code>do_float_value</code>, <code>do_integer_value</code>, and <code>do_unsigned_value</code> of <code>json_input_handler</code> and <code>json_outputhandler</code> have been restored to <code>do_double_value</code>, <code>do_longlong_value</code> and <code>do_ulonglong_value</code>, and their typedefed parameter types <code>float_type</code>, <code>integer_type</code>, and <code>unsigned_type</code> have been restored to <code>double</code>, <code>long long</code>, and <code>unsigned long long</code>.</p>

<p>The rationale for this reversion is that the change doesn't really help to make the software more flexible, and that it's better to leave out the typedefs. There will be future enhancements to support greater numeric precision, but these will not affect the current method signatures.</p>

<ul>
<li>Fix for "unused variable" warning message</li>
</ul>

<h2>0.96 Release</h2>

<p>This release includes breaking changes to interfaces. Going forward, the interfaces are expected to be stable.</p>

<p>Breaking changes:</p>

<ul>
<li><p>Renamed <code>error_handler</code> to <code>parse_error_handler</code>.</p></li>
<li><p>Renamed namespace <code>json_parser_error</code> to <code>json_parser_errc</code></p></li>
<li><p>Renamed <code>value_adapter</code> to <code>json_type_traits</code>, if you have implemented your own type specializations,<br>
you will have to rename <code>value_adapter</code> also.</p></li>
<li><p>Only json arrays now support <code>operator[](size_t)</code> to loop over values, this is no longer supported for <code>json</code> objects. Use a json object iterator instead.</p></li>
<li><p>The virtual methods <code>do_double_value</code>, <code>do_longlong_value</code> and <code>do_ulonglong_value</code> of <code>json_input_handler</code> and <code>json_outputhandler</code> have been renamed to <code>do_float_value</code>, <code>do_integer_value</code>, and <code>do_unsigned_value</code>, <br>
and their parameters have been changed from <code>double</code>, <code>long long</code>, and <code>unsigned long long</code> to typedefs <code>float_type</code>, <code>integer_type</code>, and <code>unsigned_type</code>.<br>
The rationale for this change is to allow different configurations for internal number types (reversed in 0.97.)</p></li>
</ul>

<p>General changes</p>

<ul>
<li><p><code>json</code> member function <code>begin_object</code> now returns a bidirectional iterator rather than a random access iterator.</p></li>
<li><p>Static singleton <code>instance</code> methods have been added to <code>default_parse_error_handler</code><br>
and <code>empty_json_input_handler</code>. </p></li>
<li><p>Added to the <code>json</code> class overloaded static methods parse, parse_string <br>
and parse_file that take a <code>parse_error_handler</code> as a parameter. </p></li>
<li><p>Added methods <code>last_char()</code> and <code>eof()</code> to <code>parsing_context</code>.</p></li>
<li><p>Enhancements to json parsing and json parse event error notification.</p></li>
<li><p>Added to <code>json_input_handler</code> and <code>json_output_handler</code> a non virtual method <code>value</code> that takes a null terminated string.</p></li>
<li><p>Added methods <code>is_integer</code>, <code>is_unsigned</code> and <code>is_float</code> to <code>json</code> to replace <code>is_longlong</code>, <code>is_ulonglong</code> and <code>is_double</code>, which have been deprecated.</p></li>
<li><p>Added methods <code>as_integer</code>, <code>as_unsigned</code> and <code>as_float</code> to <code>json</code> to replace <code>is_longlong</code>, <code>is_ulonglong</code> and <code>is_double</code>, which have been deprecated.</p></li>
</ul>

<p>Bug fixes:</p>

<ul>
<li><p>Fixed issue with column number reported by json_reader</p></li>
<li><p>Where &amp;s[0] and s.length() were passed to methods, &amp;s[0] has been replaced with s.c_str(). <br>
While this shouldn't be an issue on most implementations, VS throws an exception in debug modes when the string has length zero.</p></li>
<li><p>Fixes two issues in 0.95 reported by Alex Merry that caused errors with GCC: a superfluous typename has been removed in csv_serializer.hpp, and a JSONCONS_NOEXCEPT specifier has been added to the json_text_error_category_impl name method.</p></li>
<li><p>Fixed a number of typename issues in the 0.96 candidate identifed by Ignatov Serguei.</p></li>
<li><p>Fixes issues with testsuite cmake and scons reported by Alex Merry and Ignatov Serguei</p></li>
</ul>

<h2>0.95</h2>

<p>Enhancements:</p>

<ul>
<li><p>Added template method <code>any_cast</code> to <code>json</code> class.</p></li>
<li><p>The allocator type parameter in basic_json is now supported, it allows you to supply a <br>
custom allocator for dynamically allocated, fixed size small objects in the json container.<br>
The allocator type is not used for structures including vectors and strings that use large <br>
or variable amounts of memory, these always use the default allocators.</p></li>
</ul>

<p>Non-breaking Change:</p>

<ul>
<li>
<code>json_filter</code> method <code>parent</code> has been renamed to <code>input_handler</code> (old name still works) </li>
</ul>

<p>Breaking change (if you've implemented your own input and output handlers, or if you've<br>
passed json events to input and output handlers directly):</p>

<ul>
<li><p>The input handler virtual method <br>
<code>name(const std::string&amp; name, const parsing_context&amp; context)</code> <br>
has been changed to<br>
<code>do_name(const char* p, size_t length, const parsing_context&amp; context)</code> </p></li>
<li><p>The output handler virtual method <br>
<code>name(const std::string&amp; name)</code> <br>
has been changed to<br>
<code>do_name(const char* p, size_t length)</code> </p></li>
<li><p>The input handler virtual method <br>
<code>string_value(const std::string&amp; value, const parsing_context&amp; context)</code> <br>
has been changed to<br>
<code>do_string_value(const char* p, size_t length, const parsing_context&amp; context)</code> </p></li>
<li><p>The output handler virtual method <br>
<code>string_value(const std::string&amp; value)</code> <br>
has been changed to<br>
<code>do_string_value(const char* p, size_t length)</code> </p></li>
</ul>

<p>The rationale for the method parameter changes is to allow different internal<br>
representations of strings but preserve efficiency. </p>

<ul>
<li><p>The input and output handler virtual implementation methods begin_json, end_json,<br>
begin_object, end_object, begin_array, end_array, name, string_value, <br>
longlong_value, ulonglong_value, double_value, bool_value and null_value <br>
have been renamed to do_begin_json, do_end_json, do_begin_object, do_end_object, <br>
do_begin_array, do_end_array, do_name, do_string_value, do_longlong_value, <br>
do_ulonglong_value, do_double_value, do_bool_value and do_null_value and have been <br>
made private. </p></li>
<li><p>Public non-virtual interface methods begin_json, end_json,<br>
begin_object, end_object, begin_array, end_array, name<br>
have been added to json_input_handler and json_output_handler. </p></li>
</ul>

<p>The rationale for these changes is to follow best C++ practices by making the<br>
json_input_handler and json_output_handler interfaces public non-virtual and <br>
the implementations private virtual. Refer to the documentation and tutorials for details.   </p>

<ul>
<li>The error_handler virtual implementation methods have been renamed to <code>do_warning</code> and 
<code>do_error</code>, and made private. Non virtual public interface methods <code>warning</code> and <code>error</code> 
have been added. Error handling now leverages <code>std::error_code</code> to communicate parser 
error events in an extendable way.</li>
</ul>

<p>Bug fixes:</p>

<ul>
<li>Fixed bug in csv_reader</li>
</ul>

<h2>0.94.1</h2>

<p>Bug fixes:</p>

<ul>
<li>Incorporates fix from Alex Merry for comparison of json objects</li>
</ul>

<h2>0.94</h2>

<p>Bug fixes </p>

<ul>
<li>Incorporates contributions from Cory Fields for silencing some compiler warnings</li>
<li>Fixes bug reported by Vitaliy Gusev in json object operator[size_t]</li>
<li>Fixes bug in json is_empty method for empty objects</li>
</ul>

<p>Changes</p>

<ul>
<li>json constructors that take string, double etc. are now declared explicit (assignments and defaults to get and make_array methods have their own implementation and do not depend on implicit constructors.)</li>
<li>make_multi_array renamed to make_array (old name is still supported)</li>
<li>Previous versions supported any type values through special methods set_custom_data, add_custom_data, and custom_data. This version introduces a new type json::any that wraps any values and works with the usual accessors set, add and as, so the specialized methods are no longer required.</li>
</ul>

<p>Enhancements </p>

<ul>
<li>json get method with default value now accepts extended types as defaults</li>
<li>json make_array method with default value now accepts extended types as defaults</li>
</ul>

<p>New extensions</p>

<ul>
<li>Added jsoncons_ext/boost/type_extensions.hpp to collect 
extensions traits for boost types, in particular, for
boost::gregorian dates.</li>
</ul>

<h2>0.93 Release</h2>

<p>New features</p>

<ul>
<li>Supports wide character strings and streams with wjson, wjson_reader etc. Assumes UTF16 encoding if sizeof(wchar_t)=2 and UTF32 encoding if sizeof(wchar_t)=4.</li>
<li>The empty class null_type  is added to the jsoncons namespace, it replaces the member type json::null_type (json::null_type is typedefed to jsoncons::null_type for backward compatibility.)</li>
</ul>

<p>Defect fixes:</p>

<ul>
<li>The ascii character 0x7f (del) was not being considered a control character to be escaped, this is fixed.</li>
<li>Fixed two issues with serialization when the output format property escape_all_non_ascii is enabled. One, the individual bytes were being checked if they were non ascii, rather than first converting to a codepoint. Two, continuations weren't being handled when decoding.</li>
</ul>

<h2>0.92a Release</h2>

<p>Includes contributed updates for valid compilation and execution in gcc and clang environments</p>

<h2>0.92 Release</h2>

<p>Breaking change (but only if you have subclassed json_input_handler or json_output_handler)</p>

<ul>
<li>For consistency with other names, the input and output handler methods new to 0.91 - value_string, value_double, value_longlong, value_ulonglong and value_bool - have been renamed to string_value, double_value, longlong_value, ulonglong_value and bool_value.</li>
</ul>

<p>Non breaking changes (previous features are deprecated but still work)</p>

<ul>
<li><p>name_value_pair has been renamed to member_type (typedefed to previous name.)</p></li>
<li><p>as_string(output_format format) has been deprecated, use the existing to_string(output_format format) instead</p></li>
</ul>

<p>Enhancements:</p>

<ul>
<li>json now has extensibilty, you can access and modify json values with new types, see the tutorial Extensibility </li>
</ul>

<p>Preparation for allocator support:</p>

<ul>
<li>The basic_json and related classes now have an Storage template parameter, which is currently just a placeholder, but will later provide a hook to allow users to control how json storage is allocated. This addition is transparent to users of the json and related classes.</li>
</ul>

<h2>0.91 Release</h2>

<p>This release should be largely backwards compatible with 0.90 and 0.83 with two exceptions: </p>

<ol>
<li><p>If you have used object iterators, you will need to replace uses of std::pair with name_value_pair, in particular, first becomes name() and second becomes value(). </p></li>
<li><p>If you have subclassed json_input_handler, json_output_handler, or json_filter, and have implemented value(const std::string&amp; ...,  value(double ..., etc., you will need to modify the names to  value_string(const std::string&amp; ...,  value_double(double ... (no changes if you are feeding existing implementations.)</p></li>
</ol>

<p>The changes are</p>

<ul>
<li><p>Replaced std::pairstd::string,json with name_value_pair that has accessors name() and value()</p></li>
<li><p>In json_input_handler and json_output_handler, allowed for overrides of the value methods by making them non-virtual and adding virtual methods value_string, value_double, value_longlong, value_ulonglong, and value_bool</p></li>
</ul>

<p>Other new features:</p>

<ul>
<li><p>Changed implementation of is and as, the current implementation should be user extensible</p></li>
<li><p>make_multi_array makes a multidimensional array with the number of dimensions specified as a template parameter. Replaces make_2d_array and make_3d_array, which are now deprecated.</p></li>
<li><p>Added support for isstd::vector&lt;T&gt; and asstd::vector&lt;T&gt;</p></li>
<li><p>Removed JSONCONS_NO_CXX11_RVALUE_REFERENCES, compiler must support move semantics</p></li>
</ul>

<p>Incorporates a number of contributions from Pedro Larroy and the developers of the clearskies_core project:</p>

<ul>
<li>build system for posix systems</li>
<li>GCC to list of supported compilers</li>
<li>Android fix</li>
<li>fixed virtual destructors missing in json_input_handler, json_output_handler and parsing_context</li>
<li>fixed const_iterator should be iterator in json_object implementation </li>
</ul>

<p>To clean up the interface and avoid too much duplicated functionality, we've deprecated some json methods (but they still work)</p>

<pre><code>make_array
</code></pre>

<p>Use json val(json::an_array) or json::make_multi_array&lt;1&gt;(...) instead (but make_array will continue to work)</p>

<pre><code>make_2d_array
make_3d_array
</code></pre>

<p>Use make_multi_array&lt;2&gt; and make_multi_array&lt;3&gt; instead</p>

<pre><code>as_vector
</code></pre>

<p>Use asstd::vector&lt;int&gt; etc. instead</p>

<pre><code>as_int
as_uint
as_char
</code></pre>

<p>Use as, as, and as instead</p>

<h2>Release 0.90a</h2>

<p>Fixed issue affecting clang compile</p>

<h2>Release 0.90</h2>

<p>This release should be fully backwards compatible with 0.83. </p>

<p>Includes performance enhancements to json_reader and json_deserializer</p>

<p>Fixes issues with column numbers reported with exceptions</p>

<p>Incorporates a number of patches contributed by Marc Chevrier:</p>

<ul>
<li>Fixed issue with set member on json object when a member with that name already exists</li>
<li>clang port</li>
<li>cmake build files for examples and test suite</li>
<li>json template method is for examining the types of json values</li>
<li>json template method as for accessing json values</li>
</ul>

<h2>Release 0.83</h2>

<p>Optimizations (very unlikely to break earlier code)</p>

<ul>
<li><p>get(const std::name&amp; name) const now returns const json&amp; if keyed value exists, otherwise a const reference to json::null</p></li>
<li><p>get(const std::string&amp; name, const json&amp; default_val) const now returns const json (actually a const proxy that evaluates to json if read)</p></li>
</ul>

<p>Bug fixes</p>

<ul>
<li>Line number not incremented within multiline comment - fixed</li>
</ul>

<p>Deprecated features removed</p>

<ul>
<li>Removed deprecated output_format properties (too much bagage to carry around)</li>
</ul>

<h2>Release 0.82a</h2>

<ul>
<li><p>The const version of the json operator didn't need to return a proxy, the return value has been changed to const json&amp; (this change is transparent to the user.) </p></li>
<li><p>get(const std::name&amp; name) has been changed to return a copy (rather than a reference), and json::null if there is no member with that name (rather than throw.) This way both get methods return default values if no keyed value exists.</p></li>
<li><p>non-const and const methods json&amp; at(const std::name&amp; name) have been added to replace the old single argument get method. These have the same behavior as the corresponding operator[] functions, but the non-const at is more efficient.</p></li>
</ul>

<h2>Release 0.81</h2>

<ul>
<li><p>Added accessor and modifier methods floatfield to output_format to provide a supported way to set the floatfield format flag to fixed or scientific with a specified number of decimal places (this can be done in older versions, but only with deprecated methods.)</p></li>
<li><p>The default constructor now constructs an empty object (rather than a null object.) While this is a change, it's unlikely to break exisitng code (all test cases passed without modification.)</p></li>
</ul>

<p>This means that instead of</p>

<pre><code>json obj(json::an_object);
obj["field"] = "field";
</code></pre>

<p>you can simply write</p>

<pre><code>json obj;
obj["field"] = "field";
</code></pre>

<p>The former notation is still supported, though.</p>

<ul>
<li><p>Added a version of 'resize_array' to json that resizes the array to n elements and initializes them to a specified value.</p></li>
<li><p>Added a version of the static method json::make_array that takes no arguments and makes an empty json array</p></li>
</ul>

<p>Note that</p>

<pre><code>json arr(json::an_array);
</code></pre>

<p>is equivalent to</p>

<pre><code>json arr = json::make_array();
</code></pre>

<p>and</p>

<pre><code>json arr(json::an_array);
arr.resize_array(10,0.0);
</code></pre>

<p>is equivalent to</p>

<pre><code>json arr = json::make_array(10,0.0);
</code></pre>

<p>For consistency the json::make_array notation is now favored in the documentation. </p>

<h2>Release 0.71</h2>

<ul>
<li><p>Added resize_array method to json for resizing json arrays </p></li>
<li><p>Fixed issue with remove_range method (templated code failed to compile if calling this method.)</p></li>
<li><p>Added remove_member method to remove a member from a json object</p></li>
<li><p>Fixed issue with multiline line comments, added test case</p></li>
<li><p>Fixed issue with adding custom data to a json array using add_custom_data, added examples.</p></li>
</ul>

<h2>Release 0.70</h2>

<ul>
<li><p>Since 0.50, jsoncons has used snprintf for default serialization of double values to string values. This can result in invalid json output when running on a locale like German or Spanish. The period character (â€˜.â€™) is now always used as the decimal point, non English locales are ignored.</p></li>
<li><p>The output_format methods that support alternative floating point formatting, e.g. fixed, have been deprecated.</p></li>
<li>
<p>Added a template method as_vector to the json class. If a json value is an array and conversion is possible to the template type, returns a std::vector of that type, otherwise throws an std::exception. Specializations are provided for std::string, bool, char, int, unsigned int, long, unsigned long, long long, unsigned long long, and double. For example</p>

<p>std::string s("[0,1,2,3]");</p>

<p>json val = json::parse_string(s);</p>

<p>std::vector v = val.as_vector(); </p>
</li>
<li><p>Undeprecated the json member function precision</p></li>
</ul>

<h2>Release 0.60b</h2>

<p>This release (0.60b) is fully backwards compatible with 0.50.</p>

<p>A change introduced with 0.60 has been reversed. 0.60 introduced an alternative method of constructing a json arrray or object with an initial default constructor, a bug with this was fixed in 0.60a, but this feature and related documentation has been removed because it added complexity but no real value.</p>

<h3>Enhancements</h3>

<ul>
<li><p>Added swap member function to json</p></li>
<li><p>Added add and add_custom_data overrides to json that take an index value, for adding a new element at the specified index and shifting all elements currently at or above that index to the right.</p></li>
<li><p>Added capacity member functions to json</p></li>
</ul>

<h3>0.60  extensions</h3>

<ul>
<li>csv_serializer has been added to the csv extension</li>
</ul>

<h2>Release 0.50</h2>

<p>This release is fully backwards compatible with 0.4*, and mostly backwards compatible to 0.32 apart from the two name changes in 0.41</p>

<p>Bug fixes</p>

<ul>
<li>When reading the escaped characters "\b", "\f", "\r" and "\t" appearing in json strings, json_reader was replacing them with the linefeed character, this has been fixed.</li>
</ul>

<p>Deprecated </p>

<ul>
<li>Deprecated modifiers precision and fixed_decimal_places from output_format. Use set_floating_point_format instead.</li>
<li>Deprecated constructor that takes indenting parameter from output_format. For pretty printing with indenting, use the pretty_print function or pass the indenting parameter in json_serializer.</li>
</ul>

<p>Changes</p>

<ul>
<li>When serializing floating point values to a stream, previous versions defaulted to default floating point precision with a precision of 16. This has been changed to truncate trailing zeros  but keep one if immediately after a decimal point.</li>
</ul>

<p>New features</p>

<ul>
<li>For line reporting in parser error messages, json_reader now recognizes \r\n, \n alone or \r alone (\r alone is new.)</li>
<li>Added set_floating_point_format methods to output_format to give more control over floating point notation.</li>
</ul>

<p>Non functional enhancements</p>

<ul>
<li>json_reader now estimates the minimum capacity for arrays and objects, and reports that information for the begin_array and begin_object events. This greatly reduces reallocations.</li>
</ul>

<h2>Release 0.42</h2>

<ul>
<li>Fixed another bug with multi line /**/ comments </li>
<li>Minor fixes to reporting line and column number of errors</li>
<li>Added fixed_decimal_places setter to output_format</li>
<li>Added version of as_string to json that takes output_format as a parameter</li>
<li>Reorganization of test cases and examples in source tree</li>
</ul>

<h2>Release 0.41</h2>

<ul>
<li>Added non-member overload swap(json&amp; a, json&amp; b)</li>
<li>Fixed bug with multi line /**/ comments </li>
<li>Added begin_json and end_json methods to json_output_handler</li>
<li>json_deserializer should now satisfy basic exception safety (no leak guarantee)</li>
<li>Moved csv_reader.hpp to jsoncons_ext/csv directory</li>
<li>Changed csv_reader namespace to jsoncons::csv</li>
<li>json::parse_file no longer reads the entire file into memory before parsing
(it now uses json_reader default buffering)</li>
</ul>

<h2>Release 0.40</h2>

<ul>
<li>json_listener renamed to json_input_handler</li>
<li><p>json_writer renamed to json_output_handler</p></li>
<li><p>Added json_filter class</p></li>
<li><p>json get method that takes default argument now returns a value rather than a reference</p></li>
<li>Issue in csv_reader related to get method issue fixed</li>
<li>Issue with const json operator[] fixed</li>
<li>Added as_char method to json</li>
<li>Improved exception safety, some opportunites for memory leaks in the presence of exceptions removed</li>
</ul>

<h2>Release 0.33</h2>

<p>Added reserve method to json</p>

<p>Added static make_3d_array method to json</p>

<p>json_reader now configured for buffered reading</p>

<p>Added csv_reader class for reading CSV files and producing JSON events</p>

<p>Fixed bug with explicitly passing output_format in pretty_print.</p>

<h2>Release 0.32</h2>

<p>Added remove_range method, operator== and  operator!= to proxy and json objects</p>

<p>Added static methods make_array and make_2d_array to json</p>

<h2>Release 0.31</h2>

<p>error_handler method content_error renamed to error</p>

<p>Added error_code to warning, error and fatal_error methods of error_handler</p>

<h2>Release 0.30</h2>

<p>json_in_stream renamed to json_listener</p>

<p>json_out_stream renamed to json_writer</p>

<p>Added buffer accessor method to parsing_context</p>

<h2>Release 0.20</h2>

<p>Added parsing_context class for providing information about the<br>
element being parsed.</p>

<p>error_handler methods take message and parsing_context parameters</p>

<p>json_in_stream handlers take parsing_context parameter</p>

<h2>Release 0.19</h2>

<p>Added error_handler class for json_reader</p>

<p>Made json_exception a base class for all json exceptions</p>

<p>Added root() method to json_deserializer to get a reference to the json value</p>

<p>Removed swap_root() method from json_deserializer</p>

<h2>Release 0.18</h2>

<p>Renamed serialize() class method to to_stream() in json  </p>

<p>Custom data serialization supported through template function specialization of serialize<br>
(reverses change in 0.17)</p>

<h2>Release 0.17</h2>

<p>Added is_custom() method to json and proxy</p>

<p>get_custom() method renamed to custom_data() in json and proxy</p>

<p>Added clear() method to json and proxy</p>

<p>set_member() method renamed to set()</p>

<p>set_custom() method renamed to set_custom_data()</p>

<p>push_back() method renamed to add() in json and proxy</p>

<p>Added add_custom_data method() in json and proxy</p>

<p>Custom data serialization supported through template class specialization of custom_serialization<br>
(replaces template function specialization of serialize)</p>

<h2>Release 0.16</h2>

<p>Change to json_out_stream and json_serializer:</p>

<pre><code>void value(const custom_data&amp; value)
</code></pre>

<p>removed.</p>

<p>Free function serialize replaces free function to_stream for<br>
serializing custom data.</p>

<p>pretty print tidied up for nested arrays</p>

<h2>Release 0.15</h2>

<p>Made eof() method on json_reader public, to support reading<br>
multiple JSON objects from a stream.</p>

<h2>Release 0.14</h2>

<p>Added pretty_print class</p>

<p>Renamed json_stream_writer to json_serializer, <br>
implements pure virtual class json_out_stream</p>

<p>Renamed json_stream_listener to json_deserializer<br>
implements pure virtual class json_in_stream</p>

<p>Renamed json_parser to json_reader, parse to read.</p>

<p>Changed indenting so object and array members start on new line.</p>

<p>Added support for storing user data in json object, and<br>
serializing to JSON.</p>

<h2>Release 0.13</h2>

<p>Replaced simple_string union member with json_string that <br>
wraps std::basic_string</p>

<p>name() and value() event handler methods on <br>
basic_json_stream_writer take const std::basic_string&amp;<br>
rather than const Char* and length.</p>

<h2>Release 0.12</h2>

<p>Implemented operator&lt;&lt; for json::proxy</p>

<p>Added to_stream methods to json::proxy</p>

<h2>Release 0.11</h2>

<p>Added members to json_parser to access and modify the buffer capacity</p>

<p>Added checks when parsing integer values to determine overflow for <br>
long long and unsigned long long, and if overflow, parse them as<br>
doubles. </p>
</body>
</html>
<!-- This document was created with MarkdownPad, the Markdown editor for Windows (http://markdownpad.com) -->
