# bson_new_from_json()

## Synopsis

    bson_t *
    bson_new_from_json (const uint8_t *data,
                        ssize_t        len,
                        bson_error_t  *error);

## Parameters

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().
error | An optional location for a bson_error_t.

## Description

The bson_new_from_json() function allocates and 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 NULL returned.

## Errors

Errors are propagated via the error parameter.

## Returns

A newly allocated bson_t if successful, otherwise NULL and error is set.