MONGOC_BULK_OP...ION_UPDATE_ONE(3)

📦
version 2.5.6 · 16 versions
, in epel 10

✨ mongoc_bulk_operation_update_one ✨

okay bestie, so this is a page from libmongoc (that's the MongoDB C driver manual, iykyk) and it's all about mongoc_bulk_operation_update_one, which is lowkey iconic but also a little bit retired. let's get into it 💅

💖 SYNOPSIS 💖

          void
          mongoc_bulk_operation_update_one (mongoc_bulk_operation_t *bulk,
                                            const bson_t *selector,
                                            const bson_t *document,
                                            bool upsert);

🦋 DESCRIPTION 🦋

so here's the vibe: this function queues an update as part of a bulk operation. that's it. it doesn't actually go do the thing yet, no cap.

important detail fr: it will only modify a single document on the MongoDB server. one. singular. main character energy. 👑

and bestie, listen — this function does not execute the operation. it's just lining up the shot. if you actually want the entirety of the bulk operation to happen, you gotta call mongoc_bulk_operation_execute().

also, heads up 🙈: this function is superseded by mongoc_bulk_operation_update_one_with_opts(). so like, she still works, but there's a newer girl in town.

🎀 PARAMETERS 🎀

  • bulk — a mongoc_bulk_operation_t. this is the bulk operation your update is hopping into 🫶
  • selector — a bson_t that selects which document to remove. yes, the manpage literally says remove, and yes, we're moving on 😭
  • document — a bson_t containing the update document. this is the actual update payload 💖
  • upsert — true if an upsert should be performed. false if not. simple as that ✨
⚠️ WARNING: document must only contain fields whose key starts with $. that is a hard requirement, not a suggestion, fr fr. see the update document specification for more details, bestie — don't skip it 🙏

👀 SEE ALSO 👀

  • mongoc_bulk_operation_update()
  • mongoc_bulk_operation_update_one_with_opts()

🧚 AUTHOR 🧚

MongoDB, Inc — legends, honestly 🌈

2009-present, MongoDB, Inc. — slay, long-running copyright, we love to see it 👑

and that's the tea, bestie 🍓 this was version 2.5.6, dated Oct 09, 202... (the footer literally ran out of room, the date got cut off mid-number, not me 😭💀). go queue those updates responsibly, mwah 💜✨

📦 where this page comes from