DOKK / manpages / debian 12 / libbson-doc / bson_new_from_json.3.en
BSON_NEW_FROM_JSON(3) libbson BSON_NEW_FROM_JSON(3)

bson_new_from_json - bson_new_from_json()

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


  • 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.

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 are propagated via the error parameter.

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

MongoDB, Inc

2017-present, MongoDB, Inc

October 20, 2022 1.23.1