MONGOC_MATCHER_T(3)

NAME
mongoc_matcher_t - mongoc_matcher_t

Client-side document matching abstraction

SYNOPSIS

        typedef struct _mongoc_matcher_t mongoc_matcher_t;

mongoc_matcher_t provides a reduced-interface for client-side matching of BSON documents.

It can perform the basics such as $in, $nin, $eq, $neq, $gt, $gte, $lt, and $lte.

WARNING:
        mongoc_matcher_t does not currently support the full spectrum of query operations that the MongoDB server supports.

DEPRECATED

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

EXAMPLE

Filter a sequence of BSON documents from STDIN based on a query

        #include <bson/bson.h>
        #include <mongoc/mongoc.h>
        #include <stdio.h>

        int
        main (int argc, char *argv[])
        {
           mongoc_matcher_t *matcher;
           bson_reader_t *reader;
           const bson_t *bson;
           bson_t *spec;
           char *str;
           int fd;

           mongoc_init ();

        #ifdef _WIN32
           fd = fileno (stdin);
        #else
           fd = STDIN_FILENO;
        #endif

           reader = bson_reader_new_from_fd (fd, false);

           spec = BCON_NEW ("hello", "world");
           matcher = mongoc_matcher_new (spec, NULL);

           while ((bson = bson_reader_read (reader, NULL))) {
              if (mongoc_matcher_match (matcher, bson)) {
                 str = bson_as_canonical_extended_json (bson, NULL);
                 printf ("%s\n", str);
                 bson_free (str);
              }
           }

           bson_reader_destroy (reader);
           bson_destroy (spec);

           mongoc_cleanup ();

           return 0;
        }

AUTHOR
MongoDB, Inc

COPYRIGHT
2017-present, MongoDB, Inc