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.