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
stream_parser::write (1 of 6 overloads)

Parse a buffer containing all or part of a complete JSON.

Synopsis
std::size_t
write(
    char const* data,
    std::size_t size,
    error_code& ec);
Description

This function parses a all or part of a 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
stream_parser p;                                // construct a parser
std::size_t n;                                  // number of characters used
n = p.write( "[1,2" );                          // parse some of the JSON
assert( n == 4 );                               // all characters consumed
n = p.write( "3,4]" );                          // parse the rest of the JSON
assert( n == 4 );                               // all characters consumed
value jv = p.release();                         // take ownership of the value
Remarks

To indicate there are no more character buffers, such as when done returns false after writing, call finish.

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

data

A pointer to a buffer of size characters to parse.

size

The number of characters pointed to by data.

ec

Set to the error, if any occurred.


PrevUpHomeNext