mongoc_matcher_new - mongoc_matcher_new()

Author

       MongoDB, Inc

Copyright

       2017-present, MongoDB, Inc

1.21.0                                            Feb 09, 2022                             MONGOC_MATCHER_NEW(3)

Deprecated

WARNING:mongoc_matcher_t is deprecated and will be removed in version 2.0.

Errors

       Errors are propagated via the error parameter.

Name

       mongoc_matcher_new - mongoc_matcher_new()

Parameters

       • query: A bson_t.

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

Returns

       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.

Synopsis

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

       Create a new mongoc_matcher_t using the query specification provided.