bson_errors - Handling Errors

       MongoDB, Inc

       2017-present, MongoDB, Inc

1.21.0                                            Feb 09, 2022                                    BSON_ERRORS(3)

       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_reader_t  tried to   │
             │                   │ BSON_JSON_ERROR_READ_INVALID_PARAM │ parse    invalid     MongoDB   │
             │                   │ BSON_JSON_ERROR_READ_CB_FAILURE    │ 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.       │
             └───────────────────┴────────────────────────────────────┴────────────────────────────────┘

       bson_errors - Handling Errors