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