NAME

bson_init_from_json() - The bson_init_from_json() function will initialize a new bson_t by parsing the JSON found in data. Only a single JSON object may exist in data or an error will be set and false returned.

SYNOPSIS

bool
bson_init_from_json (bson_t       *bson,
                     const char   *data,
                     ssize_t       len,
                     bson_error_t *error);

PARAMETERS

bson
A bson_t \&.

data
A UTF-8 encoded string containing valid JSON.

len
The length of data in bytes excluding a trailing \0 or -1 to determine the length with strlen(3) \&.

error
An optional location for a bson_error_t \&.

DESCRIPTION

The bson_init_from_json(3) function will initialize a new bson_t by parsing the JSON found in data \&. Only a single JSON object may exist in data or an error will be set and false returned.

data should be in MongoDB Extended JSON format.

ERRORS

Errors are propagated via the error parameter.

RETURNS

true if successful, otherwise false and error is set.

COLOPHON

This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.