Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.
PrevUpHomeNext
parser::write (4 of 6 overloads)

Parse a buffer containing a complete JSON.

Synopsis
std::size_t
write(
    string_view s,
    std::error_code& ec);
Description

This function parses a complete JSON contained in the specified character buffer. The entire buffer must be consumed; if there are additional characters past the end of the complete JSON, the parse fails and an error is returned.

Example
parser p;                                       // construct a parser
size_t n = p.write( "[1,2,3]" );                // parse a complete JSON
assert( n == 7 );                               // all characters consumed
value jv = p.release();                         // take ownership of the value
Complexity

Linear in size.

Exception Safety

Basic guarantee. Calls to memory_resource::allocate may throw. Upon error or exception, subsequent calls will fail until reset is called to parse a new JSON.

Return Value

The number of characters consumed from the buffer.

Parameters

Name

Description

s

The character string to parse.

ec

Set to the error, if any occurred.


PrevUpHomeNext