MONGOC_CLIENT...STR_MAX_LENGTH(3)

📦 version 2.2.2, in ubuntu resolute

💅 MONGOC_CLIENT...STR_MAX_LENGTH(3) 💅

okay bestie, welcome to libmongoc — yes that's the manual name, and yes we're gonna talk about the function with the longest name in the entire friend group: mongoc_client_encryption_encrypt_text_substring_opts_set_str_max_length. Say it with me. Slay. 🎀

✨ SYNOPSIS ✨

void
mongoc_client_encryption_encrypt_text_substring_opts_set_str_max_length(
   mongoc_client_encryption_encrypt_text_substring_opts_t *opts,
   int32_t str_max_length);

Added in version 2.2.0. 🦋

🌸 DESCRIPTION 🌸

So what does this icon actually do? It sets the maximum string length for substring text search encryption options. That's it. That's the whole vibe. You hand it some opts and a number, and it caps how long your strings can be for that substring search setup. Periodt. 💖

🚨 okay important, do not scroll past this 🚨 The "TextPreview" algorithm is in preview and should be used for experimental workloads only. These features are unstable and their security is not guaranteed until they get released as Generally Available (GA). And here's the part that really gets you: the GA version of these features may not be backwards compatible with the preview version. So like, don't build your whole personality on it. 💀

🫶 PARAMETERS 🫶

  • opts — a mongoc_client_encryption_encrypt_text_substring_opts_t. The little options struct in question. 👑
  • str_max_length — the maximum string length for substring search. Must be greater than zero. Not zero. Not negative. Greater than zero. I'm not being dramatic, that's literally the requirement. 🙈

🔍 See also:

  • mongoc_client_encryption_encrypt_text_substring_opts_new()
  • mongoc_client_encryption_encrypt_text_opts_set_substring()

(go read those too, they're the besties of this function, iykyk 🌈)

👑 Author

MongoDB, Inc — the main characters themselves.

2009-present, MongoDB, Inc.

and that's the whole page, bestie ✨ you understood it, you ate, no crumbs left. this was libmongoc version 2.2.2, dated Feb 13, 2026 — mwah, love u, go encrypt something responsibly 💅💖🎀

📦 where this page comes from