mongoc_matcher_t(3) 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.