DOKK / manpages / debian 10 / libmongoc-doc / mongoc_matcher_new.3.en
MONGOC_MATCHER_NEW(3) MongoDB C Driver MONGOC_MATCHER_NEW(3)

mongoc_matcher_new - mongoc_matcher_new()

mongoc_matcher_t *
mongoc_matcher_new (const bson_t *query, bson_error_t *error);


Create a new mongoc_matcher_t using the query specification provided.

WARNING:

mongoc_matcher_t is deprecated and will be removed in version 2.0.


  • query: A bson_t.
  • error: An optional location for a bson_error_t or NULL.

Errors are propagated via the error parameter.

A newly allocated mongoc_matcher_t that should be freed with mongoc_matcher_destroy() when no longer in use. Upon failure, NULL is returned and error is set. This could happen if query contains an invalid query specification.

MongoDB, Inc

2017-present, MongoDB, Inc

February 23, 2019 1.14.0