MONGOC_MATCHER(3)

📦
version 1.23.1 · 2 versions
, in debian bookworm

💖 MONGOC_MATCHER 💖

okay bestie, pull up a chair because we're talking about mongoc_matcher from libmongc... no wait, libmongoc 🫶 the MongoDB C driver's own little manual page. this one's about Client Side Document Matching and it is so niche but also kinda iconic. let's get into it ✨

✨ NAME ✨

mongoc_matcher — Client Side Document Matching 🎀

🌸 BASIC DOCUMENT MATCHING (DEPRECATED) 🌸

⚠️ WARNING: This feature will be removed in version 2.0. it's giving "enjoy it while it lasts" energy, bestie 💀

so. the MongoDB C driver can match a subset of the MongoDB query specification on the client. like, right there on your machine, no server round-trip, no waiting, main character energy fr fr 👑

currently supported, and I'm listing every single one because we don't skip:

  • basic numeric equality
  • basic string equality
  • basic subdocument equality
  • basic array equality
  • $gt
  • $gte
  • $lt
  • $lte
  • $in
  • $nin
  • $ne
  • $exists
  • $type
  • $and
  • $or

that's the whole lineup, periodt 💅

now the real talk: this is not the same implementation as the MongoDB server, so some inconsistencies may occur. lowkey expected when two things do the same job in different ways, right? 🙈 and if you do find one of those inconsistent cases, pls file a bug — the maintainers wanna know, I promise, no cap 🦋

🧚 how to actually test this 🧚

the move is to do a mongodump of a single collection and pipe it into the program. chef's kiss, honestly 🍓

$ echo "db.test.insert({hello:'world'})" | mongo
connecting to: test
WriteResult({ "nInserted" : 1 })
bye

$ mongodump -d test -c test -o - | filter-bsondump
{ "_id" : { "$oid" : "537afac9a70e5b4d556153bc" }, "hello" : "world" }

look at that output. { "hello" : "world" } sitting there looking all cute. that's the vibe check passing ✅

⭐ AUTHOR ⭐

MongoDB, Inc 🌈

2017-present, MongoDB, Inc 💜

and that's the whole page, bestie!! mwah 💋 this was libmongoc version 1.23.1, dated Apr 27, 2026 — go forth and match some documents on the client side before 2.0 takes it away 😭💖

📦 where this page comes from