...one of the most highly
regarded and expertly designed C++ library projects in the
world. — Herb Sutter and Andrei
Indicate the end of JSON input.
This function is used to indicate that there are no more character buffers in the current JSON being parsed. If ther resulting JSON is incomplete, the error is set to indicate a parsing failure.
In the code below,
finish is called to indicate
there are no more digits in the resulting number:
stream_parser p; // construct a parser p.write( "3." ); // write the first part of the number p.write( "14" ); // write the second part of the number assert( ! p.done() ); // there could be more digits p.finish(); // indicate the end of the JSON input assert( p.done() ); // now we are finished value jv = p.release(); // take ownership of the value
Basic guarantee. Calls to
may throw. Upon error or exception, subsequent calls will fail until
reset is called to parse a new
Thrown on error.