- libbson 1.13.1 »
- Tutorial

# Handling Errors

## Description

Many libbson functions report errors by returning `NULL` or -1 and filling out a bson_error_t structure with an error domain, error code, and message.

- `error.domain` names the subsystem that generated the error.
- `error.code` is a domain-specific error type.
- `error.message` describes the error.

Some error codes overlap with others; always check both the domain and code to determine the type of error.

`BSON_ERROR_JSON` | `BSON_JSON_ERROR_READ_CORRUPT_JS` `BSON_JSON_ERROR_READ_INVALID_PARAM` `BSON_JSON_ERROR_READ_CB_FAILURE` | bson_json_reader_t tried to parse invalid MongoDB Extended JSON. Tried to parse a valid JSON document that is invalid as MongoDBExtended JSON. An internal callback failure during JSON parsing.
`BSON_ERROR_READER` | `BSON_ERROR_READER_BADFD` | bson_json_reader_new_from_file() could not open the file.

Created using Sphinx 1.8.3, based on Sphinx Readable Theme.