bson_new_from_json(3)

bson_new_from_json3

Usage

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.

Overview

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

Deprecated behavior: If there are multiple comma-separated JSONs in data, the keys from all JSONs are merged in the returned BSON. For example, {"a": 1},{"b": 2} is parsed as {"a": 1, "b": 2}. If the first character encountered after the last valid JSON object is {, all following characters are ignored and no error is set. Otherwise, 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.

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13

Author

MongoDB, Inc

From libbson-doc 1.30.4-1+deb13u3 in Debian 13 (Trixie). Parsed by carta from the page's man source.