NAME

       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.

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

DEPRECATED

       NOTE
              mongoc_matcher_t is deprecated and will be removed in version 2.0.

EXAMPLE

       #include <bcon.h>
       #include <bson.h>
       #include <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_json (bson, NULL);
                printf ("%s\n", str);
                bson_free (str);
             }
          }

          bson_reader_destroy (reader);
          bson_destroy (spec);

          mongoc_cleanup ();

          return 0;
       }

COLOPHON

       This   page   is   part   of   MongoDB   C   Driver.    Please   report   any   bugs    at
       https://jira.mongodb.org/browse/CDRIVER.