diff --git a/_static/documentation_options.js b/_static/documentation_options.js index a4969fc55daeb7f18a16ec726272b15dfc0064c5..eec1d8b48f6cf6f99c4baf7464abf2f323fe3786 100644 --- a/_static/documentation_options.js +++ b/_static/documentation_options.js @@ -1,6 +1,6 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '1.23.5', + VERSION: '1.24.0', LANGUAGE: 'en', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', diff --git a/index.html b/index.html index 8330c232c80ab761b293e1ba6e70ee8528219f51..378fdc0d32619166b711da90d7abd3d1f83def78 100644 --- a/index.html +++ b/index.html @@ -21,7 +21,7 @@ delighted.survey(); - MongoDB C Driver — MongoDB C Driver 1.23.5 + MongoDB C Driver — MongoDB C Driver 1.24.0 @@ -50,7 +50,7 @@
  • next
  • - + @@ -65,7 +65,7 @@

    It depends on libbson to generate and parse BSON documents, the native data format of MongoDB.

    Download

    -

    Latest release: mongo-c-driver-1.23.5.tar.gz

    +

    Latest release: mongo-c-driver-1.24.0.tar.gz

    Documentation

    diff --git a/libbson-releases.html b/libbson-releases.html index f1a908a5f8c3900671e97ea1a5c19b15bcce6fc7..ab91265ddc78c27fc2f36bd7a2004b96083cbc03 100644 --- a/libbson-releases.html +++ b/libbson-releases.html @@ -21,7 +21,7 @@ delighted.survey(); - libbson Releases — MongoDB C Driver 1.23.5 + libbson Releases — MongoDB C Driver 1.24.0 @@ -48,7 +48,7 @@
  • previous
  • - + @@ -58,103 +58,104 @@

    libbson Releases

    -

    Latest Release (1.23.5)

    +

    Latest Release (1.24.0)

    Current Development (master)

    diff --git a/libbson/1.23.5/api.html b/libbson/1.23.5/api.html index cb299937e976e6e36cbf953be99cdf54d364ad9a..ba15603adb07abb56835b4296c05b7cfe5169e15 100644 --- a/libbson/1.23.5/api.html +++ b/libbson/1.23.5/api.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_aligned_alloc.html b/libbson/1.23.5/bson_aligned_alloc.html index eb248daf3c83bc98c34514f0949052112b97ef23..f46d145ac0023b7339b9fad7279c1c0ba0df42fe 100644 --- a/libbson/1.23.5/bson_aligned_alloc.html +++ b/libbson/1.23.5/bson_aligned_alloc.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_aligned_alloc0.html b/libbson/1.23.5/bson_aligned_alloc0.html index d7f63dc859d715be2ddc0fecd8bd0444ed8467de..39ee3032a9abccd90252a1bc110f5f9203f937fa 100644 --- a/libbson/1.23.5/bson_aligned_alloc0.html +++ b/libbson/1.23.5/bson_aligned_alloc0.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_array.html b/libbson/1.23.5/bson_append_array.html index 60a87e73e87fb504232e2d1fcd00cfffff0b732e..64e61498bd2b8f8adb11d8814c4de06a1c65491d 100644 --- a/libbson/1.23.5/bson_append_array.html +++ b/libbson/1.23.5/bson_append_array.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_array_begin.html b/libbson/1.23.5/bson_append_array_begin.html index caf38ba7b95f982bd8fc323089553c86a29ae6fe..2943a8c487606de3682fed02f3885e79a51cb278 100644 --- a/libbson/1.23.5/bson_append_array_begin.html +++ b/libbson/1.23.5/bson_append_array_begin.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_array_end.html b/libbson/1.23.5/bson_append_array_end.html index 526f7bee0b1f40ea2d409b82ac2eee25e65eadde..aae0b7b5374a9cf2f647d7ae6a78f4b77f2868a8 100644 --- a/libbson/1.23.5/bson_append_array_end.html +++ b/libbson/1.23.5/bson_append_array_end.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_binary.html b/libbson/1.23.5/bson_append_binary.html index 8e882628d5e3b4b00c4087e79e130f43b001c5b1..d143c889685e623960bcdc2d3cdac8bc386a9645 100644 --- a/libbson/1.23.5/bson_append_binary.html +++ b/libbson/1.23.5/bson_append_binary.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_bool.html b/libbson/1.23.5/bson_append_bool.html index 71a374fe9b1507ec80305e52cc5c7af8cce9fc67..f8faf12d909da03e53f1bea7b22a49b8c257b038 100644 --- a/libbson/1.23.5/bson_append_bool.html +++ b/libbson/1.23.5/bson_append_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_code.html b/libbson/1.23.5/bson_append_code.html index 83297de0e8b5932db1d67f0526b8a888ee0b8b4a..cb8d46e8ad9076bac5017c978b0786e8eafdc371 100644 --- a/libbson/1.23.5/bson_append_code.html +++ b/libbson/1.23.5/bson_append_code.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_code_with_scope.html b/libbson/1.23.5/bson_append_code_with_scope.html index 79d694a2b3d51fffbc8a8098daea27507408af42..608786495e89eec0e52bfcb14bc64dcbc906cba2 100644 --- a/libbson/1.23.5/bson_append_code_with_scope.html +++ b/libbson/1.23.5/bson_append_code_with_scope.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_date_time.html b/libbson/1.23.5/bson_append_date_time.html index 7819b3a0d0e679ccfb91c64b7e574e0094cb2d69..b922ac7fc405d47c19a8f1e8d53e790b4393226d 100644 --- a/libbson/1.23.5/bson_append_date_time.html +++ b/libbson/1.23.5/bson_append_date_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_dbpointer.html b/libbson/1.23.5/bson_append_dbpointer.html index 5e5fdc14ae954383da021271e777e60e1541b4b1..54d6af3bfa763eb6e3332890a3602f954b9bdad8 100644 --- a/libbson/1.23.5/bson_append_dbpointer.html +++ b/libbson/1.23.5/bson_append_dbpointer.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_decimal128.html b/libbson/1.23.5/bson_append_decimal128.html index 4e971d25919811de12212fc233545f8313cdfc8b..f25bb24833f7f7bc1be57bd78357519376a3f654 100644 --- a/libbson/1.23.5/bson_append_decimal128.html +++ b/libbson/1.23.5/bson_append_decimal128.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_document.html b/libbson/1.23.5/bson_append_document.html index 6878c4a57d8075474fad64b7249c87588f447956..294d560cabfe68ceb48dfc99731e29a8a3ca3cb5 100644 --- a/libbson/1.23.5/bson_append_document.html +++ b/libbson/1.23.5/bson_append_document.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_document_begin.html b/libbson/1.23.5/bson_append_document_begin.html index f9ea81a838fc3dc1dc439053d4fb103276b7d66c..fa7432ff32d67e1c18656b3bad47e8525fd0ef51 100644 --- a/libbson/1.23.5/bson_append_document_begin.html +++ b/libbson/1.23.5/bson_append_document_begin.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_document_end.html b/libbson/1.23.5/bson_append_document_end.html index b5e1a0598c939186a6659a7956bf86109cf8dad4..ac77125046665882a6b6fce9e288a2fbe15b5d47 100644 --- a/libbson/1.23.5/bson_append_document_end.html +++ b/libbson/1.23.5/bson_append_document_end.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_double.html b/libbson/1.23.5/bson_append_double.html index 6858badc5cac4c8286c78ab7181b6c72b76b4d7e..1e16966d723bb24f211c11d80d6709176cacdb5b 100644 --- a/libbson/1.23.5/bson_append_double.html +++ b/libbson/1.23.5/bson_append_double.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_int32.html b/libbson/1.23.5/bson_append_int32.html index 3fbaf96aaaf7d98e7dd8d846e509fe6b2d4d5c60..4376307eedec0249e5eb9e775b3000e0c108e246 100644 --- a/libbson/1.23.5/bson_append_int32.html +++ b/libbson/1.23.5/bson_append_int32.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_int64.html b/libbson/1.23.5/bson_append_int64.html index 90b132f3d09d46de351bd5dbaf0f13d2e7950ac3..2fdc6ef5744a2fe241f29ef1ca8bc008b43b71e4 100644 --- a/libbson/1.23.5/bson_append_int64.html +++ b/libbson/1.23.5/bson_append_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_iter.html b/libbson/1.23.5/bson_append_iter.html index 644da41c5a60788cc52929771fccf431a8a010b8..8bd0485a50e701530c7ef753906fef13f1e580f2 100644 --- a/libbson/1.23.5/bson_append_iter.html +++ b/libbson/1.23.5/bson_append_iter.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_maxkey.html b/libbson/1.23.5/bson_append_maxkey.html index 97ed16d3d8e9dd44e25ea45ecc77f260b63b67da..1010fe066ca40b0755ebb5258de949821efde609 100644 --- a/libbson/1.23.5/bson_append_maxkey.html +++ b/libbson/1.23.5/bson_append_maxkey.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_minkey.html b/libbson/1.23.5/bson_append_minkey.html index 4cc87be14964f1ccfe3beded91679b4fadcbdae7..84c6609a6192d8e7b0b80463768f210cc697d32d 100644 --- a/libbson/1.23.5/bson_append_minkey.html +++ b/libbson/1.23.5/bson_append_minkey.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_now_utc.html b/libbson/1.23.5/bson_append_now_utc.html index 809c2ec26e362807897d1968bdf52559a76e87ce..6574480e891c27c8ab9e5fee20a3760e559e58b5 100644 --- a/libbson/1.23.5/bson_append_now_utc.html +++ b/libbson/1.23.5/bson_append_now_utc.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_null.html b/libbson/1.23.5/bson_append_null.html index 8a74f8b05665ba54fc1ae98c1288f503d46b7c93..0a8f7dd432b0d467d34b75497783589845732bd2 100644 --- a/libbson/1.23.5/bson_append_null.html +++ b/libbson/1.23.5/bson_append_null.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_oid.html b/libbson/1.23.5/bson_append_oid.html index 8241854f4e8bc27cf20d49b7ac918a610572fd58..6a50fe768ba09abc734c575672b3e66c72880d74 100644 --- a/libbson/1.23.5/bson_append_oid.html +++ b/libbson/1.23.5/bson_append_oid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_regex.html b/libbson/1.23.5/bson_append_regex.html index 35c1e8aeba62b42ce70453f9c471ec4503b178be..3d53b3cb22ff7a3958a7eb5b50c4de84975f7907 100644 --- a/libbson/1.23.5/bson_append_regex.html +++ b/libbson/1.23.5/bson_append_regex.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_regex_w_len.html b/libbson/1.23.5/bson_append_regex_w_len.html index 3ca9b2ae65cc61cddca397d5e5eb657161a28af3..62e6e9aa7fe9eb20f61d00f5993f0c08ebccfb6c 100644 --- a/libbson/1.23.5/bson_append_regex_w_len.html +++ b/libbson/1.23.5/bson_append_regex_w_len.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_symbol.html b/libbson/1.23.5/bson_append_symbol.html index 804f18ee91886adefc535a58024726efd3e62893..c0e4c7920271687ccacf088963a90581f84b81f2 100644 --- a/libbson/1.23.5/bson_append_symbol.html +++ b/libbson/1.23.5/bson_append_symbol.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_time_t.html b/libbson/1.23.5/bson_append_time_t.html index 85a9686f137400a736c1bb1fd71fd2f8e10a4db0..8378118c61ff302c14aa4ae817edea80898235ec 100644 --- a/libbson/1.23.5/bson_append_time_t.html +++ b/libbson/1.23.5/bson_append_time_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_timestamp.html b/libbson/1.23.5/bson_append_timestamp.html index ad2bdee65cb2f14cfb8465ea234a5785b8708bc5..6836941eda2d2c83577728f9feb9680b4fa30199 100644 --- a/libbson/1.23.5/bson_append_timestamp.html +++ b/libbson/1.23.5/bson_append_timestamp.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_timeval.html b/libbson/1.23.5/bson_append_timeval.html index db24ca6356d37d22312bf34c616c0fadfe0ef25d..e8dd3dac6267e46289b9a8738308894de97d79f3 100644 --- a/libbson/1.23.5/bson_append_timeval.html +++ b/libbson/1.23.5/bson_append_timeval.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_undefined.html b/libbson/1.23.5/bson_append_undefined.html index a5abf429df6730fc3899ed571b7f433ca1a938d8..c9939a7b08e6ebd39a7891b728fc4013e7d543ac 100644 --- a/libbson/1.23.5/bson_append_undefined.html +++ b/libbson/1.23.5/bson_append_undefined.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_utf8.html b/libbson/1.23.5/bson_append_utf8.html index cfbd007a5a82d4b83f8a2a2e0040faee92c4a06b..becbec69aaaa2e87841a62f9355944629dcb2dda 100644 --- a/libbson/1.23.5/bson_append_utf8.html +++ b/libbson/1.23.5/bson_append_utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_append_value.html b/libbson/1.23.5/bson_append_value.html index fe3c61dbe95876fe218e7edab1c96c8b4771b946..f5a63dfee5d8badf776d6b9333273ba5fc1e73f3 100644 --- a/libbson/1.23.5/bson_append_value.html +++ b/libbson/1.23.5/bson_append_value.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_array_as_json.html b/libbson/1.23.5/bson_array_as_json.html index aff427da469df6eebde49ca6b48266caacf4c0d5..df6e0e7d871b7a19a140cd4507b8b6c86a0875f3 100644 --- a/libbson/1.23.5/bson_array_as_json.html +++ b/libbson/1.23.5/bson_array_as_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_as_canonical_extended_json.html b/libbson/1.23.5/bson_as_canonical_extended_json.html index 45a4b58239915e28ac3b139802b9a3123dc2b6bf..6e48d3c22c2dca5cc60d0d46effdb8529ab06de5 100644 --- a/libbson/1.23.5/bson_as_canonical_extended_json.html +++ b/libbson/1.23.5/bson_as_canonical_extended_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_as_json.html b/libbson/1.23.5/bson_as_json.html index 8c8f2d093018c529e4aefbd5f15391293afa53c2..181acaf333723495510bd6814aded3b118d0ab98 100644 --- a/libbson/1.23.5/bson_as_json.html +++ b/libbson/1.23.5/bson_as_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_as_json_with_opts.html b/libbson/1.23.5/bson_as_json_with_opts.html index 7ee679409dbe3e6bd1627fbf4a901eeb7236222d..4e78bc2cb266a961ddc6ad84f768d11abf6f36c9 100644 --- a/libbson/1.23.5/bson_as_json_with_opts.html +++ b/libbson/1.23.5/bson_as_json_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_as_relaxed_extended_json.html b/libbson/1.23.5/bson_as_relaxed_extended_json.html index 2bc5a45ce9cb89e6114df2930e12bc157bd5742f..46f9426e9a970d4e12e35a7f05aecc464d23fe49 100644 --- a/libbson/1.23.5/bson_as_relaxed_extended_json.html +++ b/libbson/1.23.5/bson_as_relaxed_extended_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_ascii_strtoll.html b/libbson/1.23.5/bson_ascii_strtoll.html index ef2034ce83176e496aedd4f11e6804192da2d6e8..a77c9802f34389a3155c8cc6a7b2109063579aae 100644 --- a/libbson/1.23.5/bson_ascii_strtoll.html +++ b/libbson/1.23.5/bson_ascii_strtoll.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_check_version.html b/libbson/1.23.5/bson_check_version.html index f44d26121db04a683967079769754b8d44037eed..292260777dde5d84ce987d3ad23631c80dd3f3e1 100644 --- a/libbson/1.23.5/bson_check_version.html +++ b/libbson/1.23.5/bson_check_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_compare.html b/libbson/1.23.5/bson_compare.html index 469f39e9b4ab5b330b6283657fa6e4f28661aa3a..5afa711109a759d317b1b8d4da40860be1396831 100644 --- a/libbson/1.23.5/bson_compare.html +++ b/libbson/1.23.5/bson_compare.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_concat.html b/libbson/1.23.5/bson_concat.html index 41c332f7008b22deaa251aca8680a3b153340492..a94d95202111be0997a939e49851af6b88fc08be 100644 --- a/libbson/1.23.5/bson_concat.html +++ b/libbson/1.23.5/bson_concat.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_context_destroy.html b/libbson/1.23.5/bson_context_destroy.html index c373ec8b33f07c62be850690359054d9fbc0b7b3..37d7fdd4a081a43b78c0b6f32aa156892307954b 100644 --- a/libbson/1.23.5/bson_context_destroy.html +++ b/libbson/1.23.5/bson_context_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_context_get_default.html b/libbson/1.23.5/bson_context_get_default.html index f531fe8b85fe52a7fda9743f6f9c3a22869fe485..4ed6d668d392e519a7ad83edda7716e3b230d226 100644 --- a/libbson/1.23.5/bson_context_get_default.html +++ b/libbson/1.23.5/bson_context_get_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_context_new.html b/libbson/1.23.5/bson_context_new.html index 21c4d8511eead2762d69c062ce3d24e7010cd35b..e95f690e429b41d4ad0cfd18a77fe7ee3723525a 100644 --- a/libbson/1.23.5/bson_context_new.html +++ b/libbson/1.23.5/bson_context_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_context_t.html b/libbson/1.23.5/bson_context_t.html index 890c8c949ec15f78dbc9d3a0555ec96f3b6dcc89..9656e7040a730a40a2bd8e255e2885d8a7eb073c 100644 --- a/libbson/1.23.5/bson_context_t.html +++ b/libbson/1.23.5/bson_context_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_copy.html b/libbson/1.23.5/bson_copy.html index 9de37e77d0b0da1fbe29c3963ebae8714dd62697..83df850bded39706334e86a54fdac655b1fa9a83 100644 --- a/libbson/1.23.5/bson_copy.html +++ b/libbson/1.23.5/bson_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_copy_to.html b/libbson/1.23.5/bson_copy_to.html index 781ad0ed9786cf4e14ef2cca39badbc8f58b77cd..cb0d40a9e08c77e00d5cbd3dbd156261b03428c3 100644 --- a/libbson/1.23.5/bson_copy_to.html +++ b/libbson/1.23.5/bson_copy_to.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_copy_to_excluding.html b/libbson/1.23.5/bson_copy_to_excluding.html index c91c16c35328f9ce7cc4ed2829b764f8c685d7f6..c177fb522b5635db3aada081576500d34a8dea75 100644 --- a/libbson/1.23.5/bson_copy_to_excluding.html +++ b/libbson/1.23.5/bson_copy_to_excluding.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_copy_to_excluding_noinit.html b/libbson/1.23.5/bson_copy_to_excluding_noinit.html index e5e3371e67008618f23919a40b06a123faa0cb74..e90b0adcf769ccaf5f955cb7da484dca546afc11 100644 --- a/libbson/1.23.5/bson_copy_to_excluding_noinit.html +++ b/libbson/1.23.5/bson_copy_to_excluding_noinit.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_copy_to_excluding_noinit_va.html b/libbson/1.23.5/bson_copy_to_excluding_noinit_va.html index 7c450a975201b6656da6d75022c66236e569daa4..a022c4d8752aa71317be6f7a9e017274520f93ae 100644 --- a/libbson/1.23.5/bson_copy_to_excluding_noinit_va.html +++ b/libbson/1.23.5/bson_copy_to_excluding_noinit_va.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_count_keys.html b/libbson/1.23.5/bson_count_keys.html index 048c9e437a1fd3d569251d0a7537632bc343800e..e5716b5a62087989785e7aca1f23e0d92f73f7ad 100644 --- a/libbson/1.23.5/bson_count_keys.html +++ b/libbson/1.23.5/bson_count_keys.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_decimal128_from_string.html b/libbson/1.23.5/bson_decimal128_from_string.html index 3315e45104aa12732b095c19a8c6bc54d9033965..95a8d309d3b5571c20386d682785f3bd3dc60be0 100644 --- a/libbson/1.23.5/bson_decimal128_from_string.html +++ b/libbson/1.23.5/bson_decimal128_from_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_decimal128_from_string_w_len.html b/libbson/1.23.5/bson_decimal128_from_string_w_len.html index 3c8b4a844606d8951528ee7eb496ae3c78bf8cd6..9c92719a571b0726c51f41bff4e7c000db389c48 100644 --- a/libbson/1.23.5/bson_decimal128_from_string_w_len.html +++ b/libbson/1.23.5/bson_decimal128_from_string_w_len.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_decimal128_t.html b/libbson/1.23.5/bson_decimal128_t.html index 716875a0b3fa653205ea0efd0198d4de1d01e02a..ec3a959173898e9f16f1cfcfdef2f629734ac224 100644 --- a/libbson/1.23.5/bson_decimal128_t.html +++ b/libbson/1.23.5/bson_decimal128_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_decimal128_to_string.html b/libbson/1.23.5/bson_decimal128_to_string.html index 93275e1a2f52fc6230398355ebfd755a08d6af1f..72f5c589c2d3ac98d58155cd1ffdcdb33b610bb9 100644 --- a/libbson/1.23.5/bson_decimal128_to_string.html +++ b/libbson/1.23.5/bson_decimal128_to_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_destroy.html b/libbson/1.23.5/bson_destroy.html index 30a9aa26348168bf328b419e4cd40ec35209c4d0..35c0d2ef56b30dd889a59d603a6d3b4a6dc58cf2 100644 --- a/libbson/1.23.5/bson_destroy.html +++ b/libbson/1.23.5/bson_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_destroy_with_steal.html b/libbson/1.23.5/bson_destroy_with_steal.html index 7364fceaa64323c36ea1f782188aedcbb36dc3a5..5e7b1c767512026d467b739d8a8bd173dbe07319 100644 --- a/libbson/1.23.5/bson_destroy_with_steal.html +++ b/libbson/1.23.5/bson_destroy_with_steal.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_equal.html b/libbson/1.23.5/bson_equal.html index 63311e56644573bd653c551c55bed5273b719f1f..4d00892a14d21c42d2e6ad56f2fdabce62e55978 100644 --- a/libbson/1.23.5/bson_equal.html +++ b/libbson/1.23.5/bson_equal.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_error_t.html b/libbson/1.23.5/bson_error_t.html index 51d3589410a7fc60eaa100a789ce365cb535e8a9..42b239b56d771ddbd3b5ceceb86bcc1b0e77c2f4 100644 --- a/libbson/1.23.5/bson_error_t.html +++ b/libbson/1.23.5/bson_error_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_free.html b/libbson/1.23.5/bson_free.html index 5a41b53028e62cc7081c21b80d26ae23420a896e..111baecbcabbf166a61e54a2ebca9eb23cdb5a73 100644 --- a/libbson/1.23.5/bson_free.html +++ b/libbson/1.23.5/bson_free.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_get_data.html b/libbson/1.23.5/bson_get_data.html index 4c245ab40bb647f6512bdeb72cebaa8506e73d28..b93a1f448e926043fa6018e8d4753529c087dbd9 100644 --- a/libbson/1.23.5/bson_get_data.html +++ b/libbson/1.23.5/bson_get_data.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_get_major_version.html b/libbson/1.23.5/bson_get_major_version.html index a2fb80d646efe1f9d7e0d4884e964bc7ebdd8646..9d35f905872381b7c73188a1a7ceaa4f6e3f784b 100644 --- a/libbson/1.23.5/bson_get_major_version.html +++ b/libbson/1.23.5/bson_get_major_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_get_micro_version.html b/libbson/1.23.5/bson_get_micro_version.html index b3ce663e1ef8c5fb7a96236ccf14b66643745d86..fc300f0f13f16d72123861c2ededddb3dd04cd43 100644 --- a/libbson/1.23.5/bson_get_micro_version.html +++ b/libbson/1.23.5/bson_get_micro_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_get_minor_version.html b/libbson/1.23.5/bson_get_minor_version.html index fd13b647b9d54c7e7396a8f8053e1c7edcab6a52..8d0e63b7b3bce5e805df0fd566978a57fd3de05e 100644 --- a/libbson/1.23.5/bson_get_minor_version.html +++ b/libbson/1.23.5/bson_get_minor_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_get_monotonic_time.html b/libbson/1.23.5/bson_get_monotonic_time.html index 70ebd9a0759aeca2f6c8a4b85251e033821678f4..76e77954375a5f2129189f7a5325204e60727138 100644 --- a/libbson/1.23.5/bson_get_monotonic_time.html +++ b/libbson/1.23.5/bson_get_monotonic_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_get_version.html b/libbson/1.23.5/bson_get_version.html index 9cb68f6bffa3ba028472f6baf8f7e183e85950ab..a1874e4b640934b9436e7b2339bcdad3c1e48714 100644 --- a/libbson/1.23.5/bson_get_version.html +++ b/libbson/1.23.5/bson_get_version.html @@ -39,6 +39,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_has_field.html b/libbson/1.23.5/bson_has_field.html index 670e727b189385d2b1e0447ffacda1f88cea441e..e4eb6047b3e02f0585404fff347d00212495426d 100644 --- a/libbson/1.23.5/bson_has_field.html +++ b/libbson/1.23.5/bson_has_field.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_init.html b/libbson/1.23.5/bson_init.html index 4aa95f1fe1839b6225387c9458483ca10c10aaed..c84d9caac81f189ff53989aa7674a215941860b9 100644 --- a/libbson/1.23.5/bson_init.html +++ b/libbson/1.23.5/bson_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_init_from_json.html b/libbson/1.23.5/bson_init_from_json.html index 3368bddd4e3efa650c3eb985b26e369ba72d7d5e..6dd80f4ea89c2842c4839ab52221bcdf5ad45452 100644 --- a/libbson/1.23.5/bson_init_from_json.html +++ b/libbson/1.23.5/bson_init_from_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_init_static.html b/libbson/1.23.5/bson_init_static.html index e39a56576c666215531dca46ac15e7aff45c7494..25015123dc5b6f2861556ba991ae7614a1465b47 100644 --- a/libbson/1.23.5/bson_init_static.html +++ b/libbson/1.23.5/bson_init_static.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_isspace.html b/libbson/1.23.5/bson_isspace.html index 2bf27008be499869dc14de9cfc0c15d70f862842..72633905a0c62296755be579ec1651fe49941144 100644 --- a/libbson/1.23.5/bson_isspace.html +++ b/libbson/1.23.5/bson_isspace.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_array.html b/libbson/1.23.5/bson_iter_array.html index 8cc31c32801adf25169dec47873fea1e13a3740f..1702f33894d8c515032d614c80b0cae390f4ed96 100644 --- a/libbson/1.23.5/bson_iter_array.html +++ b/libbson/1.23.5/bson_iter_array.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_as_bool.html b/libbson/1.23.5/bson_iter_as_bool.html index ddd3966ed7ab96b28467d16496dc1d8f53f1e378..1af5353387e08bcb80b2a895ef2c6301b8a7f31f 100644 --- a/libbson/1.23.5/bson_iter_as_bool.html +++ b/libbson/1.23.5/bson_iter_as_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_as_double.html b/libbson/1.23.5/bson_iter_as_double.html index a989f45f835f2bef5a7504b83eef6e803cea3975..ba36da85545db4c276009c5bd367bd9d671ea81b 100644 --- a/libbson/1.23.5/bson_iter_as_double.html +++ b/libbson/1.23.5/bson_iter_as_double.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_as_int64.html b/libbson/1.23.5/bson_iter_as_int64.html index 85943846fcfd3f6d0a770be066ef488bb5e97f24..792a30d6a38949091c7b3694ffcefa870bdd67fc 100644 --- a/libbson/1.23.5/bson_iter_as_int64.html +++ b/libbson/1.23.5/bson_iter_as_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_binary.html b/libbson/1.23.5/bson_iter_binary.html index 3999ddea89b7c317273cd2350acd0c5596f942ac..5c5e1f6c86a4cca0e172763716c5db56c848ff2d 100644 --- a/libbson/1.23.5/bson_iter_binary.html +++ b/libbson/1.23.5/bson_iter_binary.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_bool.html b/libbson/1.23.5/bson_iter_bool.html index e108ab192244a99e4793e4964df68739a77db587..8b0b178c884ca0c63fa706e64d0c88673d76feed 100644 --- a/libbson/1.23.5/bson_iter_bool.html +++ b/libbson/1.23.5/bson_iter_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_code.html b/libbson/1.23.5/bson_iter_code.html index 1848795285909bfdf8baf4dafc996c360a8e4063..07462910facc2a98999a23b5a0876414b8ba8bd4 100644 --- a/libbson/1.23.5/bson_iter_code.html +++ b/libbson/1.23.5/bson_iter_code.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_codewscope.html b/libbson/1.23.5/bson_iter_codewscope.html index 91849c1eab01099cf063d674c8f7ea662a2c2a9c..701364157107348fa227ca6290d17a909dbee2d9 100644 --- a/libbson/1.23.5/bson_iter_codewscope.html +++ b/libbson/1.23.5/bson_iter_codewscope.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_date_time.html b/libbson/1.23.5/bson_iter_date_time.html index 135f363b6a9aeec1012aa3d8758fc367e0eb8a5e..577bafcb69e0b28de8072f4567a4bcc93da010c4 100644 --- a/libbson/1.23.5/bson_iter_date_time.html +++ b/libbson/1.23.5/bson_iter_date_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_dbpointer.html b/libbson/1.23.5/bson_iter_dbpointer.html index 38570297606587c06ab20e4044c57a5bcd060540..6ec341b21dea7294a48ad36be8d62a61b9008baa 100644 --- a/libbson/1.23.5/bson_iter_dbpointer.html +++ b/libbson/1.23.5/bson_iter_dbpointer.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_decimal128.html b/libbson/1.23.5/bson_iter_decimal128.html index f45f9937374e6229f6c3dd262e87268d3060aba1..ebd9b884f997918ed5839d7dcdac7f270088a232 100644 --- a/libbson/1.23.5/bson_iter_decimal128.html +++ b/libbson/1.23.5/bson_iter_decimal128.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_document.html b/libbson/1.23.5/bson_iter_document.html index 1aeb85f9696b931db370531d6cf6f69b0a7b2a70..3e4189597e36c132d81c81171af5edb0e0f8b8bd 100644 --- a/libbson/1.23.5/bson_iter_document.html +++ b/libbson/1.23.5/bson_iter_document.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_double.html b/libbson/1.23.5/bson_iter_double.html index 9d8af6fac751ef3a434a6c487a6bc98cbec4f778..c087f480339219fe4d6cc3a91f1e7a7a164dd217 100644 --- a/libbson/1.23.5/bson_iter_double.html +++ b/libbson/1.23.5/bson_iter_double.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_dup_utf8.html b/libbson/1.23.5/bson_iter_dup_utf8.html index e88f30191c2088e2c701cefacd19efb103ca7355..076c66f97099814f011404600c87371ae53dbffe 100644 --- a/libbson/1.23.5/bson_iter_dup_utf8.html +++ b/libbson/1.23.5/bson_iter_dup_utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_find.html b/libbson/1.23.5/bson_iter_find.html index 82892f548428ac31781fe70eb7a5c1e12a8a46c3..0b311233bedacf2251b3fe2998ae6398270074b1 100644 --- a/libbson/1.23.5/bson_iter_find.html +++ b/libbson/1.23.5/bson_iter_find.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_find_case.html b/libbson/1.23.5/bson_iter_find_case.html index ccd137f3fc96caab61c4c9c51cb7d3ce62917413..668111b71c2e028a19ee959db5bc6675e14b4d39 100644 --- a/libbson/1.23.5/bson_iter_find_case.html +++ b/libbson/1.23.5/bson_iter_find_case.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_find_descendant.html b/libbson/1.23.5/bson_iter_find_descendant.html index ea12679732b44ae296d48bff041b6c3fe7b47600..5b0a85afbf1023a489f3acb4552608479bfb630c 100644 --- a/libbson/1.23.5/bson_iter_find_descendant.html +++ b/libbson/1.23.5/bson_iter_find_descendant.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_find_w_len.html b/libbson/1.23.5/bson_iter_find_w_len.html index c9beb385427e7201c7b648791df09182b13bbe5f..71fd5b02ffda94fd2c399372085c864b0d9f347d 100644 --- a/libbson/1.23.5/bson_iter_find_w_len.html +++ b/libbson/1.23.5/bson_iter_find_w_len.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_init.html b/libbson/1.23.5/bson_iter_init.html index 411ff877826590afa807ba8a9f05be79bb7171f6..ef258a277e026126640ef573d303d081d69540dd 100644 --- a/libbson/1.23.5/bson_iter_init.html +++ b/libbson/1.23.5/bson_iter_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_init_find.html b/libbson/1.23.5/bson_iter_init_find.html index 6ec134675dd5a39caba0ce112c0e8486427808fb..a5ffbaf7d44ef6dfe74d3687615616c6a737b4fd 100644 --- a/libbson/1.23.5/bson_iter_init_find.html +++ b/libbson/1.23.5/bson_iter_init_find.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_init_find_case.html b/libbson/1.23.5/bson_iter_init_find_case.html index 82a3669c7b21b9c9c6cb38e2af73e7f20f4c555d..5f9cc2931bdcd8a5131baea31caf03d004bacaa6 100644 --- a/libbson/1.23.5/bson_iter_init_find_case.html +++ b/libbson/1.23.5/bson_iter_init_find_case.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_init_find_w_len.html b/libbson/1.23.5/bson_iter_init_find_w_len.html index ca268b2e25441281fdd6e271b1d2691a08eea2f0..230d87b1cc28d1016494fddd6292a52a606ec251 100644 --- a/libbson/1.23.5/bson_iter_init_find_w_len.html +++ b/libbson/1.23.5/bson_iter_init_find_w_len.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_init_from_data.html b/libbson/1.23.5/bson_iter_init_from_data.html index 24aada734ef325b08e2fc1336aa0910a73a5593a..4b164c50e41aa31636358a8b9daa8d3407ee29e8 100644 --- a/libbson/1.23.5/bson_iter_init_from_data.html +++ b/libbson/1.23.5/bson_iter_init_from_data.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_init_from_data_at_offset.html b/libbson/1.23.5/bson_iter_init_from_data_at_offset.html index 5b72b7a718e21923049fe131b2a5cf243f55ab93..4022a696a5258d6a530fc456ec44e704d16e8c3c 100644 --- a/libbson/1.23.5/bson_iter_init_from_data_at_offset.html +++ b/libbson/1.23.5/bson_iter_init_from_data_at_offset.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_int32.html b/libbson/1.23.5/bson_iter_int32.html index c370af463d53d73e710861ed84c87acb1c0f08cc..025c7f8a9d7fdbc6507a7e54e99dad6d7eff6ad9 100644 --- a/libbson/1.23.5/bson_iter_int32.html +++ b/libbson/1.23.5/bson_iter_int32.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_int64.html b/libbson/1.23.5/bson_iter_int64.html index d61e0ec7ffeddbad1885d9ceb50a4d049ba717f3..e760c58d1b45cbd297c5a8f7109bfe74377434f6 100644 --- a/libbson/1.23.5/bson_iter_int64.html +++ b/libbson/1.23.5/bson_iter_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_key.html b/libbson/1.23.5/bson_iter_key.html index 57b6bc1edbbd07dba9c507bbfda3ae99274fdbfd..5468188b7cc83846a1040e30ab0985bc62c7b542 100644 --- a/libbson/1.23.5/bson_iter_key.html +++ b/libbson/1.23.5/bson_iter_key.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_key_len.html b/libbson/1.23.5/bson_iter_key_len.html index 54185a61f5c9f4cd66f1f218c055be7394ac3142..090bf4b112238cf952a1fbeb4dea0317eec063aa 100644 --- a/libbson/1.23.5/bson_iter_key_len.html +++ b/libbson/1.23.5/bson_iter_key_len.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_next.html b/libbson/1.23.5/bson_iter_next.html index e102df138bd1888fa80e9b1475a9d0e5284e73f8..70bea572a6872a87989a588c6433946b491a46c8 100644 --- a/libbson/1.23.5/bson_iter_next.html +++ b/libbson/1.23.5/bson_iter_next.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_offset.html b/libbson/1.23.5/bson_iter_offset.html index a3e5afdf44b26a347d05db1edaf30e47a6a9c240..a36b8e9b64857a4bf7f635e6369313dfe144c385 100644 --- a/libbson/1.23.5/bson_iter_offset.html +++ b/libbson/1.23.5/bson_iter_offset.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_oid.html b/libbson/1.23.5/bson_iter_oid.html index e0e49eb9dafcdfbeabe6193f76b959a6214b4d4d..745e84518af1570de9deb2ae6135cf4be4672a96 100644 --- a/libbson/1.23.5/bson_iter_oid.html +++ b/libbson/1.23.5/bson_iter_oid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_bool.html b/libbson/1.23.5/bson_iter_overwrite_bool.html index d125fb576dcbd34a07faee34b7fe50b1d3e228d0..f41a57534d6137b60f78a434d3e16064450a7f55 100644 --- a/libbson/1.23.5/bson_iter_overwrite_bool.html +++ b/libbson/1.23.5/bson_iter_overwrite_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_date_time.html b/libbson/1.23.5/bson_iter_overwrite_date_time.html index 91fcbcbdd036776113792ba5db01410aa2e51ac6..963f26fbdbaabb3e568c76261997d0e5eb72d6c7 100644 --- a/libbson/1.23.5/bson_iter_overwrite_date_time.html +++ b/libbson/1.23.5/bson_iter_overwrite_date_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_decimal128.html b/libbson/1.23.5/bson_iter_overwrite_decimal128.html index 62884564e2d16dbc509d04153a117554173c0abe..919d2bfe9c910b411d5be1f3f3b0e0386c1c2ccf 100644 --- a/libbson/1.23.5/bson_iter_overwrite_decimal128.html +++ b/libbson/1.23.5/bson_iter_overwrite_decimal128.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_double.html b/libbson/1.23.5/bson_iter_overwrite_double.html index 29f1e4e903741824841e23f3db12310d92acbf9f..6b344cc57a8fac0a90f8376136284cefb25be99a 100644 --- a/libbson/1.23.5/bson_iter_overwrite_double.html +++ b/libbson/1.23.5/bson_iter_overwrite_double.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_int32.html b/libbson/1.23.5/bson_iter_overwrite_int32.html index 82b732acd5688afc8442ca81beee6fef9654b00c..d575f514df32795f88f07702904e5d39425e1f59 100644 --- a/libbson/1.23.5/bson_iter_overwrite_int32.html +++ b/libbson/1.23.5/bson_iter_overwrite_int32.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_int64.html b/libbson/1.23.5/bson_iter_overwrite_int64.html index 4124d0f3822e9f877ad8a1d94b2e2ab46bd3ce6f..fcf326e0c4d4b010e63af14517f6fff44732cba6 100644 --- a/libbson/1.23.5/bson_iter_overwrite_int64.html +++ b/libbson/1.23.5/bson_iter_overwrite_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_oid.html b/libbson/1.23.5/bson_iter_overwrite_oid.html index 8c7a88815d93a06f06e7dc351c6b9429d0f4bf8c..5192c5124886370e0845460fefc01eae94e438d1 100644 --- a/libbson/1.23.5/bson_iter_overwrite_oid.html +++ b/libbson/1.23.5/bson_iter_overwrite_oid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_overwrite_timestamp.html b/libbson/1.23.5/bson_iter_overwrite_timestamp.html index ebb72548401a3b36afafe75989523a652e39fa42..189c4b1f601b21caafd6260058886d225b0ffc11 100644 --- a/libbson/1.23.5/bson_iter_overwrite_timestamp.html +++ b/libbson/1.23.5/bson_iter_overwrite_timestamp.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_recurse.html b/libbson/1.23.5/bson_iter_recurse.html index feb49637c28ce10085305c855b3d1f2c3c731e51..55d98090d762bdfd730e1299a8e1722b302ff229 100644 --- a/libbson/1.23.5/bson_iter_recurse.html +++ b/libbson/1.23.5/bson_iter_recurse.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_regex.html b/libbson/1.23.5/bson_iter_regex.html index 7567d3c0288fee7088ba70063526b644c62dbedd..ab04f996c42a050150cdef301215ad2ab521e644 100644 --- a/libbson/1.23.5/bson_iter_regex.html +++ b/libbson/1.23.5/bson_iter_regex.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_symbol.html b/libbson/1.23.5/bson_iter_symbol.html index f430f54ddddead4f357d9c60b98c5c124414a904..5bc8560dcb881df08bf96d247d5776f0ebcd5c43 100644 --- a/libbson/1.23.5/bson_iter_symbol.html +++ b/libbson/1.23.5/bson_iter_symbol.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_t.html b/libbson/1.23.5/bson_iter_t.html index f9808931fec08932024f026502cd0c1708a5b31c..8ea5f52b6d2685e673dd4064f4bf9925725ec3f6 100644 --- a/libbson/1.23.5/bson_iter_t.html +++ b/libbson/1.23.5/bson_iter_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_time_t.html b/libbson/1.23.5/bson_iter_time_t.html index 1a82933e11918da7453848eaf188ec8b2022e3b8..9ea9a0751b0ba4fc505da377ce5d36c60aa7c67f 100644 --- a/libbson/1.23.5/bson_iter_time_t.html +++ b/libbson/1.23.5/bson_iter_time_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_timestamp.html b/libbson/1.23.5/bson_iter_timestamp.html index eb70a3dc807192773c7638dd1a9ebef55ba7e0f9..2648da2c08e0f1f82981779a4eff3ba42a002b14 100644 --- a/libbson/1.23.5/bson_iter_timestamp.html +++ b/libbson/1.23.5/bson_iter_timestamp.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_timeval.html b/libbson/1.23.5/bson_iter_timeval.html index c597a3651b75e77a8e4d2ec729b76e2f1f9f5dc7..100e711d564881bd8efe2ea85950d98e8577bd7f 100644 --- a/libbson/1.23.5/bson_iter_timeval.html +++ b/libbson/1.23.5/bson_iter_timeval.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_type.html b/libbson/1.23.5/bson_iter_type.html index f1fbcd67367f77369d084365072675a050d3a460..4440572b7225821a66d3489a47e826a30f4f1b3f 100644 --- a/libbson/1.23.5/bson_iter_type.html +++ b/libbson/1.23.5/bson_iter_type.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_utf8.html b/libbson/1.23.5/bson_iter_utf8.html index 022fcd225ab27985a835b6423481deaef3e354a3..a4e389a7a5b2e4bf449f22970f99a6c060f2c55c 100644 --- a/libbson/1.23.5/bson_iter_utf8.html +++ b/libbson/1.23.5/bson_iter_utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_value.html b/libbson/1.23.5/bson_iter_value.html index 2db8908bb54ae793713d2b0f2def446c52e01e42..6bcc5dc5b7bbb7e3069dcf5b74b33b61ec90a5ab 100644 --- a/libbson/1.23.5/bson_iter_value.html +++ b/libbson/1.23.5/bson_iter_value.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_iter_visit_all.html b/libbson/1.23.5/bson_iter_visit_all.html index b4883cfc2f058e82ceb41fddb2a4764db14a1dd1..bcb052e760df2de10c0deac2e25942ea7b3f0217 100644 --- a/libbson/1.23.5/bson_iter_visit_all.html +++ b/libbson/1.23.5/bson_iter_visit_all.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_data_reader_ingest.html b/libbson/1.23.5/bson_json_data_reader_ingest.html index bc0a8baf449b394e74adaffdce764d280c6aa3ed..44a2d15e8979c21079af929f4eeb753a9ef779d4 100644 --- a/libbson/1.23.5/bson_json_data_reader_ingest.html +++ b/libbson/1.23.5/bson_json_data_reader_ingest.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_data_reader_new.html b/libbson/1.23.5/bson_json_data_reader_new.html index 1155f1953272c388ebfcf7ae2e23e2192844e60c..767241f9f0b0c8a2f8eb2bab2284fe05951b9dab 100644 --- a/libbson/1.23.5/bson_json_data_reader_new.html +++ b/libbson/1.23.5/bson_json_data_reader_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_mode_t.html b/libbson/1.23.5/bson_json_mode_t.html index 27293f8e40b08e17342b94f74c09d49b96d75a60..089a99d61cfc6380723a4ee6d184c0a99f053285 100644 --- a/libbson/1.23.5/bson_json_mode_t.html +++ b/libbson/1.23.5/bson_json_mode_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_opts_destroy.html b/libbson/1.23.5/bson_json_opts_destroy.html index 6c795dd603ae27570e991b827c608b79edd80d05..a2ff0448122060538c9dda8b591da7238fdd2242 100644 --- a/libbson/1.23.5/bson_json_opts_destroy.html +++ b/libbson/1.23.5/bson_json_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_opts_new.html b/libbson/1.23.5/bson_json_opts_new.html index 9df707dda49ac3a925c408022c979086b1899d80..c99df9eb019db711f70a1ddd99026cd9118059a7 100644 --- a/libbson/1.23.5/bson_json_opts_new.html +++ b/libbson/1.23.5/bson_json_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_opts_t.html b/libbson/1.23.5/bson_json_opts_t.html index a23ecb93a05806aba0d77c73b0428f2087e80e22..8dba8fc4245f002a3531435f2f01e09347a45bef 100644 --- a/libbson/1.23.5/bson_json_opts_t.html +++ b/libbson/1.23.5/bson_json_opts_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_reader_destroy.html b/libbson/1.23.5/bson_json_reader_destroy.html index f6b4a93e1acca5d549659dee688a882492bfc968..84482c66e9ed7e755f31626f129cc52734d90397 100644 --- a/libbson/1.23.5/bson_json_reader_destroy.html +++ b/libbson/1.23.5/bson_json_reader_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_reader_new.html b/libbson/1.23.5/bson_json_reader_new.html index dc7eb251f242f0d0696b68cf02526b041793876e..67776dde82e2cb0322df82297dfb7e1b9615e970 100644 --- a/libbson/1.23.5/bson_json_reader_new.html +++ b/libbson/1.23.5/bson_json_reader_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_reader_new_from_fd.html b/libbson/1.23.5/bson_json_reader_new_from_fd.html index 8f4aa754de1ab7b463a30d9bb8cad3a7a797da25..5b2a0ac264fb5b27430e472b6a5747c2f29ec022 100644 --- a/libbson/1.23.5/bson_json_reader_new_from_fd.html +++ b/libbson/1.23.5/bson_json_reader_new_from_fd.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_reader_new_from_file.html b/libbson/1.23.5/bson_json_reader_new_from_file.html index e2077d5c76e92e0fea1dcd0cb7756cac7502a69c..e7b3ca529ce23099d6ef648f68cff6354657db2f 100644 --- a/libbson/1.23.5/bson_json_reader_new_from_file.html +++ b/libbson/1.23.5/bson_json_reader_new_from_file.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_reader_read.html b/libbson/1.23.5/bson_json_reader_read.html index 5f5510c454917aadedc511669e53b381232536bb..a9aa9fbf8f827768d3222571c10d746c871f7668 100644 --- a/libbson/1.23.5/bson_json_reader_read.html +++ b/libbson/1.23.5/bson_json_reader_read.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_json_reader_t.html b/libbson/1.23.5/bson_json_reader_t.html index 966adc29d811b13541b5f466c777aafe9ba8d79c..d2e18273bb0e5b5749a33cdd0c50aa1f0b5eb9d1 100644 --- a/libbson/1.23.5/bson_json_reader_t.html +++ b/libbson/1.23.5/bson_json_reader_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_malloc.html b/libbson/1.23.5/bson_malloc.html index 6deb646a1e31501ca296d1a8a36798a41346d80e..bbdd607d59db4531ae8c1701cd47a62681d19203 100644 --- a/libbson/1.23.5/bson_malloc.html +++ b/libbson/1.23.5/bson_malloc.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_malloc0.html b/libbson/1.23.5/bson_malloc0.html index 48d282890945ddae4041f4beec3e052454965cfb..4ab549c8f83cafaa99cc47f81e98531d58ab6e4d 100644 --- a/libbson/1.23.5/bson_malloc0.html +++ b/libbson/1.23.5/bson_malloc0.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_md5_append.html b/libbson/1.23.5/bson_md5_append.html index 5673615bd91ececc5c2590c5dbda995a9ebd63a4..ca35be947f2c501600f30ee6e4ef7a43b9489ef9 100644 --- a/libbson/1.23.5/bson_md5_append.html +++ b/libbson/1.23.5/bson_md5_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libbson/1.23.5/bson_md5_finish.html b/libbson/1.23.5/bson_md5_finish.html index d88b6b4ed71818dc0bae082cd8e4a37ef87d457b..c2af56c2b0cb1701de0266a6dfa8d230472b00d7 100644 --- a/libbson/1.23.5/bson_md5_finish.html +++ b/libbson/1.23.5/bson_md5_finish.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libbson/1.23.5/bson_md5_init.html b/libbson/1.23.5/bson_md5_init.html index 7b3f50a33109263cd9b033542440102ac4a5f4fe..68354dba4566a135b46884099714ce9f4f971f4f 100644 --- a/libbson/1.23.5/bson_md5_init.html +++ b/libbson/1.23.5/bson_md5_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libbson/1.23.5/bson_md5_t.html b/libbson/1.23.5/bson_md5_t.html index 4e3a6efee257652b25cdecb238a78644715fe79d..94337dcc28b39c45579a76d52c823c5b30b1a1f3 100644 --- a/libbson/1.23.5/bson_md5_t.html +++ b/libbson/1.23.5/bson_md5_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libbson/1.23.5/bson_mem_restore_vtable.html b/libbson/1.23.5/bson_mem_restore_vtable.html index 2825688146999aca04cdfc243f605caf762b7046..870bc73c6add54d6f8833d28034707fc803492c1 100644 --- a/libbson/1.23.5/bson_mem_restore_vtable.html +++ b/libbson/1.23.5/bson_mem_restore_vtable.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_mem_set_vtable.html b/libbson/1.23.5/bson_mem_set_vtable.html index d4371f0bdae6d0e65eaee9d235a2535f56362525..9deda2e8130b12417bd820ee4734a2f97f9b39fe 100644 --- a/libbson/1.23.5/bson_mem_set_vtable.html +++ b/libbson/1.23.5/bson_mem_set_vtable.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_memory.html b/libbson/1.23.5/bson_memory.html index 985f01fa7cb77e100284cbab50b713c4223ead2d..70b2aba25b100046f3f6969da141df8c4675eccc 100644 --- a/libbson/1.23.5/bson_memory.html +++ b/libbson/1.23.5/bson_memory.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_new.html b/libbson/1.23.5/bson_new.html index 35172131691d230e5c2d73afd3d13eea19af1e70..04e7160e94c6652fe963aa604daf01511182f642 100644 --- a/libbson/1.23.5/bson_new.html +++ b/libbson/1.23.5/bson_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_new_from_buffer.html b/libbson/1.23.5/bson_new_from_buffer.html index 808d2ac9bcfb8e7bb1f4c27faa4822a04a65547e..173fcb5adb78da0f25fbf56d7f04d254dca40bf5 100644 --- a/libbson/1.23.5/bson_new_from_buffer.html +++ b/libbson/1.23.5/bson_new_from_buffer.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_new_from_data.html b/libbson/1.23.5/bson_new_from_data.html index 13cfd90dfbe53162f9e02f5e7873981e89772c8b..375b1a26b021f0c3a1e79b1dfa7358dd0fd89c45 100644 --- a/libbson/1.23.5/bson_new_from_data.html +++ b/libbson/1.23.5/bson_new_from_data.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_new_from_json.html b/libbson/1.23.5/bson_new_from_json.html index 36e427d9c3989b005d595a49c88e3b01acd32bbb..41281979dbc6ddd5757902ebb47c90144908ad54 100644 --- a/libbson/1.23.5/bson_new_from_json.html +++ b/libbson/1.23.5/bson_new_from_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_compare.html b/libbson/1.23.5/bson_oid_compare.html index d4e39ae296ae294e9dbe923fdae3a24ca015fc6f..c95ba582fc598485161298a8ffd7c1f764109abd 100644 --- a/libbson/1.23.5/bson_oid_compare.html +++ b/libbson/1.23.5/bson_oid_compare.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_copy.html b/libbson/1.23.5/bson_oid_copy.html index 4af687ca56fef591403761a3d23826359b5a9632..d4382351e0dfc12916045ae0ff01c87fe0fbd8ca 100644 --- a/libbson/1.23.5/bson_oid_copy.html +++ b/libbson/1.23.5/bson_oid_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_equal.html b/libbson/1.23.5/bson_oid_equal.html index a3d333e349e448aea048413505459b0e692eb999..65c6d7f8749dedcc476db4bd6f14d09f61192b47 100644 --- a/libbson/1.23.5/bson_oid_equal.html +++ b/libbson/1.23.5/bson_oid_equal.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_get_time_t.html b/libbson/1.23.5/bson_oid_get_time_t.html index 1f8b0fc6c6166c31e3b2e8e38c1add190e0ea137..03c9e7ed451c12cec1ec0e3cbb4295188f099cd8 100644 --- a/libbson/1.23.5/bson_oid_get_time_t.html +++ b/libbson/1.23.5/bson_oid_get_time_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_hash.html b/libbson/1.23.5/bson_oid_hash.html index 4218326fd079b96c24c0b7548fb4556882e5943e..13fc43f8120269a842b0961b02a1e7017e1e6808 100644 --- a/libbson/1.23.5/bson_oid_hash.html +++ b/libbson/1.23.5/bson_oid_hash.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_init.html b/libbson/1.23.5/bson_oid_init.html index 94d2d00abd73380e9033e050f4fac8e53b1ed390..0ab9f1f0147b4f3757b8cefa3c3d65a9d4830388 100644 --- a/libbson/1.23.5/bson_oid_init.html +++ b/libbson/1.23.5/bson_oid_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_init_from_data.html b/libbson/1.23.5/bson_oid_init_from_data.html index ff16e969c25fba17c0bcdfd419847b62c0956267..4f78176b1a1149d7ccb4f4ab9aa7a166e3ef7c44 100644 --- a/libbson/1.23.5/bson_oid_init_from_data.html +++ b/libbson/1.23.5/bson_oid_init_from_data.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_init_from_string.html b/libbson/1.23.5/bson_oid_init_from_string.html index 2c7ad35a917499661cc2ca8ead0e0a01cf44256e..c67ae8b7379e3406325b4ef79c7754e554756cba 100644 --- a/libbson/1.23.5/bson_oid_init_from_string.html +++ b/libbson/1.23.5/bson_oid_init_from_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_init_sequence.html b/libbson/1.23.5/bson_oid_init_sequence.html index 004f71d029b372fe7f82bb6dd85f8237c223a660..33236a8ac458cd3ee0da0f26ae4ec1aaa3fa94d5 100644 --- a/libbson/1.23.5/bson_oid_init_sequence.html +++ b/libbson/1.23.5/bson_oid_init_sequence.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_is_valid.html b/libbson/1.23.5/bson_oid_is_valid.html index 807e25fb965b3b91098ed7f67a51f59cffaa39e0..aff77b319ca0e1d8d03a456e27b7ce6d4f3ba637 100644 --- a/libbson/1.23.5/bson_oid_is_valid.html +++ b/libbson/1.23.5/bson_oid_is_valid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_t.html b/libbson/1.23.5/bson_oid_t.html index 744cf035f74db2832a825b3469c389b63e8c8838..dc1f8c3c123eee7a14e04885227987f72937c181 100644 --- a/libbson/1.23.5/bson_oid_t.html +++ b/libbson/1.23.5/bson_oid_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_oid_to_string.html b/libbson/1.23.5/bson_oid_to_string.html index 2b51b26f6297204bfa3306869eb3d0788384ae55..6d327197daa4ee1d043d9f704576d9ea56587512 100644 --- a/libbson/1.23.5/bson_oid_to_string.html +++ b/libbson/1.23.5/bson_oid_to_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_destroy.html b/libbson/1.23.5/bson_reader_destroy.html index 8e1ec6bb42eec19a843fff38ab937ce4cfb6e83e..71dabddaa754c4da64c2f1d8e227603d663c82f2 100644 --- a/libbson/1.23.5/bson_reader_destroy.html +++ b/libbson/1.23.5/bson_reader_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_destroy_func_t.html b/libbson/1.23.5/bson_reader_destroy_func_t.html index f7181cb6bbad27fcc2a5f445ece2915fe2d8ca30..c86a7d271733e87698b8d5652a58497c3ad7166d 100644 --- a/libbson/1.23.5/bson_reader_destroy_func_t.html +++ b/libbson/1.23.5/bson_reader_destroy_func_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_new_from_data.html b/libbson/1.23.5/bson_reader_new_from_data.html index d0f8be39c741242538fba072cd419992fbef1d70..45a5202ae2252d37e3b83b6c32d4629119969279 100644 --- a/libbson/1.23.5/bson_reader_new_from_data.html +++ b/libbson/1.23.5/bson_reader_new_from_data.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_new_from_fd.html b/libbson/1.23.5/bson_reader_new_from_fd.html index be1abe4d39e0ebbd53e80129690748a21176d36d..bf8e75ef21554b040fddb7875900fd6c9eb7b350 100644 --- a/libbson/1.23.5/bson_reader_new_from_fd.html +++ b/libbson/1.23.5/bson_reader_new_from_fd.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_new_from_file.html b/libbson/1.23.5/bson_reader_new_from_file.html index 92fbd82916dcfb160f890bc4605f7113b90b5a22..49d9d62e2c8e595c8c5105890e6b47b2dfbb7d05 100644 --- a/libbson/1.23.5/bson_reader_new_from_file.html +++ b/libbson/1.23.5/bson_reader_new_from_file.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_new_from_handle.html b/libbson/1.23.5/bson_reader_new_from_handle.html index d9e51c87fd44b9c24e4f1e9f97af71c379499f54..5e4300a8e2c7116a290aa9bfbbf25330fcb27785 100644 --- a/libbson/1.23.5/bson_reader_new_from_handle.html +++ b/libbson/1.23.5/bson_reader_new_from_handle.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_read.html b/libbson/1.23.5/bson_reader_read.html index 72ab380a0c127fc30d61be3133ca3960dd035245..2e8bcd4e51b0f182f516615fe0f597929f4cae4c 100644 --- a/libbson/1.23.5/bson_reader_read.html +++ b/libbson/1.23.5/bson_reader_read.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_read_func_t.html b/libbson/1.23.5/bson_reader_read_func_t.html index 4dabc48827d5579b741deaba66c9255c555bc6a5..b08831d02db42dd88fcf5cdb4c506ed107bcfca8 100644 --- a/libbson/1.23.5/bson_reader_read_func_t.html +++ b/libbson/1.23.5/bson_reader_read_func_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_reset.html b/libbson/1.23.5/bson_reader_reset.html index 30c94356e0ac60a021c8cf0158a6002e53503871..397be0027b3a1acb5c3a7c9fd14d406cb07ed56d 100644 --- a/libbson/1.23.5/bson_reader_reset.html +++ b/libbson/1.23.5/bson_reader_reset.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_set_destroy_func.html b/libbson/1.23.5/bson_reader_set_destroy_func.html index 648cee2587d61e5f3fe16b2b63c98484f663a655..1eee3fdbb018986f2b01e2b398d4dce9290f2bc7 100644 --- a/libbson/1.23.5/bson_reader_set_destroy_func.html +++ b/libbson/1.23.5/bson_reader_set_destroy_func.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_set_read_func.html b/libbson/1.23.5/bson_reader_set_read_func.html index 49cd60ab91b9dd5080e16c0f27b9aad0d879dc1b..a8b736c904ba520b9148f94bc01c3f44a11bc2ec 100644 --- a/libbson/1.23.5/bson_reader_set_read_func.html +++ b/libbson/1.23.5/bson_reader_set_read_func.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_t.html b/libbson/1.23.5/bson_reader_t.html index 2ae3ee810fd7c9da0a64869588613247da646ba2..2f34dc307ba17da8a0ea5501e14e86051ad57a11 100644 --- a/libbson/1.23.5/bson_reader_t.html +++ b/libbson/1.23.5/bson_reader_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reader_tell.html b/libbson/1.23.5/bson_reader_tell.html index faa9acac27d0552eced75c324b49a529e9db9c40..6a84f9c30c650ff735fa4b042414b1e9db00e228 100644 --- a/libbson/1.23.5/bson_reader_tell.html +++ b/libbson/1.23.5/bson_reader_tell.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_realloc.html b/libbson/1.23.5/bson_realloc.html index 8c76c81df25fffc58fb04931888e57e94ca5bb0f..65884fcc5c20b8b775a1259eea3d60911dcaaf68 100644 --- a/libbson/1.23.5/bson_realloc.html +++ b/libbson/1.23.5/bson_realloc.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_realloc_ctx.html b/libbson/1.23.5/bson_realloc_ctx.html index 7d65e540047a20c969ea3711ce92082a306c75f4..939d50404698fb9eb89b5a646a14e9af359bb0a1 100644 --- a/libbson/1.23.5/bson_realloc_ctx.html +++ b/libbson/1.23.5/bson_realloc_ctx.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_realloc_func.html b/libbson/1.23.5/bson_realloc_func.html index a502b0829009d8446abec3a3f2a52e8b6f737258..b2bba859b77af8d0d374b059889b4e15881e17f0 100644 --- a/libbson/1.23.5/bson_realloc_func.html +++ b/libbson/1.23.5/bson_realloc_func.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reinit.html b/libbson/1.23.5/bson_reinit.html index 06b3f541244b47e3cba06ba1f5bbfacfd177e735..9f966b87efe680c2c0f9930af148b6b1f3edf14f 100644 --- a/libbson/1.23.5/bson_reinit.html +++ b/libbson/1.23.5/bson_reinit.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_reserve_buffer.html b/libbson/1.23.5/bson_reserve_buffer.html index 781e234c924a9f6eb087d485e446a2248a0088ce..e8a7cc17f79468380f7067d98880bf687f4810fe 100644 --- a/libbson/1.23.5/bson_reserve_buffer.html +++ b/libbson/1.23.5/bson_reserve_buffer.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_set_error.html b/libbson/1.23.5/bson_set_error.html index eb87b4cef5fe8447b5058f411cca863d4e61ab41..8400c73098837bcd3bbc4a20db35a1c0cd6e5ce5 100644 --- a/libbson/1.23.5/bson_set_error.html +++ b/libbson/1.23.5/bson_set_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_sized_new.html b/libbson/1.23.5/bson_sized_new.html index 70896c8f464e36667005362d58f4a664f283470b..d75b458b1e3a7ee7fd1bf44359047c711dab7d10 100644 --- a/libbson/1.23.5/bson_sized_new.html +++ b/libbson/1.23.5/bson_sized_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_snprintf.html b/libbson/1.23.5/bson_snprintf.html index ed18b2302f83080a15fbdcb9d12746776ab9edb4..650cb3cc983e5f14e7bd504e7aaef1a6b87b4fd9 100644 --- a/libbson/1.23.5/bson_snprintf.html +++ b/libbson/1.23.5/bson_snprintf.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_steal.html b/libbson/1.23.5/bson_steal.html index 44549538a86cf228aaa2498eaa6947eacb568a16..d0407891f6a601df4f2d6323941001bd73e7417c 100644 --- a/libbson/1.23.5/bson_steal.html +++ b/libbson/1.23.5/bson_steal.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strcasecmp.html b/libbson/1.23.5/bson_strcasecmp.html index f27b202b2897c3f33c8aaaf054dde6906202e970..5dc80382438f309e42b45c8b8fac0781ca6decc2 100644 --- a/libbson/1.23.5/bson_strcasecmp.html +++ b/libbson/1.23.5/bson_strcasecmp.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strdup.html b/libbson/1.23.5/bson_strdup.html index b576fe2d38998f1f600368094fe7abc06cef87f3..beb1fa1a19e0b3d399629a8c25aeb1708b939ac9 100644 --- a/libbson/1.23.5/bson_strdup.html +++ b/libbson/1.23.5/bson_strdup.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strdup_printf.html b/libbson/1.23.5/bson_strdup_printf.html index d12106bd07a6ef7738ff81cf6698075df5de8df3..a6a06665d2160d2ea52e3aab21498aaca47baee6 100644 --- a/libbson/1.23.5/bson_strdup_printf.html +++ b/libbson/1.23.5/bson_strdup_printf.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strdupv_printf.html b/libbson/1.23.5/bson_strdupv_printf.html index 230a1d013e4fccdc8a5f7d7bf61a590fb4bc5c6a..ad9d5a4c18493ce0407c60b46cbcb8e223c45dd3 100644 --- a/libbson/1.23.5/bson_strdupv_printf.html +++ b/libbson/1.23.5/bson_strdupv_printf.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strerror_r.html b/libbson/1.23.5/bson_strerror_r.html index d14f38829283d009ac0ffc3ea83603c5ad5b83ef..d5c97fe1147def24d6f062f60f3ff02275d495ff 100644 --- a/libbson/1.23.5/bson_strerror_r.html +++ b/libbson/1.23.5/bson_strerror_r.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strfreev.html b/libbson/1.23.5/bson_strfreev.html index d7b72b1e3c210461e674debb227f946849e46a9e..467a572fe2534125554638cede807e85963f5e08 100644 --- a/libbson/1.23.5/bson_strfreev.html +++ b/libbson/1.23.5/bson_strfreev.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_append.html b/libbson/1.23.5/bson_string_append.html index 188e0ad169808da9320e728bf2d25b52f7cdc665..e2497db348346b02e5eab67b4fc5f7e15cca65e6 100644 --- a/libbson/1.23.5/bson_string_append.html +++ b/libbson/1.23.5/bson_string_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_append_c.html b/libbson/1.23.5/bson_string_append_c.html index db6a6e9992d7a64663bc621b2f8ebccb6ec8f359..6aa72c2ae3479adfe92d64efb2b6a02e6b9ad5ee 100644 --- a/libbson/1.23.5/bson_string_append_c.html +++ b/libbson/1.23.5/bson_string_append_c.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_append_printf.html b/libbson/1.23.5/bson_string_append_printf.html index 9cb6cbdd91e3c61f499a67b53b6723d963dfd037..1c418f06e46590fa3ba87e86f8a3471afc030696 100644 --- a/libbson/1.23.5/bson_string_append_printf.html +++ b/libbson/1.23.5/bson_string_append_printf.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_append_unichar.html b/libbson/1.23.5/bson_string_append_unichar.html index cd197e4e6f382e0b72ef95a948cd193f8e5cd2bb..35c513ef7c5fa62d5a4c678ffbcc179848237ccf 100644 --- a/libbson/1.23.5/bson_string_append_unichar.html +++ b/libbson/1.23.5/bson_string_append_unichar.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_free.html b/libbson/1.23.5/bson_string_free.html index 3e057a9f17c0a711d57f11e3e4b7fd7e8639f7d9..627a25ac5036802760789453d7049d60e1295d15 100644 --- a/libbson/1.23.5/bson_string_free.html +++ b/libbson/1.23.5/bson_string_free.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_new.html b/libbson/1.23.5/bson_string_new.html index 90894ed6d69d342472a13c2bf36625245954b0ec..a04eae0e62c2c2b3d5c075932a97e61d45d4734a 100644 --- a/libbson/1.23.5/bson_string_new.html +++ b/libbson/1.23.5/bson_string_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_t.html b/libbson/1.23.5/bson_string_t.html index 2094d38406b59c0b75a527d00aade68be538853d..c92980ccabe2fc6ea48d00451ab2e0d87349a752 100644 --- a/libbson/1.23.5/bson_string_t.html +++ b/libbson/1.23.5/bson_string_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_string_truncate.html b/libbson/1.23.5/bson_string_truncate.html index c4b6e1cd0868be458332deb3261aabbd76d43639..ba56ec72d75bb78b31fb0734cb8c924d77235d75 100644 --- a/libbson/1.23.5/bson_string_truncate.html +++ b/libbson/1.23.5/bson_string_truncate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strncpy.html b/libbson/1.23.5/bson_strncpy.html index ed112f48d5d594a7f50e721480b2f5780d181198..47fd51f87be6fcc11dd26cbbcd5c7565ebfd5a91 100644 --- a/libbson/1.23.5/bson_strncpy.html +++ b/libbson/1.23.5/bson_strncpy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strndup.html b/libbson/1.23.5/bson_strndup.html index 9b7578eac714a328ed23a3c364d18594fdac8c3b..4b7f1c00e227c77fbc44de946a186336e7f4577d 100644 --- a/libbson/1.23.5/bson_strndup.html +++ b/libbson/1.23.5/bson_strndup.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_strnlen.html b/libbson/1.23.5/bson_strnlen.html index 048f78fb2869283810b1357f27a2d5334246fd6d..657dbd487de9b921bbd10419f6fc1a87ae2d1e0e 100644 --- a/libbson/1.23.5/bson_strnlen.html +++ b/libbson/1.23.5/bson_strnlen.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_subtype_t.html b/libbson/1.23.5/bson_subtype_t.html index 4f827636cec3d2d40bb1d7ab506decb4986e9005..70cc2fa2d24b52c89399fa9affdecb5f0c01385e 100644 --- a/libbson/1.23.5/bson_subtype_t.html +++ b/libbson/1.23.5/bson_subtype_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_t.html b/libbson/1.23.5/bson_t.html index ea5ecda943e85969016afc036884676dbe1af5f2..2e95fe1169be0cdb73f5ad76656cb5c6c50b19e8 100644 --- a/libbson/1.23.5/bson_t.html +++ b/libbson/1.23.5/bson_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_type_t.html b/libbson/1.23.5/bson_type_t.html index fa7910bc1cd9526e03e1989d8d3d5f56fb68ecb7..d9fefcf697e9d17efbb36ab2d736364975c6e462 100644 --- a/libbson/1.23.5/bson_type_t.html +++ b/libbson/1.23.5/bson_type_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_uint32_to_string.html b/libbson/1.23.5/bson_uint32_to_string.html index 898e8a2648a951bdbaab0e84fbecc10560de321d..1acb7ba0355664c330d04a2159489c87f8c8a2ff 100644 --- a/libbson/1.23.5/bson_uint32_to_string.html +++ b/libbson/1.23.5/bson_uint32_to_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_unichar_t.html b/libbson/1.23.5/bson_unichar_t.html index 235f24f894bc62e9063c4ed680310546b5a6a666..5f638003f7caa2e5db7e4e81ef30082f14683bea 100644 --- a/libbson/1.23.5/bson_unichar_t.html +++ b/libbson/1.23.5/bson_unichar_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_utf8_escape_for_json.html b/libbson/1.23.5/bson_utf8_escape_for_json.html index 78db333c55ec23df8beea851c59d3ed47433ca4b..4649b262a3b22d891de6f2b5273c6825d71ba2bb 100644 --- a/libbson/1.23.5/bson_utf8_escape_for_json.html +++ b/libbson/1.23.5/bson_utf8_escape_for_json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_utf8_from_unichar.html b/libbson/1.23.5/bson_utf8_from_unichar.html index 851710f39694fc8821e48621695463536c489662..ba4d95bcfc0952db7c1689832fe2b5820fb9a2e7 100644 --- a/libbson/1.23.5/bson_utf8_from_unichar.html +++ b/libbson/1.23.5/bson_utf8_from_unichar.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_utf8_get_char.html b/libbson/1.23.5/bson_utf8_get_char.html index da016532b46740b64fb77b169e7a3ab1d31f449f..fb2d91703b0838a933823a03c2be5440c83846d2 100644 --- a/libbson/1.23.5/bson_utf8_get_char.html +++ b/libbson/1.23.5/bson_utf8_get_char.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_utf8_next_char.html b/libbson/1.23.5/bson_utf8_next_char.html index dbf10a68e171aaea6c4b9057bd63b724111222c7..128db0418b529a8b00080d991181a45ecbd35b73 100644 --- a/libbson/1.23.5/bson_utf8_next_char.html +++ b/libbson/1.23.5/bson_utf8_next_char.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_utf8_validate.html b/libbson/1.23.5/bson_utf8_validate.html index 959bbbe5550eca40a9c0ac9a968d665cd20cd9ae..18ff0dc979696edc603d51a4d431d9e76595fad7 100644 --- a/libbson/1.23.5/bson_utf8_validate.html +++ b/libbson/1.23.5/bson_utf8_validate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_validate.html b/libbson/1.23.5/bson_validate.html index 8fdfa24b5e68c370ce5f0eed496bd075048eeb3d..64e7499e852c7137e33585f3fa796111115fd674 100644 --- a/libbson/1.23.5/bson_validate.html +++ b/libbson/1.23.5/bson_validate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_validate_with_error.html b/libbson/1.23.5/bson_validate_with_error.html index cf4a74e12f71a73407e2cf2d913a600c6db3ec73..960a6da553e2efef1858986d3ca85d1518e370b6 100644 --- a/libbson/1.23.5/bson_validate_with_error.html +++ b/libbson/1.23.5/bson_validate_with_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_value_copy.html b/libbson/1.23.5/bson_value_copy.html index 3f64848850b4bbcd9665af62de61c079dcb07118..a59e2f78e7be76a8ad0d820c9104fc710f122ca8 100644 --- a/libbson/1.23.5/bson_value_copy.html +++ b/libbson/1.23.5/bson_value_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_value_destroy.html b/libbson/1.23.5/bson_value_destroy.html index 9e97be1ed289de4e6283491ac17877c6d51cde3b..500391bbca4d5b571f397b4cbb3b66ef77dc3e02 100644 --- a/libbson/1.23.5/bson_value_destroy.html +++ b/libbson/1.23.5/bson_value_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_value_t.html b/libbson/1.23.5/bson_value_t.html index 6dd247af33d62c13a0190d35c8647d958a9a537a..e2c0bab60f65db9189a3e67f87e91f421bc1a909 100644 --- a/libbson/1.23.5/bson_value_t.html +++ b/libbson/1.23.5/bson_value_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_visitor_t.html b/libbson/1.23.5/bson_visitor_t.html index 5e80f950a8408b968c0fccf57fb2c2098c4750e4..095a38fe3d9897aa90d9b3b2137c30d4c703897c 100644 --- a/libbson/1.23.5/bson_visitor_t.html +++ b/libbson/1.23.5/bson_visitor_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_vsnprintf.html b/libbson/1.23.5/bson_vsnprintf.html index ad32f09367028bebca1a2dd245ffd48bb3bdfce3..42e140759b43999b3afab6375d132502f167c3a3 100644 --- a/libbson/1.23.5/bson_vsnprintf.html +++ b/libbson/1.23.5/bson_vsnprintf.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_begin.html b/libbson/1.23.5/bson_writer_begin.html index 9a604c77f0dd00b07c74d05035468e78ebf34f74..7a72efdf628ec9f1f3e2cdc6665e50f1449c6a01 100644 --- a/libbson/1.23.5/bson_writer_begin.html +++ b/libbson/1.23.5/bson_writer_begin.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_destroy.html b/libbson/1.23.5/bson_writer_destroy.html index 288316f26cb362424b7e52388cfbbb36d54df0d5..741cb364c7e218fb6fdcaa14b141631de92b4c1f 100644 --- a/libbson/1.23.5/bson_writer_destroy.html +++ b/libbson/1.23.5/bson_writer_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_end.html b/libbson/1.23.5/bson_writer_end.html index 2a9ea6b73123bcc9e71cf1f30f21ddb9928041b9..0a54d7d8ad1d833f311ceb325466d276c2774500 100644 --- a/libbson/1.23.5/bson_writer_end.html +++ b/libbson/1.23.5/bson_writer_end.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_get_length.html b/libbson/1.23.5/bson_writer_get_length.html index 48f3153f7a4ca7ea3cc8c5500a796372fd2dd719..3ae071bfd25f97a76189eae1cc1e167e4ba81f31 100644 --- a/libbson/1.23.5/bson_writer_get_length.html +++ b/libbson/1.23.5/bson_writer_get_length.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_new.html b/libbson/1.23.5/bson_writer_new.html index 38ae23917bc53a93ad49e7aa9fed250920f65ea8..0f2f3e00fe86a36798677c9488b73a9006a6ab45 100644 --- a/libbson/1.23.5/bson_writer_new.html +++ b/libbson/1.23.5/bson_writer_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_rollback.html b/libbson/1.23.5/bson_writer_rollback.html index c971112e96ab824f6244491028a52c2d21adb415..e354b0ae85afb8b25e2fde08a9257162a5702adf 100644 --- a/libbson/1.23.5/bson_writer_rollback.html +++ b/libbson/1.23.5/bson_writer_rollback.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_writer_t.html b/libbson/1.23.5/bson_writer_t.html index a873375dad6856346978db477b2b21eae305c8b9..f4fa934bc0356e90366d7b0d90feb0c9d38ee896 100644 --- a/libbson/1.23.5/bson_writer_t.html +++ b/libbson/1.23.5/bson_writer_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/bson_zero_free.html b/libbson/1.23.5/bson_zero_free.html index 211e18e6b082d7c85d97c48d18681a22ea66dce9..897e6a67d3c261caa1336279dbe26b0f16848087 100644 --- a/libbson/1.23.5/bson_zero_free.html +++ b/libbson/1.23.5/bson_zero_free.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/character_and_string_routines.html b/libbson/1.23.5/character_and_string_routines.html index cc9c031342b2ef169908699d001463e64251ee31..a8bcea2d73dd818fe964bd1842e4c9d5a5cc33f3 100644 --- a/libbson/1.23.5/character_and_string_routines.html +++ b/libbson/1.23.5/character_and_string_routines.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/creating.html b/libbson/1.23.5/creating.html index be4fc3a1845d96ef677fe1fa4d018423c3b49418..43c33d809bd1b4e2fc5998fff48e94c9542dff73 100644 --- a/libbson/1.23.5/creating.html +++ b/libbson/1.23.5/creating.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/cross-platform-notes.html b/libbson/1.23.5/cross-platform-notes.html index a1ffcd0001870969221b0ac515ecb7b91a162fca..ab7096fe853b3e5d1a63fda4749af094ed095c9b 100644 --- a/libbson/1.23.5/cross-platform-notes.html +++ b/libbson/1.23.5/cross-platform-notes.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/endianness.html b/libbson/1.23.5/endianness.html index a8a19515eb884e257522daa7906c528c841d0b0c..45e863c1e2cbd77f558fa3153a87a8ead411fb75 100644 --- a/libbson/1.23.5/endianness.html +++ b/libbson/1.23.5/endianness.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/errors.html b/libbson/1.23.5/errors.html index 0a29e7c5065f732a090c5ade60a040d230ef52dd..1609aa173b4e6fdb8dd28e3dcbb67e18c28afe15 100644 --- a/libbson/1.23.5/errors.html +++ b/libbson/1.23.5/errors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/full_index.html b/libbson/1.23.5/full_index.html index 3a449a8a39625d7727fe7106dab9dedfb7c7410e..2445224b11a81e545012dd46ea3e75d615319db3 100644 --- a/libbson/1.23.5/full_index.html +++ b/libbson/1.23.5/full_index.html @@ -38,6 +38,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/guides.html b/libbson/1.23.5/guides.html index 4397c673cf3c400cc29fbc920ff0a2581c5ecf2d..ad7128749bb403042e3be01b0251b554fdcb8d84 100644 --- a/libbson/1.23.5/guides.html +++ b/libbson/1.23.5/guides.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/include-and-link.html b/libbson/1.23.5/include-and-link.html index c400b61592b37eac73b44d348916561af670e8c7..8f659eddd83e3a0b1bd789b864e45325386e4c86 100644 --- a/libbson/1.23.5/include-and-link.html +++ b/libbson/1.23.5/include-and-link.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/index.html b/libbson/1.23.5/index.html index c457dd84fb46843ac8be13bbfb013a900f94751e..00d4d133bfbaeb77789628b9d500fcf75447bbab 100644 --- a/libbson/1.23.5/index.html +++ b/libbson/1.23.5/index.html @@ -39,6 +39,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/json.html b/libbson/1.23.5/json.html index 31519174ff068d2c6f1023efdeee639f27361386..65594661a64c69376532b9a23c776a7e7f4dac74 100644 --- a/libbson/1.23.5/json.html +++ b/libbson/1.23.5/json.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/oid.html b/libbson/1.23.5/oid.html index f3c125cbc9c36587fd6bd56dcdbb79c90e07b860..96c2be5bea3ecdaa2e5727d4957e7a278e5cba44 100644 --- a/libbson/1.23.5/oid.html +++ b/libbson/1.23.5/oid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/parsing.html b/libbson/1.23.5/parsing.html index c5be4276a2b6b3985e083e2e8efea395b3e312a6..1ef544ac166dc11e7a28235ee04d27921149c01b 100644 --- a/libbson/1.23.5/parsing.html +++ b/libbson/1.23.5/parsing.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/search.html b/libbson/1.23.5/search.html index f5a58fb98169d7edbc0e2a90a3e22658ba5fad5a..6fb260439e6c0830418afb1e941fd365ed897605 100644 --- a/libbson/1.23.5/search.html +++ b/libbson/1.23.5/search.html @@ -45,6 +45,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/streaming-bson.html b/libbson/1.23.5/streaming-bson.html index 6bb0b7e302b7b499ef80905c6fe2532470375297..ad01f837ad75363048df14ffc7a22d8edb3f769d 100644 --- a/libbson/1.23.5/streaming-bson.html +++ b/libbson/1.23.5/streaming-bson.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/threading.html b/libbson/1.23.5/threading.html index 03baf13d04826841978b98172266e685f03ddf75..e0f22cb257903f645313979572f8371d99ac5f3a 100644 --- a/libbson/1.23.5/threading.html +++ b/libbson/1.23.5/threading.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/tutorial.html b/libbson/1.23.5/tutorial.html index 46fafb896f0cefa409bcde796656bdf6aa32a42e..8664e23b065f968c33394cf5095108681056c75b 100644 --- a/libbson/1.23.5/tutorial.html +++ b/libbson/1.23.5/tutorial.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/utf8.html b/libbson/1.23.5/utf8.html index f3ff13fbafea2dfab98cdf55fb8fae9e5e651de2..1afe36c8794843cc6587c91b7c46b0d649586f81 100644 --- a/libbson/1.23.5/utf8.html +++ b/libbson/1.23.5/utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.23.5/valgrind.html b/libbson/1.23.5/valgrind.html index 76d234c1e631303ec507c89981efce94e01ad71d..e71e3dfe9ce525b234791fd05ca845a339dd60f8 100644 --- a/libbson/1.23.5/valgrind.html +++ b/libbson/1.23.5/valgrind.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libbson/1.23.5/version.html b/libbson/1.23.5/version.html index e890bef98cd0ba509d80c8c7021cd61b049919c5..3e1525bc7e3bca882bb9259521aa382ef2253a48 100644 --- a/libbson/1.23.5/version.html +++ b/libbson/1.23.5/version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.0/.nojekyll b/libbson/1.24.0/.nojekyll new file mode 100644 index 0000000000000000000000000000000000000000..19102815663d23f8b75a47e7a01965dcdc96468c --- /dev/null +++ b/libbson/1.24.0/.nojekyll @@ -0,0 +1 @@ +foo \ No newline at end of file diff --git a/libbson/1.24.0/CMakeLists.txt b/libbson/1.24.0/CMakeLists.txt new file mode 100644 index 0000000000000000000000000000000000000000..447d8c0657362ef7a10a17e4e5cfc7f650c6c3a4 --- /dev/null +++ b/libbson/1.24.0/CMakeLists.txt @@ -0,0 +1,31 @@ +# Additional generated static files +extra_dist_generated ( + .nojekyll + objects.inv + _static/ajax-loader.gif + _static/basic.css + _static/comment-bright.png + _static/comment-close.png + _static/comment.png + _static/doctools.js + _static/documentation_options.js + _static/down-pressed.png + _static/down.png + _static/file.png + _static/jquery.js + _static/minus.png + _static/plus.png + _static/pygments.css + _static/readable.css + _static/searchtools.js + _static/underscore.js + _static/up-pressed.png + _static/up.png + _static/websupport.js + search.html + searchindex.js +) + +set_dist_list (src_libbson_doc_html_DIST + CMakeLists.txt +) diff --git a/libbson/1.24.0/_static/ajax-loader.gif b/libbson/1.24.0/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 Binary files /dev/null and b/libbson/1.24.0/_static/ajax-loader.gif differ diff --git a/libbson/1.24.0/_static/basic.css b/libbson/1.24.0/_static/basic.css new file mode 100644 index 0000000000000000000000000000000000000000..19ced1057aebf39d3dac6f6a5d864491231a3e33 --- /dev/null +++ b/libbson/1.24.0/_static/basic.css @@ -0,0 +1,665 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 450px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +div.code-block-caption { + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +div.code-block-caption + div > div.highlight > pre { + margin-top: 0; +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + padding: 1em 1em 0; +} + +div.literal-block-wrapper div.highlight { + margin: 0; +} + +code.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +code.descclassname { + background-color: transparent; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: relative; + left: 0px; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/libbson/1.24.0/_static/comment-bright.png b/libbson/1.24.0/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..15e27edb12ac25701ac0ac21b97b52bb4e45415e Binary files /dev/null and b/libbson/1.24.0/_static/comment-bright.png differ diff --git a/libbson/1.24.0/_static/comment-close.png b/libbson/1.24.0/_static/comment-close.png new file mode 100644 index 0000000000000000000000000000000000000000..4d91bcf57de866a901a89a2a68c0f36af1114841 Binary files /dev/null and b/libbson/1.24.0/_static/comment-close.png differ diff --git a/libbson/1.24.0/_static/comment.png b/libbson/1.24.0/_static/comment.png new file mode 100644 index 0000000000000000000000000000000000000000..dfbc0cbd512bdeefcb1984c99d8e577efb77f006 Binary files /dev/null and b/libbson/1.24.0/_static/comment.png differ diff --git a/libbson/1.24.0/_static/doctools.js b/libbson/1.24.0/_static/doctools.js new file mode 100644 index 0000000000000000000000000000000000000000..d8928926bf24bb081d91a12f7b92e1b2d8b142b6 --- /dev/null +++ b/libbson/1.24.0/_static/doctools.js @@ -0,0 +1,313 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var bbox = span.getBBox(); + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + var parentOfText = node.parentNode.parentNode; + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated === 'undefined') + return string; + return (typeof translated === 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated === 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + if (!body.length) { + body = $('body'); + } + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) === 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this === '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + }, + + initOnKeyListeners: function() { + $(document).keyup(function(event) { + var activeElementType = document.activeElement.tagName; + // don't navigate when in search box or textarea + if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') { + switch (event.keyCode) { + case 37: // left + var prevHref = $('link[rel="prev"]').prop('href'); + if (prevHref) { + window.location.href = prevHref; + return false; + } + case 39: // right + var nextHref = $('link[rel="next"]').prop('href'); + if (nextHref) { + window.location.href = nextHref; + return false; + } + } + } + }); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); \ No newline at end of file diff --git a/libbson/1.24.0/_static/documentation_options.js b/libbson/1.24.0/_static/documentation_options.js new file mode 100644 index 0000000000000000000000000000000000000000..bc12cb35cdbb5228850f6e53832f07a9febac8ed --- /dev/null +++ b/libbson/1.24.0/_static/documentation_options.js @@ -0,0 +1,9 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + FILE_SUFFIX: '.html', + HAS_SOURCE: false, + SOURCELINK_SUFFIX: '.txt' +}; \ No newline at end of file diff --git a/libbson/1.24.0/_static/down-pressed.png b/libbson/1.24.0/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..5756c8cad8854722893dc70b9eb4bb0400343a39 Binary files /dev/null and b/libbson/1.24.0/_static/down-pressed.png differ diff --git a/libbson/1.24.0/_static/down.png b/libbson/1.24.0/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..1b3bdad2ceffae91cee61b32f3295f9bbe646e48 Binary files /dev/null and b/libbson/1.24.0/_static/down.png differ diff --git a/libbson/1.24.0/_static/file.png b/libbson/1.24.0/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 Binary files /dev/null and b/libbson/1.24.0/_static/file.png differ diff --git a/libbson/1.24.0/_static/jquery-3.2.1.js b/libbson/1.24.0/_static/jquery-3.2.1.js new file mode 100644 index 0000000000000000000000000000000000000000..d2d8ca4790e52b0537f3cbb7dcd766099b789583 --- /dev/null +++ b/libbson/1.24.0/_static/jquery-3.2.1.js @@ -0,0 +1,10253 @@ +/*! + * jQuery JavaScript Library v3.2.1 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2017-03-20T18:59Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var document = window.document; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var concat = arr.concat; + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + + + + function DOMEval( code, doc ) { + doc = doc || document; + + var script = doc.createElement( "script" ); + + script.text = code; + doc.head.appendChild( script ).parentNode.removeChild( script ); + } +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.2.1", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }, + + // Support: Android <=4.0 only + // Make sure we trim BOM and NBSP + rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, + + // Matches dashed string for camelizing + rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g, + + // Used by jQuery.camelCase as callback to replace() + fcamelCase = function( all, letter ) { + return letter.toUpperCase(); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + + if ( copyIsArray ) { + copyIsArray = false; + clone = src && Array.isArray( src ) ? src : []; + + } else { + clone = src && jQuery.isPlainObject( src ) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isFunction: function( obj ) { + return jQuery.type( obj ) === "function"; + }, + + isWindow: function( obj ) { + return obj != null && obj === obj.window; + }, + + isNumeric: function( obj ) { + + // As of jQuery 3.0, isNumeric is limited to + // strings and numbers (primitives or objects) + // that can be coerced to finite numbers (gh-2662) + var type = jQuery.type( obj ); + return ( type === "number" || type === "string" ) && + + // parseFloat NaNs numeric-cast false positives ("") + // ...but misinterprets leading-number strings, particularly hex literals ("0x...") + // subtraction forces infinities to NaN + !isNaN( obj - parseFloat( obj ) ); + }, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + + /* eslint-disable no-unused-vars */ + // See https://github.com/eslint/eslint/issues/6125 + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + type: function( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; + }, + + // Evaluates a script in a global context + globalEval: function( code ) { + DOMEval( code ); + }, + + // Convert dashed to camelCase; used by the css and data modules + // Support: IE <=9 - 11, Edge 12 - 13 + // Microsoft forgot to hump their vendor prefix (#9572) + camelCase: function( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // Support: Android <=4.0 only + trim: function( text ) { + return text == null ? + "" : + ( text + "" ).replace( rtrim, "" ); + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // Bind a function to a context, optionally partially applying any + // arguments. + proxy: function( fn, context ) { + var tmp, args, proxy; + + if ( typeof context === "string" ) { + tmp = fn[ context ]; + context = fn; + fn = tmp; + } + + // Quick check to determine if target is callable, in the spec + // this throws a TypeError, but we will just return undefined. + if ( !jQuery.isFunction( fn ) ) { + return undefined; + } + + // Simulated bind + args = slice.call( arguments, 2 ); + proxy = function() { + return fn.apply( context || this, args.concat( slice.call( arguments ) ) ); + }; + + // Set the guid of unique handler to the same of original handler, so it can be removed + proxy.guid = fn.guid = fn.guid || jQuery.guid++; + + return proxy; + }, + + now: Date.now, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), +function( i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +} ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = jQuery.type( obj ); + + if ( type === "function" || jQuery.isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.3 + * https://sizzlejs.com/ + * + * Copyright jQuery Foundation and other contributors + * Released under the MIT license + * http://jquery.org/license + * + * Date: 2016-08-08 + */ +(function( window ) { + +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ({}).hasOwnProperty, + arr = [], + pop = arr.pop, + push_native = arr.push, + push = arr.push, + slice = arr.slice, + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[i] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier + identifier = "(?:\\\\.|[\\w-]|[^\0-\\xa0])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + // "Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace + + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ), + + rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*?)" + whitespace + "*\\]", "g" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace + + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + + whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ), + funescape = function( _, escaped, escapedWhitespace ) { + var high = "0x" + escaped - 0x10000; + // NaN means non-codepoint + // Support: Firefox<24 + // Workaround erroneous numeric interpretation of +"0x" + return high !== high || escapedWhitespace ? + escaped : + high < 0 ? + // BMP codepoint + String.fromCharCode( high + 0x10000 ) : + // Supplemental Plane codepoint (surrogate pair) + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + disabledAncestor = addCombinator( + function( elem ) { + return elem.disabled === true && ("form" in elem || "label" in elem); + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + (arr = slice.call( preferredDoc.childNodes )), + preferredDoc.childNodes + ); + // Support: Android<4.0 + // Detect silently failing push.apply + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + push_native.apply( target, slice.call(els) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + // Can't trust NodeList.length + while ( (target[j++] = els[i++]) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + + if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) { + setDocument( context ); + } + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && (match = rquickExpr.exec( selector )) ) { + + // ID selector + if ( (m = match[1]) ) { + + // Document context + if ( nodeType === 9 ) { + if ( (elem = context.getElementById( m )) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && (elem = newContext.getElementById( m )) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[2] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( (m = match[3]) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !compilerCache[ selector + " " ] && + (!rbuggyQSA || !rbuggyQSA.test( selector )) ) { + + if ( nodeType !== 1 ) { + newContext = context; + newSelector = selector; + + // qSA looks outside Element context, which is not what we want + // Thanks to Andrew Dupont for this workaround technique + // Support: IE <=8 + // Exclude object elements + } else if ( context.nodeName.toLowerCase() !== "object" ) { + + // Capture the context ID, setting it first if necessary + if ( (nid = context.getAttribute( "id" )) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", (nid = expando) ); + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[i] = "#" + nid + " " + toSelector( groups[i] ); + } + newSelector = groups.join( "," ); + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + } + + if ( newSelector ) { + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return (cache[ key + " " ] = value); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement("fieldset"); + + try { + return !!fn( el ); + } catch (e) { + return false; + } finally { + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split("|"), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[i] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( (cur = cur.nextSibling) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + disabledAncestor( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction(function( argument ) { + argument = +argument; + return markFunction(function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ (j = matchIndexes[i]) ] ) { + seed[j] = !(matches[j] = seed[j]); + } + } + }); + }); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = elem && (elem.ownerDocument || elem).documentElement; + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9-11, Edge + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + if ( preferredDoc !== document && + (subWindow = document.defaultView) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert(function( el ) { + el.className = "i"; + return !el.getAttribute("className"); + }); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert(function( el ) { + el.appendChild( document.createComment("") ); + return !el.getElementsByTagName("*").length; + }); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert(function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + }); + + // ID filter and find + if ( support.getById ) { + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute("id") === attrId; + }; + }; + Expr.find["ID"] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode("id"); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find["ID"] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode("id"); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( (elem = elems[i++]) ) { + node = elem.getAttributeNode("id"); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find["TAG"] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( (elem = results[i++]) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( (support.qsa = rnative.test( document.querySelectorAll )) ) { + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert(function( el ) { + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll("[msallowcapture^='']").length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll("[selected]").length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push("~="); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll(":checked").length ) { + rbuggyQSA.push(":checked"); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push(".#.+[+~]"); + } + }); + + assert(function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement("input"); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll("[name=d]").length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll(":enabled").length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll(":disabled").length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll("*,:x"); + rbuggyQSA.push(",.*:"); + }); + } + + if ( (support.matchesSelector = rnative.test( (matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector) )) ) { + + assert(function( el ) { + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + }); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + )); + } : + function( a, b ) { + if ( b ) { + while ( (b = b.parentNode) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + compare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + (!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) { + + // Choose the first element that is related to our preferred document + if ( a === document || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) { + return -1; + } + if ( b === document || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + return a === document ? -1 : + b === document ? 1 : + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( (cur = cur.parentNode) ) { + ap.unshift( cur ); + } + cur = b; + while ( (cur = cur.parentNode) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[i] === bp[i] ) { + i++; + } + + return i ? + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[i], bp[i] ) : + + // Otherwise nodes in our document sort first + ap[i] === preferredDoc ? -1 : + bp[i] === preferredDoc ? 1 : + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + // Make sure that attribute selectors are quoted + expr = expr.replace( rattributeQuotes, "='$1']" ); + + if ( support.matchesSelector && documentIsHTML && + !compilerCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch (e) {} + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + // Set document vars if needed + if ( ( context.ownerDocument || context ) !== document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + (val = elem.getAttributeNode(name)) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return (sel + "").replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( (elem = results[i++]) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + // If no nodeType, this is expected to be an array + while ( (node = elem[i++]) ) { + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[1] = match[1].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[3] = ( match[3] || match[4] || match[5] || "" ).replace( runescape, funescape ); + + if ( match[2] === "~=" ) { + match[3] = " " + match[3] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[1] = match[1].toLowerCase(); + + if ( match[1].slice( 0, 3 ) === "nth" ) { + // nth-* requires argument + if ( !match[3] ) { + Sizzle.error( match[0] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) ); + match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" ); + + // other types prohibit arguments + } else if ( match[3] ) { + Sizzle.error( match[0] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[6] && match[2]; + + if ( matchExpr["CHILD"].test( match[0] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[3] ) { + match[2] = match[4] || match[5] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + // Get excess from tokenize (recursively) + (excess = tokenize( unquoted, true )) && + // advance to the next closing parenthesis + (excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) { + + // excess is a negative index + match[0] = match[0].slice( 0, excess ); + match[2] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { return true; } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + (pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) && + classCache( className, function( elem ) { + return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== "undefined" && elem.getAttribute("class") || "" ); + }); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + }; + }, + + "CHILD": function( type, what, argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( (node = node[ dir ]) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || (node[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + (outerCache[ node.uniqueID ] = {}); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( (node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + (diff = nodeIndex = 0) || start.pop()) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + // Use previously-cached element index if available + if ( useCache ) { + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || (node[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + (outerCache[ node.uniqueID ] = {}); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + // Use the same loop as above to seek `elem` from the start + while ( (node = ++nodeIndex && node && node[ dir ] || + (diff = nodeIndex = 0) || start.pop()) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || (node[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + (outerCache[ node.uniqueID ] = {}); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction(function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[i] ); + seed[ idx ] = !( matches[ idx ] = matched[i] ); + } + }) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + // Potentially complex pseudos + "not": markFunction(function( selector ) { + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction(function( seed, matches, context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( (elem = unmatched[i]) ) { + seed[i] = !(matches[i] = elem); + } + } + }) : + function( elem, context, xml ) { + input[0] = elem; + matcher( input, null, xml, results ); + // Don't keep the element (issue #299) + input[0] = null; + return !results.pop(); + }; + }), + + "has": markFunction(function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + }), + + "contains": markFunction(function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1; + }; + }), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + // lang value must be a valid identifier + if ( !ridentifier.test(lang || "") ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( (elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( (elem = elem.parentNode) && elem.nodeType === 1 ); + return false; + }; + }), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected); + }, + + "selected": function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos["empty"]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo(function() { + return [ 0 ]; + }), + + "last": createPositionalPseudo(function( matchIndexes, length ) { + return [ length - 1 ]; + }), + + "eq": createPositionalPseudo(function( matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + }), + + "even": createPositionalPseudo(function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "odd": createPositionalPseudo(function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "lt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "gt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }) + } +}; + +Expr.pseudos["nth"] = Expr.pseudos["eq"]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || (match = rcomma.exec( soFar )) ) { + if ( match ) { + // Don't consume trailing commas as valid + soFar = soFar.slice( match[0].length ) || soFar; + } + groups.push( (tokens = []) ); + } + + matched = false; + + // Combinators + if ( (match = rcombinators.exec( soFar )) ) { + matched = match.shift(); + tokens.push({ + value: matched, + // Cast descendant combinators to space + type: match[0].replace( rtrim, " " ) + }); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] || + (match = preFilters[ type ]( match ))) ) { + matched = match.shift(); + tokens.push({ + value: matched, + type: type, + matches: match + }); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[i].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || (elem[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || (outerCache[ elem.uniqueID ] = {}); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( (oldCache = uniqueCache[ key ]) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return (newCache[ 2 ] = oldCache[ 2 ]); + } else { + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( (newCache[ 2 ] = matcher( elem, context, xml )) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[i]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[0]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[i], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( (elem = unmatched[i]) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction(function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( (elem = temp[i]) ) { + matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) ) { + // Restore matcherIn since elem is not yet a final match + temp.push( (matcherIn[i] = elem) ); + } + } + postFinder( null, (matcherOut = []), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) && + (temp = postFinder ? indexOf( seed, elem ) : preMap[i]) > -1 ) { + + seed[temp] = !(results[temp] = elem); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + }); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[0].type ], + implicitRelative = leadingRelative || Expr.relative[" "], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + (checkContext = context).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( (matcher = Expr.relative[ tokens[i].type ]) ) { + matchers = [ addCombinator(elementMatcher( matchers ), matcher) ]; + } else { + matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[j].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" }) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( (tokens = tokens.slice( j )) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find["TAG"]( "*", outermost ), + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1), + len = elems.length; + + if ( outermost ) { + outermostContext = context === document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && (elem = elems[i]) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + if ( !context && elem.ownerDocument !== document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( (matcher = elementMatchers[j++]) ) { + if ( matcher( elem, context || document, xml) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + // They will have gone through all possible matchers + if ( (elem = !matcher && elem) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( (matcher = setMatchers[j++]) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !(unmatched[i] || setMatched[i]) ) { + setMatched[i] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[i] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( (selector = compiled.selector || selector) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[0] = match[0].slice( 0 ); + if ( tokens.length > 2 && (token = tokens[0]).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[1].type ] ) { + + context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[i]; + + // Abort if we hit a combinator + if ( Expr.relative[ (type = token.type) ] ) { + break; + } + if ( (find = Expr.find[ type ]) ) { + // Search, expanding context for leading sibling combinators + if ( (seed = find( + token.matches[0].replace( runescape, funescape ), + rsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context + )) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split("").sort( sortOrder ).join("") === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert(function( el ) { + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement("fieldset") ) & 1; +}); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert(function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute("href") === "#" ; +}) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + }); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert(function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +}) ) { + addHandle( "value", function( elem, name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + }); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert(function( el ) { + return el.getAttribute("disabled") == null; +}) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + (val = elem.getAttributeNode( name )) && val.specified ? + val.value : + null; + } + }); +} + +return Sizzle; + +})( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +}; +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +var risSimple = /^.[^:#\[\.,]*$/; + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Simple selector that can be filtered directly, removing non-Elements + if ( risSimple.test( qualifier ) ) { + return jQuery.filter( qualifier, elements, not ); + } + + // Complex selector, compare the two sets, removing non-Elements + qualifier = jQuery.filter( qualifier, elements ); + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not && elem.nodeType === 1; + } ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( jQuery.isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( nodeName( elem, "iframe" ) ) { + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( jQuery.isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && jQuery.type( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && jQuery.isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && jQuery.isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = jQuery.isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && jQuery.isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( jQuery.isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + jQuery.isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + jQuery.isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + jQuery.isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the master Deferred + master = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + master.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( master.state() === "pending" || + jQuery.isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return master.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); + } + + return master.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( jQuery.type( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !jQuery.isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ jQuery.camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ jQuery.camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ jQuery.camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( jQuery.camelCase ); + } else { + key = jQuery.camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = jQuery.camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + jQuery.contains( elem.ownerDocument, elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + +var swap = function( elem, options, callback, args ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.apply( elem, args || [] ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, + scale = 1, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + do { + + // If previous iteration zeroed out, double until we get *something*. + // Use string for doubling so we don't accidentally see scale as unchanged below + scale = scale || ".5"; + + // Adjust and apply + initialInUnit = initialInUnit / scale; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Update scale, tolerating zero or NaN from tween.cur() + // Break the loop if scale is unchanged or perfect, or if we've just had enough. + } while ( + scale !== ( scale = currentValue() / initial ) && scale !== 1 && --maxIterations + ); + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]+)/i ); + +var rscriptType = ( /^$|\/(?:java|ecma)script/i ); + + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // Support: IE <=9 only + option: [ 1, "" ], + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
    " ], + col: [ 2, "", "
    " ], + tr: [ 2, "", "
    " ], + td: [ 3, "", "
    " ], + + _default: [ 0, "", "" ] +}; + +// Support: IE <=9 only +wrapMap.optgroup = wrapMap.option; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, contains, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( jQuery.type( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + contains = jQuery.contains( elem.ownerDocument, elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( contains ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; +} )(); +var documentElement = document.documentElement; + + + +var + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, + rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 only +// See #13393 for more info +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Don't attach events to noData or text/comment nodes (but allow plain objects) + if ( !elemData ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = {}; + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + // Make a writable jQuery.Event from the native event object + var event = jQuery.event.fix( nativeEvent ); + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + handlers = ( dataPriv.get( this, "events" ) || {} )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // Triggered event must either 1) have no namespace, or 2) have namespace(s) + // a subset or equal to those in the bound event (both can have no namespace). + if ( !event.rnamespace || event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: jQuery.isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + focus: { + + // Fire native event if possible so blur/focus sequence is correct + trigger: function() { + if ( this !== safeActiveElement() && this.focus ) { + this.focus(); + return false; + } + }, + delegateType: "focusin" + }, + blur: { + trigger: function() { + if ( this === safeActiveElement() && this.blur ) { + this.blur(); + return false; + } + }, + delegateType: "focusout" + }, + click: { + + // For checkbox, fire native event so checked state will be right + trigger: function() { + if ( this.type === "checkbox" && this.click && nodeName( this, "input" ) ) { + this.click(); + return false; + } + }, + + // For cross-browser consistency, don't fire native .click() on links + _default: function( event ) { + return nodeName( event.target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + + which: function( event ) { + var button = event.button; + + // Add which for key events + if ( event.which == null && rkeyEvent.test( event.type ) ) { + return event.charCode != null ? event.charCode : event.keyCode; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { + if ( button & 1 ) { + return 1; + } + + if ( button & 2 ) { + return 3; + } + + if ( button & 4 ) { + return 2; + } + + return 0; + } + + return event.which; + } +}, jQuery.event.addProp ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + /* eslint-disable max-len */ + + // See https://github.com/eslint/eslint/issues/3229 + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi, + + /* eslint-enable */ + + // Support: IE <=10 - 11, Edge 12 - 13 + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( ">tbody", elem )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + var match = rscriptTypeMasked.exec( elem.type ); + + if ( match ) { + elem.type = match[ 1 ]; + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, pdataCur, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.access( src ); + pdataCur = dataPriv.set( dest, pdataOld ); + events = pdataOld.events; + + if ( events ) { + delete pdataCur.handle; + pdataCur.events = {}; + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = concat.apply( [], args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + isFunction = jQuery.isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( isFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( isFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl ) { + jQuery._evalUrl( node.src ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && jQuery.contains( node.ownerDocument, node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html.replace( rxhtmlTag, "<$1>" ); + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = jQuery.contains( elem.ownerDocument, elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rmargin = ( /^margin/ ); + +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + div.style.cssText = + "box-sizing:border-box;" + + "position:relative;display:block;" + + "margin:auto;border:1px;padding:1px;" + + "top:1%;width:50%"; + div.innerHTML = ""; + documentElement.appendChild( container ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = divStyle.marginLeft === "2px"; + boxSizingReliableVal = divStyle.width === "4px"; + + // Support: Android 4.0 - 4.3 only + // Some styles come back with percentage values, even though they shouldn't + div.style.marginRight = "50%"; + pixelMarginRightVal = divStyle.marginRight === "4px"; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + var pixelPositionVal, boxSizingReliableVal, pixelMarginRightVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + container.style.cssText = "border:0;width:8px;height:0;top:0;left:-9999px;" + + "padding:0;margin-top:1px;position:absolute"; + container.appendChild( div ); + + jQuery.extend( support, { + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelMarginRight: function() { + computeStyleTests(); + return pixelMarginRightVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelMarginRight() && rnumnonpx.test( ret ) && rmargin.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }, + + cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style; + +// Return a css property mapped to a potentially vendor prefixed property +function vendorPropName( name ) { + + // Shortcut for names that are not vendor prefixed + if ( name in emptyStyle ) { + return name; + } + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a property mapped along what jQuery.cssProps suggests or to +// a vendor prefixed property. +function finalPropName( name ) { + var ret = jQuery.cssProps[ name ]; + if ( !ret ) { + ret = jQuery.cssProps[ name ] = vendorPropName( name ) || name; + } + return ret; +} + +function setPositiveNumber( elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function augmentWidthOrHeight( elem, name, extra, isBorderBox, styles ) { + var i, + val = 0; + + // If we already have the right measurement, avoid augmentation + if ( extra === ( isBorderBox ? "border" : "content" ) ) { + i = 4; + + // Otherwise initialize for horizontal or vertical properties + } else { + i = name === "width" ? 1 : 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin, so add it if we want it + if ( extra === "margin" ) { + val += jQuery.css( elem, extra + cssExpand[ i ], true, styles ); + } + + if ( isBorderBox ) { + + // border-box includes padding, so remove it if we want content + if ( extra === "content" ) { + val -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // At this point, extra isn't border nor margin, so remove border + if ( extra !== "margin" ) { + val -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } else { + + // At this point, extra isn't content, so add padding + val += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // At this point, extra isn't content nor padding, so add border + if ( extra !== "padding" ) { + val += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + return val; +} + +function getWidthOrHeight( elem, name, extra ) { + + // Start with computed style + var valueIsBorderBox, + styles = getStyles( elem ), + val = curCSS( elem, name, styles ), + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Computed unit is not pixels. Stop here and return. + if ( rnumnonpx.test( val ) ) { + return val; + } + + // Check for style in case a browser which returns unreliable values + // for getComputedStyle silently falls back to the reliable elem.style + valueIsBorderBox = isBorderBox && + ( support.boxSizingReliable() || val === elem.style[ name ] ); + + // Fall back to offsetWidth/Height when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + if ( val === "auto" ) { + val = elem[ "offset" + name[ 0 ].toUpperCase() + name.slice( 1 ) ]; + } + + // Normalize "", auto, and prepare for extra + val = parseFloat( val ) || 0; + + // Use the active box-sizing model to add/subtract irrelevant styles + return ( val + + augmentWidthOrHeight( + elem, + name, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: { + "float": "cssFloat" + }, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = jQuery.camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + if ( type === "number" ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = jQuery.camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( i, name ) { + jQuery.cssHooks[ name ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, name, extra ); + } ) : + getWidthOrHeight( elem, name, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = extra && getStyles( elem ), + subtract = extra && augmentWidthOrHeight( + elem, + name, + extra, + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + styles + ); + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ name ] = value; + value = jQuery.css( elem, name ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( !rmargin.test( prefix ) ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && + ( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null || + jQuery.cssHooks[ tween.prop ] ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = jQuery.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 13 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = jQuery.camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( jQuery.isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + jQuery.proxy( result.stop, result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( jQuery.isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( jQuery.isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + jQuery.isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !jQuery.isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( jQuery.isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue && type !== false ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = jQuery.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://html.spec.whatwg.org/multipage/infrastructure.html#strip-and-collapse-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( jQuery.isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( typeof value === "string" && value ) { + classes = value.match( rnothtmlwhite ) || []; + + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( jQuery.isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + if ( typeof value === "string" && value ) { + classes = value.match( rnothtmlwhite ) || []; + + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value; + + if ( typeof stateVal === "boolean" && type === "string" ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( jQuery.isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( type === "string" ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = value.match( rnothtmlwhite ) || []; + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, isFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + isFunction = jQuery.isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( isFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( dataPriv.get( cur, "events" ) || {} )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && jQuery.isFunction( elem[ type ] ) && !jQuery.isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + elem[ type ](); + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " + + "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + + "change select submit keydown keypress keyup contextmenu" ).split( " " ), + function( i, name ) { + + // Handle event binding + jQuery.fn[ name ] = function( data, fn ) { + return arguments.length > 0 ? + this.on( name, null, data, fn ) : + this.trigger( name ); + }; +} ); + +jQuery.fn.extend( { + hover: function( fnOver, fnOut ) { + return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); + } +} ); + + + + +support.focusin = "onfocusin" in window; + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + var doc = this.ownerDocument || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = jQuery.now(); + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) { + xml = undefined; + } + + if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && jQuery.type( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = jQuery.isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ) + .filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ) + .map( function( i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( jQuery.isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() ] = match[ 2 ]; + } + } + match = responseHeaders[ key.toLowerCase() ]; + } + return match == null ? null : match; + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 13 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available, append data to url + if ( s.data ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce++ ) + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( jQuery.isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + + +jQuery._evalUrl = function( url ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + "throws": true + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( jQuery.isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( jQuery.isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var isFunction = jQuery.isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( isFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain requests + if ( s.crossDomain ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + + API Reference — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    API Reference

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_aligned_alloc.html b/libbson/1.24.0/bson_aligned_alloc.html new file mode 100644 index 0000000000000000000000000000000000000000..e22325d73fe553d3c83b8a20ed536fef019669f8 --- /dev/null +++ b/libbson/1.24.0/bson_aligned_alloc.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_aligned_alloc() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_aligned_alloc()

    +
    +

    Synopsis

    +
    void *
    +bson_aligned_alloc (size_t alignment, size_t num_bytes);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • alignment: The alignment of the allocated bytes of memory. Must be a power of 2 and a multiple of sizeof (void *).

    • +
    • num_bytes: The number of bytes to allocate. Must be a multiple of alignment.

    • +
    +
    +
    +

    Description

    +

    This is a portable aligned_alloc() wrapper.

    +

    In general, this function will return an allocation at least sizeof(void*) bytes or bigger with an alignment of at least alignment.

    +

    If there was a failure to allocate num_bytes bytes aligned to alignment, the process will be aborted.

    +
    +

    Warning

    +

    This function will abort on failure to allocate memory.

    +
    +
    +
    +

    Returns

    +

    A pointer to a memory region which HAS NOT been zeroed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_aligned_alloc0.html b/libbson/1.24.0/bson_aligned_alloc0.html new file mode 100644 index 0000000000000000000000000000000000000000..05150735455b16a2539f3000982d7966d3bd48e3 --- /dev/null +++ b/libbson/1.24.0/bson_aligned_alloc0.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_aligned_alloc0() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_aligned_alloc0()

    +
    +

    Synopsis

    +
    void *
    +bson_aligned_alloc0 (size_t alignment, size_t num_bytes);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • alignment: The alignment of the allocated bytes of memory. Must be a power of 2 and a multiple of sizeof (void *).

    • +
    • num_bytes: The number of bytes to allocate. Must be a multiple of alignment.

    • +
    +
    +
    +

    Description

    +

    This is a portable aligned_alloc() wrapper that also sets the memory to zero.

    +

    In general, this function will return an allocation at least sizeof(void*) bytes or bigger with an alignment of at least alignment.

    +

    If there was a failure to allocate num_bytes bytes aligned to alignment, the process will be aborted.

    +
    +

    Warning

    +

    This function will abort on failure to allocate memory.

    +
    +
    +
    +

    Returns

    +

    A pointer to a memory region which HAS been zeroed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_array.html b/libbson/1.24.0/bson_append_array.html new file mode 100644 index 0000000000000000000000000000000000000000..de872aa5337d3366ad61ee3a42e53b41aacbfa8d --- /dev/null +++ b/libbson/1.24.0/bson_append_array.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_array() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_array()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_ARRAY(b, key, val) \
    +   bson_append_array (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_array (bson_t *bson,
    +                   const char *key,
    +                   int key_length,
    +                   const bson_t *array);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • array: A bson_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_array() function shall append array to bson using the specified key. The type of the field will be an array, but it is the responsibility of the caller to ensure that the keys of array are properly formatted with string keys such as “0”, “1”, “2” and so forth.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function fails if appending the array grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_array_begin.html b/libbson/1.24.0/bson_append_array_begin.html new file mode 100644 index 0000000000000000000000000000000000000000..be0fccb10614974e4d7bf1ccfe98da4ff9684b26 --- /dev/null +++ b/libbson/1.24.0/bson_append_array_begin.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_append_array_begin() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_array_begin()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_ARRAY_BEGIN(b, key, child) \
    +   bson_append_array_begin (b, key, (int) strlen (key), child)
    +
    +bool
    +bson_append_array_begin (bson_t *bson,
    +                         const char *key,
    +                         int key_length,
    +                         bson_t *child);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: A string containing the name for the key.

    • +
    • key_length: The length of key or -1 to call strlen().

    • +
    • child: A bson_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_array_begin() function shall begin appending an array field to bson. This allows for incrementally building a sub-array. Doing so will generally yield better performance as you will serialize to a single buffer. When done building the sub-array, the caller MUST call bson_append_array_end().

    +

    For generating array element keys, see bson_uint32_to_string().

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the array grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_array_end.html b/libbson/1.24.0/bson_append_array_end.html new file mode 100644 index 0000000000000000000000000000000000000000..5e01d56b774404a69fe9352977e2ec630fa3c711 --- /dev/null +++ b/libbson/1.24.0/bson_append_array_end.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_append_array_end() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_array_end()

    +
    +

    Synopsis

    +
    bool
    +bson_append_array_end (bson_t *bson, bson_t *child);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_append_array_end() function shall complete the appending of an array field started with bson_append_array_begin(). child is invalid after calling this function.

    +
    +
    +

    Returns

    +

    Returns true if successful.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_binary.html b/libbson/1.24.0/bson_append_binary.html new file mode 100644 index 0000000000000000000000000000000000000000..66bd988dd40c3b083426be0361d244f760ef8762 --- /dev/null +++ b/libbson/1.24.0/bson_append_binary.html @@ -0,0 +1,168 @@ + + + + + + + + + + + + + + bson_append_binary() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_binary()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_BINARY(b, key, subtype, val, len) \
    +   bson_append_binary (b, key, (int) strlen (key), subtype, val, len)
    +
    +bool
    +bson_append_binary (bson_t *bson,
    +                    const char *key,
    +                    int key_length,
    +                    bson_subtype_t subtype,
    +                    const uint8_t *binary,
    +                    uint32_t length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: The key name.

    • +
    • key_length: The length of key in bytes or -1 to use strlen().

    • +
    • subtype: A bson_subtype_t indicating the binary subtype.

    • +
    • binary: A buffer to embed as binary data. May be NULL for an empty binary value.

    • +
    • length: The length of buffer in bytes. Must be 0 if binary is NULL.

    • +
    +
    +
    +

    Description

    +

    The bson_append_binary() function shall append a new element to bson containing the binary data provided.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending binary grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_bool.html b/libbson/1.24.0/bson_append_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..668930f81155c25497f92bd03ba92367f8914bfd --- /dev/null +++ b/libbson/1.24.0/bson_append_bool.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_append_bool() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_bool()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_BOOL(b, key, val) \
    +   bson_append_bool (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_bool (bson_t *bson, const char *key, int key_length, bool value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: The name of the field.

    • +
    • key_length: The length of key or -1 to use strlen().

    • +
    • value: true or false.

    • +
    +
    +
    +

    Description

    +

    The bson_append_bool() function shall append a new element to bson containing the boolean provided.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_code.html b/libbson/1.24.0/bson_append_code.html new file mode 100644 index 0000000000000000000000000000000000000000..df1ce83b2215a4d311975717a9aa246422d57946 --- /dev/null +++ b/libbson/1.24.0/bson_append_code.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_code() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_code()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_CODE(b, key, val) \
    +   bson_append_code (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_code (bson_t *bson,
    +                  const char *key,
    +                  int key_length,
    +                  const char *javascript);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: The key name.

    • +
    • key_length: The length of key or -1 to use strlen().

    • +
    • javascript: A UTF-8 encoded string containing the javascript.

    • +
    +
    +
    +

    Description

    +

    The bson_append_code() function shall append a new element to bson using the UTF-8 encoded javascript provided. javascript must be a NULL terminated C string.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending javascript grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_code_with_scope.html b/libbson/1.24.0/bson_append_code_with_scope.html new file mode 100644 index 0000000000000000000000000000000000000000..dcf9b6bcea0a8a9fd4a0dd5e81f74370cebea42d --- /dev/null +++ b/libbson/1.24.0/bson_append_code_with_scope.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_append_code_with_scope() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_code_with_scope()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_CODE_WITH_SCOPE(b, key, val, scope) \
    +   bson_append_code_with_scope (b, key, (int) strlen (key), val, scope)
    +
    +bool
    +bson_append_code_with_scope (bson_t *bson,
    +                             const char *key,
    +                             int key_length,
    +                             const char *javascript,
    +                             const bson_t *scope);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • javascript: A NULL-terminated UTF-8 encoded string containing the javascript fragment.

    • +
    • scope: Optional bson_t containing the scope for javascript.

    • +
    +
    +
    +

    Description

    +

    The bson_append_code_with_scope() function shall perform like bson_append_code() except it allows providing a scope to the javascript function in the form of a bson document.

    +

    If scope is NULL, this function appends an element with BSON type “code”, otherwise with BSON type “code with scope”.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending javascript and scope grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_date_time.html b/libbson/1.24.0/bson_append_date_time.html new file mode 100644 index 0000000000000000000000000000000000000000..3c95ef4c3783228a63c8426aa7d4824f98a373da --- /dev/null +++ b/libbson/1.24.0/bson_append_date_time.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_date_time() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_date_time()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_DATE_TIME(b, key, val) \
    +   bson_append_date_time (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_date_time (bson_t *bson,
    +                       const char *key,
    +                       int key_length,
    +                       int64_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: The date and time as specified in milliseconds since the UNIX epoch.

    • +
    +
    +
    +

    Description

    +

    The bson_append_date_time() function shall append a new element to a bson document containing a date and time with no timezone information. value is assumed to be in UTC format of milliseconds since the UNIX epoch. value MAY be negative.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_dbpointer.html b/libbson/1.24.0/bson_append_dbpointer.html new file mode 100644 index 0000000000000000000000000000000000000000..95e180973c8149561f0a01b2fa8839edfc83a310 --- /dev/null +++ b/libbson/1.24.0/bson_append_dbpointer.html @@ -0,0 +1,169 @@ + + + + + + + + + + + + + + bson_append_dbpointer() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_dbpointer()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_DBPOINTER(b, key, coll, oid) \
    +   bson_append_dbpointer (b, key, (int) strlen (key), coll, oid)
    +
    +bool
    +bson_append_dbpointer (bson_t *bson,
    +                       const char *key,
    +                       int key_length,
    +                       const char *collection,
    +                       const bson_oid_t *oid);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • collection: The target collection name.

    • +
    • oid: The target document identifier.

    • +
    +
    +
    +

    Description

    +
    +

    Warning

    +

    The dbpointer field type is DEPRECATED and should only be used when interacting with legacy systems.

    +
    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the array grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_decimal128.html b/libbson/1.24.0/bson_append_decimal128.html new file mode 100644 index 0000000000000000000000000000000000000000..547bc3fdabf79ad4a1738bfd9cc5ef6100de6c03 --- /dev/null +++ b/libbson/1.24.0/bson_append_decimal128.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_decimal128() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_decimal128()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_DECIMAL128(b, key, val) \
    +   bson_append_decimal128 (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_decimal128 (bson_t *bson,
    +                        const char *key,
    +                        int key_length,
    +                        const bson_decimal128_t *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A bson_decimal128_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_decimal128() function shall append a new element to bson containing a Decimal 128.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_document.html b/libbson/1.24.0/bson_append_document.html new file mode 100644 index 0000000000000000000000000000000000000000..af5c228ee38016de07dddaef75696a45cadbfb6b --- /dev/null +++ b/libbson/1.24.0/bson_append_document.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_document() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_document()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_DOCUMENT(b, key, val) \
    +   bson_append_document (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_document (bson_t *bson,
    +                      const char *key,
    +                      int key_length,
    +                      const bson_t *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A bson_t containing the sub-document to append.

    • +
    +
    +
    +

    Description

    +

    The bson_append_document() function shall append child to bson using the specified key. The type of the field will be a document.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_document_begin.html b/libbson/1.24.0/bson_append_document_begin.html new file mode 100644 index 0000000000000000000000000000000000000000..f8b958d5d30ca1eda2cfb759d2509cd0db45e899 --- /dev/null +++ b/libbson/1.24.0/bson_append_document_begin.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_append_document_begin() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_document_begin()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_DOCUMENT_BEGIN(b, key, child) \
    +   bson_append_document_begin (b, key, (int) strlen (key), child)
    +
    +bool
    +bson_append_document_begin (bson_t *bson,
    +                            const char *key,
    +                            int key_length,
    +                            bson_t *child);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • child: An uninitialized bson_t to be initialized as the sub-document.

    • +
    +
    +
    +

    Description

    +

    The bson_append_document_begin() function shall begin appending a sub-document to bson. Use child to add fields to the sub-document. When completed, call bson_append_document_end() to complete the element.

    +

    child MUST be an uninitialized bson_t to avoid leaking memory.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if bson must grow larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_document_end.html b/libbson/1.24.0/bson_append_document_end.html new file mode 100644 index 0000000000000000000000000000000000000000..db57fabae0e6e5ec871fedaeb744dd1bc2c8796c --- /dev/null +++ b/libbson/1.24.0/bson_append_document_end.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_append_document_end() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_document_end()

    +
    +

    Synopsis

    +
    bool
    +bson_append_document_end (bson_t *bson, bson_t *child);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_append_document_end() function shall complete the appending of a document with bson_append_document_begin(). child is invalid after calling this function.

    +
    +
    +

    Returns

    +

    Returns true if successful.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_double.html b/libbson/1.24.0/bson_append_double.html new file mode 100644 index 0000000000000000000000000000000000000000..df65c2bf9426c4bc6880901911490da59b35e4ce --- /dev/null +++ b/libbson/1.24.0/bson_append_double.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_double() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_double()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_DOUBLE(b, key, val) \
    +   bson_append_double (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_double (bson_t *bson,
    +                    const char *key,
    +                    int key_length,
    +                    double value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A double value to append.

    • +
    +
    +
    +

    Description

    +

    The bson_append_double() function shall append a new element to a bson document of type double.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_int32.html b/libbson/1.24.0/bson_append_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..633f62145e677b46dcabc138b6ac53cce73dd432 --- /dev/null +++ b/libbson/1.24.0/bson_append_int32.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_int32() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_int32()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_INT32(b, key, val) \
    +   bson_append_int32 (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_int32 (bson_t *bson,
    +                   const char *key,
    +                   int key_length,
    +                   int32_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: An int32_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_int32() function shall append a new element to bson containing a 32-bit signed integer.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_int64.html b/libbson/1.24.0/bson_append_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..53bf9a2117990b5df42253bb95428221fad25451 --- /dev/null +++ b/libbson/1.24.0/bson_append_int64.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_int64() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_int64()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_INT64(b, key, val) \
    +   bson_append_int64 (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_int64 (bson_t *bson,
    +                   const char *key,
    +                   int key_length,
    +                   int64_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: An int64_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_int64() function shall append a new element to bson containing a 64-bit signed integer.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_iter.html b/libbson/1.24.0/bson_append_iter.html new file mode 100644 index 0000000000000000000000000000000000000000..52d537c5bcb53003400d43890c9dccbb7c04cd46 --- /dev/null +++ b/libbson/1.24.0/bson_append_iter.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_append_iter() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_iter()

    +
    +

    Synopsis

    +
    bool
    +bson_append_iter (bson_t *bson,
    +                  const char *key,
    +                  int key_length,
    +                  const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: Optional field name. If NULL, uses bson_iter_key(iter).

    • +
    • key_length: The length of key or -1 to use strlen().

    • +
    • iter: A bson_iter_t located on the position of the element to append.

    • +
    +
    +
    +

    Description

    +

    Appends the value at the current position of iter to the document.

    +
    +
    +

    Returns

    +

    Returns true if successful; false if the operation would overflow the maximum document size or another invalid state is detected.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_maxkey.html b/libbson/1.24.0/bson_append_maxkey.html new file mode 100644 index 0000000000000000000000000000000000000000..82d40c923d04d56a83759dd9a435e893dfedee9d --- /dev/null +++ b/libbson/1.24.0/bson_append_maxkey.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_append_maxkey() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_maxkey()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_MAXKEY(b, key) \
    +   bson_append_maxkey (b, key, (int) strlen (key))
    +
    +bool
    +bson_append_maxkey (bson_t *bson, const char *key, int key_length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    The bson_append_maxkey() function shall append an element of type BSON_TYPE_MAXKEY to a bson document. This is primarily used in queries and unlikely to be used when storing a document to MongoDB.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_minkey.html b/libbson/1.24.0/bson_append_minkey.html new file mode 100644 index 0000000000000000000000000000000000000000..f439caf26e28a367fdea2f391d76472b97a338c9 --- /dev/null +++ b/libbson/1.24.0/bson_append_minkey.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_append_minkey() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_minkey()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_MINKEY(b, key) \
    +   bson_append_minkey (b, key, (int) strlen (key))
    +
    +bool
    +bson_append_minkey (bson_t *bson, const char *key, int key_length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    The bson_append_minkey() function shall append an element of type BSON_TYPE_MINKEY to a bson document. This is primarily used in queries and unlikely to be used when storing a document to MongoDB.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_now_utc.html b/libbson/1.24.0/bson_append_now_utc.html new file mode 100644 index 0000000000000000000000000000000000000000..e784d5b0c47db69de3d3d518a4b4758e843e4ae2 --- /dev/null +++ b/libbson/1.24.0/bson_append_now_utc.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_append_now_utc() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_now_utc()

    +
    +

    Synopsis

    +
    bool
    +bson_append_now_utc (bson_t *bson, const char *key, int key_length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    The bson_append_now_utc() function is a helper to get the current date and time in UTC and append it to bson as a BSON_TYPE_DATE_TIME element.

    +

    This function calls bson_append_date_time() internally.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_null.html b/libbson/1.24.0/bson_append_null.html new file mode 100644 index 0000000000000000000000000000000000000000..2871af97bfb43a2516016bb0db5497af6120be63 --- /dev/null +++ b/libbson/1.24.0/bson_append_null.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_append_null() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_null()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_NULL(b, key) bson_append_null (b, key, (int) strlen (key))
    +
    +bool
    +bson_append_null (bson_t *bson, const char *key, int key_length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    The bson_append_null() function shall append a new element to bson of type BSON_TYPE_NULL.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_oid.html b/libbson/1.24.0/bson_append_oid.html new file mode 100644 index 0000000000000000000000000000000000000000..81591a0bbd99adf859e28622eb243e6bbff4a48b --- /dev/null +++ b/libbson/1.24.0/bson_append_oid.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_oid() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_oid()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_OID(b, key, val) \
    +   bson_append_oid (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_oid (bson_t *bson,
    +                 const char *key,
    +                 int key_length,
    +                 const bson_oid_t *oid);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • oid: A bson_oid_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_oid() function shall append a new element to bson of type BSON_TYPE_OID. oid MUST be a pointer to a bson_oid_t.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending oid grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_regex.html b/libbson/1.24.0/bson_append_regex.html new file mode 100644 index 0000000000000000000000000000000000000000..d3839c0bb2bb43e881aa093ef2314727dedea684 --- /dev/null +++ b/libbson/1.24.0/bson_append_regex.html @@ -0,0 +1,175 @@ + + + + + + + + + + + + + + bson_append_regex() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_regex()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_REGEX(b, key, val, opt) \
    +   bson_append_regex (b, key, (int) strlen (key), val, opt)
    +
    +bool
    +bson_append_regex (bson_t *bson,
    +                   const char *key,
    +                   int key_length,
    +                   const char *regex,
    +                   const char *options);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • regex: An ASCII string containing the regex.

    • +
    • options: An optional string containing the regex options as a string.

    • +
    +
    +
    +

    Description

    +

    Appends a new field to bson of type BSON_TYPE_REGEX. regex should be the regex string. options should contain the options for the regex.

    +

    Valid characters for options include:

    +
      +
    • 'i' for case-insensitive.

    • +
    • 'm' for multiple matching.

    • +
    • 'x' for verbose mode.

    • +
    • 'l' to make w and W locale dependent.

    • +
    • 's' for dotall mode (‘.’ matches everything)

    • +
    • 'u' to make w and W match unicode.

    • +
    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the regex grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_regex_w_len.html b/libbson/1.24.0/bson_append_regex_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..42dbd7ece5685f9cbe28085bbd5df6532016a061 --- /dev/null +++ b/libbson/1.24.0/bson_append_regex_w_len.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + bson_append_regex_w_len() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_regex_w_len()

    +
    +

    Synopsis

    +
    bool
    +bson_append_regex_w_len (bson_t *bson,
    +                          const char *key,
    +                          int key_length,
    +                          const char *regex,
    +                          int regex_length,
    +                          const char *options);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • regex: An ASCII string containing the regex.

    • +
    • regex_length: The length of regex in bytes, or -1 to determine the length with strlen().

    • +
    • options: An optional string containing the regex options as a string.

    • +
    +
    +
    +

    Description

    +

    Appends a new field to bson of type BSON_TYPE_REGEX. regex should be the regex string. options should contain the options for the regex.

    +

    Valid characters for options include:

    +
      +
    • 'i' for case-insensitive.

    • +
    • 'm' for multiple matching.

    • +
    • 'x' for verbose mode.

    • +
    • 'l' to make w and W locale dependent.

    • +
    • 's' for dotall mode (‘.’ matches everything)

    • +
    • 'u' to make w and W match unicode.

    • +
    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the regex grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_symbol.html b/libbson/1.24.0/bson_append_symbol.html new file mode 100644 index 0000000000000000000000000000000000000000..12bb47190f7b20465350e0d2c6f4a2cfdd0e338d --- /dev/null +++ b/libbson/1.24.0/bson_append_symbol.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_append_symbol() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_symbol()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_SYMBOL(b, key, val) \
    +   bson_append_symbol (b, key, (int) strlen (key), val, (int) strlen (val))
    +
    +bool
    +bson_append_symbol (bson_t *bson,
    +                    const char *key,
    +                    int key_length,
    +                    const char *value,
    +                    int length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: The symbol.

    • +
    • length: A length of symbol in bytes, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    Appends a new field to bson of type BSON_TYPE_SYMBOL. This BSON type is deprecated and should not be used in new code.

    +

    Due to legacy behavior, passing NULL for value appends a null value, not a symbol value. To append a null value directly, prefer using bson_append_null().

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_time_t.html b/libbson/1.24.0/bson_append_time_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2f5ea7f39a3a558e5fd51710a36b582f600c3ca8 --- /dev/null +++ b/libbson/1.24.0/bson_append_time_t.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_time_t() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_time_t()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_TIME_T(b, key, val) \
    +   bson_append_time_t (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_time_t (bson_t *bson,
    +                    const char *key,
    +                    int key_length,
    +                    time_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A time_t.

    • +
    +
    +
    +

    Description

    +

    The bson_append_time_t() function is a helper that takes a time_t instead of milliseconds since the UNIX epoch.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_timestamp.html b/libbson/1.24.0/bson_append_timestamp.html new file mode 100644 index 0000000000000000000000000000000000000000..f0e4a1de70a08fce363919b977a79f8960a4b91f --- /dev/null +++ b/libbson/1.24.0/bson_append_timestamp.html @@ -0,0 +1,168 @@ + + + + + + + + + + + + + + bson_append_timestamp() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_timestamp()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_TIMESTAMP(b, key, val, inc) \
    +   bson_append_timestamp (b, key, (int) strlen (key), val, inc)
    +
    +bool
    +bson_append_timestamp (bson_t *bson,
    +                       const char *key,
    +                       int key_length,
    +                       uint32_t timestamp,
    +                       uint32_t increment);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • timestamp: A uint32_t.

    • +
    • increment: A uint32_t.

    • +
    +
    +
    +

    Description

    +

    This function is not similar in functionality to bson_append_date_time(). Timestamp elements are different in that they include only second precision and an increment field.

    +

    They are primarily used for intra-MongoDB server communication.

    +

    The bson_append_timestamp() function shall append a new element of type BSON_TYPE_TIMESTAMP.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_timeval.html b/libbson/1.24.0/bson_append_timeval.html new file mode 100644 index 0000000000000000000000000000000000000000..b843cd96749706717f103f4e403562e93806b622 --- /dev/null +++ b/libbson/1.24.0/bson_append_timeval.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_timeval() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_timeval()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_TIMEVAL(b, key, val) \
    +   bson_append_timeval (b, key, (int) strlen (key), val)
    +
    +bool
    +bson_append_timeval (bson_t *bson,
    +                     const char *key,
    +                     int key_length,
    +                     struct timeval *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A struct timeval.

    • +
    +
    +
    +

    Description

    +

    The bson_append_timeval() function is a helper that takes a struct timeval instead of milliseconds since the UNIX epoch.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_undefined.html b/libbson/1.24.0/bson_append_undefined.html new file mode 100644 index 0000000000000000000000000000000000000000..9c401625dc851c108e9a775d7918fd1cea028327 --- /dev/null +++ b/libbson/1.24.0/bson_append_undefined.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_append_undefined() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_undefined()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_UNDEFINED(b, key) \
    +   bson_append_undefined (b, key, (int) strlen (key))
    +
    +bool
    +bson_append_undefined (bson_t *bson, const char *key, int key_length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    The bson_append_undefined() function shall append a new element to bson of type BSON_TYPE_UNDEFINED. Undefined is common in Javascript. However, this element type is deprecated and should not be used in new code.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_utf8.html b/libbson/1.24.0/bson_append_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..307a2b511c893823439cc7b9947d70a5bc2b4f68 --- /dev/null +++ b/libbson/1.24.0/bson_append_utf8.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_append_utf8() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_utf8()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_UTF8(b, key, val) \
    +   bson_append_utf8 (b, key, (int) strlen (key), val, (int) strlen (val))
    +
    +bool
    +bson_append_utf8 (bson_t *bson,
    +                  const char *key,
    +                  int key_length,
    +                  const char *value,
    +                  int length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A UTF-8 encoded string.

    • +
    • length: The number of bytes in value excluding the trailing \0, or -1 to determine the length with strlen().

    • +
    +
    +
    +

    Description

    +

    The bson_append_utf8() function shall append a UTF-8 encoded string to bson.

    +

    value MUST be valid UTF-8.

    +

    Some UTF-8 implementations allow for \0 to be contained within the string (excluding the termination \0. This is allowed, but remember that it could cause issues with communicating with external systems that do not support it.

    +

    It is suggested to use modified UTF-8 which uses a 2 byte representation for embedded \0 within the string. This will allow these UTF-8 encoded strings to used with many libc functions.

    +

    Due to legacy behavior, passing NULL for value appends a null value, not a UTF8 value. To append a null value directly, prefer using bson_append_null().

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_append_value.html b/libbson/1.24.0/bson_append_value.html new file mode 100644 index 0000000000000000000000000000000000000000..274ccd4e8a04263e1214ba9b7bb34e616ab0fe3b --- /dev/null +++ b/libbson/1.24.0/bson_append_value.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_value() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_append_value()

    +
    +

    Synopsis

    +
    #define BSON_APPEND_VALUE(b, key, val) \
    +   bson_append_value (b, key, (int) strlen (key), (val))
    +
    +bool
    +bson_append_value (bson_t *bson,
    +                   const char *key,
    +                   int key_length,
    +                   const bson_value_t *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: An ASCII C string containing the name of the field.

    • +
    • key_length: The length of key in bytes, or -1 to determine the length with strlen().

    • +
    • value: A bson_value_t.

    • +
    +
    +
    +

    Description

    +

    Appends a new field to bson by determining the boxed type in value. This is useful if you want to copy fields between documents but do not know the field type until runtime.

    +
    +
    +

    Returns

    +

    Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_array_as_canonical_extended_json.html b/libbson/1.24.0/bson_array_as_canonical_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..7f6a0761c60fbe4950b7aefa871dd6a35573e139 --- /dev/null +++ b/libbson/1.24.0/bson_array_as_canonical_extended_json.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + bson_array_as_canonical_extended_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_array_as_canonical_extended_json()

    +
    +

    Synopsis

    +
    char *
    +bson_array_as_canonical_extended_json (const bson_t *bson, size_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    +
    +
    +

    Description

    +

    The bson_array_as_canonical_extended_json() encodes bson as a UTF-8 string in the canonical MongoDB Extended JSON format, except the outermost element is encoded as a JSON array, rather than a JSON document.

    +

    The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int main ()
    +{
    +   bson_t bson;
    +   char *str;
    +
    +   bson_init (&bson);
    +   /* BSON array is a normal BSON document with integer values for the keys,
    +    * starting with 0 and continuing sequentially
    +    */
    +   BSON_APPEND_INT32 (&bson, "0", 1);
    +   BSON_APPEND_UTF8 (&bson, "1", "bar");
    +
    +   str = bson_array_as_canonical_extended_json (&bson, NULL);
    +   /* Prints
    +    * [ { "$numberInt" : 1 }, "bar" ]
    +    */
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   bson_destroy (&bson);
    +}
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_array_as_json.html b/libbson/1.24.0/bson_array_as_json.html new file mode 100644 index 0000000000000000000000000000000000000000..218eea27fc6e791d41cd65ae5619d674632400f6 --- /dev/null +++ b/libbson/1.24.0/bson_array_as_json.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + bson_array_as_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_array_as_json()

    +
    +

    Synopsis

    +
    char *
    +bson_array_as_json (const bson_t *bson, size_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    +
    +
    +

    Description

    +

    The bson_array_as_json() function shall encode bson as a UTF-8 +string using libbson’s legacy JSON format, except the outermost element is +encoded as a JSON array, rather than a JSON document. This function is +superseded by bson_array_as_canonical_extended_json() and +bson_array_as_relaxed_extended_json(), which use the same +MongoDB Extended JSON format as all other MongoDB drivers. +The caller is responsible for freeing the resulting UTF-8 encoded string by +calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int main ()
    +{
    +   bson_t bson;
    +   char *str;
    +
    +   bson_init (&bson);
    +   /* BSON array is a normal BSON document with integer values for the keys,
    +    * starting with 0 and continuing sequentially
    +    */
    +   BSON_APPEND_UTF8 (&bson, "0", "foo");
    +   BSON_APPEND_UTF8 (&bson, "1", "bar");
    +
    +   str = bson_array_as_json (&bson, NULL);
    +   /* Prints
    +    * [ "foo", "bar" ]
    +    */
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   bson_destroy (&bson);
    +}
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_array_as_relaxed_extended_json.html b/libbson/1.24.0/bson_array_as_relaxed_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..a01029d42f04781d4f540d0ba937bc98403df880 --- /dev/null +++ b/libbson/1.24.0/bson_array_as_relaxed_extended_json.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + bson_array_as_relaxed_extended_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_array_as_relaxed_extended_json()

    +
    +

    Synopsis

    +
    char *
    +bson_array_as_relaxed_extended_json (const bson_t *bson, size_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    +
    +
    +

    Description

    +

    The bson_as_relaxed_extended_json() encodes bson as a UTF-8 string in the relaxed MongoDB Extended JSON format, except the outermost element is encoded as a JSON array, rather than a JSON document.

    +

    The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int main ()
    +{
    +   bson_t bson;
    +   char *str;
    +
    +   bson_init (&bson);
    +   /* BSON array is a normal BSON document with integer values for the keys,
    +    * starting with 0 and continuing sequentially
    +    */
    +   BSON_APPEND_DOUBLE (&bson, "0", 3.14);
    +   BSON_APPEND_UTF8 (&bson, "1", "bar");
    +
    +   str = bson_array_as_relaxed_extended_json (&bson, NULL);
    +   /* Prints
    +    * [ 3.14, "bar" ]
    +    */
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   bson_destroy (&bson);
    +}
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_as_canonical_extended_json.html b/libbson/1.24.0/bson_as_canonical_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..fc3a60c377cbf7a181c8102ade76e4640fe066f9 --- /dev/null +++ b/libbson/1.24.0/bson_as_canonical_extended_json.html @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + bson_as_canonical_extended_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_as_canonical_extended_json()

    +
    +

    Synopsis

    +
    char *
    +bson_as_canonical_extended_json (const bson_t *bson, size_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    +
    +
    +

    Description

    +

    The bson_as_canonical_extended_json() encodes bson as a UTF-8 string in the canonical MongoDB Extended JSON format.

    +

    The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    char *str = bson_as_canonical_extended_json (doc, NULL);
    +printf ("%s\n", str);
    +bson_free (str);
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_as_json.html b/libbson/1.24.0/bson_as_json.html new file mode 100644 index 0000000000000000000000000000000000000000..6820470d4da5cb880023c0e709200985627afbef --- /dev/null +++ b/libbson/1.24.0/bson_as_json.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + bson_as_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_as_json()

    +
    +

    Synopsis

    +
    char *
    +bson_as_json (const bson_t *bson, size_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    +
    +
    +

    Description

    +

    The bson_as_json() function shall encode bson as a UTF-8 string using libbson’s legacy JSON format. This function is superseded by bson_as_canonical_extended_json() and bson_as_relaxed_extended_json(), which use the same MongoDB Extended JSON format as all other MongoDB drivers.

    +

    The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int main ()
    +{
    +   bson_t bson;
    +   char *str;
    +
    +   bson_init (&bson);
    +   BSON_APPEND_UTF8 (&bson, "0", "foo");
    +   BSON_APPEND_UTF8 (&bson, "1", "bar");
    +
    +   str = bson_as_json (&bson, NULL);
    +   /* Prints
    +    * { "0" : "foo", "1" : "bar" }
    +    */
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   bson_destroy (&bson);
    +}
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_as_json_with_opts.html b/libbson/1.24.0/bson_as_json_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..8f4ad1676a733c05f46d4aed44edb7d732932500 --- /dev/null +++ b/libbson/1.24.0/bson_as_json_with_opts.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + bson_as_json_with_opts() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_as_json_with_opts()

    +
    +

    Synopsis

    +
    char *
    +bson_as_json_with_opts (const bson_t *bson, size_t *length, const bson_json_opts_t *opts);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    • opts: A bson_json_opts_t.

    • +
    +
    +
    +

    Description

    +

    The bson_as_json_with_opts() encodes bson as a UTF-8 string in the MongoDB Extended JSON format.

    +

    The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +

    The opts structure is used to pass options for the encoding process. Please refer to the documentation of bson_json_opts_t for more details.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    bson_json_opts_t *opts = bson_json_opts_new (BSON_JSON_MODE_CANONICAL, BSON_MAX_LEN_UNLIMITED);
    +char *str = bson_as_json_with_opts (doc, NULL, opts);
    +printf ("%s\n", str);
    +bson_free (str);
    +bson_json_opts_destroy (opts);
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_as_relaxed_extended_json.html b/libbson/1.24.0/bson_as_relaxed_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..7dd238e4234ee026f161ae9309f4c86c5fbdbbec --- /dev/null +++ b/libbson/1.24.0/bson_as_relaxed_extended_json.html @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + bson_as_relaxed_extended_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_as_relaxed_extended_json()

    +
    +

    Synopsis

    +
    char *
    +bson_as_relaxed_extended_json (const bson_t *bson, size_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • length: An optional location for the length of the resulting string.

    • +
    +
    +
    +

    Description

    +

    The bson_as_relaxed_extended_json() encodes bson as a UTF-8 string in the relaxed MongoDB Extended JSON format.

    +

    The caller is responsible for freeing the resulting UTF-8 encoded string by calling bson_free() with the result.

    +

    If non-NULL, length will be set to the length of the result in bytes.

    +
    +
    +

    Returns

    +

    If successful, a newly allocated UTF-8 encoded string and length is set.

    +

    Upon failure, NULL is returned.

    +
    +
    +

    Example

    +
    char *str = bson_as_relaxed_extended_json (doc, NULL);
    +printf ("%s\n", str);
    +bson_free (str);
    +
    +
    +
    +

    See also

    +
    +
    :symbol: bson_array_as_canonical_extended_json()
    +
    + +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    + + + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_ascii_strtoll.html b/libbson/1.24.0/bson_ascii_strtoll.html new file mode 100644 index 0000000000000000000000000000000000000000..91afd994e0bf3e6bbaedc7078e2eda16114bad20 --- /dev/null +++ b/libbson/1.24.0/bson_ascii_strtoll.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_ascii_strtoll() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_ascii_strtoll()

    +
    +

    Synopsis

    +
    int64_t
    +bson_ascii_strtoll (const char *str, char **endptr, int base);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: The string to convert.

    • +
    • endptr: Address of the first invalid character of str, or null.

    • +
    • base: The base to use for the conversion.

    • +
    +
    +
    +

    Description

    +

    A portable version of strtoll().

    +

    Converts a string to a 64-bit signed integer according to the given base, +which must be 16, 10, or 8. Leading whitespace will be ignored.

    +

    If base is 0 is passed in, the base is inferred from the string’s leading +characters. Base-16 numbers start with “0x” or “0X”, base-8 numbers start with +“0”, base-10 numbers start with a digit from 1 to 9.

    +

    If endptr is not NULL, it will be assigned the address of the first invalid +character of str, or its null terminating byte if the entire string was valid.

    +

    If an invalid value is encountered, errno will be set to EINVAL and zero will +be returned. If the number is out of range, errno is set to ERANGE and +LLONG_MAX or LLONG_MIN is returned.

    +
    +
    +

    Returns

    +

    The result of the conversion.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_check_version.html b/libbson/1.24.0/bson_check_version.html new file mode 100644 index 0000000000000000000000000000000000000000..373ab1754ee8e4437252cf085dca91d9c9e00baf --- /dev/null +++ b/libbson/1.24.0/bson_check_version.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_check_version() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_check_version()

    +
    +

    Synopsis

    +
    bool
    +bson_check_version (int required_major, int required_minor, int required_micro);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • required_major: The minimum major version required.

    • +
    • required_minor: The minimum minor version required.

    • +
    • required_micro: The minimum micro version required.

    • +
    +
    +
    +

    Description

    +

    Check at runtime if this release of libbson meets a required version.

    +
    +
    +

    Returns

    +

    True if libbson’s version is greater than or equal to the required version.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_compare.html b/libbson/1.24.0/bson_compare.html new file mode 100644 index 0000000000000000000000000000000000000000..b3485975eb13441c87b7c54b3f639d94170ddd7f --- /dev/null +++ b/libbson/1.24.0/bson_compare.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_compare() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_compare()

    +
    +

    Synopsis

    +
    int
    +bson_compare (const bson_t *bson, const bson_t *other);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_compare() function shall compare two bson documents for equality.

    +

    This can be useful in conjunction with _qsort()_.

    +

    If equal, 0 is returned.

    +
    +

    Tip

    +

    This function uses _memcmp()_ internally, so the semantics are the same.

    +
    +
    +
    +

    Returns

    +

    less than zero, zero, or greater than zero in qsort() style.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_concat.html b/libbson/1.24.0/bson_concat.html new file mode 100644 index 0000000000000000000000000000000000000000..e53d764142ad4ee9e8c211bf138ef0fe853703db --- /dev/null +++ b/libbson/1.24.0/bson_concat.html @@ -0,0 +1,192 @@ + + + + + + + + + + + + + + bson_concat() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_concat()

    +
    +

    Synopsis

    +
    bool
    +bson_concat (bson_t *dst, const bson_t *src);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_concat() function shall append the contents of src to dst.

    +
    +
    +

    Returns

    +

    Returns true if successful; false if the operation would overflow the maximum document size or another invalid state is detected.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_context_destroy.html b/libbson/1.24.0/bson_context_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..55b5be90880c4102b770535e18ad14cedcf161db --- /dev/null +++ b/libbson/1.24.0/bson_context_destroy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_context_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_context_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_context_destroy (bson_context_t *context);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_context_destroy() function shall release all resources associated with context. Does nothing if context is NULL.

    +

    This should be called when you are no longer using a bson_context_t that you have allocated with bson_context_new().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_context_get_default.html b/libbson/1.24.0/bson_context_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..646c2621f9243dc52e79d177671df84dcff46d1e --- /dev/null +++ b/libbson/1.24.0/bson_context_get_default.html @@ -0,0 +1,146 @@ + + + + + + + + + + + + + + bson_context_get_default() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_context_get_default()

    +
    +

    Synopsis

    +
    bson_context_t *
    +bson_context_get_default (void);
    +
    +
    +
    +
    +

    Returns

    +

    The bson_context_get_default() function shall return the default bson_context_t for the process. +This context is created with the flags BSON_CONTEXT_THREAD_SAFE and BSON_CONTEXT_DISABLE_PID_CACHE.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_context_new.html b/libbson/1.24.0/bson_context_new.html new file mode 100644 index 0000000000000000000000000000000000000000..7dc607b9677a45507d1fa3a776387819f9df13e3 --- /dev/null +++ b/libbson/1.24.0/bson_context_new.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_context_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_context_new()

    +
    +

    Synopsis

    +
    bson_context_t *
    +bson_context_new (bson_context_flags_t flags);
    +
    +
    +
    +
    +

    Parameters

    + +

    The following flags may be used: +* BSON_CONTEXT_NONE meaning creating ObjectIDs with this context is not a thread-safe operation. +* BSON_CONTEXT_DISABLE_PID_CACHE meaning creating ObjectIDs will also check if the process has +changed by calling getpid() on every ObjectID generation.

    +

    The following flags are deprecated and have no effect:

    +
      +
    • BSON_CONTEXT_DISABLE_HOST_CACHE

    • +
    • BSON_CONTEXT_THREAD_SAFE

    • +
    • BSON_CONTEXT_USE_TASK_ID

    • +
    +
    +
    +

    Description

    +

    Creates a new bson_context_t. This is rarely needed as bson_context_get_default() serves most use-cases.

    +
    +
    +

    Returns

    +

    A newly allocated bson_context_t that should be freed with bson_context_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_context_t.html b/libbson/1.24.0/bson_context_t.html new file mode 100644 index 0000000000000000000000000000000000000000..376dfcac83ef3122ab8c7b74eabb1ced7e94a552 --- /dev/null +++ b/libbson/1.24.0/bson_context_t.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + bson_context_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_context_t

    +

    BSON OID Generation Context

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef enum {
    +  BSON_CONTEXT_NONE = 0,
    +  BSON_CONTEXT_DISABLE_PID_CACHE = (1 << 2),
    +} bson_context_flags_t;
    +
    +typedef struct _bson_context_t bson_context_t;
    +
    +bson_context_t *
    +bson_context_get_default (void) BSON_GNUC_CONST;
    +bson_context_t *
    +bson_context_new (bson_context_flags_t flags);
    +void
    +bson_context_destroy (bson_context_t *context);
    +
    +
    +
    +
    +

    Description

    +

    The bson_context_t structure is context for generation of BSON Object +IDs. This context allows overriding behavior of generating ObjectIDs. The flags +BSON_CONTEXT_NONE, BSON_CONTEXT_THREAD_SAFE, and BSON_CONTEXT_DISABLE_PID_CACHE +are the only ones used. The others have no effect.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_context_t *ctx = NULL;
    +   bson_oid_t oid;
    +
    +   /* use default context, via bson_context_get_default() */
    +   bson_oid_init (&oid, NULL);
    +
    +   /* specify a local context for additional control */
    +   ctx = bson_context_new (BSON_CONTEXT_NONE);
    +   bson_oid_init (&oid, ctx);
    +
    +   bson_context_destroy (ctx);
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_copy.html b/libbson/1.24.0/bson_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..4ac17969c4af4eb01ba38778e6443262b0b5cf61 --- /dev/null +++ b/libbson/1.24.0/bson_copy.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_copy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_copy()

    +
    +

    Synopsis

    +
    bson_t *
    +bson_copy (const bson_t *bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_copy() function shall copy the contents of a bson document into a new bson_t.

    +

    The resulting bson_t should be freed with bson_destroy().

    +
    +
    +

    Returns

    +

    A newly allocated bson_t that should be freed with bson_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_copy_to.html b/libbson/1.24.0/bson_copy_to.html new file mode 100644 index 0000000000000000000000000000000000000000..ec77471d5027e44e9a1f8f3202e2d7c15e37f196 --- /dev/null +++ b/libbson/1.24.0/bson_copy_to.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_copy_to() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_copy_to()

    +
    +

    Synopsis

    +
    void
    +bson_copy_to (const bson_t *src, bson_t *dst);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_copy_to() function shall initialize dst with a copy of the contents of src.

    +

    dst MUST be an uninitialized bson_t to avoid leaking memory.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_copy_to_excluding.html b/libbson/1.24.0/bson_copy_to_excluding.html new file mode 100644 index 0000000000000000000000000000000000000000..632c710cfd506513f420e7eb97d3e2ceea9973b9 --- /dev/null +++ b/libbson/1.24.0/bson_copy_to_excluding.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_copy_to_excluding() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_copy_to_excluding()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.1.0: This function is deprecated and should not be used in new code.

    +

    Please use bson_copy_to_excluding_noinit() in new code.

    +
    +
    +
    +

    Synopsis

    +
    void
    +bson_copy_to_excluding (const bson_t *src,
    +                        bson_t *dst,
    +                        const char *first_exclude,
    +                        ...) BSON_GNUC_NULL_TERMINATED
    +   BSON_GNUC_DEPRECATED_FOR (bson_copy_to_excluding_noinit);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • src: A bson_t.

    • +
    • dst: A bson_t.

    • +
    • first_exclude: The first field name to exclude.

    • +
    +
    +
    +

    Description

    +

    The bson_copy_to_excluding() function shall copy all fields from +src to dst except those specified by the variadic, NULL terminated list +of keys starting from first_exclude.

    +
    +

    Warning

    +

    bson_init() is called on dst.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_copy_to_excluding_noinit.html b/libbson/1.24.0/bson_copy_to_excluding_noinit.html new file mode 100644 index 0000000000000000000000000000000000000000..e946c2a2fe80a40c25a74ba6baf7dba347b0a72a --- /dev/null +++ b/libbson/1.24.0/bson_copy_to_excluding_noinit.html @@ -0,0 +1,196 @@ + + + + + + + + + + + + + + bson_copy_to_excluding_noinit() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_copy_to_excluding_noinit()

    +
    +

    Synopsis

    +
    void
    +bson_copy_to_excluding_noinit (const bson_t *src,
    +                               bson_t *dst,
    +                               const char *first_exclude,
    +                               ...) BSON_GNUC_NULL_TERMINATED;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • src: A bson_t.

    • +
    • dst: A bson_t.

    • +
    • first_exclude: The first field name to exclude.

    • +
    +
    +
    +

    Description

    +

    The bson_copy_to_excluding_noinit() function shall copy all fields +from src to dst except those specified by the variadic, NULL terminated +list of keys starting from first_exclude. +Works the same way as bson_copy_to_excluding(), except does not call +bson_init() on dst. +This function should be preferred in new code over bson_copy_to_excluding().

    +
    +

    Warning

    +

    This is generally not needed except in very special situations.

    +
    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int main ()
    +{
    +   bson_t bson;
    +   bson_t bson2;
    +   char *str;
    +
    +   bson_init (&bson);
    +   bson_append_int32 (&bson, "a", 1, 1);
    +   bson_append_int32 (&bson, "b", 1, 2);
    +   bson_append_int32 (&bson, "c", 1, 2);
    +
    +   bson_init (&bson2);
    +   bson_copy_to_excluding_noinit (&bson, &bson2, "b", NULL);
    +
    +   str = bson_as_json (&bson2, NULL);
    +   /* Prints
    +    * { "a" : 1, "c" : 2 }
    +    */
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   bson_destroy (&bson);
    +   bson_destroy (&bson2);
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_copy_to_excluding_noinit_va.html b/libbson/1.24.0/bson_copy_to_excluding_noinit_va.html new file mode 100644 index 0000000000000000000000000000000000000000..a8b2d334f42e782408836c45c260747513dda2ca --- /dev/null +++ b/libbson/1.24.0/bson_copy_to_excluding_noinit_va.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_copy_to_excluding_noinit_va() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_copy_to_excluding_noinit_va()

    +
    +

    Synopsis

    +
    void
    +bson_copy_to_excluding_noinit_va (const bson_t *src,
    +                                  bson_t *dst,
    +                                  const char *first_exclude,
    +                                  va_list args);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • src: A bson_t.

    • +
    • dst: A bson_t.

    • +
    • first_exclude: The first field name to exclude.

    • +
    • args: A va_list.

    • +
    +
    +
    +

    Description

    +

    The bson_copy_to_excluding_noinit_va() function shall copy all fields from src to dst except those specified by first_exclude and args.

    +

    This method works the same way as bson_copy_to_excluding_noinit(), except it takes a va_list. This method does not call bson_init() on dst.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_count_keys.html b/libbson/1.24.0/bson_count_keys.html new file mode 100644 index 0000000000000000000000000000000000000000..7f1549510ce0b05f9dced4504156173d9856e9c7 --- /dev/null +++ b/libbson/1.24.0/bson_count_keys.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_count_keys() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_count_keys()

    +
    +

    Synopsis

    +
    uint32_t
    +bson_count_keys (const bson_t *bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_count_keys() function shall count the number of elements within bson.

    +
    +
    +

    Returns

    +

    A positive integer or zero.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_decimal128_from_string.html b/libbson/1.24.0/bson_decimal128_from_string.html new file mode 100644 index 0000000000000000000000000000000000000000..4b578eddba13c61a43961348979cfaf172d7cbc8 --- /dev/null +++ b/libbson/1.24.0/bson_decimal128_from_string.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + bson_decimal128_from_string() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_decimal128_from_string()

    +
    +

    Synopsis

    +
    bool
    +bson_decimal128_from_string (const char *string, bson_decimal128_t *dec);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Parses the string containing ascii encoded Decimal128 and initialize the bytes +in dec. See the Decimal128 specification +for the exact string format.

    +
    +
    +

    Returns

    +

    Returns true if valid Decimal128 string was provided, otherwise false +and dec will be set to NaN.

    +
    +
    +

    Example

    +
    bson_decimal128_t dec;
    +bson_decimal128_from_string ("1.00", &dec);
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_decimal128_from_string_w_len.html b/libbson/1.24.0/bson_decimal128_from_string_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..d479d0628b6d5d94e64af607d4b7d174a0ac4950 --- /dev/null +++ b/libbson/1.24.0/bson_decimal128_from_string_w_len.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_decimal128_from_string_w_len() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_decimal128_from_string_w_len()

    +
    +

    Synopsis

    +
    bool
    +bson_decimal128_from_string_w_len (const char *string,
    +                                   int len,
    +                                   bson_decimal128_t *dec);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • string: A string containing ASCII encoded Decimal128.

    • +
    • len: The length of string in bytes, or -1 meaning the string is null-terminated.

    • +
    • dec: A bson_decimal128_t.

    • +
    +
    +
    +

    Description

    +

    Parses the string containing ascii encoded Decimal128 and initialize the bytes +in dec. See the Decimal128 specification +for the exact string format.

    +
    +
    +

    Returns

    +

    Returns true if valid Decimal128 string was provided, otherwise false +and dec will be set to NaN.

    +
    +
    +

    Example

    +
    bson_decimal128_t dec;
    +bson_decimal128_from_string_w_len ("1.00", 4, &dec);
    +bson_decimal128_from_string_w_len ("1.00", -1, &dec);
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_decimal128_t.html b/libbson/1.24.0/bson_decimal128_t.html new file mode 100644 index 0000000000000000000000000000000000000000..67e79863b4a08907e4bb28b1d37ac9a39a36e1d6 --- /dev/null +++ b/libbson/1.24.0/bson_decimal128_t.html @@ -0,0 +1,194 @@ + + + + + + + + + + + + + + bson_decimal128_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_decimal128_t

    +

    BSON Decimal128 Abstraction

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +#define BSON_DECIMAL128_STRING 43
    +#define BSON_DECIMAL128_INF "Infinity"
    +#define BSON_DECIMAL128_NAN "NaN"
    +
    +typedef struct {
    +#if BSON_BYTE_ORDER == BSON_LITTLE_ENDIAN
    +   uint64_t low;
    +   uint64_t high;
    +#elif BSON_BYTE_ORDER == BSON_BIG_ENDIAN
    +   uint64_t high;
    +   uint64_t low;
    +#endif
    +} bson_decimal128_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_decimal128_t structure represents the IEEE-754 Decimal128 +data type. The type bson_decimal128_t is an aggregate that contains two +uint64_ts, named high and low. The declaration and layout order +between them depends on the endian order of the target platform: low will +always correspond to the low-order bits of the Decimal128 object, while high +corresponds to the high-order bits. The bson_decimal128_t always has a size +of sixteen (16), and can be bit-cast to/from a _Decimal128.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   char string[BSON_DECIMAL128_STRING];
    +   bson_decimal128_t decimal128;
    +
    +   bson_decimal128_from_string ("100.00", &decimal128);
    +   bson_decimal128_to_string (&decimal128, string);
    +   printf ("Decimal128 value: %s\n", string);
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_decimal128_to_string.html b/libbson/1.24.0/bson_decimal128_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..d76b02e3d2a8c2f38163cfe29cc3ff8e6d77e96f --- /dev/null +++ b/libbson/1.24.0/bson_decimal128_to_string.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_decimal128_to_string() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_decimal128_to_string()

    +
    +

    Synopsis

    +
    void
    +bson_decimal128_to_string (const bson_decimal128_t *dec, char *str);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • dec: A bson_decimal128_t.

    • +
    • str: A location of length BSON_DECIMAL128_STRING for the resulting string.

    • +
    +
    +
    +

    Description

    +

    Converts dec into a printable string.

    +
    +
    +

    Example

    +
    char decimal128_string[BSON_DECIMAL128_STRING];
    +bson_decimal128_to_string (&decimal128t, decimal128_string);
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_destroy.html b/libbson/1.24.0/bson_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..32d9ea26870f54642e35bcc774325a9aa5ebd581 --- /dev/null +++ b/libbson/1.24.0/bson_destroy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_destroy (bson_t *bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_destroy() function shall free an allocated bson_t structure. Does nothing if bson is NULL.

    +

    This function should always be called when you are done with a bson_t unless otherwise specified.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_destroy_with_steal.html b/libbson/1.24.0/bson_destroy_with_steal.html new file mode 100644 index 0000000000000000000000000000000000000000..78f309836065ea2c345402bd8933173fa505088b --- /dev/null +++ b/libbson/1.24.0/bson_destroy_with_steal.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + bson_destroy_with_steal() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_destroy_with_steal()

    +
    +

    Synopsis

    +
    uint8_t *
    +bson_destroy_with_steal (bson_t *bson, bool steal, uint32_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • steal: A bool indicating if the underlying buffer should be stolen.

    • +
    • length: A location for storing the resulting buffer length.

    • +
    +
    +
    +

    Description

    +

    The bson_destroy_with_steal() function shall destroy a bson_t structure but return the underlying buffer instead of freeing it. If steal is false, this is equivalent to calling bson_destroy(). It is a programming error to call this function on a bson_t that is not a top-level bson_t, such as those initialized with bson_append_document_begin(), bson_append_array_begin(), and bson_writer_begin().

    +
    +
    +

    Returns

    +

    bson_destroy_with_steal() shall return a buffer containing the contents of the bson_t if steal is non-zero. This should be freed with bson_free() when no longer in use. length will be set to the length of the bson document if non-NULL.

    +
    +

    See also

    +
    +
    bson_steal(), a higher-level function that efficiently transfers the contents of one bson_t to another.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_equal.html b/libbson/1.24.0/bson_equal.html new file mode 100644 index 0000000000000000000000000000000000000000..f97c69b251bf22b59ac088cadf733c20a0399ab2 --- /dev/null +++ b/libbson/1.24.0/bson_equal.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_equal() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_equal()

    +
    +

    Synopsis

    +
    bool
    +bson_equal (const bson_t *bson, const bson_t *other);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_equal() function shall return true if both documents are equal.

    +
    +
    +

    Returns

    +

    true if both documents are equal.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_error_t.html b/libbson/1.24.0/bson_error_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c83f4d29ac876c5288b22b2cb03d0a080b25e68a --- /dev/null +++ b/libbson/1.24.0/bson_error_t.html @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + bson_error_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_error_t

    +

    BSON Error Encapsulation

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct {
    +   uint32_t domain;
    +   uint32_t code;
    +   char message[504];
    +} bson_error_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_error_t structure is used as an out-parameter to pass error information to the caller. It should be stack-allocated and does not requiring freeing.

    +

    See Handling Errors.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    bson_reader_t *reader;
    +bson_error_t error;
    +
    +reader = bson_reader_new_from_file ("dump.bson", &error);
    +if (!reader) {
    +   fprintf (
    +      stderr, "ERROR: %d.%d: %s\n", error.domain, error.code, error.message);
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_free.html b/libbson/1.24.0/bson_free.html new file mode 100644 index 0000000000000000000000000000000000000000..67fb542751914ec15c7e4006a1b2bb625dcbea72 --- /dev/null +++ b/libbson/1.24.0/bson_free.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_free() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_free()

    +
    +

    Synopsis

    +
    void
    +bson_free (void *mem);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • mem: A memory region.

    • +
    +
    +
    +

    Description

    +

    This function shall free the memory supplied by mem. This should be used by functions that require you free the result with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_get_data.html b/libbson/1.24.0/bson_get_data.html new file mode 100644 index 0000000000000000000000000000000000000000..d04132ce5f86855b49e2bcbc44aa89b69861e3a0 --- /dev/null +++ b/libbson/1.24.0/bson_get_data.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_get_data() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_get_data()

    +
    +

    Synopsis

    +
    const uint8_t *
    +bson_get_data (const bson_t *bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_get_data() function shall return the raw buffer of a bson document. This can be used in conjunction with the len property of a bson_t if you want to copy the raw buffer around.

    +
    +
    +

    Returns

    +

    A buffer which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_get_major_version.html b/libbson/1.24.0/bson_get_major_version.html new file mode 100644 index 0000000000000000000000000000000000000000..1b3ac5a1c48d1bca546d5f0e10a18d8c6daffa85 --- /dev/null +++ b/libbson/1.24.0/bson_get_major_version.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_get_major_version() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_get_major_version()

    +
    +

    Synopsis

    +
    int
    +bson_get_major_version (void);
    +
    +
    +
    +
    +

    Description

    +

    Get the first number in libbson’s MAJOR.MINOR.MICRO release version.

    +
    +
    +

    Returns

    +

    The value of BSON_MAJOR_VERSION when Libbson was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_get_micro_version.html b/libbson/1.24.0/bson_get_micro_version.html new file mode 100644 index 0000000000000000000000000000000000000000..663b263310323a65e9e111652140fa4269780355 --- /dev/null +++ b/libbson/1.24.0/bson_get_micro_version.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_get_micro_version() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_get_micro_version()

    +
    +

    Synopsis

    +
    int
    +bson_get_micro_version (void);
    +
    +
    +
    +
    +

    Description

    +

    Get the third number in libbson’s MAJOR.MINOR.MICRO release version.

    +
    +
    +

    Returns

    +

    The value of BSON_MICRO_VERSION when Libbson was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_get_minor_version.html b/libbson/1.24.0/bson_get_minor_version.html new file mode 100644 index 0000000000000000000000000000000000000000..12218c3625889f4a8a84e84c01fdb6b0ad04f455 --- /dev/null +++ b/libbson/1.24.0/bson_get_minor_version.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_get_minor_version() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_get_minor_version()

    +
    +

    Synopsis

    +
    int
    +bson_get_minor_version (void);
    +
    +
    +
    +
    +

    Description

    +

    Get the middle number in libbson’s MAJOR.MINOR.MICRO release version.

    +
    +
    +

    Returns

    +

    The value of BSON_MINOR_VERSION when Libbson was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_get_monotonic_time.html b/libbson/1.24.0/bson_get_monotonic_time.html new file mode 100644 index 0000000000000000000000000000000000000000..407a44e324a989a490ac7108c491991605682fa1 --- /dev/null +++ b/libbson/1.24.0/bson_get_monotonic_time.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + System Clock — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    System Clock

    +

    BSON Clock Abstraction

    +
    +

    Synopsis

    +
    int64_t
    +bson_get_monotonic_time (void);
    +int
    +bson_gettimeofday (struct timeval *tv);
    +
    +
    +
    +
    +

    Description

    +

    The clock abstraction in Libbson provides a cross-platform way to handle timeouts within the BSON library. It abstracts the differences in implementations of gettimeofday() as well as providing a monotonic (incrementing only) clock in microseconds.

    +
    +
    +

    Functions

    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_get_version.html b/libbson/1.24.0/bson_get_version.html new file mode 100644 index 0000000000000000000000000000000000000000..c83e6de352679dfba4ab3dba45b9de1249df700b --- /dev/null +++ b/libbson/1.24.0/bson_get_version.html @@ -0,0 +1,145 @@ + + + + + + + + + + + + + + bson_get_version() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_get_version()

    +
    +

    Synopsis

    +
    const char *
    +bson_get_version (void);
    +
    +
    +
    +
    +

    Description

    +

    A string representation of Libbson’s version, formatted something like “1.2.3” or “1.2.3-pre”.

    +
    +
    +

    Returns

    +

    A string you must not modify or free.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_has_field.html b/libbson/1.24.0/bson_has_field.html new file mode 100644 index 0000000000000000000000000000000000000000..87f579c1326fa6abf28a04b671e3a1594710c0da --- /dev/null +++ b/libbson/1.24.0/bson_has_field.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_has_field() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_has_field()

    +
    +

    Synopsis

    +
    bool
    +bson_has_field (const bson_t *bson, const char *key);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • key: A string containing the name of the field to check for.

    • +
    +
    +
    +

    Description

    +

    Checks to see if key contains an element named key. This also accepts “dotkey” notation such as “a.b.c.d”.

    +
    +
    +

    Returns

    +

    true if key was found within bson; otherwise false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_init.html b/libbson/1.24.0/bson_init.html new file mode 100644 index 0000000000000000000000000000000000000000..3b04cdddf612b23b2bd19abecae8d5aafdf2cf50 --- /dev/null +++ b/libbson/1.24.0/bson_init.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + bson_init() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_init()

    +
    +

    Synopsis

    +
    void
    +bson_init (bson_t *b);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_init() function shall initialize a bson_t that is placed on the stack. This is equivalent to initializing a bson_t to BSON_INITIALIZER.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_init_from_json.html b/libbson/1.24.0/bson_init_from_json.html new file mode 100644 index 0000000000000000000000000000000000000000..2eb704d5d86c8ac4452f1990a97d79ed920c7e81 --- /dev/null +++ b/libbson/1.24.0/bson_init_from_json.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + bson_init_from_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_init_from_json()

    +
    +

    Synopsis

    +
    bool
    +bson_init_from_json (bson_t *bson,
    +                     const char *data,
    +                     ssize_t len,
    +                     bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: Pointer to an uninitialized bson_t.

    • +
    • data: A UTF-8 encoded string containing valid JSON.

    • +
    • len: The length of data in bytes excluding a trailing \0 or -1 to determine the length with strlen().

    • +
    • error: An optional location for a bson_error_t.

    • +
    +
    +
    +

    Description

    +

    The bson_init_from_json() function will initialize a new bson_t by parsing the JSON found in data. Only a single JSON object may exist in data or an error will be set and false returned.

    +

    data should be in MongoDB Extended JSON format.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if valid JSON was parsed, otherwise false and error is set. On success, bson is initialized and must be freed with bson_destroy(), otherwise bson is invalid.

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_init_static.html b/libbson/1.24.0/bson_init_static.html new file mode 100644 index 0000000000000000000000000000000000000000..7aaef029626cba1fb806aefb5f784a3ed7ab8daa --- /dev/null +++ b/libbson/1.24.0/bson_init_static.html @@ -0,0 +1,194 @@ + + + + + + + + + + + + + + bson_init_static() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_init_static()

    +
    +

    Synopsis

    +
    bool
    +bson_init_static (bson_t *b, const uint8_t *data, size_t length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • b: A bson_t.

    • +
    • data: A buffer to initialize with.

    • +
    • length: The length of data in bytes.

    • +
    +
    +
    +

    Description

    +

    The bson_init_static() function shall shall initialize a read-only bson_t on the stack using the data provided. No copies of the data will be made and therefore must remain valid for the lifetime of the bson_t.

    +

    The resulting bson_t has internal references and therefore must not be copied to avoid dangling pointers in the copy.

    +
    +
    +

    Returns

    +

    Returns true if bson_t was successfully initialized, otherwise false. The function can fail if data or length are invalid.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_isspace.html b/libbson/1.24.0/bson_isspace.html new file mode 100644 index 0000000000000000000000000000000000000000..189856757053e60429e061ac4695b05a573832a3 --- /dev/null +++ b/libbson/1.24.0/bson_isspace.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_isspace() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_isspace()

    +
    +

    Synopsis

    +
    bool
    +bson_isspace (int c);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • c: A character.

    • +
    +
    +
    +

    Description

    +

    A safer alternative to isspace with additional bounds checking.

    +

    It is equivalent to isspace, excepts always returns false if c is out of the inclusive bounds [-1, 255].

    +
    +
    +

    Returns

    +

    A boolean indicating if the c is considered white-space (as determined by the isspace function).

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_array.html b/libbson/1.24.0/bson_iter_array.html new file mode 100644 index 0000000000000000000000000000000000000000..b6c0cb980265d510514485bd01236054964be477 --- /dev/null +++ b/libbson/1.24.0/bson_iter_array.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_array() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_array()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_ARRAY(iter) (bson_iter_type ((iter)) == BSON_TYPE_ARRAY)
    +
    +void
    +bson_iter_array (const bson_iter_t *iter,
    +                 uint32_t *array_len,
    +                 const uint8_t **array);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • array_len: A location for the buffer length.

    • +
    • array: A location for the immutable buffer.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_array() function shall retrieve the raw buffer of a sub-array from iter. iter MUST be on an element that is of type BSON_TYPE_ARRAY. This can be verified with bson_iter_type() or the BSON_ITER_HOLDS_ARRAY() macro.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_as_bool.html b/libbson/1.24.0/bson_iter_as_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..19d02140a6033f8a1368c9083ceed1d8dff2f3c5 --- /dev/null +++ b/libbson/1.24.0/bson_iter_as_bool.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + bson_iter_as_bool() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_as_bool()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_as_bool (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the current field as if it were a boolean.

    +

    bson_iter_as_bool() currently knows how to determine a boolean value from the following types:

    +
      +
    • BSON_TYPE_BOOL

    • +
    • BSON_TYPE_DOUBLE

    • +
    • BSON_TYPE_INT32

    • +
    • BSON_TYPE_INT64

    • +
    • BSON_TYPE_NULL

    • +
    • BSON_TYPE_UNDEFINED

    • +
    • BSON_TYPE_UTF8

    • +
    +

    BSON_TYPE_UTF8 will always equate to true.

    +
    +
    +

    Returns

    +

    true if the field equates to non-zero.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_as_double.html b/libbson/1.24.0/bson_iter_as_double.html new file mode 100644 index 0000000000000000000000000000000000000000..c0705ee235bb76c38b2f2191902da773b653fbf5 --- /dev/null +++ b/libbson/1.24.0/bson_iter_as_double.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + bson_iter_as_double() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_as_double()

    +
    +

    Synopsis

    +
    double
    +bson_iter_as_double (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the current field as if it were a double.

    +

    bson_iter_as_double() will cast the following types to double

    +
      +
    • BSON_TYPE_BOOL

    • +
    • BSON_TYPE_DOUBLE

    • +
    • BSON_TYPE_INT32

    • +
    • BSON_TYPE_INT64

    • +
    +

    Any other value will return 0.

    +
    +
    +

    Returns

    +

    The value type casted to double.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_as_int64.html b/libbson/1.24.0/bson_iter_as_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..c209589f5376ebb0b4fc4d96567a97ee682178c2 --- /dev/null +++ b/libbson/1.24.0/bson_iter_as_int64.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_as_int64() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_as_int64()

    +
    +

    Synopsis

    +
    int64_t
    +bson_iter_as_int64 (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_as_int64() function shall return the contents of the current element as if it were a BSON_TYPE_INT64 element. The currently supported casts include:

    +
      +
    • BSON_TYPE_BOOL

    • +
    • BSON_TYPE_DOUBLE

    • +
    • BSON_TYPE_INT32

    • +
    • BSON_TYPE_INT64

    • +
    +
    +
    +

    Returns

    +

    A 64-bit signed integer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_binary.html b/libbson/1.24.0/bson_iter_binary.html new file mode 100644 index 0000000000000000000000000000000000000000..1ee0a2949c37f1d5b46b3a971020dd5bff4aeac1 --- /dev/null +++ b/libbson/1.24.0/bson_iter_binary.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_binary() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_binary()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_BINARY(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_BINARY)
    +
    +void
    +bson_iter_binary (const bson_iter_t *iter,
    +                  bson_subtype_t *subtype,
    +                  uint32_t *binary_len,
    +                  const uint8_t **binary);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • subtype: A location for a bson_subtype_t or NULL.

    • +
    • binary_len: A location for the length of binary.

    • +
    • binary: A location for a pointer to the immutable buffer.

    • +
    +
    +
    +

    Description

    +

    This function shall return the binary data of a BSON_TYPE_BINARY element. It is a programming error to call this function on a field that is not of type BSON_TYPE_BINARY. You can check this with the BSON_ITER_HOLDS_BINARY() macro or bson_iter_type().

    +

    The buffer that binary points to is only valid until the iterator’s bson_t is modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_bool.html b/libbson/1.24.0/bson_iter_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..1d77061fead3f706ffe0277ce64fe15585c71ecc --- /dev/null +++ b/libbson/1.24.0/bson_iter_bool.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_bool() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_bool()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_BOOL(iter) (bson_iter_type ((iter)) == BSON_TYPE_BOOL)
    +
    +bool
    +bson_iter_bool (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_bool() function shall return the boolean value of a BSON_TYPE_BOOL element. It is a programming error to call this function on an element other than BSON_TYPE_BOOL. You can check this with bson_iter_type() or BSON_ITER_HOLDS_BOOL().

    +
    +
    +

    Returns

    +

    Either true or false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_code.html b/libbson/1.24.0/bson_iter_code.html new file mode 100644 index 0000000000000000000000000000000000000000..02648944bf128d27d952f8abf7f7e83fb4c86f40 --- /dev/null +++ b/libbson/1.24.0/bson_iter_code.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_iter_code() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_code()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_CODE(iter) (bson_iter_type ((iter)) == BSON_TYPE_CODE)
    +
    +const char *
    +bson_iter_code (const bson_iter_t *iter, uint32_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • length: A location for the length of the UTF-8 encoded string or NULL.

    • +
    +
    +
    +

    Description

    +

    This function returns the contents of a BSON_TYPE_CODE field. The length of the string is stored in length if non-NULL.

    +

    It is invalid to call this function on a field that is not of type BSON_TYPE_CODE.

    +
    +
    +

    Returns

    +

    A UTF-8 encoded string which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_codewscope.html b/libbson/1.24.0/bson_iter_codewscope.html new file mode 100644 index 0000000000000000000000000000000000000000..4f5b9646691a5801a80083c1c22e11430fb75b98 --- /dev/null +++ b/libbson/1.24.0/bson_iter_codewscope.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_iter_codewscope() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_codewscope()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_CODEWSCOPE(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_CODEWSCOPE)
    +
    +const char *
    +bson_iter_codewscope (const bson_iter_t *iter,
    +                      uint32_t *length,
    +                      uint32_t *scope_len,
    +                      const uint8_t **scope);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • length: An optional location for the length of the resulting UTF-8 encoded string.

    • +
    • scope_len: A optional location for the length of scope.

    • +
    • scope: An optional location to store the immutable raw scope BSON document.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_codewscope() function acts similar to bson_iter_code() except for BSON_TYPE_CODEWSCOPE elements. It also will provide a pointer to the buffer for scope, which can be loaded into a bson_t using bson_init_static().

    +
    +
    +

    Returns

    +

    An UTF-8 encoded string containing the JavaScript code which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_date_time.html b/libbson/1.24.0/bson_iter_date_time.html new file mode 100644 index 0000000000000000000000000000000000000000..025a6a4ee066afe8d685e89d6eaf0ef48ff95496 --- /dev/null +++ b/libbson/1.24.0/bson_iter_date_time.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_date_time() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_date_time()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_DATE_TIME(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_DATE_TIME)
    +
    +int64_t
    +bson_iter_date_time (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_date_time() function shall return the number of milliseconds since the UNIX epoch, as contained in the BSON_TYPE_DATE_TIME element.

    +
    +
    +

    Returns

    +

    A 64-bit integer containing the number of milliseconds since the UNIX epoch.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_dbpointer.html b/libbson/1.24.0/bson_iter_dbpointer.html new file mode 100644 index 0000000000000000000000000000000000000000..091b24f5b1aa7c9d3df4292973775fce27357997 --- /dev/null +++ b/libbson/1.24.0/bson_iter_dbpointer.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_dbpointer() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_dbpointer()

    +
    +

    Synopsis

    +
    void
    +bson_iter_dbpointer (const bson_iter_t *iter,
    +                     uint32_t *collection_len,
    +                     const char **collection,
    +                     const bson_oid_t **oid);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • collection_len: A location for the length of the collection name.

    • +
    • collection: A location for the collection name..

    • +
    • oid: A location for a bson_oid_t.

    • +
    +
    +
    +

    Description

    +

    Fetches the contents of a BSON_TYPE_DBPOINTER element.

    +
    +

    Warning

    +

    The BSON_TYPE_DBPOINTER field type is deprecated by the BSON spec and should not be used in new code.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_decimal128.html b/libbson/1.24.0/bson_iter_decimal128.html new file mode 100644 index 0000000000000000000000000000000000000000..8c9680a5ef3adafca3d3df709c1be355bcca1c17 --- /dev/null +++ b/libbson/1.24.0/bson_iter_decimal128.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_iter_decimal128() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_decimal128()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_DECIMAL128(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_DECIMAL128)
    +
    +bool
    +bson_iter_decimal128 (const bson_iter_t *iter, /* IN */
    +                      bson_decimal128_t *dec); /* OUT */
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the value from a BSON_TYPE_DECIMAL128 field. You should verify that this is a BSON_TYPE_DECIMAL128 field before calling this function.

    +
    +
    +

    Returns

    +

    true if type was BSON_TYPE_DECIMAL128, otherwise false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_document.html b/libbson/1.24.0/bson_iter_document.html new file mode 100644 index 0000000000000000000000000000000000000000..38d32c68fbd7610732c7a2002f26b7db2408eafd --- /dev/null +++ b/libbson/1.24.0/bson_iter_document.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_document() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_document()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_DOCUMENT(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_DOCUMENT)
    +
    +void
    +bson_iter_document (const bson_iter_t *iter,
    +                    uint32_t *document_len,
    +                    const uint8_t **document);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • document_len: A location for the length of the document in bytes.

    • +
    • document: A location for the document buffer.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_document() function shall retrieve the raw buffer of a sub-document from iter. iter MUST be on an element that is of type BSON_TYPE_DOCUMENT. This can be verified with bson_iter_type() or the BSON_ITER_HOLDS_DOCUMENT() macro.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_double.html b/libbson/1.24.0/bson_iter_double.html new file mode 100644 index 0000000000000000000000000000000000000000..bedf833ca91c6233a3e75db90f8a221d0249d0df --- /dev/null +++ b/libbson/1.24.0/bson_iter_double.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_double() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_double()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_DOUBLE(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_DOUBLE)
    +
    +double
    +bson_iter_double (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the contents of a BSON_TYPE_DOUBLE field.

    +
    +
    +

    Returns

    +

    A double.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_dup_utf8.html b/libbson/1.24.0/bson_iter_dup_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..bb1d35b322b431a7c9f180dedd496d523cd47299 --- /dev/null +++ b/libbson/1.24.0/bson_iter_dup_utf8.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_iter_dup_utf8() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_dup_utf8()

    +
    +

    Synopsis

    +
    char *
    +bson_iter_dup_utf8 (const bson_iter_t *iter, uint32_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • length: An optional location for the length of the UTF-8 encoded string.

    • +
    +
    +
    +

    Description

    +

    This function is similar to bson_iter_utf8() except that it calls bson_strndup() on the result.

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_find.html b/libbson/1.24.0/bson_iter_find.html new file mode 100644 index 0000000000000000000000000000000000000000..dc112a08dd0cf359aad61b4c6960687374ac69b9 --- /dev/null +++ b/libbson/1.24.0/bson_iter_find.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_find() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_find()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_find (bson_iter_t *iter, const char *key);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • key: A string containing the requested key.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_find() function shall advance iter to the first element named key or exhaust all elements of iter. If iter is exhausted, false is returned and iter should be considered invalid.

    +

    key is case-sensitive. For a case-folded version, see bson_iter_find_case().

    +
    +
    +

    Returns

    +

    true is returned if the requested key was found. If not, iter was exhausted and should now be considered invalid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_find_case.html b/libbson/1.24.0/bson_iter_find_case.html new file mode 100644 index 0000000000000000000000000000000000000000..3eef7cad0c75de99faa0a9a26ea967837a6afe97 --- /dev/null +++ b/libbson/1.24.0/bson_iter_find_case.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_find_case() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_find_case()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_find_case (bson_iter_t *iter, const char *key);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • key: An ASCII string containing the field to locate.

    • +
    +
    +
    +

    Description

    +

    Advances iter to the first element matching the name of key or exhausting all elements.

    +

    key is not case-sensitive. The keys will be case-folded to determine a match using the current locale.

    +
    +
    +

    Returns

    +

    true if key was found.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_find_descendant.html b/libbson/1.24.0/bson_iter_find_descendant.html new file mode 100644 index 0000000000000000000000000000000000000000..2bc51c427343b9e1978cde3afb9465092dc105f8 --- /dev/null +++ b/libbson/1.24.0/bson_iter_find_descendant.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_iter_find_descendant() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_find_descendant()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_find_descendant (bson_iter_t *iter,
    +                           const char *dotkey,
    +                           bson_iter_t *descendant);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_find_descendant() function shall follow standard MongoDB dot notation to recurse into subdocuments. descendant will be initialized and advanced to the descendant. If false is returned, both iter and descendant should be considered invalid.

    +
    +
    +

    Returns

    +

    true is returned if the requested key was found. If not, false is returned and iter was exhausted and should now be considered invalid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_find_w_len.html b/libbson/1.24.0/bson_iter_find_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..374c0db2ab70cc3fd70686cefbc32d69e0bd2eb2 --- /dev/null +++ b/libbson/1.24.0/bson_iter_find_w_len.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_find_w_len() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_find_w_len()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_find_w_len (bson_iter_t *iter, const char *key, int keylen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • key: A string containing the requested key.

    • +
    • keylen: An integer indicating the length of the key string.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_find_w_len() function shall advance iter to the first element named key or exhaust all elements of iter. If iter is exhausted, false is returned and iter should be considered invalid.

    +

    key is case-sensitive. For a case-folded version, see bson_iter_find_case().

    +
    +
    +

    Returns

    +

    true is returned if the requested key was found. If not, iter was exhausted and should now be considered invalid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_init.html b/libbson/1.24.0/bson_iter_init.html new file mode 100644 index 0000000000000000000000000000000000000000..c44b9b8ff53582d342c9a76ea1fb2279514fb3b3 --- /dev/null +++ b/libbson/1.24.0/bson_iter_init.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + bson_iter_init() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_init()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_init (bson_iter_t *iter, const bson_t *bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_init() function shall initialize iter to iterate upon the BSON document bson. Upon initialization, iter is placed before the first element. Callers must call bson_iter_next(), bson_iter_find(), or bson_iter_find_case() to advance to an element.

    +
    +
    +

    Returns

    +

    Returns true if the iter was successfully initialized.

    +
    +
    +

    Example

    +
    static void
    +print_doc_id (const bson_t *doc)
    +{
    +   bson_iter_t iter;
    +   bson_oid_t oid;
    +   char oidstr[25];
    +
    +   if (bson_iter_init (&iter, doc) && bson_iter_find (&iter, "_id") &&
    +       BSON_ITER_HOLDS_OID (&iter)) {
    +      bson_iter_oid (&iter, &oid);
    +      bson_oid_to_string (&oid, oidstr);
    +      printf ("%s\n", oidstr);
    +   } else {
    +      printf ("Document is missing _id.\n");
    +   }
    +}
    +
    +/* alternatively */
    +
    +static void
    +print_doc_id (const bson_t *doc)
    +{
    +   bson_iter_t iter;
    +   bson_oid_t oid;
    +   char oidstr[25];
    +
    +   if (bson_iter_init_find (&iter, doc, "_id") && BSON_ITER_HOLDS_OID (&iter)) {
    +      bson_iter_oid (&iter, &oid);
    +      bson_oid_to_string (&oid, oidstr);
    +      printf ("%s\n", oidstr);
    +   } else {
    +      printf ("Document is missing _id.\n");
    +   }
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_init_find.html b/libbson/1.24.0/bson_iter_init_find.html new file mode 100644 index 0000000000000000000000000000000000000000..e353ba3b2d914cbc229292d97d1737478d35f728 --- /dev/null +++ b/libbson/1.24.0/bson_iter_init_find.html @@ -0,0 +1,168 @@ + + + + + + + + + + + + + + bson_iter_init_find() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_init_find()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_init_find (bson_iter_t *iter, const bson_t *bson, const char *key);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • bson: A bson_t.

    • +
    • key: A key to locate after initializing the iter.

    • +
    +
    +
    +

    Description

    +

    This function is identical to (bson_iter_init() && bson_iter_find()).

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_init_find_case.html b/libbson/1.24.0/bson_iter_init_find_case.html new file mode 100644 index 0000000000000000000000000000000000000000..aafa6c43e67676dd03109456461ae08071698835 --- /dev/null +++ b/libbson/1.24.0/bson_iter_init_find_case.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_iter_init_find_case() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_init_find_case()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_init_find_case (bson_iter_t *iter,
    +                          const bson_t *bson,
    +                          const char *key);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • bson: A bson_t.

    • +
    • key: A key to locate after initializing the iter.

    • +
    +
    +
    +

    Description

    +

    This function is identical to bson_iter_init() && bson_iter_find_case().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_init_find_w_len.html b/libbson/1.24.0/bson_iter_init_find_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..9c7609a722b5cdae00cdb3120ade97b461538617 --- /dev/null +++ b/libbson/1.24.0/bson_iter_init_find_w_len.html @@ -0,0 +1,172 @@ + + + + + + + + + + + + + + bson_iter_init_find_w_len() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_init_find_w_len()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_init_find_w_len (bson_iter_t *iter,
    +                           const bson_t *bson,
    +                           const char *key,
    +                           int keylen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • bson: A bson_t.

    • +
    • key: A key to locate after initializing the iter.

    • +
    • keylen: An integer indicating the length of the key string.

    • +
    +
    +
    +

    Description

    +

    This function is identical to (bson_iter_init() && bson_iter_find_w_len()).

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_init_from_data.html b/libbson/1.24.0/bson_iter_init_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..e668bc282417876d712278112b3d4d67a963bd5b --- /dev/null +++ b/libbson/1.24.0/bson_iter_init_from_data.html @@ -0,0 +1,193 @@ + + + + + + + + + + + + + + bson_iter_init_from_data() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_init_from_data()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_init_from_data (bson_iter_t *iter, const uint8_t *data, size_t length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • data: A buffer to initialize with.

    • +
    • length: The length of data in bytes.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_init_from_data() function shall initialize iter to iterate upon the buffer data, which must contain a BSON document. Upon initialization, iter is placed before the first element. Callers must call bson_iter_next(), bson_iter_find(), or bson_iter_find_case() to advance to an element.

    +
    +
    +

    Returns

    +

    Returns true if the iter was successfully initialized.

    +
    +
    +

    Example

    +
    static void
    +print_doc_id (const uint8_t *data, size_t length)
    +{
    +   bson_iter_t iter;
    +   bson_oid_t oid;
    +   char oidstr[25];
    +
    +   if (bson_iter_init_from_data (&iter, data, length) && bson_iter_find (&iter, "_id") &&
    +       BSON_ITER_HOLDS_OID (&iter)) {
    +      bson_iter_oid (&iter, &oid);
    +      bson_oid_to_string (&oid, oidstr);
    +      printf ("%s\n", oidstr);
    +   } else {
    +      printf ("Document is missing _id.\n");
    +   }
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_init_from_data_at_offset.html b/libbson/1.24.0/bson_iter_init_from_data_at_offset.html new file mode 100644 index 0000000000000000000000000000000000000000..160b9cd40bf10883796cacb536827f5e0155ff16 --- /dev/null +++ b/libbson/1.24.0/bson_iter_init_from_data_at_offset.html @@ -0,0 +1,188 @@ + + + + + + + + + + + + + + bson_iter_init_from_data_at_offset() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_init_from_data_at_offset()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_init_from_data_at_offset (bson_iter_t *iter,
    +                                    const uint8_t *data,
    +                                    size_t length,
    +                                    uint32_t offset,
    +                                    uint32_t keylen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • data: A buffer to initialize with. This is not validated.

    • +
    • length: The length of data in bytes. This is not validated.

    • +
    • offset: The offset of the field to start iterating. This is not validated. This should be an offset previously obtained from bson_iter_offset().

    • +
    • keylen: The string length of the key of the field to start iterating. This is not validated. This should be a length previously obtained from bson_iter_key_len().

    • +
    +
    +
    +

    Description

    +

    Creates a bson_iter_t and starts iteration on a field at the offset.

    +

    bson_iter_init_from_data_at_offset() is useful for situations where the +progress of a bson_iter_t must be saved and restored without relying +on the bson_iter_t data layout. Saving the progress could be +accomplished by:

    + +

    Then later, these saved values can be passed to +bson_iter_init_from_data_at_offset() to reconstruct the +bson_iter_t in constant time.

    +
    +
    +

    Returns

    +

    Returns true if the iter was successfully initialized.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_int32.html b/libbson/1.24.0/bson_iter_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..347e414623922a7b316eacc414a2ba1b221bc1b9 --- /dev/null +++ b/libbson/1.24.0/bson_iter_int32.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_int32() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_int32()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_INT32(iter) (bson_iter_type ((iter)) == BSON_TYPE_INT32)
    +
    +int32_t
    +bson_iter_int32 (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the value from a BSON_TYPE_INT32 element. You should verify that the field is a BSON_TYPE_INT32 field before calling this function.

    +
    +
    +

    Returns

    +

    A 32-bit integer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_int64.html b/libbson/1.24.0/bson_iter_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..cea73df7c3cf048b0b6d9fc2209c312f668e188b --- /dev/null +++ b/libbson/1.24.0/bson_iter_int64.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_int64() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_int64()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_INT64(iter) (bson_iter_type ((iter)) == BSON_TYPE_INT64)
    +
    +int64_t
    +bson_iter_int64 (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the value from a BSON_TYPE_INT64 field. You should verify that this is a BSON_TYPE_INT64 field before calling this function.

    +
    +
    +

    Returns

    +

    A 64-bit integer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_key.html b/libbson/1.24.0/bson_iter_key.html new file mode 100644 index 0000000000000000000000000000000000000000..f4b4ae78af0ebc2b719dc8e717dd638d14331c43 --- /dev/null +++ b/libbson/1.24.0/bson_iter_key.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_key() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_key()

    +
    +

    Synopsis

    +
    const char *
    +bson_iter_key (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the key for the current element observed by iter.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed.

    +
    +

    See also

    +
    +
    bson_iter_key_len() to retrieve the length of the key in constant time.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_key_len.html b/libbson/1.24.0/bson_iter_key_len.html new file mode 100644 index 0000000000000000000000000000000000000000..50f357f91cab39ff2d8d1a0c5fa71d235aa9025d --- /dev/null +++ b/libbson/1.24.0/bson_iter_key_len.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_key_len() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_key_len()

    +
    +

    Synopsis

    +
    uint32_t
    +bson_iter_key_len (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the length of the key for the current element observed by iter. This is a constant time computation, and therefore faster than calling strlen() on a key returned by bson_iter_key().

    +
    +
    +

    Returns

    +

    An integer representing the key length.

    +
    +

    See also

    +
    +
    bson_iter_key() to retrieve current key.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_next.html b/libbson/1.24.0/bson_iter_next.html new file mode 100644 index 0000000000000000000000000000000000000000..5f62e8eb81ee526b85a69d1e19e0a6669d48586f --- /dev/null +++ b/libbson/1.24.0/bson_iter_next.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_iter_next() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_next()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_next (bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Advances iter to the next element in the document.

    +
    +
    +

    Returns

    +

    true if iter was advanced. Returns false if iter has passed the last element in the document or encountered invalid BSON.

    +

    It is a programming error to use iter after this function has returned false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_offset.html b/libbson/1.24.0/bson_iter_offset.html new file mode 100644 index 0000000000000000000000000000000000000000..2c74ff559e5a60a71958446bd6d2287991c28b83 --- /dev/null +++ b/libbson/1.24.0/bson_iter_offset.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_offset() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_offset()

    +
    +

    Synopsis

    +
    uint32_t
    +bson_iter_offset (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the offset for the current element observed by iter.

    +
    +
    +

    Returns

    +

    An unsigned integer representing the offset in the BSON data of the current element.

    +
    +

    See also

    +
    +
    bson_iter_init_from_data_at_offset() to use this offset to reconstruct a bson_iter_t in constant time.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_oid.html b/libbson/1.24.0/bson_iter_oid.html new file mode 100644 index 0000000000000000000000000000000000000000..337ee4d984a8cb894e9f46b5440685048d897890 --- /dev/null +++ b/libbson/1.24.0/bson_iter_oid.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_oid() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_oid()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_OID(iter) (bson_iter_type ((iter)) == BSON_TYPE_OID)
    +
    +const bson_oid_t *
    +bson_iter_oid (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the bson_oid_t for a BSON_TYPE_OID element. You should verify it is an element of type BSON_TYPE_OID before calling this function.

    +
    +
    +

    Returns

    +

    A bson_oid_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_bool.html b/libbson/1.24.0/bson_iter_overwrite_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..44a281718d2f5804b676981d330185f5371c8471 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_bool.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_bool() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_bool()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_bool (bson_iter_t *iter, bool value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • value: A bool containing the new value.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_overwrite_bool() function shall overwrite the contents of a BSON_TYPE_BOOL element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_BOOL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_date_time.html b/libbson/1.24.0/bson_iter_overwrite_date_time.html new file mode 100644 index 0000000000000000000000000000000000000000..3a1edfd29b873f2563c1d8b2bef54749bff66926 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_date_time.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_date_time() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_date_time()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_date_time (bson_iter_t *iter, int64_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • value: The date and time as specified in milliseconds since the UNIX epoch.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_overwrite_date_time() function shall overwrite the contents of a BSON_TYPE_DATE_TIME element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_DATE_TIME.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_decimal128.html b/libbson/1.24.0/bson_iter_overwrite_decimal128.html new file mode 100644 index 0000000000000000000000000000000000000000..eb4d3b0df4e08dd5cb095d51bbb4a26cdfe1c740 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_decimal128.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_decimal128() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_decimal128()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_overwrite_decimal128 (bson_iter_t *iter, const bson_decimal128_t *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • value: The new Decimal128 value.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_overwrite_decimal128() function shall overwrite the contents of a BSON_TYPE_DECIMAL128 element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_DECIMAL128.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_double.html b/libbson/1.24.0/bson_iter_overwrite_double.html new file mode 100644 index 0000000000000000000000000000000000000000..f39264d5f95059f8770a506114dd666e594daa59 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_double.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_double() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_double()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_double (bson_iter_t *iter, double value);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_overwrite_double() function shall overwrite the contents of a BSON_TYPE_DOUBLE element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_DOUBLE.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_int32.html b/libbson/1.24.0/bson_iter_overwrite_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..e392c488c8d2d1d92bd9dfe72b7224e24daffa50 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_int32.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_int32() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_int32()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_int32 (bson_iter_t *iter, int32_t value);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_overwrite_int32() function shall overwrite the contents of a BSON_TYPE_INT32 element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_BOOL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_int64.html b/libbson/1.24.0/bson_iter_overwrite_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..ce17677cb2c478f28c5e01e5ac8ce3be52048ac3 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_int64.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_int64() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_int64()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_int64 (bson_iter_t *iter, int64_t value);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_overwrite_int64() function shall overwrite the contents of a BSON_TYPE_INT64 element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_INT64.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_oid.html b/libbson/1.24.0/bson_iter_overwrite_oid.html new file mode 100644 index 0000000000000000000000000000000000000000..8d5fc149ccb38da73b72a0159b764f049f7a4e4e --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_oid.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_oid() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_oid()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_oid (bson_iter_t *iter, const bson_oid_t *value);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_overwrite_oid() function shall overwrite the contents of a BSON_TYPE_OID element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_OID.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_overwrite_timestamp.html b/libbson/1.24.0/bson_iter_overwrite_timestamp.html new file mode 100644 index 0000000000000000000000000000000000000000..49bedb4cf28470299e3f721ebb7fee4a9fab10c7 --- /dev/null +++ b/libbson/1.24.0/bson_iter_overwrite_timestamp.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_overwrite_timestamp() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_overwrite_timestamp()

    +
    +

    Synopsis

    +
    void
    +bson_iter_overwrite_timestamp (bson_iter_t *iter,
    +                               uint32_t timestamp,
    +                               uint32_t increment);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • timestamp: A uint32_t.

    • +
    • increment: A uint32_t.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_overwrite_timestamp() function shall overwrite the contents of a BSON_TYPE_TIMESTAMP element in place.

    +

    This may only be done when the underlying bson document allows mutation.

    +

    It is a programming error to call this function when iter is not observing an element of type BSON_TYPE_TIMESTAMP.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_recurse.html b/libbson/1.24.0/bson_iter_recurse.html new file mode 100644 index 0000000000000000000000000000000000000000..0fa3b2abd43f0f08f3d9bf0947734a4e44653d73 --- /dev/null +++ b/libbson/1.24.0/bson_iter_recurse.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_recurse() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_recurse()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_recurse (const bson_iter_t *iter, bson_iter_t *child);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_recurse() function shall initialize child using the embedded document or array currently observed by iter.

    +

    If there was a failure to initialize the iter, false is returned and both iter and child should be considered invalid.

    +

    This should only be called when observing an element of type BSON_TYPE_ARRAY or BSON_TYPE_DOCUMENT.

    +
    +
    +

    Returns

    +

    If iter observes an element of type BSON_TYPE_ARRAY or BSON_TYPE_DOCUMENT, then child is initialized and the function returns true. Otherwise, the function returns false and child is invalid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_regex.html b/libbson/1.24.0/bson_iter_regex.html new file mode 100644 index 0000000000000000000000000000000000000000..a58c08c073d4d17466170f7bf446dbc7e5bfa817 --- /dev/null +++ b/libbson/1.24.0/bson_iter_regex.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_regex() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_regex()

    +
    +

    Synopsis

    +
    const char *
    +bson_iter_regex (const bson_iter_t *iter, const char **options);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_regex() function shall retrieve the contents of a BSON_TYPE_REGEX element currently observed by iter.

    +

    It is invalid to call this function when not observing an element of type BSON_TYPE_REGEX.

    +
    +
    +

    Returns

    +

    A string containing the regex which should not be modified or freed. options is set to the options provided for the regex.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_symbol.html b/libbson/1.24.0/bson_iter_symbol.html new file mode 100644 index 0000000000000000000000000000000000000000..096ca87ec568f73b3630eef76f031556e3bc9259 --- /dev/null +++ b/libbson/1.24.0/bson_iter_symbol.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_symbol() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_symbol()

    +
    +

    Synopsis

    +
    const char *
    +bson_iter_symbol (const bson_iter_t *iter, uint32_t *length);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The symbol element type is DEPRECATED in the bson specification at http://bsonspec.org.

    +

    The bson_iter_symbol() function shall return the contents of a BSON_TYPE_SYMBOL element.

    +

    If non-NULL, length will be set to the length of the resulting string.

    +
    +
    +

    Returns

    +

    The symbol and length is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_t.html b/libbson/1.24.0/bson_iter_t.html new file mode 100644 index 0000000000000000000000000000000000000000..30bd2605f78b9cba0e8f05e0d17a294c2433a403 --- /dev/null +++ b/libbson/1.24.0/bson_iter_t.html @@ -0,0 +1,295 @@ + + + + + + + + + + + + + + bson_iter_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_t

    +

    BSON Document Iterator

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +#define BSON_ITER_HOLDS_DOUBLE(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_UTF8(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_DOCUMENT(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_ARRAY(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_BINARY(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_UNDEFINED(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_OID(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_BOOL(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_DATE_TIME(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_NULL(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_REGEX(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_DBPOINTER(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_CODE(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_SYMBOL(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_CODEWSCOPE(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_INT32(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_TIMESTAMP(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_INT64(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_DECIMAL128(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_MAXKEY(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_MINKEY(iter) /* ... */
    +
    +#define BSON_ITER_HOLDS_INT(iter) \
    +   (BSON_ITER_HOLDS_INT32 (iter) || BSON_ITER_HOLDS_INT64 (iter))
    +
    +#define BSON_ITER_HOLDS_NUMBER(iter) \
    +   (BSON_ITER_HOLDS_INT (iter) || BSON_ITER_HOLDS_DOUBLE (iter))
    +
    +#define BSON_ITER_IS_KEY(iter, key) \
    +   (0 == strcmp ((key), bson_iter_key ((iter))))
    +
    +typedef struct {
    +   /*< private >*/
    +} bson_iter_t;
    +
    +
    +
    +
    +

    Description

    +

    bson_iter_t is a structure used to iterate through the elements of a bson_t. It is meant to be used on the stack and can be discarded at any time as it contains no external allocation. The contents of the structure should be considered private and may change between releases, however the structure size will not change.

    +

    The bson_t MUST be valid for the lifetime of the iter and it is an error to modify the bson_t while using the iter.

    +
    +
    +

    Functions

    + +
    +
    +

    Examples

    +
    bson_iter_t iter;
    +
    +if (bson_iter_init (&iter, my_bson_doc)) {
    +   while (bson_iter_next (&iter)) {
    +      printf ("Found a field named: %s\n", bson_iter_key (&iter));
    +   }
    +}
    +
    +
    +
    bson_iter_t iter;
    +
    +if (bson_iter_init (&iter, my_bson_doc) && bson_iter_find (&iter, "my_field")) {
    +   printf ("Found the field named: %s\n", bson_iter_key (&iter));
    +}
    +
    +
    +
    bson_iter_t iter;
    +bson_iter_t sub_iter;
    +
    +if (bson_iter_init_find (&iter, my_bson_doc, "mysubdoc") &&
    +    (BSON_ITER_HOLDS_DOCUMENT (&iter) || BSON_ITER_HOLDS_ARRAY (&iter)) &&
    +    bson_iter_recurse (&iter, &sub_iter)) {
    +   while (bson_iter_next (&sub_iter)) {
    +      printf ("Found key \"%s\" in sub document.\n", bson_iter_key (&sub_iter));
    +   }
    +}
    +
    +
    +
    bson_iter_t iter;
    +
    +if (bson_iter_init (&iter, my_doc) &&
    +    bson_iter_find_descendant (&iter, "a.b.c.d", &sub_iter)) {
    +   printf ("The type of a.b.c.d is: %d\n", (int) bson_iter_type (&sub_iter));
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_time_t.html b/libbson/1.24.0/bson_iter_time_t.html new file mode 100644 index 0000000000000000000000000000000000000000..9717e0b872c54ebf305728aca859c6ed88a152e3 --- /dev/null +++ b/libbson/1.24.0/bson_iter_time_t.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_iter_time_t() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_time_t()

    +
    +

    Synopsis

    +
    time_t
    +bson_iter_time_t (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_time_t() function shall return the number of seconds since the UNIX epoch, as contained in the BSON_TYPE_DATE_TIME element.

    +
    +
    +

    Returns

    +

    A time_t containing the number of seconds since the UNIX epoch.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_timestamp.html b/libbson/1.24.0/bson_iter_timestamp.html new file mode 100644 index 0000000000000000000000000000000000000000..58ef2b7866c9b292503b32d0530bfcbb991cb735 --- /dev/null +++ b/libbson/1.24.0/bson_iter_timestamp.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_iter_timestamp() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_timestamp()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_TIMESTAMP(iter) \
    +   (bson_iter_type ((iter)) == BSON_TYPE_TIMESTAMP)
    +
    +void
    +bson_iter_timestamp (const bson_iter_t *iter,
    +                     uint32_t *timestamp,
    +                     uint32_t *increment);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • timestamp: A uint32_t.

    • +
    • increment: A uint32_t.

    • +
    +
    +
    +

    Description

    +

    The BSON_TYPE_TIMESTAMP type is not a date/time and is typically used for intra-server communication.

    +

    You probably want bson_iter_date_time().

    +

    The bson_iter_timestamp() function shall return the contents of a BSON_TYPE_TIMESTAMP element. It is invalid to call this function while observing an element that is not of type BSON_TYPE_TIMESTAMP.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_timeval.html b/libbson/1.24.0/bson_iter_timeval.html new file mode 100644 index 0000000000000000000000000000000000000000..e64fc368278c351479d8576579b1d119fac11f4d --- /dev/null +++ b/libbson/1.24.0/bson_iter_timeval.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_iter_timeval() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_timeval()

    +
    +

    Synopsis

    +
    void
    +bson_iter_timeval (const bson_iter_t *iter, struct timeval *tv);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_timeval() function shall return the number of seconds and microseconds since the UNIX epoch, as contained in the BSON_TYPE_DATE_TIME element into tv.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_type.html b/libbson/1.24.0/bson_iter_type.html new file mode 100644 index 0000000000000000000000000000000000000000..8d5d0ef1a427f2b90ccbf4b990188e2529dee0b4 --- /dev/null +++ b/libbson/1.24.0/bson_iter_type.html @@ -0,0 +1,179 @@ + + + + + + + + + + + + + + bson_iter_type() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_type()

    +
    +

    Synopsis

    +
    typedef enum {
    +   BSON_TYPE_EOD = 0x00,
    +   BSON_TYPE_DOUBLE = 0x01,
    +   BSON_TYPE_UTF8 = 0x02,
    +   BSON_TYPE_DOCUMENT = 0x03,
    +   BSON_TYPE_ARRAY = 0x04,
    +   BSON_TYPE_BINARY = 0x05,
    +   BSON_TYPE_UNDEFINED = 0x06,
    +   BSON_TYPE_OID = 0x07,
    +   BSON_TYPE_BOOL = 0x08,
    +   BSON_TYPE_DATE_TIME = 0x09,
    +   BSON_TYPE_NULL = 0x0A,
    +   BSON_TYPE_REGEX = 0x0B,
    +   BSON_TYPE_DBPOINTER = 0x0C,
    +   BSON_TYPE_CODE = 0x0D,
    +   BSON_TYPE_SYMBOL = 0x0E,
    +   BSON_TYPE_CODEWSCOPE = 0x0F,
    +   BSON_TYPE_INT32 = 0x10,
    +   BSON_TYPE_TIMESTAMP = 0x11,
    +   BSON_TYPE_INT64 = 0x12,
    +   BSON_TYPE_MAXKEY = 0x7F,
    +   BSON_TYPE_MINKEY = 0xFF,
    +} bson_type_t;
    +
    +bson_type_t
    +bson_iter_type (const bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_iter_type() function shall return the type of the observed element in a bson document.

    +
    +
    +

    Returns

    +

    A bson_type_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_utf8.html b/libbson/1.24.0/bson_iter_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..0a242d2f01c3c16c0fa562e88734fd701ae5efd1 --- /dev/null +++ b/libbson/1.24.0/bson_iter_utf8.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_utf8() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_utf8()

    +
    +

    Synopsis

    +
    #define BSON_ITER_HOLDS_UTF8(iter) (bson_iter_type ((iter)) == BSON_TYPE_UTF8)
    +
    +const char *
    +bson_iter_utf8 (const bson_iter_t *iter, uint32_t *length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • iter: A bson_iter_t.

    • +
    • length: An optional location for the length of the resulting UTF-8 encoded string.

    • +
    +
    +
    +

    Description

    +

    The bson_iter_utf8() function shall retrieve the contents of a BSON_TYPE_UTF8 element currently observed by iter.

    +

    It is invalid to call this function while observing an element other than BSON_TYPE_UTF8.

    +
    +
    +

    Returns

    +

    A UTF-8 encoded string that has not been modified or freed.

    +

    It is suggested that the caller validate the content is valid UTF-8 before using this in other places. That can be done by calling bson_utf8_validate() or validating the underlying bson_t before iterating it.

    +

    Note that not all drivers use multi-byte representation for \0 in UTF-8 encodings (commonly referred to as modified-UTF8). You probably want to take a look at the length field when marshaling to other runtimes.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_value.html b/libbson/1.24.0/bson_iter_value.html new file mode 100644 index 0000000000000000000000000000000000000000..44ad1ee45921c184382de0e709bee0f0a29052dd --- /dev/null +++ b/libbson/1.24.0/bson_iter_value.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_iter_value() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_value()

    +
    +

    Synopsis

    +
    const bson_value_t *
    +bson_iter_value (bson_iter_t *iter);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the value for the currently observed type as a boxed type. This allows passing around the value without knowing the type at runtime.

    +

    If the bson_iter_t is further modified, the bson_value_t is invalidated.

    +
    +
    +

    Returns

    +

    A bson_value_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_iter_visit_all.html b/libbson/1.24.0/bson_iter_visit_all.html new file mode 100644 index 0000000000000000000000000000000000000000..23b705a6662ad1cc5ba4a27022fe3db478f3f4cd --- /dev/null +++ b/libbson/1.24.0/bson_iter_visit_all.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_iter_visit_all() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_iter_visit_all()

    +
    +

    Synopsis

    +
    bool
    +bson_iter_visit_all (bson_iter_t *iter,
    +                     const bson_visitor_t *visitor,
    +                     void *data);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    A convenience function to iterate all remaining fields of iter using the callback vtable provided by visitor.

    +
    +
    +

    Returns

    +

    Returns true if visitation was prematurely stopped by a callback function. Returns false either because all elements were visited or due to corrupt BSON.

    +

    See bson_visitor_t for examples of how to set your own callbacks to provide information about the location of corrupt or unsupported BSON document entries.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_data_reader_ingest.html b/libbson/1.24.0/bson_json_data_reader_ingest.html new file mode 100644 index 0000000000000000000000000000000000000000..148d8463fabafdbd42bbd1ae2df52629d6e32141 --- /dev/null +++ b/libbson/1.24.0/bson_json_data_reader_ingest.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_json_data_reader_ingest() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_data_reader_ingest()

    +
    +

    Synopsis

    +
    void
    +bson_json_data_reader_ingest (bson_json_reader_t *reader,
    +                              const uint8_t *data,
    +                              size_t len);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • reader: A bson_json_reader_t.

    • +
    • data: A uint8_t containing data to feed.

    • +
    • len: A size_t containing the length of data.

    • +
    +
    +
    +

    Description

    +

    Feed data to a memory based json reader.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_data_reader_new.html b/libbson/1.24.0/bson_json_data_reader_new.html new file mode 100644 index 0000000000000000000000000000000000000000..e895c4799a757aa0998e3c088b1c4647352ae79c --- /dev/null +++ b/libbson/1.24.0/bson_json_data_reader_new.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_json_data_reader_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_data_reader_new()

    +
    +

    Synopsis

    +
    bson_json_reader_t *
    +bson_json_data_reader_new (bool allow_multiple, size_t size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • allow_multiple: Unused.

    • +
    • size: A requested buffer size.

    • +
    +
    +
    +

    Description

    +

    Creates a new streaming JSON reader that will convert JSON documents to BSON.

    +

    The allow_multiple parameter is unused.

    +
    +
    +

    Returns

    +

    A newly allocated bson_json_reader_t that should be freed with bson_json_reader_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_mode_t.html b/libbson/1.24.0/bson_json_mode_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2423dfb395daf55823ef35b6eda73485c31e3ea0 --- /dev/null +++ b/libbson/1.24.0/bson_json_mode_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_json_mode_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_mode_t

    +

    BSON JSON encoding mode enumeration

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef enum {
    +   BSON_JSON_MODE_LEGACY,
    +   BSON_JSON_MODE_CANONICAL,
    +   BSON_JSON_MODE_RELAXED,
    +} bson_json_mode_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_json_mode_t enumeration contains all available modes for encoding BSON into MongoDB Extended JSON.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_opts_destroy.html b/libbson/1.24.0/bson_json_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..1c2b8c9ba48113939572fd6bcb136bbd29b1b1fb --- /dev/null +++ b/libbson/1.24.0/bson_json_opts_destroy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_json_opts_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_json_opts_destroy (bson_json_opts_t *opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Destroys and releases all resources associated with opts. Does nothing if opts is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_opts_new.html b/libbson/1.24.0/bson_json_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..76fae6eb7c9f0e582d3fe9fc91521ee6f76f3d6d --- /dev/null +++ b/libbson/1.24.0/bson_json_opts_new.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_json_opts_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_opts_new()

    +
    +

    Synopsis

    +
    bson_json_opts_t *
    +bson_json_opts_new (bson_json_mode_t mode, int32_t max_len);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • mode: A bson_json_mode_t.

    • +
    • max_len: An int32_t.

    • +
    +
    +
    +

    Description

    +

    The bson_json_opts_new() function shall create a new bson_json_opts_t using the mode and length supplied. The mode member is a bson_json_mode_t defining the encoding mode.

    +

    The max_len member holds a maximum length for the resulting JSON string. Encoding will stop once the serialised string has reached this length. To encode the full BSON document, BSON_MAX_LEN_UNLIMITED can be used.

    +
    +
    +

    Returns

    +

    A newly allocated bson_json_opts_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_opts_set_outermost_array.html b/libbson/1.24.0/bson_json_opts_set_outermost_array.html new file mode 100644 index 0000000000000000000000000000000000000000..54a35c77d117aa7316a0671e2aa54b25db034dc8 --- /dev/null +++ b/libbson/1.24.0/bson_json_opts_set_outermost_array.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_json_opts_set_outermost_array() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_opts_set_outermost_array()

    +
    +

    Synopsis

    +
    void
    +bson_json_opts_set_outermost_array (bson_json_opts_t *opts, bool is_outermost_array);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • opts: A bson_json_opts_t.

    • +
    • is_outermost_array: A value determining what we want to set the is_outermost_array variable to.

    • +
    +
    +
    +

    Description

    +

    The bson_json_opts_set_outermost_array() function shall set the is_outermost_array variable on the bson_json_opts_t parameter using the boolean provided.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_opts_t.html b/libbson/1.24.0/bson_json_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..8abc7ccd72cb19b485b748fc9668ef2c633ab749 --- /dev/null +++ b/libbson/1.24.0/bson_json_opts_t.html @@ -0,0 +1,171 @@ + + + + + + + + + + + + + + bson_json_opts_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_opts_t

    +

    BSON to JSON encoding options

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct _bson_json_opts_t bson_json_opts_t;
    +
    +bson_json_opts_t *
    +bson_json_opts_new (bson_json_mode_t mode, int32_t max_len);
    +
    +void
    +bson_json_opts_destroy (bson_json_opts_t *opts);
    +
    +
    +
    +
    +

    Description

    +

    The bson_json_opts_t structure contains options for encoding BSON into MongoDB Extended JSON.

    +

    The mode member is a bson_json_mode_t defining the encoding mode.

    +

    The max_len member holds a maximum length for the resulting JSON string. Encoding will stop once the serialised string has reached this length. To encode the full BSON document, BSON_MAX_LEN_UNLIMITED can be used.

    +
    +

    See also

    + +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_reader_destroy.html b/libbson/1.24.0/bson_json_reader_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..d81f74d20e22fe988a2afaf4eb4fe93a7601ffd7 --- /dev/null +++ b/libbson/1.24.0/bson_json_reader_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_json_reader_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_reader_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_json_reader_destroy (bson_json_reader_t *reader);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees a bson_json_reader_t. Does nothing if reader is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_reader_new.html b/libbson/1.24.0/bson_json_reader_new.html new file mode 100644 index 0000000000000000000000000000000000000000..5cccabb1c13e22106a0d68042b8127e643018f05 --- /dev/null +++ b/libbson/1.24.0/bson_json_reader_new.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_json_reader_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_reader_new()

    +
    +

    Synopsis

    +
    bson_json_reader_t *
    +bson_json_reader_new (void *data,
    +                      bson_json_reader_cb cb,
    +                      bson_json_destroy_cb dcb,
    +                      bool allow_multiple,
    +                      size_t buf_size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • data: A user-defined pointer.

    • +
    • cb: A bson_json_reader_cb.

    • +
    • dcb: A bson_json_destroy_cb.

    • +
    • allow_multiple: Unused.

    • +
    • buf_size: A size_t containing the requested internal buffer size.

    • +
    +
    +
    +

    Description

    +

    Creates a new bson_json_reader_t that can read from an arbitrary data source in a streaming fashion.

    +

    The allow_multiple parameter is unused.

    +
    +
    +

    Returns

    +

    A newly allocated bson_json_reader_t that should be freed with bson_json_reader_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_reader_new_from_fd.html b/libbson/1.24.0/bson_json_reader_new_from_fd.html new file mode 100644 index 0000000000000000000000000000000000000000..250f5dc8658adaad8b7d03b4100346f0d91ab476 --- /dev/null +++ b/libbson/1.24.0/bson_json_reader_new_from_fd.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_json_reader_new_from_fd() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_reader_new_from_fd()

    +
    +

    Synopsis

    +
    bson_json_reader_t *
    +bson_json_reader_new_from_fd (int fd, bool close_on_destroy);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • fd: An open file-descriptor.

    • +
    • close_on_destroy: Whether close() should be called on fd when the reader is destroyed.

    • +
    +
    +
    +

    Description

    +

    Creates a new JSON to BSON converter that will be reading from the file-descriptor fd.

    +
    +
    +

    Returns

    +

    A newly allocated bson_json_reader_t that should be freed with bson_json_reader_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_reader_new_from_file.html b/libbson/1.24.0/bson_json_reader_new_from_file.html new file mode 100644 index 0000000000000000000000000000000000000000..494be90d23be0c675dd66c355bc1bf4f25736e87 --- /dev/null +++ b/libbson/1.24.0/bson_json_reader_new_from_file.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_json_reader_new_from_file() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_reader_new_from_file()

    +
    +

    Synopsis

    +
    bson_json_reader_t *
    +bson_json_reader_new_from_file (const char *filename, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • filename: A file-name in the system file-name encoding.

    • +
    • error: A bson_error_t.

    • +
    +
    +
    +

    Description

    +

    Creates a new bson_json_reader_t using the underlying file found at filename.

    +
    +
    +

    Errors

    +

    Errors are propagated via error.

    +
    +
    +

    Returns

    +

    A newly allocated bson_json_reader_t if successful, otherwise NULL and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_reader_read.html b/libbson/1.24.0/bson_json_reader_read.html new file mode 100644 index 0000000000000000000000000000000000000000..8cb4a36ff00936ac44955ac04a8fec2bec22966c --- /dev/null +++ b/libbson/1.24.0/bson_json_reader_read.html @@ -0,0 +1,175 @@ + + + + + + + + + + + + + + bson_json_reader_read() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_reader_read()

    +
    +

    Synopsis

    +
    int
    +bson_json_reader_read (bson_json_reader_t *reader,
    +                       bson_t *bson,
    +                       bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Reads the next BSON document from the underlying JSON source.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    1 if successful and data was read. 0 if successful and no data was read. -1 if there was an error.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_json_reader_t.html b/libbson/1.24.0/bson_json_reader_t.html new file mode 100644 index 0000000000000000000000000000000000000000..e868bd8a9f0100af6d6731aad4be26ba2a1573f7 --- /dev/null +++ b/libbson/1.24.0/bson_json_reader_t.html @@ -0,0 +1,263 @@ + + + + + + + + + + + + + + bson_json_reader_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_json_reader_t

    +

    Bulk JSON to BSON conversion

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct _bson_json_reader_t bson_json_reader_t;
    +
    +typedef enum {
    +   BSON_JSON_ERROR_READ_CORRUPT_JS = 1,
    +   BSON_JSON_ERROR_READ_INVALID_PARAM,
    +   BSON_JSON_ERROR_READ_CB_FAILURE,
    +} bson_json_error_code_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_json_reader_t structure is used for reading a sequence of JSON documents and transforming them to bson_t documents.

    +

    This can often be useful if you want to perform bulk operations that are defined in a file containing JSON documents.

    +
    +

    Tip

    +

    bson_json_reader_t works upon JSON documents formatted in MongoDB extended JSON format.

    +
    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    /*
    + * Copyright 2013 MongoDB, Inc.
    + *
    + * Licensed under the Apache License, Version 2.0 (the "License");
    + * you may not use this file except in compliance with the License.
    + * You may obtain a copy of the License at
    + *
    + *   http://www.apache.org/licenses/LICENSE-2.0
    + *
    + * Unless required by applicable law or agreed to in writing, software
    + * distributed under the License is distributed on an "AS IS" BASIS,
    + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    + * See the License for the specific language governing permissions and
    + * limitations under the License.
    + */
    +
    +
    +/*
    + * This program will print each JSON document contained in the provided files
    + * as a BSON string to STDOUT.
    + */
    +
    +
    +#include <bson/bson.h>
    +#include <stdlib.h>
    +#include <stdio.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_json_reader_t *reader;
    +   bson_error_t error;
    +   const char *filename;
    +   bson_t doc = BSON_INITIALIZER;
    +   int i;
    +   int b;
    +
    +   /*
    +    * Print program usage if no arguments are provided.
    +    */
    +   if (argc == 1) {
    +      fprintf (stderr, "usage: %s FILE...\n", argv[0]);
    +      return 1;
    +   }
    +
    +   /*
    +    * Process command line arguments expecting each to be a filename.
    +    */
    +   for (i = 1; i < argc; i++) {
    +      filename = argv[i];
    +
    +      /*
    +       * Open the filename provided in command line arguments.
    +       */
    +      if (0 == strcmp (filename, "-")) {
    +         reader = bson_json_reader_new_from_fd (STDIN_FILENO, false);
    +      } else {
    +         if (!(reader = bson_json_reader_new_from_file (filename, &error))) {
    +            fprintf (
    +               stderr, "Failed to open \"%s\": %s\n", filename, error.message);
    +            continue;
    +         }
    +      }
    +
    +      /*
    +       * Convert each incoming document to BSON and print to stdout.
    +       */
    +      while ((b = bson_json_reader_read (reader, &doc, &error))) {
    +         if (b < 0) {
    +            fprintf (stderr, "Error in json parsing:\n%s\n", error.message);
    +            abort ();
    +         }
    +
    +         if (fwrite (bson_get_data (&doc), 1, doc.len, stdout) != doc.len) {
    +            fprintf (stderr, "Failed to write to stdout, exiting.\n");
    +            exit (1);
    +         }
    +         bson_reinit (&doc);
    +      }
    +
    +      bson_json_reader_destroy (reader);
    +      bson_destroy (&doc);
    +   }
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_malloc.html b/libbson/1.24.0/bson_malloc.html new file mode 100644 index 0000000000000000000000000000000000000000..16e4c9ac3fb2b45927970c7a0164833cefae6c36 --- /dev/null +++ b/libbson/1.24.0/bson_malloc.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_malloc() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_malloc()

    +
    +

    Synopsis

    +
    void *
    +bson_malloc (size_t num_bytes);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • num_bytes: A size_t containing the number of bytes to allocate.

    • +
    +
    +
    +

    Description

    +

    This is a portable malloc() wrapper.

    +

    In general, this function will return an allocation at least sizeof(void*) bytes or bigger.

    +

    If there was a failure to allocate num_bytes bytes, the process will be aborted.

    +
    +

    Warning

    +

    This function will abort on failure to allocate memory.

    +
    +
    +
    +

    Returns

    +

    A pointer to a memory region which HAS NOT been zeroed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_malloc0.html b/libbson/1.24.0/bson_malloc0.html new file mode 100644 index 0000000000000000000000000000000000000000..5a80282d604b9bedd9da15ed194113d5e7b7d35b --- /dev/null +++ b/libbson/1.24.0/bson_malloc0.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_malloc0() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_malloc0()

    +
    +

    Synopsis

    +
    void *
    +bson_malloc0 (size_t num_bytes);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • num_bytes: A size_t.

    • +
    +
    +
    +

    Description

    +

    This is a portable malloc() wrapper that also sets the memory to zero. Similar to calloc().

    +

    In general, this function will return an allocation at least sizeof(void*) bytes or bigger.

    +

    If there was a failure to allocate num_bytes bytes, the process will be aborted.

    +
    +

    Warning

    +

    This function will abort on failure to allocate memory.

    +
    +
    +
    +

    Returns

    +

    A pointer to a memory region which HAS been zeroed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_mem_restore_vtable.html b/libbson/1.24.0/bson_mem_restore_vtable.html new file mode 100644 index 0000000000000000000000000000000000000000..869659abdaf625639fe9818cac8e1db80e91f551 --- /dev/null +++ b/libbson/1.24.0/bson_mem_restore_vtable.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_mem_restore_vtable() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_mem_restore_vtable()

    +
    +

    Synopsis

    +
    void
    +bson_mem_restore_vtable (void);
    +
    +
    +
    +
    +

    Description

    +

    This function shall restore the default memory allocator to be used by Libbson.

    +
    +

    Warning

    +

    This function MUST be called at the end of the process. Failure to do so will result in memory being freed by the wrong allocator.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_mem_set_vtable.html b/libbson/1.24.0/bson_mem_set_vtable.html new file mode 100644 index 0000000000000000000000000000000000000000..aeb370af006f324a79790e72fdfa070763082e9c --- /dev/null +++ b/libbson/1.24.0/bson_mem_set_vtable.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_mem_set_vtable() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_mem_set_vtable()

    +
    +

    Synopsis

    +
    typedef struct _bson_mem_vtable_t {
    +   void *(*malloc) (size_t num_bytes);
    +   void *(*calloc) (size_t n_members, size_t num_bytes);
    +   void *(*realloc) (void *mem, size_t num_bytes);
    +   void (*free) (void *mem);
    +   void *(*aligned_alloc) (size_t alignment, size_t num_bytes);
    +   void *padding[3];
    +} bson_mem_vtable_t;
    +
    +void
    +bson_mem_set_vtable (const bson_mem_vtable_t *vtable);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • vtable: A bson_mem_vtable_t with every non-padding field set.

    • +
    +
    +
    +

    Description

    +

    This function shall install a new memory allocator to be used by Libbson.

    +

    For backwards compatibility, if vtable->aligned_alloc is not set, calls to vtable->aligned_alloc will use vtable->malloc instead.

    +
    +

    Warning

    +

    This function MUST be called at the beginning of the process. Failure to do so will result in memory being freed by the wrong allocator.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_memory.html b/libbson/1.24.0/bson_memory.html new file mode 100644 index 0000000000000000000000000000000000000000..181a019c61690d0546273ec4e744eac3f1097bc8 --- /dev/null +++ b/libbson/1.24.0/bson_memory.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + Memory Management — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Memory Management

    +

    BSON Memory Abstraction.

    +
    +

    Description

    +

    Libbson contains a lightweight memory abstraction to make portability to new platforms easier. Additionally, it helps us integrate with interesting higher-level languages. One caveat, however, is that Libbson is not designed to deal with Out of Memory (OOM) situations. Doing so requires extreme diligence throughout the application stack that has rarely been implemented correctly. This may change in the future. As it stands now, Libbson will abort() under OOM situations.

    +

    To aid in language binding integration, Libbson allows for setting a custom memory allocator via bson_mem_set_vtable(). This allocation may be reversed via bson_mem_restore_vtable().

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_new.html b/libbson/1.24.0/bson_new.html new file mode 100644 index 0000000000000000000000000000000000000000..cdb579884041b039fa3cdb6c1a2ee1cbdd5f5830 --- /dev/null +++ b/libbson/1.24.0/bson_new.html @@ -0,0 +1,185 @@ + + + + + + + + + + + + + + bson_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_new()

    +
    +

    Synopsis

    +
    bson_t *
    +bson_new (void);
    +
    +
    +
    +
    +

    Description

    +

    The bson_new() function shall create a new bson_t structure on the heap. It should be freed with bson_destroy() when it is no longer in use.

    +
    +
    +

    Returns

    +

    A newly allocated bson_t that should be freed with bson_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_new_from_buffer.html b/libbson/1.24.0/bson_new_from_buffer.html new file mode 100644 index 0000000000000000000000000000000000000000..e1e830ee290638d14bcf3819685e37d1d22d0855 --- /dev/null +++ b/libbson/1.24.0/bson_new_from_buffer.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + bson_new_from_buffer() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_new_from_buffer()

    +
    +

    Synopsis

    +
    bson_t *
    +bson_new_from_buffer (uint8_t **buf,
    +                      size_t *buf_len,
    +                      bson_realloc_func realloc_func,
    +                      void *realloc_func_ctx);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • buf: An out-pointer to a buffer containing a serialized BSON document, or to NULL.

    • +
    • buf_len: An out-pointer to the length of the buffer in bytes.

    • +
    • realloc_func: Optional bson_realloc_func for reallocating the buffer.

    • +
    • realloc_func_ctx: Optional pointer that will be passed as ctx to realloc_func.

    • +
    +
    +
    +

    Description

    +

    Creates a new bson_t using the data provided.

    +

    The realloc_func, if provided, is called to resize buf if the document is later expanded, for example by a call to one of the bson_append functions.

    +

    If *buf is initially NULL then it is allocated, using realloc_func or the default allocator, and initialized with an empty BSON document, and *buf_len is set to 5, the size of an empty document.

    +
    +
    +

    Returns

    +

    A newly-allocated bson_t on success, or NULL.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_new_from_data.html b/libbson/1.24.0/bson_new_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..123373f783796fedd522f9519ee07cab91d25ace --- /dev/null +++ b/libbson/1.24.0/bson_new_from_data.html @@ -0,0 +1,192 @@ + + + + + + + + + + + + + + bson_new_from_data() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_new_from_data()

    +
    +

    Synopsis

    +
    bson_t *
    +bson_new_from_data (const uint8_t *data, size_t length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • data: A BSON encoded document buffer.

    • +
    • length: The length of data in bytes.

    • +
    +
    +
    +

    Description

    +

    The bson_new_from_data() function shall create a new bson_t on the heap and copy the contents of data. This may be helpful when working with language bindings but is generally expected to be slower.

    +
    +
    +

    Returns

    +

    A newly allocated bson_t if successful, otherwise NULL.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_new_from_json.html b/libbson/1.24.0/bson_new_from_json.html new file mode 100644 index 0000000000000000000000000000000000000000..5424356f5286ce48e212285608f23e97b86a3da0 --- /dev/null +++ b/libbson/1.24.0/bson_new_from_json.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + bson_new_from_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_new_from_json()

    +
    +

    Synopsis

    +
    bson_t *
    +bson_new_from_json (const uint8_t *data, ssize_t len, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • data: A UTF-8 encoded string containing valid JSON.

    • +
    • len: The length of data in bytes excluding a trailing \0 or -1 to determine the length with strlen().

    • +
    • error: An optional location for a bson_error_t.

    • +
    +
    +
    +

    Description

    +

    The bson_new_from_json() function allocates and initialize a new bson_t by parsing the JSON found in data. Only a single JSON object may exist in data or an error will be set and NULL returned.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A newly allocated bson_t if successful, otherwise NULL and error is set.

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_compare.html b/libbson/1.24.0/bson_oid_compare.html new file mode 100644 index 0000000000000000000000000000000000000000..eec5de6cdc5fc85b333971cc38e1cc974ba145f2 --- /dev/null +++ b/libbson/1.24.0/bson_oid_compare.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_oid_compare() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_compare()

    +
    +

    Synopsis

    +
    int
    +bson_oid_compare (const bson_oid_t *oid1, const bson_oid_t *oid2);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_oid_compare() function shall return a qsort() style value of a lexicographical sort of oid1 and oid2.

    +
    +
    +

    Returns

    +

    less than 0, 0, or greater than 0 based on the comparison.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_copy.html b/libbson/1.24.0/bson_oid_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..7d3d4e2acbda06ec45b72ff3fe0ab22122904723 --- /dev/null +++ b/libbson/1.24.0/bson_oid_copy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_copy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_copy()

    +
    +

    Synopsis

    +
    void
    +bson_oid_copy (const bson_oid_t *src, bson_oid_t *dst);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Copies the contents of src into dst.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_equal.html b/libbson/1.24.0/bson_oid_equal.html new file mode 100644 index 0000000000000000000000000000000000000000..b3c48705a6abc856e9f4aefe4705692597c8a487 --- /dev/null +++ b/libbson/1.24.0/bson_oid_equal.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_oid_equal() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_equal()

    +
    +

    Synopsis

    +
    bool
    +bson_oid_equal (const bson_oid_t *oid1, const bson_oid_t *oid2);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Checks if two bson_oid_t contain the same bytes.

    +
    +
    +

    Returns

    +

    true if they are equal, otherwise false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_get_time_t.html b/libbson/1.24.0/bson_oid_get_time_t.html new file mode 100644 index 0000000000000000000000000000000000000000..16ea274ebc68f32c3a173627d41f76a1c3d30356 --- /dev/null +++ b/libbson/1.24.0/bson_oid_get_time_t.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_oid_get_time_t() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_get_time_t()

    +
    +

    Synopsis

    +
    time_t
    +bson_oid_get_time_t (const bson_oid_t *oid);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the generation time in seconds since the UNIX Epoch of oid.

    +
    +
    +

    Returns

    +

    A time_t containing the seconds since the UNIX epoch of oid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_hash.html b/libbson/1.24.0/bson_oid_hash.html new file mode 100644 index 0000000000000000000000000000000000000000..e618c93bb7334e098969e8ebcc4c360326e05a0d --- /dev/null +++ b/libbson/1.24.0/bson_oid_hash.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_oid_hash() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_hash()

    +
    +

    Synopsis

    +
    uint32_t
    +bson_oid_hash (const bson_oid_t *oid);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Generates a hash code for oid suitable for a hashtable.

    +
    +
    +

    Returns

    +

    A 32-bit hash code.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_init.html b/libbson/1.24.0/bson_oid_init.html new file mode 100644 index 0000000000000000000000000000000000000000..f91cabfbfb17fadc996d6c2ea1344232e1b83f82 --- /dev/null +++ b/libbson/1.24.0/bson_oid_init.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_init() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_init()

    +
    +

    Synopsis

    +
    void
    +bson_oid_init (bson_oid_t *oid, bson_context_t *context);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Generates a new bson_oid_t using either context or the default bson_context_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_init_from_data.html b/libbson/1.24.0/bson_oid_init_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..02391377f874363b345d7c0d635047b1863eefdd --- /dev/null +++ b/libbson/1.24.0/bson_oid_init_from_data.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_init_from_data() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_init_from_data()

    +
    +

    Synopsis

    +
    void
    +bson_oid_init_from_data (bson_oid_t *oid, const uint8_t *data);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • oid: A bson_oid_t.

    • +
    • data: A buffer containing 12 bytes for the oid.

    • +
    +
    +
    +

    Description

    +

    Initializes a bson_oid_t using the raw buffer provided.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_init_from_string.html b/libbson/1.24.0/bson_oid_init_from_string.html new file mode 100644 index 0000000000000000000000000000000000000000..c3d3017864a504f38ba3fe0ca279aef9a94b658f --- /dev/null +++ b/libbson/1.24.0/bson_oid_init_from_string.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_oid_init_from_string() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_init_from_string()

    +
    +

    Synopsis

    +
    void
    +bson_oid_init_from_string (bson_oid_t *oid, const char *str);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • oid: A bson_oid_t.

    • +
    • str: A string containing a hex encoded version of the oid.

    • +
    +
    +
    +

    Description

    +

    Parses the string containing hex encoded oid and initialize the bytes in oid.

    +
    +
    +

    Example

    +
    bson_oid_init_from_string (&oid, "012345678901234567890123");
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_init_sequence.html b/libbson/1.24.0/bson_oid_init_sequence.html new file mode 100644 index 0000000000000000000000000000000000000000..2beefe735b2701d15a1c3210207afffe8e51aaf1 --- /dev/null +++ b/libbson/1.24.0/bson_oid_init_sequence.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_oid_init_sequence() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_init_sequence()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.14.0: This function is deprecated and should not be used in new code.

    +

    Please use bson_oid_init() in new code.

    +
    +
    +
    +

    Synopsis

    +
    void
    +bson_oid_init_sequence (bson_oid_t *oid, bson_context_t *context)
    +  BSON_GNUC_DEPRECATED_FOR (bson_oid_init);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Generates a new ObjectID with the next 64-bit sequence number in context. The first 4 bytes contain the current time and the following 8 contain the sequence number in big-endian format.

    +

    The bson_oid_t generated by this function is not guaranteed to be globally unique. Only unique within this context. It is however, guaranteed to be sequential.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_is_valid.html b/libbson/1.24.0/bson_oid_is_valid.html new file mode 100644 index 0000000000000000000000000000000000000000..73ac4249184bf60df732362ec151198907d4cfb1 --- /dev/null +++ b/libbson/1.24.0/bson_oid_is_valid.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_oid_is_valid() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_is_valid()

    +
    +

    Synopsis

    +
    bool
    +bson_oid_is_valid (const char *str, size_t length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: A string.

    • +
    • length: The length of str.

    • +
    +
    +
    +

    Description

    +

    Checks if a string containing a hex encoded string is a valid BSON ObjectID.

    +
    +
    +

    Returns

    +

    true if str could be parsed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_t.html b/libbson/1.24.0/bson_oid_t.html new file mode 100644 index 0000000000000000000000000000000000000000..bc3d0ecd7189f9b3bd93d69602b78cae6c04f8ab --- /dev/null +++ b/libbson/1.24.0/bson_oid_t.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + bson_oid_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_t

    +

    BSON ObjectID Abstraction

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct {
    +   uint8_t bytes[12];
    +} bson_oid_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_oid_t structure contains the 12-byte ObjectId notation defined by the BSON ObjectID specification.

    +

    ObjectId is a 12-byte BSON type, constructed using:

    +
      +
    • a 4-byte value representing the seconds since the Unix epoch (in Big Endian).

    • +
    • a 5-byte random value.

    • +
    • a 3-byte counter (Big Endian), starting with a random value.

    • +
    +
    +
    +

    String Conversion

    +

    You can convert an Object ID to a string using bson_oid_to_string() and back with bson_oid_init_from_string().

    +
    +
    +

    Hashing

    +

    A bson_oid_t can be used in hashtables using the function bson_oid_hash() and bson_oid_equal().

    +
    +
    +

    Comparing

    +

    A bson_oid_t can be compared to another using bson_oid_compare() for qsort() style comparing and bson_oid_equal() for direct equality.

    +
    +
    +

    Validating

    +

    You can validate that a string containing a hex-encoded ObjectID is valid using the function bson_oid_is_valid().

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_oid_t oid;
    +   char str[25];
    +
    +   bson_oid_init (&oid, NULL);
    +   bson_oid_to_string (&oid, str);
    +   printf ("%s\n", str);
    +
    +   if (bson_oid_is_valid (str, sizeof str)) {
    +      bson_oid_init_from_string (&oid, str);
    +   }
    +
    +   printf ("The UNIX time was: %u\n", (unsigned) bson_oid_get_time_t (&oid));
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_oid_to_string.html b/libbson/1.24.0/bson_oid_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..cbabdbdc50f7652a8113401213fc23fca33b275a --- /dev/null +++ b/libbson/1.24.0/bson_oid_to_string.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_to_string() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_oid_to_string()

    +
    +

    Synopsis

    +
    void
    +bson_oid_to_string (const bson_oid_t *oid, char str[25]);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • oid: A bson_oid_t.

    • +
    • str: A location for the resulting string.

    • +
    +
    +
    +

    Description

    +

    Converts oid into a hex encoded string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_destroy.html b/libbson/1.24.0/bson_reader_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..1af01792ec72df654c2c79b608ca2c44dc3802f9 --- /dev/null +++ b/libbson/1.24.0/bson_reader_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_reader_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_reader_destroy (bson_reader_t *reader);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Destroys and releases all resources associated with reader. Does nothing if reader is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_destroy_func_t.html b/libbson/1.24.0/bson_reader_destroy_func_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3cf4ded2d1dcaba9c63799c0b87f4d40881c0d75 --- /dev/null +++ b/libbson/1.24.0/bson_reader_destroy_func_t.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_reader_destroy_func_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_destroy_func_t

    +
    +

    Synopsis

    +
    typedef void (*bson_reader_destroy_func_t) (void *handle);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    An optional callback function that will be called when a bson_reader_t created with bson_reader_new_from_handle() is destroyed with bson_reader_destroy().

    +

    The handle used when creating the reader is passed to this callback.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_new_from_data.html b/libbson/1.24.0/bson_reader_new_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..7b6de5c821c3341ec2ca2feefd3a36de057ec62f --- /dev/null +++ b/libbson/1.24.0/bson_reader_new_from_data.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_reader_new_from_data() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_new_from_data()

    +
    +

    Synopsis

    +
    bson_reader_t *
    +bson_reader_new_from_data (const uint8_t *data, size_t length);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • data: A uint8_t.

    • +
    • length: A size_t.

    • +
    +
    +
    +

    Description

    +

    The bson_reader_new_from_data() function shall create a new bson_reader_t using the buffer supplied. data is not copied and MUST be valid for the lifetime of the resulting bson_reader_t.

    +
    +
    +

    Returns

    +

    A newly allocated bson_reader_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_new_from_fd.html b/libbson/1.24.0/bson_reader_new_from_fd.html new file mode 100644 index 0000000000000000000000000000000000000000..139b2595fdf477f975baead7b10303d24a612c3e --- /dev/null +++ b/libbson/1.24.0/bson_reader_new_from_fd.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_reader_new_from_fd() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_new_from_fd()

    +
    +

    Synopsis

    +
    bson_reader_t *
    +bson_reader_new_from_fd (int fd, bool close_on_destroy);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • fd: A valid file-descriptor.

    • +
    • close_on_destroy: Whether close() should be called on fd when the reader is destroyed.

    • +
    +
    +
    +

    Description

    +

    The bson_reader_new_from_fd() function shall create a new bson_reader_t that will read from the provided file-descriptor.

    +

    fd MUST be in blocking mode.

    +

    If close_fd is true, then fd will be closed when the bson_reader_t is destroyed with bson_reader_destroy().

    +
    +
    +

    Returns

    +

    A newly allocated bson_reader_t that should be freed with bson_reader_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_new_from_file.html b/libbson/1.24.0/bson_reader_new_from_file.html new file mode 100644 index 0000000000000000000000000000000000000000..4167efb5b2865c75abb9b984c014a6dfe075a36f --- /dev/null +++ b/libbson/1.24.0/bson_reader_new_from_file.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_reader_new_from_file() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_new_from_file()

    +
    +

    Synopsis

    +
    bson_reader_t *
    +bson_reader_new_from_file (const char *path, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • path: A filename in the host filename encoding.

    • +
    • error: A bson_error_t.

    • +
    +
    +
    +

    Description

    +

    Creates a new bson_reader_t using the file denoted by filename.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A newly allocated bson_reader_t on success, otherwise NULL and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_new_from_handle.html b/libbson/1.24.0/bson_reader_new_from_handle.html new file mode 100644 index 0000000000000000000000000000000000000000..39513d888ffd47570bcb5c09009b4716b094c606 --- /dev/null +++ b/libbson/1.24.0/bson_reader_new_from_handle.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_reader_new_from_handle() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_new_from_handle()

    +
    +

    Synopsis

    +
    bson_reader_t *
    +bson_reader_new_from_handle (void *handle,
    +                             bson_reader_read_func_t rf,
    +                             bson_reader_destroy_func_t df);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function allows for a pluggable data stream for the reader. This can be used to read from sockets, files, memory, or other arbitrary sources.

    +
    +
    +

    Returns

    +

    A newly allocated bson_reader_t if successful; otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_read.html b/libbson/1.24.0/bson_reader_read.html new file mode 100644 index 0000000000000000000000000000000000000000..a659d8835d28c17193fe2f3633764863ff16c738 --- /dev/null +++ b/libbson/1.24.0/bson_reader_read.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + bson_reader_read() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_read()

    +
    +

    Synopsis

    +
    const bson_t *
    +bson_reader_read (bson_reader_t *reader, bool *reached_eof);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The bson_reader_read() function shall read the next document from the underlying file-descriptor or buffer.

    +

    If there are no further documents or a failure was detected, then NULL is returned.

    +

    If we reached the end of the sequence, reached_eof is set to true.

    +

    To detect an error, check for NULL and reached_of is false.

    +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed.

    +
    +
    +

    Example

    +
    const bson_t *doc;
    +bool reached_eof = false;
    +
    +while ((doc = bson_reader_read (reader, &reached_eof))) {
    +   /* do something */
    +}
    +
    +if (!reached_eof) {
    +   fprintf (stderr, "Failed to read all documents.\n");
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_read_func_t.html b/libbson/1.24.0/bson_reader_read_func_t.html new file mode 100644 index 0000000000000000000000000000000000000000..bd4738002f7fcb3924705758c97d4afecd851a1b --- /dev/null +++ b/libbson/1.24.0/bson_reader_read_func_t.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_reader_read_func_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_read_func_t

    +
    +

    Synopsis

    +
    typedef ssize_t (*bson_reader_read_func_t) (void *handle,
    +                                            void *buf,
    +                                            size_t count);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • handle: The handle to read from.

    • +
    • buf: The buffer to read into.

    • +
    • count: The number of bytes to read.

    • +
    +
    +
    +

    Description

    +

    A callback function that will be called by bson_reader_t to read the next chunk of data from the underlying opaque file descriptor.

    +

    This function is meant to operate similar to the read(2) function as part of libc on UNIX-like systems.

    +
    +
    +

    Returns

    +

    0 for end of stream.

    +

    -1 for a failure on read.

    +

    A value greater than zero for the number of bytes read into buf.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_reset.html b/libbson/1.24.0/bson_reader_reset.html new file mode 100644 index 0000000000000000000000000000000000000000..bbc3c125ad7f15df45919ec96cbf0561289cc257 --- /dev/null +++ b/libbson/1.24.0/bson_reader_reset.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_reader_reset() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_reset()

    +
    +

    Synopsis

    +
    void
    +bson_reader_reset (bson_reader_t *reader);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Seeks to the beginning of the underlying buffer. Valid only for a reader created from a buffer with bson_reader_new_from_data(), not one created from a file, file descriptor, or handle.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_set_destroy_func.html b/libbson/1.24.0/bson_reader_set_destroy_func.html new file mode 100644 index 0000000000000000000000000000000000000000..e29cd4a89302cfec028aea0cf498c54bea7a702c --- /dev/null +++ b/libbson/1.24.0/bson_reader_set_destroy_func.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_reader_set_destroy_func() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_set_destroy_func()

    +
    +

    Synopsis

    +
    void
    +bson_reader_set_destroy_func (bson_reader_t *reader,
    +                              bson_reader_destroy_func_t func);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Allows for setting a callback to be executed when a reader is destroyed. This should only be used by implementations implementing their own read callbacks.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_set_read_func.html b/libbson/1.24.0/bson_reader_set_read_func.html new file mode 100644 index 0000000000000000000000000000000000000000..b0af87c7ba31bc8f206cae5ad676e6331b8c3b53 --- /dev/null +++ b/libbson/1.24.0/bson_reader_set_read_func.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_reader_set_read_func() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_set_read_func()

    +
    +

    Synopsis

    +
    void
    +bson_reader_set_read_func (bson_reader_t *reader, bson_reader_read_func_t func);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the function to read more data from the underlying stream in a custom bson_reader_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_t.html b/libbson/1.24.0/bson_reader_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f006313a531a3ba20eb9f8964fdbe0433458fa9b --- /dev/null +++ b/libbson/1.24.0/bson_reader_t.html @@ -0,0 +1,262 @@ + + + + + + + + + + + + + + bson_reader_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_t

    +

    Streaming BSON Document Reader

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct _bson_reader_t bson_reader_t;
    +
    +bson_reader_t *
    +bson_reader_new_from_handle (void *handle,
    +                             bson_reader_read_func_t rf,
    +                             bson_reader_destroy_func_t df);
    +bson_reader_t *
    +bson_reader_new_from_fd (int fd, bool close_on_destroy);
    +bson_reader_t *
    +bson_reader_new_from_file (const char *path, bson_error_t *error);
    +bson_reader_t *
    +bson_reader_new_from_data (const uint8_t *data, size_t length);
    +
    +void
    +bson_reader_destroy (bson_reader_t *reader);
    +
    +
    +
    +
    +

    Description

    +

    bson_reader_t is a structure used for reading a sequence of BSON documents. The sequence can come from a file-descriptor, memory region, or custom callbacks.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    /*
    + * Copyright 2013 MongoDB, Inc.
    + *
    + * Licensed under the Apache License, Version 2.0 (the "License");
    + * you may not use this file except in compliance with the License.
    + * You may obtain a copy of the License at
    + *
    + *   http://www.apache.org/licenses/LICENSE-2.0
    + *
    + * Unless required by applicable law or agreed to in writing, software
    + * distributed under the License is distributed on an "AS IS" BASIS,
    + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    + * See the License for the specific language governing permissions and
    + * limitations under the License.
    + */
    +
    +
    +/*
    + * This program will print each BSON document contained in the provided files
    + * as a JSON string to STDOUT.
    + */
    +
    +
    +#include <bson/bson.h>
    +#include <stdio.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_reader_t *reader;
    +   const bson_t *b;
    +   bson_error_t error;
    +   const char *filename;
    +   char *str;
    +   int i;
    +
    +   /*
    +    * Print program usage if no arguments are provided.
    +    */
    +   if (argc == 1) {
    +      fprintf (stderr, "usage: %s [FILE | -]...\nUse - for STDIN.\n", argv[0]);
    +      return 1;
    +   }
    +
    +   /*
    +    * Process command line arguments expecting each to be a filename.
    +    */
    +   for (i = 1; i < argc; i++) {
    +      filename = argv[i];
    +
    +      if (strcmp (filename, "-") == 0) {
    +         reader = bson_reader_new_from_fd (STDIN_FILENO, false);
    +      } else {
    +         if (!(reader = bson_reader_new_from_file (filename, &error))) {
    +            fprintf (
    +               stderr, "Failed to open \"%s\": %s\n", filename, error.message);
    +            continue;
    +         }
    +      }
    +
    +      /*
    +       * Convert each incoming document to JSON and print to stdout.
    +       */
    +      while ((b = bson_reader_read (reader, NULL))) {
    +         str = bson_as_canonical_extended_json (b, NULL);
    +         fprintf (stdout, "%s\n", str);
    +         bson_free (str);
    +      }
    +
    +      /*
    +       * Cleanup after our reader, which closes the file descriptor.
    +       */
    +      bson_reader_destroy (reader);
    +   }
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reader_tell.html b/libbson/1.24.0/bson_reader_tell.html new file mode 100644 index 0000000000000000000000000000000000000000..c36b9c032e76fb0b5e1507fd374afe50a4178af3 --- /dev/null +++ b/libbson/1.24.0/bson_reader_tell.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_reader_tell() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reader_tell()

    +
    +

    Synopsis

    +
    off_t
    +bson_reader_tell (bson_reader_t *reader);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Tells the current position within the underlying stream.

    +
    +
    +

    Returns

    +

    -1 on failure, otherwise the offset within the underlying stream.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_realloc.html b/libbson/1.24.0/bson_realloc.html new file mode 100644 index 0000000000000000000000000000000000000000..902e812eb6f26c435208bf86f128f52f10b356a9 --- /dev/null +++ b/libbson/1.24.0/bson_realloc.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_realloc() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_realloc()

    +
    +

    Synopsis

    +
    void *
    +bson_realloc (void *mem, size_t num_bytes);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • mem: A memory region.

    • +
    • num_bytes: A size_t containing the new requested size.

    • +
    +
    +
    +

    Description

    +

    This is a portable realloc() wrapper.

    +

    In general, this function will return an allocation at least sizeof(void*) bytes or bigger. If num_bytes is 0, then the allocation will be freed.

    +

    If there was a failure to allocate num_bytes bytes, the process will be aborted.

    +
    +

    Warning

    +

    This function will abort on failure to allocate memory.

    +
    +
    +
    +

    Returns

    +

    A pointer to a memory region which HAS NOT been zeroed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_realloc_ctx.html b/libbson/1.24.0/bson_realloc_ctx.html new file mode 100644 index 0000000000000000000000000000000000000000..cf189f349189ff765ea1efbf2b671564b6f2a26a --- /dev/null +++ b/libbson/1.24.0/bson_realloc_ctx.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_realloc_ctx() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_realloc_ctx()

    +
    +

    Synopsis

    +
    void *
    +bson_realloc_ctx (void *mem, size_t num_bytes, void *ctx);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • mem: A memory region.

    • +
    • num_bytes: A size_t containing the requested size.

    • +
    • ctx: A consumer-specific pointer or NULL.

    • +
    +
    +
    +

    Description

    +

    This function is identical to bson_realloc() except it takes a context parameter. This is useful when working with pooled or specific memory allocators.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_realloc_func.html b/libbson/1.24.0/bson_realloc_func.html new file mode 100644 index 0000000000000000000000000000000000000000..4b9aa557ac1e6b4f61db7739f16e10af8d9c4843 --- /dev/null +++ b/libbson/1.24.0/bson_realloc_func.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_realloc_func — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_realloc_func

    +
    +

    Synopsis

    +
    typedef void *(*bson_realloc_func) (void *mem, size_t num_bytes, void *ctx);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • mem: A memory region.

    • +
    • num_bytes: A size_t containing the requested size.

    • +
    • ctx: A consumer-specific pointer or NULL.

    • +
    +
    +
    +

    Description

    +

    This is a prototype for pluggable realloc functions used through the Libbson library. If you wish to use a custom allocator this is one way to do it. Additionally, bson_realloc_ctx() is a default implementation of this prototype.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reinit.html b/libbson/1.24.0/bson_reinit.html new file mode 100644 index 0000000000000000000000000000000000000000..5819ef4feee4b0899399ed540d4d4be84b20d28c --- /dev/null +++ b/libbson/1.24.0/bson_reinit.html @@ -0,0 +1,188 @@ + + + + + + + + + + + + + + bson_reinit() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reinit()

    +
    +

    Synopsis

    +
    void
    +bson_reinit (bson_t *b);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Reinitializes a bson_t.

    +

    If the bson_t structure contains a malloc()’d buffer, it may be reused. To be certain that any buffer is freed, always call bson_destroy() on any bson_t structure, whether initialized or reinitialized, after its final use.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_reserve_buffer.html b/libbson/1.24.0/bson_reserve_buffer.html new file mode 100644 index 0000000000000000000000000000000000000000..4bced2c8b7d16a80a6dcb85621a8740daf36057d --- /dev/null +++ b/libbson/1.24.0/bson_reserve_buffer.html @@ -0,0 +1,267 @@ + + + + + + + + + + + + + + bson_reserve_buffer() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_reserve_buffer()

    +
    +

    Synopsis

    +
    uint8_t *
    +bson_reserve_buffer (bson_t *bson, uint32_t size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: An initialized bson_t.

    • +
    • size: The length in bytes of the new buffer.

    • +
    +
    +
    +

    Description

    +

    Grow the internal buffer of bson to size and set the document length to size. Useful for eliminating copies when reading BSON bytes from a stream.

    +

    First, initialize bson with bson_init() or bson_new(), then call this function. After it returns, the length of bson is set to size but its contents are uninitialized memory: you must fill the contents with a BSON document of the correct length before any other operations.

    +

    The document must be freed with bson_destroy().

    +
    +
    +

    Returns

    +

    A pointer to the internal buffer, which is at least size bytes, or NULL if the space could not be allocated.

    +
    +
    +

    Example

    +

    Use bson_reserve_buffer to write a function that takes a bson_t pointer and reads a file into it directly:

    +
    #include <stdio.h>
    +#include <bson/bson.h>
    +
    +bool
    +read_into (bson_t *bson, FILE *fp)
    +{
    +   uint8_t *buffer;
    +   long size;
    +
    +   if (fseek (fp, 0L, SEEK_END) < 0) {
    +      perror ("Couldn't get file size");
    +      return 1;
    +   }
    +
    +   size = ftell (fp);
    +   if (size == EOF) {
    +      perror ("Couldn't get file size");
    +      return 1;
    +   }
    +
    +   if (size > INT32_MAX) {
    +      fprintf (stderr, "File too large\n");
    +      return 1;
    +   }
    +
    +   /* reserve buffer space - bson is temporarily invalid */
    +   buffer = bson_reserve_buffer (bson, (uint32_t) size);
    +   if (!buffer) {
    +      fprintf (stderr, "Couldn't reserve %ld bytes", size);
    +      return false;
    +   }
    +
    +   /* read file directly into the buffer */
    +   rewind (fp);
    +   if (fread ((void *) buffer, 1, (size_t) size, fp) < (size_t) size) {
    +      perror ("Couldn't read file");
    +      return false;
    +   }
    +
    +   return true;
    +}
    +
    +int
    +main ()
    +{
    +   FILE *fp;
    +   char *json;
    +
    +   /* stack-allocated, initialized bson_t */
    +   bson_t bson = BSON_INITIALIZER;
    +
    +   if (!(fp = fopen ("document.bson", "rb"))) {
    +      perror ("Couldn't read file");
    +      return 1;
    +   }
    +
    +   read_into (&bson, fp);
    +   fclose (fp);
    +
    +   json = bson_as_canonical_extended_json (&bson, NULL);
    +   printf ("%s\n", json);
    +
    +   bson_free (json);
    +   bson_destroy (&bson);
    +
    +   return 0;
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_set_error.html b/libbson/1.24.0/bson_set_error.html new file mode 100644 index 0000000000000000000000000000000000000000..9c7897ef560c862d9761518efece11497aaae17b --- /dev/null +++ b/libbson/1.24.0/bson_set_error.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_set_error() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_set_error()

    +
    +

    Synopsis

    +
    void
    +bson_set_error (
    +   bson_error_t *error, uint32_t domain, uint32_t code, const char *format, ...)
    +   BSON_GNUC_PRINTF (4, 5);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • error: A bson_error_t.

    • +
    • domain: A uint32_t.

    • +
    • code: A uint32_t.

    • +
    • format: A printf() style format string.

    • +
    +
    +
    +

    Description

    +

    This is a helper function to set the parameters of a bson_error_t. It handles the case where error is NULL by doing nothing.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_sized_new.html b/libbson/1.24.0/bson_sized_new.html new file mode 100644 index 0000000000000000000000000000000000000000..0b593fc5d9723bcbfa0d0286178e6c6a2bdc3943 --- /dev/null +++ b/libbson/1.24.0/bson_sized_new.html @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + bson_sized_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_sized_new()

    +
    +

    Synopsis

    +
    bson_t *
    +bson_sized_new (size_t size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • size: The size to pre-allocate for the underlying buffer.

    • +
    +
    +
    +

    Description

    +

    The bson_sized_new() function shall create a new bson_t on the heap with a preallocated buffer. This is useful if you have a good idea of the size of the resulting document.

    +
    +
    +

    Returns

    +

    A newly allocated bson_t that should be freed with bson_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_snprintf.html b/libbson/1.24.0/bson_snprintf.html new file mode 100644 index 0000000000000000000000000000000000000000..e13be09dc0fc01ee2981c38cdb1048640c11cf2b --- /dev/null +++ b/libbson/1.24.0/bson_snprintf.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_snprintf() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_snprintf()

    +
    +

    Synopsis

    +
    int
    +bson_snprintf (char *str, size_t size, const char *format, ...)
    +   BSON_GNUC_PRINTF (3, 4);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: The destination buffer.

    • +
    • size: The size of str.

    • +
    • format: A printf style format string.

    • +
    +
    +
    +

    Description

    +

    This is a portable wrapper around snprintf(). It also enforces a trailing \0 in the resulting string.

    +
    +
    +

    Returns

    +

    The number of bytes written to str.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_steal.html b/libbson/1.24.0/bson_steal.html new file mode 100644 index 0000000000000000000000000000000000000000..7a571bf352c8d138920a8183b57097620523b06b --- /dev/null +++ b/libbson/1.24.0/bson_steal.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + bson_steal() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_steal()

    +
    +

    Synopsis

    +
    bool
    +bson_steal (bson_t *dst, bson_t *src);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Efficiently transfer the contents of src to dst and destroy src.

    +

    Before calling this function, src must be initialized and dst must be uninitialized. After this function returns successfully, src is destroyed, and dst is initialized and must be freed with bson_destroy().

    +

    For example, if you have a higher-level structure that wraps a bson_t, use bson_steal to transfer BSON data into it:

    +
    typedef struct {
    +   bson_t bson;
    +} bson_wrapper_t;
    +
    +
    +bson_wrapper_t *
    +wrap_bson (bson_t *b)
    +{
    +   bson_wrapper_t *wrapper = bson_malloc (sizeof (bson_wrapper_t));
    +
    +   if (bson_steal (&wrapper->bson, b)) {
    +      return wrapper;
    +   }
    +
    +   bson_free (wrapper);
    +   return NULL;
    +}
    +
    +
    +void
    +bson_wrapper_destroy (bson_wrapper_t *wrapper)
    +{
    +   bson_destroy (&wrapper->bson);
    +   bson_free (wrapper);
    +}
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_t bson = BSON_INITIALIZER;
    +   bson_wrapper_t *wrapper;
    +
    +   BSON_APPEND_UTF8 (&bson, "key", "value");
    +
    +   /* now "bson" is destroyed */
    +   wrapper = wrap_bson (&bson);
    +
    +   /* clean up */
    +   bson_wrapper_destroy (wrapper);
    +}
    +
    +
    +
    +
    +

    Returns

    +

    Returns true if src was successfully moved to dst, false if src is invalid, or was statically initialized, or another error occurred.

    +
    +

    See also

    +
    +
    bson_destroy_with_steal(), a lower-level function that returns the raw contents of a bson_t.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strcasecmp.html b/libbson/1.24.0/bson_strcasecmp.html new file mode 100644 index 0000000000000000000000000000000000000000..1025c027be2cbd50b1b4070dd2b4b81895fe9521 --- /dev/null +++ b/libbson/1.24.0/bson_strcasecmp.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_strcasecmp() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strcasecmp()

    +
    +

    Synopsis

    +
    int
    +bson_strcasecmp (const char *s1, const char *s2);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • s1: A string.

    • +
    • s2: A string.

    • +
    +
    +
    +

    Description

    +

    A portable version of strcasecmp().

    +
    +
    +

    Returns

    +

    Returns a negative integer if s1 sorts lexicographically before s2, a positive +integer if it sorts after, or 0 if they are equivalent, after translating both +strings to lower case.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strdup.html b/libbson/1.24.0/bson_strdup.html new file mode 100644 index 0000000000000000000000000000000000000000..f5d340eeae4fe0ed487f18844ca464a512033bb5 --- /dev/null +++ b/libbson/1.24.0/bson_strdup.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_strdup() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strdup()

    +
    +

    Synopsis

    +
    char *
    +bson_strdup (const char *str);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: A string.

    • +
    +
    +
    +

    Description

    +

    Copies str into a new string. If str is NULL, then NULL is returned.

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strdup_printf.html b/libbson/1.24.0/bson_strdup_printf.html new file mode 100644 index 0000000000000000000000000000000000000000..fe2f4a2f278a448ff62c4ccfa7ea65ece54313d4 --- /dev/null +++ b/libbson/1.24.0/bson_strdup_printf.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_strdup_printf() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strdup_printf()

    +
    +

    Synopsis

    +
    char *
    +bson_strdup_printf (const char *format, ...) BSON_GNUC_PRINTF (1, 2);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • format: A printf style format string.

    • +
    +
    +
    +

    Description

    +

    This function performs a printf style format but into a newly allocated string.

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strdupv_printf.html b/libbson/1.24.0/bson_strdupv_printf.html new file mode 100644 index 0000000000000000000000000000000000000000..512aff6e6ac7a377807464a634ed6b8d0473a0e2 --- /dev/null +++ b/libbson/1.24.0/bson_strdupv_printf.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_strdupv_printf() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strdupv_printf()

    +
    +

    Synopsis

    +
    char *
    +bson_strdupv_printf (const char *format, va_list args) BSON_GNUC_PRINTF (1, 0);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • format: A printf style format string.

    • +
    • args: A va_list.

    • +
    +
    +
    +

    Description

    +

    This function is like bson_strdup_printf() except takes a va_list of parameters.

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strerror_r.html b/libbson/1.24.0/bson_strerror_r.html new file mode 100644 index 0000000000000000000000000000000000000000..70863cc3777e6b6171459f15c9a3a8d2e11cce1e --- /dev/null +++ b/libbson/1.24.0/bson_strerror_r.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_strerror_r() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strerror_r()

    +
    +

    Synopsis

    +
    char *
    +bson_strerror_r (int err_code, char *buf, size_t buflen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • err_code: An errno.

    • +
    • buf: A location to store the string.

    • +
    • buflen: The size of buf.

    • +
    +
    +
    +

    Description

    +

    This is a portability wrapper around strerror().

    +
    +
    +

    Returns

    +

    The passed in buf parameter or an internal string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strfreev.html b/libbson/1.24.0/bson_strfreev.html new file mode 100644 index 0000000000000000000000000000000000000000..b40483b1eb6be022f883f31a219a8c0fc3be0177 --- /dev/null +++ b/libbson/1.24.0/bson_strfreev.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_strfreev() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strfreev()

    +
    +

    Synopsis

    +
    void
    +bson_strfreev (char **strv);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • strv: A NULL-terminated array of strings to free, including the array.

    • +
    +
    +
    +

    Description

    +

    This will free each string in a NULL-terminated array of strings and then the array itself.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_append.html b/libbson/1.24.0/bson_string_append.html new file mode 100644 index 0000000000000000000000000000000000000000..592c121417f824ca267e4861eaea602437712f97 --- /dev/null +++ b/libbson/1.24.0/bson_string_append.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_string_append() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_append()

    +
    +

    Synopsis

    +
    void
    +bson_string_append (bson_string_t *string, const char *str);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Appends the ASCII or UTF-8 encoded string str to string. This is not suitable for embedding NULLs in strings.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_append_c.html b/libbson/1.24.0/bson_string_append_c.html new file mode 100644 index 0000000000000000000000000000000000000000..17ea937c8530c2e720891f88eda759ba5d64074c --- /dev/null +++ b/libbson/1.24.0/bson_string_append_c.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_string_append_c() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_append_c()

    +
    +

    Synopsis

    +
    void
    +bson_string_append_c (bson_string_t *string, char str);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Appends c to the string builder string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_append_printf.html b/libbson/1.24.0/bson_string_append_printf.html new file mode 100644 index 0000000000000000000000000000000000000000..f1db59fc8f53855c1b74e8297d24c37d0f84abd9 --- /dev/null +++ b/libbson/1.24.0/bson_string_append_printf.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_string_append_printf() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_append_printf()

    +
    +

    Synopsis

    +
    void
    +bson_string_append_printf (bson_string_t *string, const char *format, ...)
    +   BSON_GNUC_PRINTF (2, 3);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • string: A bson_string_t.

    • +
    • format: A printf style format string.

    • +
    +
    +
    +

    Description

    +

    Like bson_string_append() but formats a printf style string and then appends that to string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_append_unichar.html b/libbson/1.24.0/bson_string_append_unichar.html new file mode 100644 index 0000000000000000000000000000000000000000..fc00ad2d6b082d91d1a4113948ba7d43a0d06bdd --- /dev/null +++ b/libbson/1.24.0/bson_string_append_unichar.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_string_append_unichar() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_append_unichar()

    +
    +

    Synopsis

    +
    void
    +bson_string_append_unichar (bson_string_t *string, bson_unichar_t unichar);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Appends a unicode character to string. The character will be encoded into its multi-byte UTF-8 representation.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_free.html b/libbson/1.24.0/bson_string_free.html new file mode 100644 index 0000000000000000000000000000000000000000..48a3209796c09e1bf04f275aef331064b345ae9b --- /dev/null +++ b/libbson/1.24.0/bson_string_free.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_string_free() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_free()

    +
    +

    Synopsis

    +
    char *
    +bson_string_free (bson_string_t *string, bool free_segment);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • string: A bson_string_t.

    • +
    • free_segment: A bool indicating whether string->str should be freed.

    • +
    +
    +
    +

    Description

    +

    Frees the bson_string_t structure and optionally string->str.

    +
    +
    +

    Returns

    +

    string->str if free_segment is false, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_new.html b/libbson/1.24.0/bson_string_new.html new file mode 100644 index 0000000000000000000000000000000000000000..e52656bb6929f41421c04bb5f148ce5a5f1dbe02 --- /dev/null +++ b/libbson/1.24.0/bson_string_new.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_string_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_new()

    +
    +

    Synopsis

    +
    bson_string_t *
    +bson_string_new (const char *str);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: A string to be copied or NULL.

    • +
    +
    +
    +

    Description

    +

    Creates a new string builder, which uses power-of-two growth of buffers. Use the various bson_string_append*() functions to append to the string.

    +
    +
    +

    Returns

    +

    A newly allocated bson_string_t that should be freed with bson_string_free() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_t.html b/libbson/1.24.0/bson_string_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2eb060d6d0fc3373634851aff05e131919fbf69d --- /dev/null +++ b/libbson/1.24.0/bson_string_t.html @@ -0,0 +1,181 @@ + + + + + + + + + + + + + + bson_string_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_t

    +

    String Building Abstraction

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct {
    +   char *str;
    +   uint32_t len;
    +   uint32_t alloc;
    +} bson_string_t;
    +
    +
    +
    +
    +

    Description

    +

    bson_string_t is an abstraction for building strings. As chunks are added to the string, allocations are performed in powers of two.

    +

    This API is useful if you need to build UTF-8 encoded strings.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    bson_string_t *str;
    +
    +str = bson_string_new (NULL);
    +bson_string_append_printf (str, "%d %s %f\n", 0, "some string", 0.123);
    +printf ("%s\n", str->str);
    +
    +bson_string_free (str, true);
    +
    +
    +
    +

    Tip

    +

    You can call bson_string_free() with false if you would like to take ownership of str->str. Some APIs that do this might call return bson_string_free (str, false); after building the string.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_string_truncate.html b/libbson/1.24.0/bson_string_truncate.html new file mode 100644 index 0000000000000000000000000000000000000000..bae98208e97d1e7ae363dd47d649bc24474cbef5 --- /dev/null +++ b/libbson/1.24.0/bson_string_truncate.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_string_truncate() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_string_truncate()

    +
    +

    Synopsis

    +
    void
    +bson_string_truncate (bson_string_t *string, uint32_t len);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • string: A bson_string_t.

    • +
    • len: The new length of the string, excluding the trailing \0.

    • +
    +
    +
    +

    Description

    +

    Truncates the string so that it is len bytes in length. This must be smaller or equal to the current length of the string.

    +

    A \0 byte will be placed where the end of the string occurs.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strncpy.html b/libbson/1.24.0/bson_strncpy.html new file mode 100644 index 0000000000000000000000000000000000000000..47e8954565985948b8a1c3ac25589e8b73ca6bbb --- /dev/null +++ b/libbson/1.24.0/bson_strncpy.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_strncpy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strncpy()

    +
    +

    Synopsis

    +
    void
    +bson_strncpy (char *dst, const char *src, size_t size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • dst: The destination buffer.

    • +
    • src: The src buffer.

    • +
    • size: The number of bytes to copy into dst, which must be at least that size.

    • +
    +
    +
    +

    Description

    +

    Copies up to size bytes from src into dst. dst must be at least size bytes in size. A trailing \0 is always set.

    +

    Does nothing if size is zero.

    +

    bson_strncpy matches the behavior of the C11 standard strncpy_s, rather than strncpy. This means that bson_strncpy always writes a null terminator to dst, even if dst is too short to fit the entire string from src. If there is additional space left in dst after copying src, bson_strncpy does not fill the remaining space with null characters.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strndup.html b/libbson/1.24.0/bson_strndup.html new file mode 100644 index 0000000000000000000000000000000000000000..b4a2aaa7df1440610dafb9d12fe945cef0b2a5a4 --- /dev/null +++ b/libbson/1.24.0/bson_strndup.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_strndup() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strndup()

    +
    +

    Synopsis

    +
    char *
    +bson_strndup (const char *str, size_t n_bytes);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: A string to copy.

    • +
    • n_bytes: A size_t.

    • +
    +
    +
    +

    Description

    +

    Allocates a new string and copies up to n_bytes from str into it. A trailing \0 is always set.

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_strnlen.html b/libbson/1.24.0/bson_strnlen.html new file mode 100644 index 0000000000000000000000000000000000000000..282818ff726f38bfb21847e56370df29076352b1 --- /dev/null +++ b/libbson/1.24.0/bson_strnlen.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_strnlen() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_strnlen()

    +
    +

    Synopsis

    +
    size_t
    +bson_strnlen (const char *s, size_t maxlen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • s: A string.

    • +
    • maxlen: The maximum size of string to check.

    • +
    +
    +
    +

    Description

    +

    A portable version of strnlen().

    +
    +
    +

    Returns

    +

    The length of s in bytes or maxlen if no \0 was found.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_subtype_t.html b/libbson/1.24.0/bson_subtype_t.html new file mode 100644 index 0000000000000000000000000000000000000000..6046808ce3feffaf630d193ecf9b0492f1be4a59 --- /dev/null +++ b/libbson/1.24.0/bson_subtype_t.html @@ -0,0 +1,169 @@ + + + + + + + + + + + + + + bson_subtype_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_subtype_t

    +

    Binary Field Subtype

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +
    +typedef enum {
    +   BSON_SUBTYPE_BINARY = 0x00,
    +   BSON_SUBTYPE_FUNCTION = 0x01,
    +   BSON_SUBTYPE_BINARY_DEPRECATED = 0x02,
    +   BSON_SUBTYPE_UUID_DEPRECATED = 0x03,
    +   BSON_SUBTYPE_UUID = 0x04,
    +   BSON_SUBTYPE_MD5 = 0x05,
    +   BSON_SUBTYPE_COLUMN = 0x07,
    +   BSON_SUBTYPE_USER = 0x80,
    +} bson_subtype_t;
    +
    +
    +
    +
    +

    Description

    +

    This enumeration contains the various subtypes that may be used in a binary field. See http://bsonspec.org for more information.

    +
    +
    +

    Functions

    +
    +
    +
    +
    +

    Example

    +
    bson_t doc = BSON_INITIALIZER;
    +
    +BSON_APPEND_BINARY (&doc, "binary", BSON_SUBTYPE_BINARY, data, data_len);
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_t.html b/libbson/1.24.0/bson_t.html new file mode 100644 index 0000000000000000000000000000000000000000..be3e076a5e35a67003827837b7eb5631500a43d2 --- /dev/null +++ b/libbson/1.24.0/bson_t.html @@ -0,0 +1,364 @@ + + + + + + + + + + + + + + bson_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_t

    +

    BSON Document Abstraction

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +/**
    + * bson_empty:
    + * @b: a bson_t.
    + *
    + * Checks to see if @b is an empty BSON document. An empty BSON document is
    + * a 5 byte document which contains the length (4 bytes) and a single NUL
    + * byte indicating end of fields.
    + */
    +#define bson_empty(b) /* ... */
    +
    +/**
    + * bson_empty0:
    + *
    + * Like bson_empty() but treats NULL the same as an empty bson_t document.
    + */
    +#define bson_empty0(b) /* ... */
    +
    +/**
    + * bson_clear:
    + *
    + * Easily free a bson document and set it to NULL. Use like:
    + *
    + * bson_t *doc = bson_new();
    + * bson_clear (&doc);
    + * BSON_ASSERT (doc == NULL);
    + */
    +#define bson_clear(bptr) /* ... */
    +
    +/**
    + * BSON_MAX_SIZE:
    + *
    + * The maximum size in bytes of a BSON document.
    + */
    +#define BSON_MAX_SIZE /* ... */
    +
    +#define BSON_APPEND_ARRAY(b, key, val) \
    +   bson_append_array (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_ARRAY_BEGIN(b, key, child) \
    +   bson_append_array_begin (b, key, (int) strlen (key), child)
    +
    +#define BSON_APPEND_BINARY(b, key, subtype, val, len) \
    +   bson_append_binary (b, key, (int) strlen (key), subtype, val, len)
    +
    +#define BSON_APPEND_BOOL(b, key, val) \
    +   bson_append_bool (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_CODE(b, key, val) \
    +   bson_append_code (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_CODE_WITH_SCOPE(b, key, val, scope) \
    +   bson_append_code_with_scope (b, key, (int) strlen (key), val, scope)
    +
    +#define BSON_APPEND_DBPOINTER(b, key, coll, oid) \
    +   bson_append_dbpointer (b, key, (int) strlen (key), coll, oid)
    +
    +#define BSON_APPEND_DOCUMENT_BEGIN(b, key, child) \
    +   bson_append_document_begin (b, key, (int) strlen (key), child)
    +
    +#define BSON_APPEND_DOUBLE(b, key, val) \
    +   bson_append_double (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_DOCUMENT(b, key, val) \
    +   bson_append_document (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_INT32(b, key, val) \
    +   bson_append_int32 (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_INT64(b, key, val) \
    +   bson_append_int64 (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_MINKEY(b, key) \
    +   bson_append_minkey (b, key, (int) strlen (key))
    +
    +#define BSON_APPEND_DECIMAL128(b, key, val) \
    +   bson_append_decimal128 (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_MAXKEY(b, key) \
    +   bson_append_maxkey (b, key, (int) strlen (key))
    +
    +#define BSON_APPEND_NULL(b, key) bson_append_null (b, key, (int) strlen (key))
    +
    +#define BSON_APPEND_OID(b, key, val) \
    +   bson_append_oid (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_REGEX(b, key, val, opt) \
    +   bson_append_regex (b, key, (int) strlen (key), val, opt)
    +
    +#define BSON_APPEND_UTF8(b, key, val) \
    +   bson_append_utf8 (b, key, (int) strlen (key), val, (int) strlen (val))
    +
    +#define BSON_APPEND_SYMBOL(b, key, val) \
    +   bson_append_symbol (b, key, (int) strlen (key), val, (int) strlen (val))
    +
    +#define BSON_APPEND_TIME_T(b, key, val) \
    +   bson_append_time_t (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_TIMEVAL(b, key, val) \
    +   bson_append_timeval (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_DATE_TIME(b, key, val) \
    +   bson_append_date_time (b, key, (int) strlen (key), val)
    +
    +#define BSON_APPEND_TIMESTAMP(b, key, val, inc) \
    +   bson_append_timestamp (b, key, (int) strlen (key), val, inc)
    +
    +#define BSON_APPEND_UNDEFINED(b, key) \
    +   bson_append_undefined (b, key, (int) strlen (key))
    +
    +#define BSON_APPEND_VALUE(b, key, val) \
    +   bson_append_value (b, key, (int) strlen (key), (val))
    +
    +BSON_ALIGNED_BEGIN (128)
    +typedef struct {
    +   uint32_t flags;       /* Internal flags for the bson_t. */
    +   uint32_t len;         /* Length of BSON data. */
    +   uint8_t padding[120]; /* Padding for stack allocation. */
    +} bson_t BSON_ALIGNED_END (128);
    +
    +
    +
    +
    +

    Description

    +

    The bson_t structure represents a BSON document. This structure manages the underlying BSON encoded buffer. For mutable documents, it can append new data to the document.

    +
    +
    +

    Performance Notes

    +

    The bson_t structure attempts to use an inline allocation within the structure to speed up performance of small documents. When this internal buffer has been exhausted, a heap allocated buffer will be dynamically allocated. Therefore, it is essential to call bson_destroy() on allocated documents.

    +
    +
    +

    Duplicate Keys

    +

    The BSON specification allows BSON documents to have +duplicate keys. Documents are stored as an ordered list of key-value pairs. A +bson_t may contain duplicate keys. Applications should refrain from +generating such documents, because MongoDB server behavior is undefined when a +BSON document contains duplicate keys.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    static void
    +create_on_heap (void)
    +{
    +   bson_t *b = bson_new ();
    +
    +   BSON_APPEND_INT32 (b, "foo", 123);
    +   BSON_APPEND_UTF8 (b, "bar", "foo");
    +   BSON_APPEND_DOUBLE (b, "baz", 1.23f);
    +
    +   bson_destroy (b);
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_type_t.html b/libbson/1.24.0/bson_type_t.html new file mode 100644 index 0000000000000000000000000000000000000000..26566a7e5417bd486725c0ec040d9fe42065e381 --- /dev/null +++ b/libbson/1.24.0/bson_type_t.html @@ -0,0 +1,185 @@ + + + + + + + + + + + + + + bson_type_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_type_t

    +

    BSON Type Enumeration

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef enum {
    +   BSON_TYPE_EOD = 0x00,
    +   BSON_TYPE_DOUBLE = 0x01,
    +   BSON_TYPE_UTF8 = 0x02,
    +   BSON_TYPE_DOCUMENT = 0x03,
    +   BSON_TYPE_ARRAY = 0x04,
    +   BSON_TYPE_BINARY = 0x05,
    +   BSON_TYPE_UNDEFINED = 0x06,
    +   BSON_TYPE_OID = 0x07,
    +   BSON_TYPE_BOOL = 0x08,
    +   BSON_TYPE_DATE_TIME = 0x09,
    +   BSON_TYPE_NULL = 0x0A,
    +   BSON_TYPE_REGEX = 0x0B,
    +   BSON_TYPE_DBPOINTER = 0x0C,
    +   BSON_TYPE_CODE = 0x0D,
    +   BSON_TYPE_SYMBOL = 0x0E,
    +   BSON_TYPE_CODEWSCOPE = 0x0F,
    +   BSON_TYPE_INT32 = 0x10,
    +   BSON_TYPE_TIMESTAMP = 0x11,
    +   BSON_TYPE_INT64 = 0x12,
    +   BSON_TYPE_DECIMAL128 = 0x13,
    +   BSON_TYPE_MAXKEY = 0x7F,
    +   BSON_TYPE_MINKEY = 0xFF,
    +} bson_type_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_type_t enumeration contains all of the types from the BSON Specification. It can be used to determine the type of a field at runtime.

    +
    +
    +

    Functions

    +
    +
    +
    +
    +

    Example

    +
    bson_iter_t iter;
    +
    +if (bson_iter_init_find (&iter, doc, "foo") &&
    +    (BSON_TYPE_INT32 == bson_iter_type (&iter))) {
    +   printf ("'foo' is an int32.\n");
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_uint32_to_string.html b/libbson/1.24.0/bson_uint32_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..60203e46376229d2a98728f56450df085d3acde5 --- /dev/null +++ b/libbson/1.24.0/bson_uint32_to_string.html @@ -0,0 +1,178 @@ + + + + + + + + + + + + + + bson_uint32_to_string() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_uint32_to_string()

    +
    +

    Synopsis

    +
    size_t
    +bson_uint32_to_string (uint32_t value,
    +                       const char **strptr,
    +                       char *str,
    +                       size_t size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • value: A uint32_t.

    • +
    • strptr: A location for the resulting string pointer.

    • +
    • str: A location to buffer the string.

    • +
    • size: A size_t containing the size of str.

    • +
    +
    +
    +

    Description

    +

    Converts value to a string.

    +

    If value is from 0 to 999, it will use a constant string in the data section of the library.

    +

    If not, a string will be formatted using str and snprintf().

    +

    strptr will always be set. It will either point to str or a constant string. Use this as your key.

    +
    +
    +

    Array Element Key Building

    +

    Each element in a BSON array has a monotonic string key like "0", "1", etc. This function is optimized for generating such string keys.

    +
    char str[16];
    +const char *key;
    +uint32_t i;
    +
    +for (i = 0; i < 10; i++) {
    +   bson_uint32_to_string (i, &key, str, sizeof str);
    +   printf ("Key: %s\n", key);
    +}
    +
    +
    +
    +
    +

    Returns

    +

    The number of bytes in the resulting string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_unichar_t.html b/libbson/1.24.0/bson_unichar_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b442b7ec62e103f6f4f42ab4f69710613077663f --- /dev/null +++ b/libbson/1.24.0/bson_unichar_t.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_unichar_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_unichar_t

    +

    Unicode Character Abstraction

    +
    +

    Synopsis

    +
    typedef uint32_t bson_unichar_t;
    +
    +
    +
    +
    +

    Description

    +

    bson_unichar_t provides an abstraction on a single unicode character. It is the 32-bit representation of a character. As UTF-8 can contain multi-byte characters, this should be used when iterating through UTF-8 text.

    +
    +
    +

    Functions

    +
    +
    +
    +
    +

    Example

    +
    static void
    +print_each_char (const char *str)
    +{
    +   bson_unichar_t c;
    +
    +   for (; *str; str = bson_utf8_next_char (str)) {
    +      c = bson_utf8_get_char (str);
    +      printf ("The numberic value is %u.\n", (unsigned) c);
    +   }
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_utf8_escape_for_json.html b/libbson/1.24.0/bson_utf8_escape_for_json.html new file mode 100644 index 0000000000000000000000000000000000000000..431b309268757601277bff7140dd8d966da2c190 --- /dev/null +++ b/libbson/1.24.0/bson_utf8_escape_for_json.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_utf8_escape_for_json() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_utf8_escape_for_json()

    +
    +

    Synopsis

    +
    char *
    +bson_utf8_escape_for_json (const char *utf8, ssize_t utf8_len);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • utf8: A UTF-8 encoded string.

    • +
    • utf8_len: The length of utf8 in bytes or -1 if it is NULL terminated.

    • +
    +
    +
    +

    Description

    +

    Allocates a new string matching utf8 except that special +characters in JSON are escaped. The resulting string is also +UTF-8 encoded.

    +

    Both “ and \ characters will be backslash-escaped. If a NUL +byte is found before utf8_len bytes, it is converted to +“\u0000”. Other non-ASCII characters in the input are preserved.

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_utf8_from_unichar.html b/libbson/1.24.0/bson_utf8_from_unichar.html new file mode 100644 index 0000000000000000000000000000000000000000..8159d540ae4108f09e8069f458343a4db44a6566 --- /dev/null +++ b/libbson/1.24.0/bson_utf8_from_unichar.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_utf8_from_unichar() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_utf8_from_unichar()

    +
    +

    Synopsis

    +
    void
    +bson_utf8_from_unichar (bson_unichar_t unichar, char utf8[6], uint32_t *len);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • unichar: A bson_unichar_t.

    • +
    • utf8: A location for the utf8 sequence.

    • +
    • len: A location for the number of bytes in the resulting utf8 sequence.

    • +
    +
    +
    +

    Description

    +

    Converts a single unicode character to a multi-byte UTF-8 sequence. The result is stored in utf8 and the number of bytes used in len.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_utf8_get_char.html b/libbson/1.24.0/bson_utf8_get_char.html new file mode 100644 index 0000000000000000000000000000000000000000..390355e09cf340d41b0637f055d25dd8586c3498 --- /dev/null +++ b/libbson/1.24.0/bson_utf8_get_char.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_utf8_get_char() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_utf8_get_char()

    +
    +

    Synopsis

    +
    bson_unichar_t
    +bson_utf8_get_char (const char *utf8);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • utf8: A UTF-8 encoded string.

    • +
    +
    +
    +

    Description

    +

    Converts the current character in a UTF-8 sequence to a bson_unichar_t, the 32-bit representation of the multi-byte character.

    +
    +
    +

    Returns

    +

    A bson_unichar_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_utf8_next_char.html b/libbson/1.24.0/bson_utf8_next_char.html new file mode 100644 index 0000000000000000000000000000000000000000..96774732f1bbc963f4dd6a4259d0d950719b8cb1 --- /dev/null +++ b/libbson/1.24.0/bson_utf8_next_char.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_utf8_next_char() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_utf8_next_char()

    +
    +

    Synopsis

    +
    const char *
    +bson_utf8_next_char (const char *utf8);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • utf8: A UTF-8 encoded string.

    • +
    +
    +
    +

    Description

    +

    Advances within utf8 to the next UTF-8 character, which may be multiple bytes offset from utf8. A pointer to the next character is returned.

    +

    It is invalid to call this function on a string whose current character is \0.

    +
    +
    +

    Returns

    +

    A pointer to the beginning of the next character in the UTF-8 encoded string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_utf8_validate.html b/libbson/1.24.0/bson_utf8_validate.html new file mode 100644 index 0000000000000000000000000000000000000000..bf9dab4eb279a00db1b840f7e910a524c0ccc0d0 --- /dev/null +++ b/libbson/1.24.0/bson_utf8_validate.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_utf8_validate() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_utf8_validate()

    +
    +

    Synopsis

    +
    bool
    +bson_utf8_validate (const char *utf8, size_t utf8_len, bool allow_null);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • utf8: A string to verify.

    • +
    • utf8_len: The length of utf8 in bytes.

    • +
    • allow_null: A bool indicating that embedded \0 bytes are allowed.

    • +
    +
    +
    +

    Description

    +

    Validates that the content within utf8 is valid UTF-8 (by the RFC 3629 standard). If allow_null is true, then embedded NULL bytes are allowed (\0).

    +
    +
    +

    Returns

    +

    true if utf8 contains valid UTF-8.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_validate.html b/libbson/1.24.0/bson_validate.html new file mode 100644 index 0000000000000000000000000000000000000000..c70c9539048c7e88a530057a5be5dae6d00252ea --- /dev/null +++ b/libbson/1.24.0/bson_validate.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_validate() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_validate()

    +
    +

    Synopsis

    +
    bool
    +bson_validate (const bson_t *bson, bson_validate_flags_t flags, size_t *offset);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • flags: A bitwise-or of all desired bson_validate_flags_t.

    • +
    • offset: A location for the offset within bson where the error occurred.

    • +
    +
    +
    +

    Description

    +

    Validates a BSON document by walking through the document and inspecting the keys and values for valid content.

    +

    You can modify how the validation occurs through the use of the flags parameter, see bson_validate_with_error() for details.

    +
    +
    +

    Returns

    +

    Returns true if bson is valid; otherwise false and offset is set to the byte offset where the error was detected.

    +
    +

    See also

    + +
    +
    bson_visitor_t can be used for custom validation, Example Custom Validation.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_validate_with_error.html b/libbson/1.24.0/bson_validate_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..0f80f1db7425d8cb158ac76e6551795a83503ab9 --- /dev/null +++ b/libbson/1.24.0/bson_validate_with_error.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + bson_validate_with_error() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_validate_with_error()

    +
    +

    Synopsis

    +
    typedef enum {
    +   BSON_VALIDATE_NONE = 0,
    +   BSON_VALIDATE_UTF8 = (1 << 0),
    +   BSON_VALIDATE_DOLLAR_KEYS = (1 << 1),
    +   BSON_VALIDATE_DOT_KEYS = (1 << 2),
    +   BSON_VALIDATE_UTF8_ALLOW_NULL = (1 << 3),
    +   BSON_VALIDATE_EMPTY_KEYS = (1 << 4),
    +} bson_validate_flags_t;
    +
    +bool
    +bson_validate_with_error (const bson_t *bson,
    +                          bson_validate_flags_t flags,
    +                          bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bson: A bson_t.

    • +
    • flags: A bitwise-or of all desired validation flags.

    • +
    • error: Optional bson_error_t.

    • +
    +
    +
    +

    Description

    +

    Validates a BSON document by walking through the document and inspecting the keys and values for valid content.

    +

    You can modify how the validation occurs through the use of the flags parameter. A description of their effect is below.

    +
      +
    • BSON_VALIDATE_NONE Basic validation of BSON length and structure.

    • +
    • BSON_VALIDATE_UTF8 All keys and string values are checked for invalid UTF-8.

    • +
    • BSON_VALIDATE_UTF8_ALLOW_NULL String values are allowed to have embedded NULL bytes.

    • +
    • BSON_VALIDATE_DOLLAR_KEYS Prohibit keys that start with $ outside of a “DBRef” subdocument.

    • +
    • BSON_VALIDATE_DOT_KEYS Prohibit keys that contain . anywhere in the string.

    • +
    • BSON_VALIDATE_EMPTY_KEYS Prohibit zero-length keys.

    • +
    +
    +
    +

    Returns

    +

    Returns true if bson is valid; otherwise false and error is filled out.

    +

    The bson_error_t domain is set to BSON_ERROR_INVALID. Its code is set to one of the bson_validate_flags_t flags indicating which validation failed; for example, if a key contains invalid UTF-8, then the code is set to BSON_VALIDATE_UTF8, but if the basic structure of the BSON document is corrupt, the code is set to BSON_VALIDATE_NONE. The error message is filled out, and gives more detail if possible.

    +
    +

    See also

    + +
    +
    bson_visitor_t can be used for custom validation, Example Custom Validation.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_value_copy.html b/libbson/1.24.0/bson_value_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..1ee8a110ce5fe708ee28507812f2d1ee4f27e4dd --- /dev/null +++ b/libbson/1.24.0/bson_value_copy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_value_copy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_value_copy()

    +
    +

    Synopsis

    +
    void
    +bson_value_copy (const bson_value_t *src, bson_value_t *dst);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function will copy the boxed content in src into dst. dst must be freed with bson_value_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_value_destroy.html b/libbson/1.24.0/bson_value_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..a062501b3cac552d23bb41248594880060e3dec6 --- /dev/null +++ b/libbson/1.24.0/bson_value_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_value_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_value_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_value_destroy (bson_value_t *value);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Releases any resources associated with value. Does nothing if value is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_value_t.html b/libbson/1.24.0/bson_value_t.html new file mode 100644 index 0000000000000000000000000000000000000000..dc7b96f0812fb3f61a74a38e3791e9097bb03ef1 --- /dev/null +++ b/libbson/1.24.0/bson_value_t.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + bson_value_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_value_t

    +

    BSON Boxed Container Type

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct _bson_value_t {
    +   bson_type_t value_type;
    +   union {
    +      bson_oid_t v_oid;
    +      int64_t v_int64;
    +      int32_t v_int32;
    +      int8_t v_int8;
    +      double v_double;
    +      bool v_bool;
    +      int64_t v_datetime;
    +      struct {
    +         uint32_t timestamp;
    +         uint32_t increment;
    +      } v_timestamp;
    +      struct {
    +         uint32_t len;
    +         char *str;
    +      } v_utf8;
    +      struct {
    +         uint32_t data_len;
    +         uint8_t *data;
    +      } v_doc;
    +      struct {
    +         uint32_t data_len;
    +         uint8_t *data;
    +         bson_subtype_t subtype;
    +      } v_binary;
    +      struct {
    +         char *regex;
    +         char *options;
    +      } v_regex;
    +      struct {
    +         char *collection;
    +         uint32_t collection_len;
    +         bson_oid_t oid;
    +      } v_dbpointer;
    +      struct {
    +         uint32_t code_len;
    +         char *code;
    +      } v_code;
    +      struct {
    +         uint32_t code_len;
    +         char *code;
    +         uint32_t scope_len;
    +         uint8_t *scope_data;
    +      } v_codewscope;
    +      struct {
    +         uint32_t len;
    +         char *symbol;
    +      } v_symbol;
    +      bson_decimal128_t v_decimal128;
    +   } value;
    +} bson_value_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_value_t structure is a boxed type for encapsulating a runtime determined type.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    const bson_value_t *value;
    +
    +value = bson_iter_value (&iter);
    +
    +if (value->value_type == BSON_TYPE_INT32) {
    +   printf ("%d\n", value->value.v_int32);
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_visitor_t.html b/libbson/1.24.0/bson_visitor_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7f8e4f7087c33e31f820356cc9f838b06a63c361 --- /dev/null +++ b/libbson/1.24.0/bson_visitor_t.html @@ -0,0 +1,468 @@ + + + + + + + + + + + + + + bson_visitor_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_visitor_t

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct {
    +   /* run before / after descending into a document */
    +   bool (*visit_before) (const bson_iter_t *iter, const char *key, void *data);
    +   bool (*visit_after) (const bson_iter_t *iter, const char *key, void *data);
    +   /* corrupt BSON, or unsupported type and visit_unsupported_type not set */
    +   void (*visit_corrupt) (const bson_iter_t *iter, void *data);
    +   /* normal bson field callbacks */
    +   bool (*visit_double) (const bson_iter_t *iter,
    +                         const char *key,
    +                         double v_double,
    +                         void *data);
    +   bool (*visit_utf8) (const bson_iter_t *iter,
    +                       const char *key,
    +                       size_t v_utf8_len,
    +                       const char *v_utf8,
    +                       void *data);
    +   bool (*visit_document) (const bson_iter_t *iter,
    +                           const char *key,
    +                           const bson_t *v_document,
    +                           void *data);
    +   bool (*visit_array) (const bson_iter_t *iter,
    +                        const char *key,
    +                        const bson_t *v_array,
    +                        void *data);
    +   bool (*visit_binary) (const bson_iter_t *iter,
    +                         const char *key,
    +                         bson_subtype_t v_subtype,
    +                         size_t v_binary_len,
    +                         const uint8_t *v_binary,
    +                         void *data);
    +   /* normal field with deprecated "Undefined" BSON type */
    +   bool (*visit_undefined) (const bson_iter_t *iter,
    +                            const char *key,
    +                            void *data);
    +   bool (*visit_oid) (const bson_iter_t *iter,
    +                      const char *key,
    +                      const bson_oid_t *v_oid,
    +                      void *data);
    +   bool (*visit_bool) (const bson_iter_t *iter,
    +                       const char *key,
    +                       bool v_bool,
    +                       void *data);
    +   bool (*visit_date_time) (const bson_iter_t *iter,
    +                            const char *key,
    +                            int64_t msec_since_epoch,
    +                            void *data);
    +   bool (*visit_null) (const bson_iter_t *iter, const char *key, void *data);
    +   bool (*visit_regex) (const bson_iter_t *iter,
    +                        const char *key,
    +                        const char *v_regex,
    +                        const char *v_options,
    +                        void *data);
    +   bool (*visit_dbpointer) (const bson_iter_t *iter,
    +                            const char *key,
    +                            size_t v_collection_len,
    +                            const char *v_collection,
    +                            const bson_oid_t *v_oid,
    +                            void *data);
    +   bool (*visit_code) (const bson_iter_t *iter,
    +                       const char *key,
    +                       size_t v_code_len,
    +                       const char *v_code,
    +                       void *data);
    +   bool (*visit_symbol) (const bson_iter_t *iter,
    +                         const char *key,
    +                         size_t v_symbol_len,
    +                         const char *v_symbol,
    +                         void *data);
    +   bool (*visit_codewscope) (const bson_iter_t *iter,
    +                             const char *key,
    +                             size_t v_code_len,
    +                             const char *v_code,
    +                             const bson_t *v_scope,
    +                             void *data);
    +   bool (*visit_int32) (const bson_iter_t *iter,
    +                        const char *key,
    +                        int32_t v_int32,
    +                        void *data);
    +   bool (*visit_timestamp) (const bson_iter_t *iter,
    +                            const char *key,
    +                            uint32_t v_timestamp,
    +                            uint32_t v_increment,
    +                            void *data);
    +   bool (*visit_int64) (const bson_iter_t *iter,
    +                        const char *key,
    +                        int64_t v_int64,
    +                        void *data);
    +   bool (*visit_maxkey) (const bson_iter_t *iter, const char *key, void *data);
    +   bool (*visit_minkey) (const bson_iter_t *iter, const char *key, void *data);
    +   /* if set, called instead of visit_corrupt when an apparently valid BSON
    +    * includes an unrecognized field type (reading future version of BSON) */
    +   void (*visit_unsupported_type) (const bson_iter_t *iter,
    +                                   const char *key,
    +                                   uint32_t type_code,
    +                                   void *data);
    +   bool (*visit_decimal128) (const bson_iter_t *iter,
    +                             const char *key,
    +                             const bson_decimal128_t *v_decimal128,
    +                             void *data);
    +
    +   void *padding[7];
    +} bson_visitor_t bson_visitor_t;
    +
    +
    +
    +
    +

    Description

    +

    The bson_visitor_t structure provides a series of callbacks that can be called while iterating a BSON document. This may simplify the conversion of a bson_t to a higher level language structure.

    +

    If the optional callback visit_unsupported_type is set, it is called instead of visit_corrupt in the specific case of an unrecognized field type. (Parsing is aborted in either case.) Use this callback to report an error like “unrecognized type” instead of simply “corrupt BSON”. This future-proofs code that may use an older version of libbson to parse future BSON formats.

    +
    +
    +

    Functions

    +
    +
    +
    +
    +

    Basic Example

    +
    #include <bson/bson.h>
    +#include <stdio.h>
    +
    +static bool
    +my_visit_before (const bson_iter_t *iter, const char *key, void *data)
    +{
    +   int *count = (int *) data;
    +
    +   (*count)++;
    +
    +   /* returning true stops further iteration of the document */
    +
    +   return false;
    +}
    +
    +static void
    +count_fields (bson_t *doc)
    +{
    +   bson_visitor_t visitor = {0};
    +   bson_iter_t iter;
    +   int count = 0;
    +
    +   visitor.visit_before = my_visit_before;
    +
    +   if (bson_iter_init (&iter, doc)) {
    +      bson_iter_visit_all (&iter, &visitor, &count);
    +   }
    +
    +   printf ("Found %d fields.\n", count);
    +}
    +
    +
    +

    The example below demonstrates how to set your own callbacks to provide information about the location of corrupt or unsupported BSON document entries.

    +
    +
    +

    Example Corruption Check

    +
    #include <bson/bson.h>
    +#include <stdio.h>
    +
    +typedef struct {
    +   ssize_t *err_offset;
    +} my_state_t;
    +
    +static void
    +my_visit_corrupt (const bson_iter_t *iter, void *data)
    +{
    +   *(((my_state_t *) data)->err_offset) = iter->off;
    +}
    +
    +static void
    +my_visit_unsupported_type (const bson_iter_t *iter,
    +                           const char *key,
    +                           uint32_t type_code,
    +                           void *data)
    +{
    +   *(((my_state_t *) data)->err_offset) = iter->off;
    +}
    +
    +static void
    +find_error_location (bson_t *doc)
    +{
    +   bson_visitor_t visitors = {0};
    +   bson_iter_t iter;
    +   my_state_t state;
    +   ssize_t err_offset = -1;
    +
    +   visitors.visit_corrupt = my_visit_corrupt;
    +   visitors.visit_unsupported_type = my_visit_unsupported_type;
    +   /* provide additional visitors as needed based on your requirements */
    +   state.err_offset = &err_offset;
    +
    +   if (!bson_iter_init (&iter, doc)) {
    +      printf ("Could not initialize iterator!");
    +      exit (1);
    +   }
    +
    +   if (bson_iter_visit_all (&iter, &visitors, &state) ||
    +       err_offset != -1) {
    +      printf ("Found error at offset %d.\n", err_offset);
    +   } else {
    +      printf ("BSON document had no errors.\n");
    +   }
    +}
    +
    +
    +

    The example below demonstrates how to use a visitor to validate a BSON document’s maximum depth.

    +
    +
    +

    Example Custom Validation

    +
    +
    bson-check-depth.c
    +
    /* Reports the maximum nested depth of a BSON document. */
    +#include <bson/bson.h>
    +
    +#include <assert.h>
    +#include <inttypes.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +typedef struct {
    +   uint32_t depth;
    +   uint32_t max_depth;
    +   bool valid;
    +} check_depth_t;
    +
    +bool
    +_check_depth_document (const bson_iter_t *iter,
    +                       const char *key,
    +                       const bson_t *v_document,
    +                       void *data);
    +
    +static const bson_visitor_t check_depth_funcs = {
    +   NULL,
    +   NULL,
    +   NULL,
    +   NULL,
    +   NULL,
    +   _check_depth_document,
    +   _check_depth_document,
    +   NULL,
    +};
    +
    +bool
    +_check_depth_document (const bson_iter_t *iter,
    +                       const char *key,
    +                       const bson_t *v_document,
    +                       void *data)
    +{
    +   check_depth_t *state = (check_depth_t *) data;
    +   bson_iter_t child;
    +
    +   BSON_UNUSED (iter);
    +   BSON_UNUSED (key);
    +
    +   if (!bson_iter_init (&child, v_document)) {
    +      fprintf (stderr, "corrupt\n");
    +      return true; /* cancel */
    +   }
    +
    +   state->depth++;
    +   if (state->depth > state->max_depth) {
    +      state->valid = false;
    +      return true; /* cancel */
    +   }
    +
    +   bson_iter_visit_all (&child, &check_depth_funcs, state);
    +   state->depth--;
    +   return false; /* continue */
    +}
    +
    +void
    +check_depth (const bson_t *bson, uint32_t max_depth)
    +{
    +   bson_iter_t iter;
    +   check_depth_t state = {0};
    +
    +   if (!bson_iter_init (&iter, bson)) {
    +      fprintf (stderr, "corrupt\n");
    +   }
    +
    +   state.valid = true;
    +   state.max_depth = max_depth;
    +   _check_depth_document (&iter, NULL, bson, &state);
    +   if (!state.valid) {
    +      printf ("document exceeds maximum depth of %" PRIu32 "\n",
    +              state.max_depth);
    +   } else {
    +      char *as_json = bson_as_canonical_extended_json (bson, NULL);
    +      printf ("document %s ", as_json);
    +      printf ("is valid\n");
    +      bson_free (as_json);
    +   }
    +}
    +
    +int
    +main (int argc, char **argv)
    +{
    +   bson_reader_t *bson_reader;
    +   const bson_t *bson;
    +   bool reached_eof;
    +   bson_error_t error;
    +
    +   if (argc != 3) {
    +      fprintf (stderr, "usage: %s FILE MAX_DEPTH\n", argv[0]);
    +      fprintf (stderr, "Checks that the depth of the BSON contained in FILE\n");
    +      fprintf (stderr, "does not exceed MAX_DEPTH\n");
    +   }
    +
    +   const char *const filename = argv[1];
    +   const int max_depth = atoi (argv[2]);
    +
    +   bson_reader = bson_reader_new_from_file (filename, &error);
    +   if (!bson_reader) {
    +      printf ("could not read %s: %s\n", filename, error.message);
    +      return 1;
    +   }
    +
    +   BSON_ASSERT (bson_in_range_signed (uint32_t, max_depth));
    +
    +   while ((bson = bson_reader_read (bson_reader, &reached_eof))) {
    +      check_depth (bson, (uint32_t) max_depth);
    +   }
    +
    +   if (!reached_eof) {
    +      printf ("error reading BSON\n");
    +   }
    +
    +   bson_reader_destroy (bson_reader);
    +   return 0;
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_vsnprintf.html b/libbson/1.24.0/bson_vsnprintf.html new file mode 100644 index 0000000000000000000000000000000000000000..906fdce7ff5a7ff17565b1f08de872721153b01c --- /dev/null +++ b/libbson/1.24.0/bson_vsnprintf.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_vsnprintf() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_vsnprintf()

    +
    +

    Synopsis

    +
    int
    +bson_vsnprintf (char *str, size_t size, const char *format, va_list ap)
    +   BSON_GNUC_PRINTF (3, 0);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • str: A location for the resulting string.

    • +
    • size: The size of str in bytes.

    • +
    • format: A printf style format string.

    • +
    • ap: A va_list of parameters for the format.

    • +
    +
    +
    +

    Description

    +

    Like bson_snprintf() but allows for variadic parameters.

    +
    +
    +

    Returns

    +

    The number of bytes written to str excluding the \0 byte.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_begin.html b/libbson/1.24.0/bson_writer_begin.html new file mode 100644 index 0000000000000000000000000000000000000000..ae94f66c0ce81a47094aa3184a61729093d4dc3f --- /dev/null +++ b/libbson/1.24.0/bson_writer_begin.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_writer_begin() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_begin()

    +
    +

    Synopsis

    +
    bool
    +bson_writer_begin (bson_writer_t *writer, bson_t **bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Begins writing a new document. The caller may use the bson structure to write out a new BSON document. When completed, the caller must call either bson_writer_end() or bson_writer_rollback().

    +
    +
    +

    Returns

    +

    true if there was space in the underlying buffers to begin the document.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_destroy.html b/libbson/1.24.0/bson_writer_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..7a9eb1b61f746586bc2d01850a5a6188605a9397 --- /dev/null +++ b/libbson/1.24.0/bson_writer_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_writer_destroy() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_destroy()

    +
    +

    Synopsis

    +
    void
    +bson_writer_destroy (bson_writer_t *writer);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Cleanup after writer and release any allocated memory. Does nothing if writer is NULL. Note that the buffer supplied to bson_writer_new() is NOT freed from this method. The caller is responsible for that.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_end.html b/libbson/1.24.0/bson_writer_end.html new file mode 100644 index 0000000000000000000000000000000000000000..43459d14a9b992d3d305ff4931e70a9c404139b9 --- /dev/null +++ b/libbson/1.24.0/bson_writer_end.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_writer_end() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_end()

    +
    +

    Synopsis

    +
    void
    +bson_writer_end (bson_writer_t *writer);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Complete writing of a bson_writer_t to the buffer supplied.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_get_length.html b/libbson/1.24.0/bson_writer_get_length.html new file mode 100644 index 0000000000000000000000000000000000000000..5c25de921838f79872eda826942b673ea1975510 --- /dev/null +++ b/libbson/1.24.0/bson_writer_get_length.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_writer_get_length() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_get_length()

    +
    +

    Synopsis

    +
    size_t
    +bson_writer_get_length (bson_writer_t *writer);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the current length of the content written by the buffer (including the initial offset). This includes a partly written document currently being written.

    +

    This is useful if you want to check to see if you’ve passed a given memory boundary that cannot be sent in a packet. See bson_writer_rollback() to abort the current document being written.

    +
    +
    +

    Returns

    +

    The length of the underlying buffer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_new.html b/libbson/1.24.0/bson_writer_new.html new file mode 100644 index 0000000000000000000000000000000000000000..71fbcd01588ab5c7902c977282c94a3b9d67091f --- /dev/null +++ b/libbson/1.24.0/bson_writer_new.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_writer_new() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_new()

    +
    +

    Synopsis

    +
    bson_writer_t *
    +bson_writer_new (uint8_t **buf,
    +                 size_t *buflen,
    +                 size_t offset,
    +                 bson_realloc_func realloc_func,
    +                 void *realloc_func_ctx);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • buf: A uint8_t.

    • +
    • buflen: A size_t.

    • +
    • offset: A size_t.

    • +
    • realloc_func: A bson_realloc_func.

    • +
    • realloc_func_ctx: A bson_realloc_func.

    • +
    +
    +
    +

    Description

    +

    Creates a new instance of bson_writer_t using the buffer, length, offset, and _realloc()_ function supplied.

    +

    The caller is expected to clean up the structure when finished using bson_writer_destroy().

    +
    +
    +

    Returns

    +

    A newly allocated bson_writer_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_rollback.html b/libbson/1.24.0/bson_writer_rollback.html new file mode 100644 index 0000000000000000000000000000000000000000..79c3b4bf3824d6e0c608cf5492a1efc2b6a35a8d --- /dev/null +++ b/libbson/1.24.0/bson_writer_rollback.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_writer_rollback() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_rollback()

    +
    +

    Synopsis

    +
    void
    +bson_writer_rollback (bson_writer_t *writer);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Abort the appending of the current bson_t to the memory region managed by writer. This is useful if you detected that you went past a particular memory limit. For example, MongoDB has 48MB message limits.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_writer_t.html b/libbson/1.24.0/bson_writer_t.html new file mode 100644 index 0000000000000000000000000000000000000000..92741f760a2dbfbe343a77ce4a210c497b226c91 --- /dev/null +++ b/libbson/1.24.0/bson_writer_t.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + bson_writer_t — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_writer_t

    +

    Bulk BSON serialization Abstraction

    +
    +

    Synopsis

    +
    #include <bson/bson.h>
    +
    +typedef struct _bson_writer_t bson_writer_t;
    +
    +bson_writer_t *
    +bson_writer_new (uint8_t **buf,
    +                 size_t *buflen,
    +                 size_t offset,
    +                 bson_realloc_func realloc_func,
    +                 void *realloc_func_ctx);
    +void
    +bson_writer_destroy (bson_writer_t *writer);
    +
    +
    +
    +
    +

    Description

    +

    The bson_writer_t API provides an abstraction for serializing many BSON documents to a single memory region. The memory region may be dynamically allocated and re-allocated as more memory is demanded. This can be useful when building network packets from a high-level language. For example, you can serialize a Python Dictionary directly to a single buffer destined for a TCP packet.

    +
    +
    +

    Functions

    + +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_writer_t *writer;
    +   uint8_t *buf = NULL;
    +   size_t buflen = 0;
    +   bson_t *doc;
    +
    +   writer = bson_writer_new (&buf, &buflen, 0, bson_realloc_ctx, NULL);
    +
    +   for (i = 0; i < 1000; i++) {
    +      bson_writer_begin (writer, &doc);
    +      BSON_APPEND_INT32 (&doc, "i", i);
    +      bson_writer_end (writer);
    +   }
    +
    +   bson_writer_destroy (writer);
    +
    +   bson_free (buf);
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/bson_zero_free.html b/libbson/1.24.0/bson_zero_free.html new file mode 100644 index 0000000000000000000000000000000000000000..419c577e9f4fe57a4a69b12c83d15aec8fe32bc7 --- /dev/null +++ b/libbson/1.24.0/bson_zero_free.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_zero_free() — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    bson_zero_free()

    +
    +

    Synopsis

    +
    void
    +bson_zero_free (void *mem, size_t size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • mem: A memory region.

    • +
    • size: The size of mem.

    • +
    +
    +
    +

    Description

    +

    This function behaves like bson_free() except that it zeroes the memory first. This can be useful if you are storing passwords or other similarly important data. Note that if it truly is important, you probably want a page protected with mlock() as well to prevent it swapping to disk.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/character_and_string_routines.html b/libbson/1.24.0/character_and_string_routines.html new file mode 100644 index 0000000000000000000000000000000000000000..4d7d03945611964bd94aa2c58896087b839a6a34 --- /dev/null +++ b/libbson/1.24.0/character_and_string_routines.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + Character and String Routines — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libbson/1.24.0/creating.html b/libbson/1.24.0/creating.html new file mode 100644 index 0000000000000000000000000000000000000000..3e95fb1db176e51af844f4fbf28a6fedb53f656d --- /dev/null +++ b/libbson/1.24.0/creating.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + Creating a BSON Document — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Creating a BSON Document

    +
    +

    The bson_t structure

    +

    BSON documents are created using the bson_t structure. This structure encapsulates the necessary logic for encoding using the BSON Specification. At the core, bson_t is a buffer manager and set of encoding routines.

    +
    +

    Tip

    +

    BSON documents can live on the stack or the heap based on the performance needs or preference of the consumer.

    +
    +

    Let’s start by creating a new BSON document on the stack. Whenever using libbson, make sure you #include <bson/bson.h>.

    +
    bson_t b;
    +
    +bson_init (&b);
    +
    +
    +

    This creates an empty document. In JSON, this would be the same as {}.

    +

    We can now proceed to adding items to the BSON document. A variety of functions prefixed with bson_append_ can be used based on the type of field you want to append. Let’s append a UTF-8 encoded string.

    +
    bson_append_utf8 (&b, "key", -1, "value", -1);
    +
    +
    +

    Notice the two -1 parameters. The first indicates that the length of key in bytes should be determined with strlen(). Alternatively, we could have passed the number 3. The same goes for the second -1, but for value.

    +

    Libbson provides macros to make this less tedious when using string literals. The following two appends are identical.

    +
    bson_append_utf8 (&b, "key", -1, "value", -1);
    +BSON_APPEND_UTF8 (&b, "key", "value");
    +
    +
    +

    Now let’s take a look at an example that adds a few different field types to a BSON document.

    +
    bson_t b = BSON_INITIALIZER;
    +
    +BSON_APPEND_INT32 (&b, "a", 1);
    +BSON_APPEND_UTF8 (&b, "hello", "world");
    +BSON_APPEND_BOOL (&b, "bool", true);
    +
    +
    +

    Notice that we omitted the call to bson_init(). By specifying BSON_INITIALIZER we can remove the need to initialize the structure to a base state.

    +
    +
    +

    Sub-Documents and Sub-Arrays

    +

    To simplify the creation of sub-documents and arrays, bson_append_document_begin() and bson_append_array_begin() exist. These can be used to build a sub-document using the parent documents memory region as the destination buffer.

    +
    bson_t parent;
    +bson_t child;
    +char *str;
    +
    +bson_init (&parent);
    +bson_append_document_begin (&parent, "foo", 3, &child);
    +bson_append_int32 (&child, "baz", 3, 1);
    +bson_append_document_end (&parent, &child);
    +
    +str = bson_as_canonical_extended_json (&parent, NULL);
    +printf ("%s\n", str);
    +bson_free (str);
    +
    +bson_destroy (&parent);
    +
    +
    +
    { "foo" : { "baz" : 1 } }
    +
    +
    +
    +
    +

    Simplified BSON C Object Notation

    +

    Creating BSON documents by hand can be tedious and time consuming. BCON, or BSON C Object Notation, was added to allow for the creation of BSON documents in a format that looks closer to the destination format.

    +

    The following example shows the use of BCON. Notice that values for fields are wrapped in the BCON_* macros. These are required for the variadic processor to determine the parameter type.

    +
    bson_t *doc;
    +
    +doc = BCON_NEW ("foo",
    +                "{",
    +                "int",
    +                BCON_INT32 (1),
    +                "array",
    +                "[",
    +                BCON_INT32 (100),
    +                "{",
    +                "sub",
    +                BCON_UTF8 ("value"),
    +                "}",
    +                "]",
    +                "}");
    +
    +
    +

    Creates the following document

    +
    { "foo" : { "int" : 1, "array" : [ 100, { "sub" : "value" } ] } }
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/cross-platform-notes.html b/libbson/1.24.0/cross-platform-notes.html new file mode 100644 index 0000000000000000000000000000000000000000..e5c635a7e0ea6b1d5397b24807a32808dd620b05 --- /dev/null +++ b/libbson/1.24.0/cross-platform-notes.html @@ -0,0 +1,121 @@ + + + + + + + + + + + + + + Cross Platform Notes — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Cross Platform Notes

    + +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/endianness.html b/libbson/1.24.0/endianness.html new file mode 100644 index 0000000000000000000000000000000000000000..0b9c68d2cf662296d791a50a270937d5af31100a --- /dev/null +++ b/libbson/1.24.0/endianness.html @@ -0,0 +1,117 @@ + + + + + + + + + + + + + + Endianness — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Endianness

    +

    The BSON specification dictates that the encoding format is in little-endian. Many implementations simply ignore endianness altogether and expect that they are to be run on little-endian. Libbson supports both Big and Little Endian systems. This means we use memcpy() when appropriate instead of dereferencing and properly convert to and from the host endian format. We expect the compiler intrinsics to optimize it to a dereference when possible.

    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/errors.html b/libbson/1.24.0/errors.html new file mode 100644 index 0000000000000000000000000000000000000000..edee26e81831cc50eb0973e0074ab658d3e98195 --- /dev/null +++ b/libbson/1.24.0/errors.html @@ -0,0 +1,105 @@ + + + + + + + + + + + + + + Handling Errors — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +

    Handling Errors

    +
    +

    Description

    +

    Many libbson functions report errors by returning NULL or -1 and filling out a bson_error_t structure with an error domain, error code, and message.

    +
      +
    • error.domain names the subsystem that generated the error.

    • +
    • error.code is a domain-specific error type.

    • +
    • error.message describes the error.

    • +
    +

    Some error codes overlap with others; always check both the domain and code to determine the type of error.

    + + + + + + + + + + + +

    BSON_ERROR_JSON

    BSON_JSON_ERROR_READ_CORRUPT_JS +BSON_JSON_ERROR_READ_INVALID_PARAM +BSON_JSON_ERROR_READ_CB_FAILURE

    bson_json_reader_t tried to parse invalid MongoDB Extended JSON. +Tried to parse a valid JSON document that is invalid as MongoDBExtended JSON. +An internal callback failure during JSON parsing.

    BSON_ERROR_READER

    BSON_ERROR_READER_BADFD

    bson_json_reader_new_from_file() could not open the file.

    +
    +
    + + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/full_index.html b/libbson/1.24.0/full_index.html new file mode 100644 index 0000000000000000000000000000000000000000..ae2c73f667d58e01351946f556ec3c75d1ed3bd3 --- /dev/null +++ b/libbson/1.24.0/full_index.html @@ -0,0 +1,396 @@ + + + + + + + + + + + + + + Index — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Index

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/guides.html b/libbson/1.24.0/guides.html new file mode 100644 index 0000000000000000000000000000000000000000..eb7fa54765b663bf70a1299b91433905b451aec1 --- /dev/null +++ b/libbson/1.24.0/guides.html @@ -0,0 +1,121 @@ + + + + + + + + + + + + + + Guides — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Guides

    + +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/include-and-link.html b/libbson/1.24.0/include-and-link.html new file mode 100644 index 0000000000000000000000000000000000000000..769b0e6a2d91336a3adb6bab32d8a0c1f5228ee1 --- /dev/null +++ b/libbson/1.24.0/include-and-link.html @@ -0,0 +1,182 @@ + + + + + + + + + + + + + + Using libbson In Your C Program — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Using libbson In Your C Program

    +
    +

    Include bson.h

    +

    All libbson’s functions and types are available in one header file. Simply include bson.h:

    +
    +
    hello_bson.c
    +
    #include <stdio.h>
    +#include <bson/bson.h>
    +
    +int
    +main (int argc, const char **argv)
    +{
    +   bson_t *b;
    +   char *j;
    +
    +   b = BCON_NEW ("hello", BCON_UTF8 ("bson!"));
    +   j = bson_as_canonical_extended_json (b, NULL);
    +   printf ("%s\n", j);
    +
    +   bson_free (j);
    +   bson_destroy (b);
    +
    +   return 0;
    +}
    +
    +
    +
    +
    +
    +

    CMake

    +

    The libbson installation includes a CMake config-file package, so you can use CMake’s find_package command to import libbson’s CMake target and link to libbson (as a shared library):

    +
    +
    CMakeLists.txt
    +
    # Specify the minimum version you require.
    +find_package (bson-1.0 1.7 REQUIRED)
    +
    +# The "hello_bson.c" sample program is shared among four tests.
    +add_executable (hello_bson ../../hello_bson.c)
    +target_link_libraries (hello_bson PRIVATE mongo::bson_shared)
    +
    +
    +
    +

    You can also use libbson as a static library instead: Use the mongo::bson_static CMake target:

    +
    # Specify the minimum version you require.
    +find_package (bson-1.0 1.7 REQUIRED)
    +
    +# The "hello_bson.c" sample program is shared among four tests.
    +add_executable (hello_bson ../../hello_bson.c)
    +target_link_libraries (hello_bson PRIVATE mongo::bson_static)
    +
    +
    +
    +
    +

    pkg-config

    +

    If you’re not using CMake, use pkg-config on the command line to set header and library paths:

    +
    gcc -o hello_bson hello_bson.c $(pkg-config --libs --cflags libbson-1.0)
    +
    +
    +

    Or to statically link to libbson:

    +
    gcc -o hello_bson hello_bson.c $(pkg-config --libs --cflags libbson-static-1.0)
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/index.html b/libbson/1.24.0/index.html new file mode 100644 index 0000000000000000000000000000000000000000..18a31359a46086c54b50f61ae7bbdf6b7121f6ce --- /dev/null +++ b/libbson/1.24.0/index.html @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + libbson — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + +
    + + + + +
    +
    +
    +
    + +
    +

    libbson

    +

    A Cross Platform BSON Library for C

    +
    +

    Introduction

    +

    libbson builds, parses, and iterates BSON documents, the native data format of MongoDB. It also converts BSON to and from JSON, and provides a platform compatibility layer for the MongoDB C Driver.

    + +
    + +
    + + +
    +
    + + +
    +
    +
    + +
    +
    + + +
    + + + \ No newline at end of file diff --git a/libbson/1.24.0/json.html b/libbson/1.24.0/json.html new file mode 100644 index 0000000000000000000000000000000000000000..021b624d594c7f7e722030fa5f8563dc20744726 --- /dev/null +++ b/libbson/1.24.0/json.html @@ -0,0 +1,348 @@ + + + + + + + + + + + + + + JSON — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    JSON

    +

    Libbson provides routines for converting to and from the JSON format. In particular, it supports the MongoDB extended JSON format.

    +
    +

    Converting BSON to JSON

    +

    There are often times where you might want to convert a BSON document to JSON. It is convenient for debugging as well as an interchange format. To help with this, Libbson contains the functions bson_as_canonical_extended_json() and bson_as_relaxed_extended_json(). The canonical format preserves BSON type information for values that may have ambiguous representations in JSON (e.g. numeric types).

    +
    bson_t *b;
    +size_t len;
    +char *str;
    +
    +b = BCON_NEW ("a", BCON_INT32 (1));
    +
    +str = bson_as_canonical_extended_json (b, &len);
    +printf ("%s\n", str);
    +bson_free (str);
    +
    +bson_destroy (b);
    +
    +
    +
    { "a" : { "$numberInt": "1" } }
    +
    +
    +

    The relaxed format prefers JSON primitives for numeric values and may be used if type fidelity is not required.

    +
    bson_t *b;
    +size_t len;
    +char *str;
    +
    +b = BCON_NEW ("a", BCON_INT32 (1));
    +
    +str = bson_as_relaxed_extended_json (b, &len);
    +printf ("%s\n", str);
    +bson_free (str);
    +
    +bson_destroy (b);
    +
    +
    +
    { "a" : 1 }
    +
    +
    +
    +
    +

    Converting JSON to BSON

    +

    Converting back from JSON is also useful and common enough that we added bson_init_from_json() and bson_new_from_json().

    +

    The following example creates a new bson_t from the JSON string {"a":1}.

    +
    bson_t *b;
    +bson_error_t error;
    +
    +b = bson_new_from_json ("{\"a\":1}", -1, &error);
    +
    +if (!b) {
    +   printf ("Error: %s\n", error.message);
    +} else {
    +   bson_destroy (b);
    +}
    +
    +
    +
    +
    +

    Streaming JSON Parsing

    +

    Libbson provides bson_json_reader_t to allow for parsing a sequence of JSON documents into BSON. The interface is similar to bson_reader_t but expects the input to be in the MongoDB extended JSON format.

    +
    /*
    + * Copyright 2013 MongoDB, Inc.
    + *
    + * Licensed under the Apache License, Version 2.0 (the "License");
    + * you may not use this file except in compliance with the License.
    + * You may obtain a copy of the License at
    + *
    + *   http://www.apache.org/licenses/LICENSE-2.0
    + *
    + * Unless required by applicable law or agreed to in writing, software
    + * distributed under the License is distributed on an "AS IS" BASIS,
    + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    + * See the License for the specific language governing permissions and
    + * limitations under the License.
    + */
    +
    +
    +/*
    + * This program will print each JSON document contained in the provided files
    + * as a BSON string to STDOUT.
    + */
    +
    +
    +#include <bson/bson.h>
    +#include <stdlib.h>
    +#include <stdio.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_json_reader_t *reader;
    +   bson_error_t error;
    +   const char *filename;
    +   bson_t doc = BSON_INITIALIZER;
    +   int i;
    +   int b;
    +
    +   /*
    +    * Print program usage if no arguments are provided.
    +    */
    +   if (argc == 1) {
    +      fprintf (stderr, "usage: %s FILE...\n", argv[0]);
    +      return 1;
    +   }
    +
    +   /*
    +    * Process command line arguments expecting each to be a filename.
    +    */
    +   for (i = 1; i < argc; i++) {
    +      filename = argv[i];
    +
    +      /*
    +       * Open the filename provided in command line arguments.
    +       */
    +      if (0 == strcmp (filename, "-")) {
    +         reader = bson_json_reader_new_from_fd (STDIN_FILENO, false);
    +      } else {
    +         if (!(reader = bson_json_reader_new_from_file (filename, &error))) {
    +            fprintf (
    +               stderr, "Failed to open \"%s\": %s\n", filename, error.message);
    +            continue;
    +         }
    +      }
    +
    +      /*
    +       * Convert each incoming document to BSON and print to stdout.
    +       */
    +      while ((b = bson_json_reader_read (reader, &doc, &error))) {
    +         if (b < 0) {
    +            fprintf (stderr, "Error in json parsing:\n%s\n", error.message);
    +            abort ();
    +         }
    +
    +         if (fwrite (bson_get_data (&doc), 1, doc.len, stdout) != doc.len) {
    +            fprintf (stderr, "Failed to write to stdout, exiting.\n");
    +            exit (1);
    +         }
    +         bson_reinit (&doc);
    +      }
    +
    +      bson_json_reader_destroy (reader);
    +      bson_destroy (&doc);
    +   }
    +
    +   return 0;
    +}
    +
    +
    +
    +
    +

    Examples

    +

    The following example reads BSON documents from stdin and prints them to stdout as JSON.

    +
    /*
    + * Copyright 2013 MongoDB, Inc.
    + *
    + * Licensed under the Apache License, Version 2.0 (the "License");
    + * you may not use this file except in compliance with the License.
    + * You may obtain a copy of the License at
    + *
    + *   http://www.apache.org/licenses/LICENSE-2.0
    + *
    + * Unless required by applicable law or agreed to in writing, software
    + * distributed under the License is distributed on an "AS IS" BASIS,
    + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    + * See the License for the specific language governing permissions and
    + * limitations under the License.
    + */
    +
    +
    +/*
    + * This program will print each BSON document contained in the provided files
    + * as a JSON string to STDOUT.
    + */
    +
    +
    +#include <bson/bson.h>
    +#include <stdio.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_reader_t *reader;
    +   const bson_t *b;
    +   bson_error_t error;
    +   const char *filename;
    +   char *str;
    +   int i;
    +
    +   /*
    +    * Print program usage if no arguments are provided.
    +    */
    +   if (argc == 1) {
    +      fprintf (stderr, "usage: %s [FILE | -]...\nUse - for STDIN.\n", argv[0]);
    +      return 1;
    +   }
    +
    +   /*
    +    * Process command line arguments expecting each to be a filename.
    +    */
    +   for (i = 1; i < argc; i++) {
    +      filename = argv[i];
    +
    +      if (strcmp (filename, "-") == 0) {
    +         reader = bson_reader_new_from_fd (STDIN_FILENO, false);
    +      } else {
    +         if (!(reader = bson_reader_new_from_file (filename, &error))) {
    +            fprintf (
    +               stderr, "Failed to open \"%s\": %s\n", filename, error.message);
    +            continue;
    +         }
    +      }
    +
    +      /*
    +       * Convert each incoming document to JSON and print to stdout.
    +       */
    +      while ((b = bson_reader_read (reader, NULL))) {
    +         str = bson_as_canonical_extended_json (b, NULL);
    +         fprintf (stdout, "%s\n", str);
    +         bson_free (str);
    +      }
    +
    +      /*
    +       * Cleanup after our reader, which closes the file descriptor.
    +       */
    +      bson_reader_destroy (reader);
    +   }
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/objects.inv b/libbson/1.24.0/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..dd912aee83e5e14786416c4933deca14e21daa3a Binary files /dev/null and b/libbson/1.24.0/objects.inv differ diff --git a/libbson/1.24.0/oid.html b/libbson/1.24.0/oid.html new file mode 100644 index 0000000000000000000000000000000000000000..c90df440dd68a5885a64269e927c94de3944502e --- /dev/null +++ b/libbson/1.24.0/oid.html @@ -0,0 +1,180 @@ + + + + + + + + + + + + + + ObjectIDs — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    ObjectIDs

    +

    Libbson provides a simple way to generate ObjectIDs. It can be used in a single-threaded or multi-threaded manner depending on your requirements.

    +

    The bson_oid_t structure represents an ObjectID in MongoDB. It is a 96-bit identifier.

    +
    +

    Composition

    +
      +
    • 4 bytes : The UNIX timestamp in big-endian format.

    • +
    • 5 bytes : A random number.

    • +
    • 3 bytes : A 24-bit monotonic counter incrementing from rand() in big-endian.

    • +
    +
    +
    +

    Sorting ObjectIDs

    +

    The typical way to sort in C is using qsort(). Therefore, Libbson provides a qsort() compatible callback function named bson_oid_compare(). It returns less than 1, greater than 1, or 0 depending on the equality of two bson_oid_t structures.

    +
    +
    +

    Comparing Object IDs

    +

    If you simply want to compare two bson_oid_t structures for equality, use bson_oid_equal().

    +
    +
    +

    Generating

    +

    To generate a bson_oid_t, you may use the following.

    +
    bson_oid_t oid;
    +
    +bson_oid_init (&oid, NULL);
    +
    +
    +
    +
    +

    Parsing ObjectID Strings

    +

    You can also parse a string containing a bson_oid_t. The input string MUST be 24 characters or more in length.

    +
    bson_oid_t oid;
    +
    +bson_oid_init_from_string (&oid, "123456789012345678901234");
    +
    +
    +
    bson_oid_t oid;
    +
    +bson_oid_init_from_string_unsafe (&oid, "123456789012345678901234");
    +
    +
    +
    +
    +

    Hashing ObjectIDs

    +

    If you need to store items in a hashtable, you may want to use the bson_oid_t as the key. Libbson provides a hash function for just this purpose. It is based on DJB hash.

    +
    unsigned hash;
    +
    +hash = bson_oid_hash (oid);
    +
    +
    +
    +
    +

    Fetching ObjectID Creation Time

    +

    You can easily fetch the time that a bson_oid_t was generated using bson_oid_get_time_t().

    +
    time_t t;
    +
    +t = bson_oid_get_time_t (oid);
    +printf ("The OID was generated at %u\n", (unsigned) t);
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/parsing.html b/libbson/1.24.0/parsing.html new file mode 100644 index 0000000000000000000000000000000000000000..46e8b326bdcadadae211bb1bef0f0d3c496d788f --- /dev/null +++ b/libbson/1.24.0/parsing.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + Parsing and Iterating BSON Documents — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Parsing and Iterating BSON Documents

    +
    +

    Parsing

    +

    BSON documents are lazily parsed as necessary. To begin parsing a BSON document, use one of the provided Libbson functions to create a new bson_t from existing data such as bson_new_from_data(). This will make a copy of the data so that additional mutations may occur to the BSON document.

    +
    +

    Tip

    +

    If you only want to parse a BSON document and have no need to mutate it, you may use bson_init_static() to avoid making a copy of the data.

    +
    +
    bson_t *b;
    +
    +b = bson_new_from_data (my_data, my_data_len);
    +if (!b) {
    +   fprintf (stderr, "The specified length embedded in <my_data> did not match "
    +                    "<my_data_len>\n");
    +   return;
    +}
    +
    +bson_destroy (b);
    +
    +
    +

    Only two checks are performed when creating a new bson_t from an existing buffer. First, the document must begin with the buffer length, matching what was expected by the caller. Second, the document must end with the expected trailing \0 byte.

    +

    To parse the document further we use a bson_iter_t to iterate the elements within the document. Let’s print all of the field names in the document.

    +
    bson_t *b;
    +bson_iter_t iter;
    +
    +if ((b = bson_new_from_data (my_data, my_data_len))) {
    +   if (bson_iter_init (&iter, b)) {
    +      while (bson_iter_next (&iter)) {
    +         printf ("Found element key: \"%s\"\n", bson_iter_key (&iter));
    +      }
    +   }
    +   bson_destroy (b);
    +}
    +
    +
    +

    Converting a document to JSON uses a bson_iter_t and bson_visitor_t to iterate all fields of a BSON document recursively and generate a UTF-8 encoded JSON string.

    +
    bson_t *b;
    +char *json;
    +
    +if ((b = bson_new_from_data (my_data, my_data_len))) {
    +   if ((json = bson_as_canonical_extended_json (b, NULL))) {
    +      printf ("%s\n", json);
    +      bson_free (json);
    +   }
    +   bson_destroy (b);
    +}
    +
    +
    +
    +
    +

    Recursing into Sub-Documents

    +

    Libbson provides convenient sub-iterators to dive down into a sub-document or sub-array. Below is an example that will dive into a sub-document named “foo” and print it’s field names.

    +
    bson_iter_t iter;
    +bson_iter_t child;
    +char *json;
    +
    +if (bson_iter_init_find (&iter, doc, "foo") &&
    +    BSON_ITER_HOLDS_DOCUMENT (&iter) && bson_iter_recurse (&iter, &child)) {
    +   while (bson_iter_next (&child)) {
    +      printf ("Found sub-key of \"foo\" named \"%s\"\n",
    +              bson_iter_key (&child));
    +   }
    +}
    +
    +
    +
    +
    +

    Finding Fields using Dot Notation

    +

    Using the bson_iter_recurse() function exemplified above, bson_iter_find_descendant() can find a field for you using the MongoDB style path notation such as “foo.bar.0.baz”.

    +

    Let’s create a document like {"foo": {"bar": [{"baz: 1}]}} and locate the "baz" field.

    +
    bson_t *b;
    +bson_iter_t iter;
    +bson_iter_t baz;
    +
    +b =
    +   BCON_NEW ("foo", "{", "bar", "[", "{", "baz", BCON_INT32 (1), "}", "]", "}");
    +
    +if (bson_iter_init (&iter, b) &&
    +    bson_iter_find_descendant (&iter, "foo.bar.0.baz", &baz) &&
    +    BSON_ITER_HOLDS_INT32 (&baz)) {
    +   printf ("baz = %d\n", bson_iter_int32 (&baz));
    +}
    +
    +bson_destroy (b);
    +
    +
    +
    +
    +

    Validating a BSON Document

    +

    If all you want to do is validate that a BSON document is valid, you can use bson_validate().

    +
    size_t err_offset;
    +
    +if (!bson_validate (doc, BSON_VALIDATE_NONE, &err_offset)) {
    +   fprintf (stderr,
    +            "The document failed to validate at offset: %u\n",
    +            (unsigned) err_offset);
    +}
    +
    +
    +

    See the bson_validate() documentation for more information and examples.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/search.html b/libbson/1.24.0/search.html new file mode 100644 index 0000000000000000000000000000000000000000..8a07bdba47a9cc975140724c18245d297f2551cb --- /dev/null +++ b/libbson/1.24.0/search.html @@ -0,0 +1,117 @@ + + + + + + + + + + + + + Search — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +

    Search

    +
    + +

    + Please activate JavaScript to enable the search + functionality. +

    +
    +

    + From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list. +

    +
    + + + +
    + +
    + +
    + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/searchindex.js b/libbson/1.24.0/searchindex.js new file mode 100644 index 0000000000000000000000000000000000000000..238e7ccc47feec2b6395e09e9d12ef05e9ebe72c --- /dev/null +++ b/libbson/1.24.0/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"docnames": ["api", "bson_aligned_alloc", "bson_aligned_alloc0", "bson_append_array", "bson_append_array_begin", "bson_append_array_end", "bson_append_binary", "bson_append_bool", "bson_append_code", "bson_append_code_with_scope", "bson_append_date_time", "bson_append_dbpointer", "bson_append_decimal128", "bson_append_document", "bson_append_document_begin", "bson_append_document_end", "bson_append_double", "bson_append_int32", "bson_append_int64", "bson_append_iter", "bson_append_maxkey", "bson_append_minkey", "bson_append_now_utc", "bson_append_null", "bson_append_oid", "bson_append_regex", "bson_append_regex_w_len", "bson_append_symbol", "bson_append_time_t", "bson_append_timestamp", "bson_append_timeval", "bson_append_undefined", "bson_append_utf8", "bson_append_value", "bson_array_as_canonical_extended_json", "bson_array_as_json", "bson_array_as_relaxed_extended_json", "bson_as_canonical_extended_json", "bson_as_json", "bson_as_json_with_opts", "bson_as_relaxed_extended_json", "bson_ascii_strtoll", "bson_check_version", "bson_compare", "bson_concat", "bson_context_destroy", "bson_context_get_default", "bson_context_new", "bson_context_t", "bson_copy", "bson_copy_to", "bson_copy_to_excluding", "bson_copy_to_excluding_noinit", "bson_copy_to_excluding_noinit_va", "bson_count_keys", "bson_decimal128_from_string", "bson_decimal128_from_string_w_len", "bson_decimal128_t", "bson_decimal128_to_string", "bson_destroy", "bson_destroy_with_steal", "bson_equal", "bson_error_t", "bson_free", "bson_get_data", "bson_get_major_version", "bson_get_micro_version", "bson_get_minor_version", "bson_get_monotonic_time", "bson_get_version", "bson_has_field", "bson_init", "bson_init_from_json", "bson_init_static", "bson_isspace", "bson_iter_array", "bson_iter_as_bool", "bson_iter_as_double", "bson_iter_as_int64", "bson_iter_binary", "bson_iter_bool", "bson_iter_code", "bson_iter_codewscope", "bson_iter_date_time", "bson_iter_dbpointer", "bson_iter_decimal128", "bson_iter_document", "bson_iter_double", "bson_iter_dup_utf8", "bson_iter_find", "bson_iter_find_case", "bson_iter_find_descendant", "bson_iter_find_w_len", "bson_iter_init", "bson_iter_init_find", "bson_iter_init_find_case", "bson_iter_init_find_w_len", "bson_iter_init_from_data", "bson_iter_init_from_data_at_offset", "bson_iter_int32", "bson_iter_int64", "bson_iter_key", "bson_iter_key_len", "bson_iter_next", "bson_iter_offset", "bson_iter_oid", "bson_iter_overwrite_bool", "bson_iter_overwrite_date_time", "bson_iter_overwrite_decimal128", "bson_iter_overwrite_double", "bson_iter_overwrite_int32", "bson_iter_overwrite_int64", "bson_iter_overwrite_oid", "bson_iter_overwrite_timestamp", "bson_iter_recurse", "bson_iter_regex", "bson_iter_symbol", "bson_iter_t", "bson_iter_time_t", "bson_iter_timestamp", "bson_iter_timeval", "bson_iter_type", "bson_iter_utf8", "bson_iter_value", "bson_iter_visit_all", "bson_json_data_reader_ingest", "bson_json_data_reader_new", "bson_json_mode_t", "bson_json_opts_destroy", "bson_json_opts_new", "bson_json_opts_set_outermost_array", "bson_json_opts_t", "bson_json_reader_destroy", "bson_json_reader_new", "bson_json_reader_new_from_fd", "bson_json_reader_new_from_file", "bson_json_reader_read", "bson_json_reader_t", "bson_malloc", "bson_malloc0", "bson_mem_restore_vtable", "bson_mem_set_vtable", "bson_memory", "bson_new", "bson_new_from_buffer", "bson_new_from_data", "bson_new_from_json", "bson_oid_compare", "bson_oid_copy", "bson_oid_equal", "bson_oid_get_time_t", "bson_oid_hash", "bson_oid_init", "bson_oid_init_from_data", "bson_oid_init_from_string", "bson_oid_init_sequence", "bson_oid_is_valid", "bson_oid_t", "bson_oid_to_string", "bson_reader_destroy", "bson_reader_destroy_func_t", "bson_reader_new_from_data", "bson_reader_new_from_fd", "bson_reader_new_from_file", "bson_reader_new_from_handle", "bson_reader_read", "bson_reader_read_func_t", "bson_reader_reset", "bson_reader_set_destroy_func", "bson_reader_set_read_func", "bson_reader_t", "bson_reader_tell", "bson_realloc", "bson_realloc_ctx", "bson_realloc_func", "bson_reinit", "bson_reserve_buffer", "bson_set_error", "bson_sized_new", "bson_snprintf", "bson_steal", "bson_strcasecmp", "bson_strdup", "bson_strdup_printf", "bson_strdupv_printf", "bson_strerror_r", "bson_strfreev", "bson_string_append", "bson_string_append_c", "bson_string_append_printf", "bson_string_append_unichar", "bson_string_free", "bson_string_new", "bson_string_t", "bson_string_truncate", "bson_strncpy", "bson_strndup", "bson_strnlen", "bson_subtype_t", "bson_t", "bson_type_t", "bson_uint32_to_string", "bson_unichar_t", "bson_utf8_escape_for_json", "bson_utf8_from_unichar", "bson_utf8_get_char", "bson_utf8_next_char", "bson_utf8_validate", "bson_validate", "bson_validate_with_error", "bson_value_copy", "bson_value_destroy", "bson_value_t", "bson_visitor_t", "bson_vsnprintf", "bson_writer_begin", "bson_writer_destroy", "bson_writer_end", "bson_writer_get_length", "bson_writer_new", "bson_writer_rollback", "bson_writer_t", "bson_zero_free", "character_and_string_routines", "creating", "cross-platform-notes", "endianness", "errors", "full_index", "guides", "include-and-link", "index", "json", "oid", "parsing", "streaming-bson", "threading", "tutorial", "utf8", "version"], "filenames": ["api.rst", "bson_aligned_alloc.rst", "bson_aligned_alloc0.rst", "bson_append_array.rst", "bson_append_array_begin.rst", "bson_append_array_end.rst", "bson_append_binary.rst", "bson_append_bool.rst", "bson_append_code.rst", "bson_append_code_with_scope.rst", "bson_append_date_time.rst", "bson_append_dbpointer.rst", "bson_append_decimal128.rst", "bson_append_document.rst", "bson_append_document_begin.rst", "bson_append_document_end.rst", "bson_append_double.rst", "bson_append_int32.rst", "bson_append_int64.rst", "bson_append_iter.rst", "bson_append_maxkey.rst", "bson_append_minkey.rst", "bson_append_now_utc.rst", "bson_append_null.rst", "bson_append_oid.rst", "bson_append_regex.rst", "bson_append_regex_w_len.rst", "bson_append_symbol.rst", "bson_append_time_t.rst", "bson_append_timestamp.rst", "bson_append_timeval.rst", "bson_append_undefined.rst", "bson_append_utf8.rst", "bson_append_value.rst", "bson_array_as_canonical_extended_json.rst", "bson_array_as_json.rst", "bson_array_as_relaxed_extended_json.rst", "bson_as_canonical_extended_json.rst", "bson_as_json.rst", "bson_as_json_with_opts.rst", "bson_as_relaxed_extended_json.rst", "bson_ascii_strtoll.rst", "bson_check_version.rst", "bson_compare.rst", "bson_concat.rst", "bson_context_destroy.rst", "bson_context_get_default.rst", "bson_context_new.rst", "bson_context_t.rst", "bson_copy.rst", "bson_copy_to.rst", "bson_copy_to_excluding.rst", "bson_copy_to_excluding_noinit.rst", "bson_copy_to_excluding_noinit_va.rst", "bson_count_keys.rst", "bson_decimal128_from_string.rst", "bson_decimal128_from_string_w_len.rst", "bson_decimal128_t.rst", "bson_decimal128_to_string.rst", "bson_destroy.rst", "bson_destroy_with_steal.rst", "bson_equal.rst", "bson_error_t.rst", "bson_free.rst", "bson_get_data.rst", "bson_get_major_version.rst", "bson_get_micro_version.rst", "bson_get_minor_version.rst", "bson_get_monotonic_time.rst", "bson_get_version.rst", "bson_has_field.rst", "bson_init.rst", "bson_init_from_json.rst", "bson_init_static.rst", "bson_isspace.rst", "bson_iter_array.rst", "bson_iter_as_bool.rst", "bson_iter_as_double.rst", "bson_iter_as_int64.rst", "bson_iter_binary.rst", "bson_iter_bool.rst", "bson_iter_code.rst", "bson_iter_codewscope.rst", "bson_iter_date_time.rst", "bson_iter_dbpointer.rst", "bson_iter_decimal128.rst", "bson_iter_document.rst", "bson_iter_double.rst", "bson_iter_dup_utf8.rst", "bson_iter_find.rst", "bson_iter_find_case.rst", "bson_iter_find_descendant.rst", "bson_iter_find_w_len.rst", "bson_iter_init.rst", "bson_iter_init_find.rst", "bson_iter_init_find_case.rst", "bson_iter_init_find_w_len.rst", "bson_iter_init_from_data.rst", "bson_iter_init_from_data_at_offset.rst", "bson_iter_int32.rst", "bson_iter_int64.rst", "bson_iter_key.rst", "bson_iter_key_len.rst", "bson_iter_next.rst", "bson_iter_offset.rst", "bson_iter_oid.rst", "bson_iter_overwrite_bool.rst", "bson_iter_overwrite_date_time.rst", "bson_iter_overwrite_decimal128.rst", "bson_iter_overwrite_double.rst", "bson_iter_overwrite_int32.rst", "bson_iter_overwrite_int64.rst", "bson_iter_overwrite_oid.rst", "bson_iter_overwrite_timestamp.rst", "bson_iter_recurse.rst", "bson_iter_regex.rst", "bson_iter_symbol.rst", "bson_iter_t.rst", "bson_iter_time_t.rst", "bson_iter_timestamp.rst", "bson_iter_timeval.rst", "bson_iter_type.rst", "bson_iter_utf8.rst", "bson_iter_value.rst", "bson_iter_visit_all.rst", "bson_json_data_reader_ingest.rst", "bson_json_data_reader_new.rst", "bson_json_mode_t.rst", "bson_json_opts_destroy.rst", "bson_json_opts_new.rst", "bson_json_opts_set_outermost_array.rst", "bson_json_opts_t.rst", "bson_json_reader_destroy.rst", "bson_json_reader_new.rst", "bson_json_reader_new_from_fd.rst", "bson_json_reader_new_from_file.rst", "bson_json_reader_read.rst", "bson_json_reader_t.rst", "bson_malloc.rst", "bson_malloc0.rst", "bson_mem_restore_vtable.rst", "bson_mem_set_vtable.rst", "bson_memory.rst", "bson_new.rst", "bson_new_from_buffer.rst", "bson_new_from_data.rst", "bson_new_from_json.rst", "bson_oid_compare.rst", "bson_oid_copy.rst", "bson_oid_equal.rst", "bson_oid_get_time_t.rst", "bson_oid_hash.rst", "bson_oid_init.rst", "bson_oid_init_from_data.rst", "bson_oid_init_from_string.rst", "bson_oid_init_sequence.rst", "bson_oid_is_valid.rst", "bson_oid_t.rst", "bson_oid_to_string.rst", "bson_reader_destroy.rst", "bson_reader_destroy_func_t.rst", "bson_reader_new_from_data.rst", "bson_reader_new_from_fd.rst", "bson_reader_new_from_file.rst", "bson_reader_new_from_handle.rst", "bson_reader_read.rst", "bson_reader_read_func_t.rst", "bson_reader_reset.rst", "bson_reader_set_destroy_func.rst", "bson_reader_set_read_func.rst", "bson_reader_t.rst", "bson_reader_tell.rst", "bson_realloc.rst", "bson_realloc_ctx.rst", "bson_realloc_func.rst", "bson_reinit.rst", "bson_reserve_buffer.rst", "bson_set_error.rst", "bson_sized_new.rst", "bson_snprintf.rst", "bson_steal.rst", "bson_strcasecmp.rst", "bson_strdup.rst", "bson_strdup_printf.rst", "bson_strdupv_printf.rst", "bson_strerror_r.rst", "bson_strfreev.rst", "bson_string_append.rst", "bson_string_append_c.rst", "bson_string_append_printf.rst", "bson_string_append_unichar.rst", "bson_string_free.rst", "bson_string_new.rst", "bson_string_t.rst", "bson_string_truncate.rst", "bson_strncpy.rst", "bson_strndup.rst", "bson_strnlen.rst", "bson_subtype_t.rst", "bson_t.rst", "bson_type_t.rst", "bson_uint32_to_string.rst", "bson_unichar_t.rst", "bson_utf8_escape_for_json.rst", "bson_utf8_from_unichar.rst", "bson_utf8_get_char.rst", "bson_utf8_next_char.rst", "bson_utf8_validate.rst", "bson_validate.rst", "bson_validate_with_error.rst", "bson_value_copy.rst", "bson_value_destroy.rst", "bson_value_t.rst", "bson_visitor_t.rst", "bson_vsnprintf.rst", "bson_writer_begin.rst", "bson_writer_destroy.rst", "bson_writer_end.rst", "bson_writer_get_length.rst", "bson_writer_new.rst", "bson_writer_rollback.rst", "bson_writer_t.rst", "bson_zero_free.rst", "character_and_string_routines.rst", "creating.rst", "cross-platform-notes.rst", "endianness.rst", "errors.rst", "full_index.rst", "guides.rst", "include-and-link.rst", "index.rst", "json.rst", "oid.rst", "parsing.rst", "streaming-bson.rst", "threading.rst", "tutorial.rst", "utf8.rst", "version.rst"], "titles": ["API Reference", "bson_aligned_alloc()", "bson_aligned_alloc0()", "bson_append_array()", "bson_append_array_begin()", "bson_append_array_end()", "bson_append_binary()", "bson_append_bool()", "bson_append_code()", "bson_append_code_with_scope()", "bson_append_date_time()", "bson_append_dbpointer()", "bson_append_decimal128()", "bson_append_document()", "bson_append_document_begin()", "bson_append_document_end()", "bson_append_double()", "bson_append_int32()", "bson_append_int64()", "bson_append_iter()", "bson_append_maxkey()", "bson_append_minkey()", "bson_append_now_utc()", "bson_append_null()", "bson_append_oid()", "bson_append_regex()", "bson_append_regex_w_len()", "bson_append_symbol()", "bson_append_time_t()", "bson_append_timestamp()", "bson_append_timeval()", "bson_append_undefined()", "bson_append_utf8()", "bson_append_value()", "bson_array_as_canonical_extended_json()", "bson_array_as_json()", "bson_array_as_relaxed_extended_json()", "bson_as_canonical_extended_json()", "bson_as_json()", "bson_as_json_with_opts()", "bson_as_relaxed_extended_json()", "bson_ascii_strtoll()", "bson_check_version()", "bson_compare()", "bson_concat()", "bson_context_destroy()", "bson_context_get_default()", "bson_context_new()", "bson_context_t", "bson_copy()", "bson_copy_to()", "bson_copy_to_excluding()", "bson_copy_to_excluding_noinit()", "bson_copy_to_excluding_noinit_va()", "bson_count_keys()", "bson_decimal128_from_string()", "bson_decimal128_from_string_w_len()", "bson_decimal128_t", "bson_decimal128_to_string()", "bson_destroy()", "bson_destroy_with_steal()", "bson_equal()", "bson_error_t", "bson_free()", "bson_get_data()", "bson_get_major_version()", "bson_get_micro_version()", "bson_get_minor_version()", "System Clock", "bson_get_version()", "bson_has_field()", "bson_init()", "bson_init_from_json()", "bson_init_static()", "bson_isspace()", "bson_iter_array()", "bson_iter_as_bool()", "bson_iter_as_double()", "bson_iter_as_int64()", "bson_iter_binary()", "bson_iter_bool()", "bson_iter_code()", "bson_iter_codewscope()", "bson_iter_date_time()", "bson_iter_dbpointer()", "bson_iter_decimal128()", "bson_iter_document()", "bson_iter_double()", "bson_iter_dup_utf8()", "bson_iter_find()", "bson_iter_find_case()", "bson_iter_find_descendant()", "bson_iter_find_w_len()", "bson_iter_init()", "bson_iter_init_find()", "bson_iter_init_find_case()", "bson_iter_init_find_w_len()", "bson_iter_init_from_data()", "bson_iter_init_from_data_at_offset()", "bson_iter_int32()", "bson_iter_int64()", "bson_iter_key()", "bson_iter_key_len()", "bson_iter_next()", "bson_iter_offset()", "bson_iter_oid()", "bson_iter_overwrite_bool()", "bson_iter_overwrite_date_time()", "bson_iter_overwrite_decimal128()", "bson_iter_overwrite_double()", "bson_iter_overwrite_int32()", "bson_iter_overwrite_int64()", "bson_iter_overwrite_oid()", "bson_iter_overwrite_timestamp()", "bson_iter_recurse()", "bson_iter_regex()", "bson_iter_symbol()", "bson_iter_t", "bson_iter_time_t()", "bson_iter_timestamp()", "bson_iter_timeval()", "bson_iter_type()", "bson_iter_utf8()", "bson_iter_value()", "bson_iter_visit_all()", "bson_json_data_reader_ingest()", "bson_json_data_reader_new()", "bson_json_mode_t", "bson_json_opts_destroy()", "bson_json_opts_new()", "bson_json_opts_set_outermost_array()", "bson_json_opts_t", "bson_json_reader_destroy()", "bson_json_reader_new()", "bson_json_reader_new_from_fd()", "bson_json_reader_new_from_file()", "bson_json_reader_read()", "bson_json_reader_t", "bson_malloc()", "bson_malloc0()", "bson_mem_restore_vtable()", "bson_mem_set_vtable()", "Memory Management", "bson_new()", "bson_new_from_buffer()", "bson_new_from_data()", "bson_new_from_json()", "bson_oid_compare()", "bson_oid_copy()", "bson_oid_equal()", "bson_oid_get_time_t()", "bson_oid_hash()", "bson_oid_init()", "bson_oid_init_from_data()", "bson_oid_init_from_string()", "bson_oid_init_sequence()", "bson_oid_is_valid()", "bson_oid_t", "bson_oid_to_string()", "bson_reader_destroy()", "bson_reader_destroy_func_t", "bson_reader_new_from_data()", "bson_reader_new_from_fd()", "bson_reader_new_from_file()", "bson_reader_new_from_handle()", "bson_reader_read()", "bson_reader_read_func_t", "bson_reader_reset()", "bson_reader_set_destroy_func()", "bson_reader_set_read_func()", "bson_reader_t", "bson_reader_tell()", "bson_realloc()", "bson_realloc_ctx()", "bson_realloc_func", "bson_reinit()", "bson_reserve_buffer()", "bson_set_error()", "bson_sized_new()", "bson_snprintf()", "bson_steal()", "bson_strcasecmp()", "bson_strdup()", "bson_strdup_printf()", "bson_strdupv_printf()", "bson_strerror_r()", "bson_strfreev()", "bson_string_append()", "bson_string_append_c()", "bson_string_append_printf()", "bson_string_append_unichar()", "bson_string_free()", "bson_string_new()", "bson_string_t", "bson_string_truncate()", "bson_strncpy()", "bson_strndup()", "bson_strnlen()", "bson_subtype_t", "bson_t", "bson_type_t", "bson_uint32_to_string()", "bson_unichar_t", "bson_utf8_escape_for_json()", "bson_utf8_from_unichar()", "bson_utf8_get_char()", "bson_utf8_next_char()", "bson_utf8_validate()", "bson_validate()", "bson_validate_with_error()", "bson_value_copy()", "bson_value_destroy()", "bson_value_t", "bson_visitor_t", "bson_vsnprintf()", "bson_writer_begin()", "bson_writer_destroy()", "bson_writer_end()", "bson_writer_get_length()", "bson_writer_new()", "bson_writer_rollback()", "bson_writer_t", "bson_zero_free()", "Character and String Routines", "Creating a BSON Document", "Cross Platform Notes", "Endianness", "Handling Errors", "Index", "Guides", "Using libbson In Your C Program", "libbson", "JSON", "ObjectIDs", "Parsing and Iterating BSON Documents", "Streaming BSON", "Threading", "Tutorial", "UTF-8", "Libbson Versioning"], "terms": {"bson_t": [0, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 43, 44, 49, 50, 51, 52, 53, 54, 59, 60, 61, 64, 70, 71, 72, 73, 79, 82, 93, 94, 95, 96, 98, 117, 122, 136, 137, 143, 144, 145, 146, 165, 170, 175, 176, 178, 180, 198, 208, 209, 213, 215, 220, 221, 228, 230, 231, 232, 234, 235], "bson_append_arrai": [0, 199, 228], "bson_append_array_begin": [0, 5, 60, 199, 224, 228], "bson_append_array_end": [0, 4, 199, 228], "bson_append_binari": [0, 198, 199, 228], "bson_append_bool": [0, 199, 224, 228], "bson_append_cod": [0, 9, 199, 228], "bson_append_code_with_scop": [0, 199, 228], "bson_append_date_tim": [0, 22, 29, 199, 228], "bson_append_dbpoint": [0, 199, 228], "bson_append_decimal128": [0, 199, 228], "bson_append_docu": [0, 199, 228], "bson_append_document_begin": [0, 15, 60, 199, 224, 228], "bson_append_document_end": [0, 14, 199, 224, 228], "bson_append_doubl": [0, 36, 199, 228], "bson_append_int32": [0, 34, 52, 199, 221, 224, 228, 235], "bson_append_int64": [0, 199, 228], "bson_append_it": [0, 199, 228], "bson_append_maxkei": [0, 199, 228], "bson_append_minkei": [0, 199, 228], "bson_append_now_utc": [0, 199, 228], "bson_append_nul": [0, 27, 32, 199, 228], "bson_append_oid": [0, 199, 228], "bson_append_regex": [0, 199, 228], "bson_append_regex_w_len": [0, 199, 228], "bson_append_symbol": [0, 199, 228], "bson_append_time_t": [0, 199, 228], "bson_append_timestamp": [0, 199, 228], "bson_append_timev": [0, 199, 228], "bson_append_undefin": [0, 199, 228], "bson_append_utf8": [0, 34, 35, 36, 38, 180, 199, 224, 228], "bson_append_valu": [0, 199, 228], "bson_array_as_canonical_extended_json": [0, 35, 36, 37, 38, 39, 40, 199, 228], "bson_array_as_json": [0, 34, 36, 37, 38, 39, 40, 199, 228], "bson_array_as_relaxed_extended_json": [0, 34, 35, 37, 38, 39, 40, 199, 228], "bson_as_canonical_extended_json": [0, 34, 35, 36, 38, 39, 40, 170, 176, 199, 213, 224, 228, 230, 232, 234, 235], "bson_as_json": [0, 34, 35, 36, 37, 39, 40, 52, 199, 228], "bson_as_json_with_opt": [0, 34, 35, 36, 37, 38, 40, 127, 131, 199, 228], "bson_as_relaxed_extended_json": [0, 34, 35, 36, 37, 38, 39, 199, 228, 232], "bson_compar": [0, 199, 228], "bson_concat": [0, 71, 72, 73, 143, 144, 145, 146, 175, 176, 178, 199, 228], "bson_copi": [0, 199, 228], "bson_copy_to": [0, 199, 228], "bson_copy_to_exclud": [0, 52, 199, 228], "bson_copy_to_excluding_noinit": [0, 51, 53, 199, 228], "bson_copy_to_excluding_noinit_va": [0, 199, 228], "bson_count_kei": [0, 199, 228], "bson_destroi": [0, 34, 35, 36, 38, 49, 52, 60, 72, 137, 143, 175, 176, 178, 180, 199, 224, 228, 230, 232, 234], "bson_destroy_with_st": [0, 180, 199, 228], "bson_equ": [0, 199, 228], "bson_get_data": [0, 98, 137, 199, 228, 232], "bson_has_field": [0, 199, 228], "bson_init": [0, 34, 35, 36, 38, 44, 51, 52, 53, 72, 73, 143, 144, 145, 146, 175, 176, 178, 199, 224, 228], "bson_init_from_json": [0, 44, 71, 73, 136, 143, 144, 145, 146, 175, 176, 178, 199, 228, 232], "bson_init_stat": [0, 44, 71, 72, 82, 143, 144, 145, 146, 175, 176, 178, 199, 228, 234], "bson_json_mode_t": [0, 129, 131, 199, 228], "bson_json_opts_t": [0, 39, 128, 129, 130, 199, 228], "bson_new": [0, 44, 71, 72, 73, 144, 145, 146, 175, 176, 178, 199, 228], "bson_new_from_buff": [0, 44, 71, 72, 73, 143, 145, 146, 175, 176, 178, 199, 228], "bson_new_from_data": [0, 44, 71, 72, 73, 143, 144, 146, 175, 176, 178, 199, 228, 234], "bson_new_from_json": [0, 44, 71, 72, 73, 136, 143, 144, 145, 175, 176, 178, 199, 228, 232], "bson_reinit": [0, 44, 71, 72, 73, 137, 143, 144, 145, 146, 176, 178, 199, 228, 232], "bson_reserve_buff": [0, 44, 71, 72, 73, 143, 144, 145, 146, 175, 178, 199, 228], "bson_sized_new": [0, 44, 71, 72, 73, 143, 144, 145, 146, 175, 176, 199, 228], "bson_steal": [0, 60, 199, 228], "bson_valid": [0, 199, 209, 228, 234], "bson_validate_with_error": [0, 199, 208, 228], "bson_context_t": [0, 45, 46, 47, 152, 155, 228, 231], "bson_context_destroi": [0, 47, 48, 228], "bson_context_get_default": [0, 47, 48, 228], "bson_context_new": [0, 45, 48, 228], "bson_decimal128_t": [0, 12, 55, 56, 58, 85, 108, 212, 213, 228, 231], "bson_decimal128_from_str": [0, 57, 228], "bson_decimal128_from_string_w_len": [0, 57, 228], "bson_decimal128_to_str": [0, 57, 228], "bson_error_t": [0, 72, 135, 136, 137, 146, 163, 170, 177, 209, 213, 227, 228, 231, 232, 235], "bson_set_error": [0, 62, 228], "bson_strerror_r": [0, 62, 228], "bson_iter_t": [0, 19, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 118, 119, 120, 121, 122, 123, 124, 200, 213, 228, 231, 234], "bson_iter_arrai": [0, 117, 228], "bson_iter_as_bool": [0, 117, 228], "bson_iter_as_doubl": [0, 117, 228], "bson_iter_as_int64": [0, 117, 228], "bson_iter_binari": [0, 117, 228], "bson_iter_bool": [0, 117, 228], "bson_iter_cod": [0, 82, 117, 228], "bson_iter_codewscop": [0, 117, 228], "bson_iter_date_tim": [0, 117, 119, 228], "bson_iter_dbpoint": [0, 117, 228], "bson_iter_decimal128": [0, 117, 228], "bson_iter_docu": [0, 117, 228], "bson_iter_doubl": [0, 117, 228], "bson_iter_dup_utf8": [0, 117, 228], "bson_iter_find": [0, 93, 94, 97, 117, 228], "bson_iter_find_cas": [0, 89, 92, 93, 95, 97, 117, 228], "bson_iter_find_descend": [0, 117, 228, 234], "bson_iter_find_w_len": [0, 96, 117, 228], "bson_iter_init": [0, 94, 95, 96, 97, 117, 213, 228, 234], "bson_iter_init_find": [0, 93, 95, 96, 97, 117, 200, 228, 234], "bson_iter_init_find_cas": [0, 93, 94, 96, 97, 117, 228], "bson_iter_init_find_w_len": [0, 117, 228], "bson_iter_init_from_data": [0, 93, 94, 95, 96, 117, 228], "bson_iter_init_from_data_at_offset": [0, 104, 117, 228], "bson_iter_int32": [0, 117, 228, 234], "bson_iter_int64": [0, 117, 228], "bson_iter_kei": [0, 19, 102, 117, 228, 234], "bson_iter_key_len": [0, 98, 101, 117, 228], "bson_iter_next": [0, 93, 97, 117, 228, 234], "bson_iter_offset": [0, 98, 117, 228], "bson_iter_oid": [0, 93, 97, 117, 228], "bson_iter_overwrite_bool": [0, 117, 228], "bson_iter_overwrite_date_tim": [0, 117, 228], "bson_iter_overwrite_decimal128": [0, 117, 228], "bson_iter_overwrite_doubl": [0, 117, 228], "bson_iter_overwrite_int32": [0, 117, 228], "bson_iter_overwrite_int64": [0, 117, 228], "bson_iter_overwrite_oid": [0, 117, 228], "bson_iter_overwrite_timestamp": [0, 117, 228], "bson_iter_recurs": [0, 117, 228, 234], "bson_iter_regex": [0, 117, 228], "bson_iter_symbol": [0, 117, 228], "bson_iter_time_t": [0, 117, 228], "bson_iter_timestamp": [0, 117, 228], "bson_iter_timev": [0, 117, 228], "bson_iter_typ": [0, 75, 79, 80, 81, 82, 83, 85, 86, 87, 99, 100, 105, 117, 119, 122, 200, 228], "bson_iter_utf8": [0, 88, 117, 228], "bson_iter_valu": [0, 117, 212, 228], "bson_iter_visit_al": [0, 117, 213, 228], "bson_json_reader_t": [0, 125, 126, 132, 133, 134, 135, 136, 227, 228, 231, 232], "bson_json_data_reader_ingest": [0, 137, 228], "bson_json_data_reader_new": [0, 137, 228], "bson_json_reader_destroi": [0, 126, 133, 134, 137, 228, 232], "bson_json_reader_new": [0, 137, 228], "bson_json_reader_new_from_fd": [0, 137, 228, 232], "bson_json_reader_new_from_fil": [0, 137, 227, 228, 232], "bson_json_reader_read": [0, 72, 137, 146, 228, 232], "bson_oid_t": [0, 11, 24, 48, 84, 93, 97, 105, 112, 147, 148, 149, 150, 151, 152, 153, 154, 155, 158, 212, 213, 228, 231, 233], "bson_oid_compar": [0, 157, 228, 233], "bson_oid_copi": [0, 157, 228], "bson_oid_equ": [0, 157, 228, 233], "bson_oid_get_time_t": [0, 157, 228, 233], "bson_oid_hash": [0, 157, 228, 233], "bson_oid_init": [0, 48, 155, 157, 228, 233], "bson_oid_init_from_data": [0, 157, 228], "bson_oid_init_from_str": [0, 157, 228, 233], "bson_oid_init_sequ": [0, 157, 228], "bson_oid_is_valid": [0, 157, 228], "bson_oid_to_str": [0, 93, 97, 157, 228], "bson_reader_t": [0, 62, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 171, 213, 228, 231, 232, 235], "bson_reader_destroi": [0, 160, 162, 170, 213, 228, 232, 235], "bson_reader_destroy_func_t": [0, 164, 168, 170, 228], "bson_reader_new_from_data": [0, 167, 170, 228, 235], "bson_reader_new_from_fd": [0, 170, 228, 232, 235], "bson_reader_new_from_fil": [0, 62, 170, 213, 228, 232, 235], "bson_reader_new_from_handl": [0, 160, 170, 228], "bson_reader_read": [0, 170, 213, 228, 232, 235], "bson_reader_read_func_t": [0, 164, 169, 170, 228], "bson_reader_reset": [0, 170, 228], "bson_reader_set_destroy_func": [0, 170, 228], "bson_reader_set_read_func": [0, 170, 228], "bson_reader_tel": [0, 170, 228, 235], "charact": [0, 25, 26, 41, 74, 190, 195, 202, 203, 204, 205, 206, 228, 231, 233], "string": [0, 3, 4, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 55, 56, 57, 58, 69, 70, 72, 81, 82, 88, 89, 90, 92, 96, 98, 101, 115, 116, 122, 129, 131, 137, 146, 154, 156, 158, 170, 177, 179, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 201, 203, 205, 206, 207, 209, 214, 224, 228, 231, 232, 234, 238], "routin": [0, 224, 228, 231, 232], "bson_ascii_strtol": [0, 223, 228], "bson_isspac": [0, 223, 228], "bson_snprintf": [0, 214, 223, 228], "bson_strcasecmp": [0, 223, 228], "bson_strdup": [0, 223, 228], "bson_strdup_printf": [0, 184, 223, 228], "bson_strdupv_printf": [0, 223, 228], "bson_strfreev": [0, 223, 228], "bson_strncpi": [0, 223, 228], "bson_strndup": [0, 88, 223, 228], "bson_strnlen": [0, 223, 228], "bson_uint32_to_str": [0, 4, 223, 228], "bson_utf8_escape_for_json": [0, 223, 228], "bson_utf8_from_unichar": [0, 223, 228], "bson_utf8_get_char": [0, 202, 223, 228], "bson_utf8_next_char": [0, 202, 223, 228], "bson_utf8_valid": [0, 122, 223, 228, 238], "bson_vsnprintf": [0, 223, 228], "bson_string_t": [0, 187, 188, 189, 190, 191, 192, 194, 228, 231], "bson_string_append": [0, 189, 192, 193, 228], "bson_string_append_c": [0, 193, 228], "bson_string_append_printf": [0, 193, 228], "bson_string_append_unichar": [0, 193, 228], "bson_string_fre": [0, 192, 193, 228], "bson_string_new": [0, 193, 228], "bson_string_trunc": [0, 193, 228], "bson_subtype_t": [0, 6, 79, 212, 213, 228, 231], "bson_type_t": [0, 121, 212, 228, 231], "bson_unichar_t": [0, 190, 204, 205, 228, 231], "bson_value_t": [0, 33, 123, 210, 211, 228, 231], "bson_value_copi": [0, 212, 228], "bson_value_destroi": [0, 210, 212, 228], "bson_visitor_t": [0, 124, 208, 209, 228, 231, 234], "bson_writer_t": [0, 215, 216, 217, 218, 219, 220, 228, 231, 235], "bson_writer_begin": [0, 60, 221, 228, 235], "bson_writer_destroi": [0, 219, 221, 228], "bson_writer_end": [0, 215, 221, 228, 235], "bson_writer_get_length": [0, 221, 228], "bson_writer_new": [0, 216, 221, 228, 235], "bson_writer_rollback": [0, 215, 218, 221, 228], "system": [0, 11, 32, 135, 166, 226, 228, 231, 236], "clock": [0, 228, 231], "memori": [0, 1, 2, 14, 50, 63, 125, 138, 139, 140, 141, 164, 170, 172, 173, 174, 176, 216, 218, 220, 221, 222, 224, 228, 231, 235], "manag": [0, 199, 220, 224, 228, 231, 235], "bson_fre": [0, 34, 35, 36, 37, 38, 39, 40, 52, 60, 88, 142, 170, 176, 180, 182, 183, 184, 196, 203, 213, 221, 222, 224, 228, 230, 232, 234, 235], "bson_malloc": [0, 142, 180, 228], "bson_malloc0": [0, 142, 228], "bson_aligned_alloc": [0, 142, 228], "bson_aligned_alloc0": [0, 142, 228], "bson_mem_restore_vt": [0, 142, 228], "bson_mem_set_vt": [0, 142, 228], "bson_realloc": [0, 142, 173, 228], "bson_realloc_ctx": [0, 142, 174, 221, 228, 235], "bson_realloc_func": [0, 142, 144, 219, 221, 228], "bson_zero_fre": [0, 142, 228], "libbson": [0, 35, 38, 42, 65, 66, 67, 68, 69, 140, 141, 142, 174, 213, 224, 226, 227, 228, 232, 233, 234, 236, 237, 238], "version": [0, 41, 42, 51, 65, 66, 67, 69, 89, 92, 137, 154, 155, 170, 181, 197, 213, 228, 230, 231, 232], "bson_check_vers": [0, 228, 239], "bson_get_major_vers": [0, 228, 239], "bson_get_micro_vers": [0, 228, 239], "bson_get_minor_vers": [0, 228, 239], "bson_get_vers": [0, 228, 239], "void": [1, 2, 45, 46, 48, 50, 51, 52, 53, 58, 59, 63, 65, 66, 67, 68, 69, 71, 75, 79, 84, 86, 93, 97, 106, 107, 109, 110, 111, 112, 113, 119, 120, 124, 125, 128, 130, 131, 132, 133, 138, 139, 140, 141, 143, 144, 148, 152, 153, 154, 155, 158, 159, 160, 164, 166, 167, 168, 169, 170, 172, 173, 174, 175, 176, 177, 180, 186, 187, 188, 189, 190, 194, 195, 199, 202, 204, 210, 211, 213, 216, 217, 219, 220, 221, 222, 239], "size_t": [1, 2, 34, 35, 36, 37, 38, 39, 40, 73, 97, 98, 125, 126, 133, 138, 139, 141, 144, 145, 156, 161, 166, 170, 172, 173, 174, 176, 178, 179, 185, 195, 196, 197, 201, 207, 208, 213, 214, 218, 219, 221, 222, 232, 234, 235], "align": [1, 2, 141], "num_byt": [1, 2, 138, 139, 141, 172, 173, 174], "The": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 59, 60, 61, 62, 64, 65, 66, 67, 68, 71, 72, 73, 75, 77, 78, 79, 80, 81, 82, 83, 84, 86, 89, 90, 91, 92, 93, 97, 98, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 126, 127, 129, 130, 131, 133, 137, 143, 144, 145, 146, 147, 155, 156, 157, 160, 161, 162, 165, 166, 170, 176, 178, 179, 185, 190, 194, 195, 197, 199, 200, 201, 202, 203, 204, 207, 209, 212, 213, 214, 215, 216, 218, 219, 221, 222, 226, 230, 232, 233, 234, 235, 239], "alloc": [1, 2, 34, 35, 36, 37, 38, 39, 40, 45, 47, 49, 59, 62, 88, 117, 126, 129, 133, 134, 135, 138, 139, 140, 141, 142, 143, 144, 145, 146, 161, 162, 163, 164, 172, 173, 174, 176, 178, 182, 183, 184, 192, 193, 196, 199, 203, 216, 219, 221], "byte": [1, 2, 3, 6, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 55, 56, 72, 73, 86, 97, 98, 122, 138, 139, 144, 145, 146, 149, 153, 154, 155, 157, 166, 172, 176, 179, 190, 194, 195, 197, 199, 201, 202, 203, 204, 205, 206, 207, 208, 209, 214, 224, 233, 234, 238], "must": [1, 2, 4, 6, 8, 14, 24, 32, 41, 50, 69, 72, 73, 75, 86, 93, 97, 98, 117, 140, 141, 161, 162, 176, 180, 194, 195, 210, 215, 233, 234, 238], "power": [1, 2, 192, 193], "2": [1, 2, 3, 32, 48, 52, 69, 137, 166, 170, 183, 189, 209, 213, 232], "multipl": [1, 2, 25, 26, 206], "sizeof": [1, 2, 138, 139, 157, 172, 180, 201], "number": [1, 2, 32, 41, 54, 65, 66, 67, 83, 118, 120, 138, 155, 166, 179, 195, 201, 202, 204, 214, 223, 224, 233], "thi": [1, 2, 4, 5, 9, 15, 20, 21, 22, 27, 29, 31, 32, 33, 35, 38, 42, 43, 45, 46, 47, 48, 51, 52, 53, 59, 60, 63, 64, 70, 71, 75, 79, 80, 81, 85, 86, 88, 94, 95, 96, 98, 99, 100, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 119, 122, 123, 129, 131, 137, 138, 139, 140, 141, 142, 145, 155, 160, 164, 166, 168, 170, 172, 173, 174, 176, 177, 178, 179, 180, 183, 184, 185, 186, 187, 193, 194, 195, 198, 199, 201, 202, 206, 210, 213, 216, 218, 220, 221, 222, 224, 226, 232, 233, 234, 235, 239], "i": [1, 2, 3, 5, 6, 9, 10, 11, 15, 19, 20, 21, 22, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 51, 52, 56, 57, 59, 60, 62, 71, 72, 74, 75, 79, 80, 81, 84, 85, 86, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 102, 103, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 119, 122, 123, 126, 128, 129, 131, 132, 133, 134, 135, 137, 138, 139, 141, 142, 143, 144, 145, 146, 155, 156, 157, 159, 160, 161, 162, 163, 165, 166, 168, 170, 172, 173, 174, 175, 176, 177, 178, 179, 180, 182, 184, 185, 187, 191, 193, 194, 195, 196, 199, 200, 201, 202, 203, 204, 206, 207, 208, 209, 211, 212, 213, 216, 218, 219, 220, 221, 222, 224, 226, 227, 230, 232, 233, 234, 235, 236, 238], "portabl": [1, 2, 41, 138, 139, 142, 172, 179, 181, 185, 197], "aligned_alloc": [1, 2, 141], "wrapper": [1, 2, 138, 139, 172, 179, 180, 185], "In": [1, 2, 138, 139, 172, 224, 228, 231, 232, 237], "gener": [1, 2, 4, 47, 48, 52, 138, 139, 145, 150, 151, 152, 155, 172, 199, 201, 227, 234, 236], "function": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 38, 43, 44, 45, 46, 49, 50, 51, 52, 53, 54, 59, 60, 61, 63, 64, 71, 72, 73, 74, 75, 78, 79, 80, 81, 82, 83, 85, 86, 88, 89, 91, 92, 93, 94, 95, 96, 97, 99, 100, 103, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 118, 119, 120, 121, 122, 124, 129, 130, 138, 139, 140, 141, 143, 144, 145, 146, 147, 155, 160, 161, 162, 164, 165, 166, 169, 172, 173, 174, 176, 177, 178, 180, 183, 184, 192, 201, 206, 210, 219, 222, 224, 227, 230, 232, 233, 234, 235, 238], "an": [1, 2, 3, 4, 5, 6, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 50, 57, 59, 62, 70, 72, 75, 80, 82, 86, 88, 90, 92, 93, 96, 97, 98, 102, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 117, 119, 122, 129, 133, 134, 136, 137, 138, 139, 144, 146, 152, 155, 157, 160, 165, 170, 172, 176, 180, 185, 188, 193, 199, 200, 202, 213, 221, 224, 227, 232, 233, 234], "least": [1, 2, 138, 139, 172, 176, 195], "bigger": [1, 2, 138, 139, 172], "If": [1, 2, 9, 19, 34, 35, 36, 37, 38, 39, 40, 41, 43, 60, 89, 91, 92, 114, 116, 123, 138, 139, 144, 162, 165, 172, 174, 175, 182, 195, 201, 203, 207, 213, 230, 233, 234, 238], "wa": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 41, 55, 56, 65, 66, 67, 70, 72, 73, 85, 89, 90, 91, 92, 93, 97, 98, 103, 114, 124, 136, 138, 139, 157, 165, 172, 180, 197, 208, 215, 224, 233, 234], "failur": [1, 2, 34, 35, 36, 37, 38, 39, 40, 114, 138, 139, 140, 141, 165, 166, 171, 172, 227], "process": [1, 2, 39, 46, 47, 137, 138, 139, 140, 141, 170, 172, 232], "abort": [1, 2, 137, 138, 139, 142, 172, 213, 218, 220, 232], "A": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 43, 44, 45, 47, 49, 50, 51, 52, 53, 54, 55, 56, 58, 59, 60, 61, 63, 64, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 118, 119, 120, 121, 122, 123, 124, 125, 126, 128, 129, 130, 132, 133, 134, 135, 136, 138, 139, 141, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 161, 162, 163, 164, 165, 166, 167, 168, 169, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 194, 195, 196, 197, 199, 201, 203, 204, 205, 206, 207, 208, 209, 210, 211, 214, 215, 216, 217, 218, 219, 220, 222, 224, 231, 233], "pointer": [1, 2, 24, 72, 73, 79, 82, 98, 133, 138, 139, 144, 164, 172, 173, 174, 176, 201, 206], "region": [1, 2, 63, 138, 139, 170, 172, 173, 174, 220, 221, 222, 224, 235], "which": [1, 2, 32, 35, 38, 41, 64, 81, 82, 97, 101, 115, 138, 139, 170, 172, 176, 192, 195, 199, 206, 209, 232, 235], "ha": [1, 2, 47, 57, 73, 103, 122, 129, 131, 138, 139, 142, 172, 199, 201, 220, 238], "NOT": [1, 138, 172, 216, 236], "been": [1, 2, 122, 138, 139, 142, 172, 199], "zero": [1, 2, 41, 43, 54, 60, 76, 138, 139, 166, 172, 195, 209, 222], "also": [2, 47, 70, 82, 139, 179, 203, 230, 231, 232, 233, 235], "set": [2, 34, 35, 36, 37, 38, 39, 40, 41, 55, 56, 60, 72, 115, 116, 124, 130, 135, 139, 141, 142, 144, 146, 163, 165, 168, 169, 176, 177, 195, 196, 199, 201, 208, 209, 213, 224, 230], "defin": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 23, 24, 25, 27, 28, 29, 30, 31, 32, 33, 57, 75, 79, 80, 81, 82, 83, 85, 86, 87, 99, 100, 105, 117, 119, 122, 129, 131, 133, 137, 157, 199, 239], "b": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 23, 24, 25, 27, 28, 29, 30, 31, 32, 33, 52, 70, 71, 73, 91, 117, 137, 170, 175, 180, 199, 224, 230, 232, 234], "kei": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 51, 52, 70, 89, 90, 91, 92, 94, 95, 96, 98, 101, 102, 117, 180, 208, 209, 213, 224, 233, 234], "val": [3, 6, 7, 8, 9, 10, 12, 13, 16, 17, 18, 24, 25, 27, 28, 29, 30, 32, 33, 199], "int": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 38, 41, 42, 43, 48, 52, 56, 57, 65, 66, 67, 68, 74, 92, 96, 117, 134, 136, 137, 147, 157, 162, 170, 176, 179, 180, 181, 185, 199, 213, 214, 221, 224, 230, 232, 235], "strlen": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 72, 102, 146, 199, 224], "bool": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 42, 44, 55, 56, 60, 61, 70, 72, 73, 74, 76, 80, 85, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 103, 106, 108, 114, 124, 126, 130, 133, 134, 149, 156, 162, 165, 170, 176, 180, 191, 207, 208, 209, 212, 213, 215, 224, 235], "bson": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 43, 48, 49, 52, 54, 57, 59, 60, 61, 62, 64, 68, 70, 72, 82, 84, 93, 94, 95, 96, 97, 103, 104, 106, 107, 108, 109, 110, 111, 112, 113, 116, 117, 121, 124, 126, 127, 129, 131, 134, 136, 137, 142, 144, 145, 156, 157, 170, 176, 180, 193, 198, 199, 200, 201, 208, 209, 212, 213, 215, 221, 226, 228, 229, 231, 237], "const": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 43, 44, 49, 50, 51, 52, 53, 54, 55, 56, 58, 61, 64, 69, 70, 72, 73, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 104, 105, 108, 112, 114, 115, 116, 118, 119, 120, 121, 122, 123, 124, 125, 135, 137, 141, 145, 146, 147, 148, 149, 150, 151, 153, 154, 156, 158, 161, 163, 165, 170, 177, 179, 181, 182, 183, 184, 187, 189, 192, 195, 196, 197, 201, 202, 203, 205, 206, 207, 208, 209, 210, 212, 213, 214, 230, 232, 235], "char": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 48, 51, 52, 53, 55, 56, 57, 58, 62, 69, 70, 72, 81, 82, 84, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 101, 115, 116, 122, 135, 137, 154, 156, 157, 158, 163, 170, 176, 177, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 191, 192, 193, 195, 196, 197, 201, 202, 203, 204, 205, 206, 207, 212, 213, 214, 221, 224, 230, 232, 234, 235], "key_length": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33], "arrai": [3, 4, 5, 11, 34, 35, 36, 75, 114, 186, 234], "ascii": [3, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 55, 56, 90, 187, 188, 203], "c": [3, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 52, 70, 74, 91, 117, 188, 202, 213, 228, 231, 233, 237], "contain": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 55, 56, 57, 60, 70, 72, 82, 83, 89, 90, 92, 97, 106, 115, 117, 118, 120, 125, 127, 131, 133, 137, 138, 142, 144, 146, 149, 150, 153, 154, 155, 156, 157, 170, 172, 173, 174, 175, 198, 199, 200, 201, 202, 207, 209, 212, 213, 232, 233, 238], "name": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 51, 52, 53, 57, 70, 84, 89, 90, 92, 117, 135, 227, 233, 234], "field": [3, 4, 5, 7, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 51, 52, 53, 70, 76, 77, 79, 81, 84, 85, 87, 90, 98, 99, 100, 117, 122, 124, 141, 198, 199, 200, 213, 224], "length": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 56, 58, 60, 72, 73, 75, 79, 81, 82, 84, 86, 88, 92, 96, 97, 98, 101, 102, 116, 122, 125, 129, 131, 144, 145, 146, 156, 161, 170, 176, 194, 197, 199, 203, 207, 209, 218, 219, 224, 233, 234, 238], "1": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 38, 41, 48, 51, 52, 55, 56, 69, 72, 74, 136, 137, 146, 155, 166, 170, 171, 176, 183, 184, 199, 201, 203, 209, 213, 224, 227, 230, 232, 233, 234, 235, 238, 239], "determin": [3, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 72, 74, 76, 90, 130, 146, 200, 212, 224, 227], "shall": [3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15, 16, 17, 18, 20, 21, 23, 24, 29, 31, 32, 35, 38, 43, 44, 45, 46, 49, 50, 51, 52, 53, 54, 59, 60, 61, 63, 64, 71, 73, 75, 78, 79, 80, 83, 86, 89, 91, 92, 93, 97, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 118, 119, 120, 121, 122, 129, 130, 140, 141, 143, 145, 147, 161, 162, 165, 178], "append": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 44, 187, 188, 189, 190, 192, 199, 220, 224], "us": [3, 6, 7, 8, 11, 13, 14, 19, 20, 21, 27, 29, 31, 32, 33, 35, 38, 39, 41, 43, 45, 47, 48, 51, 60, 62, 63, 64, 73, 82, 84, 90, 98, 103, 104, 114, 117, 119, 122, 124, 129, 130, 131, 135, 137, 140, 141, 143, 144, 152, 153, 155, 157, 160, 161, 163, 164, 168, 170, 173, 174, 175, 176, 178, 180, 192, 193, 198, 199, 200, 201, 202, 204, 208, 209, 210, 213, 215, 218, 219, 220, 221, 222, 224, 226, 228, 231, 232, 233, 235, 236, 237, 238, 239], "specifi": [3, 10, 13, 48, 51, 52, 53, 59, 107, 224, 230, 234], "type": [3, 9, 11, 13, 16, 20, 21, 23, 24, 25, 26, 27, 29, 31, 33, 57, 75, 76, 77, 79, 81, 84, 85, 86, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 119, 121, 123, 157, 200, 212, 213, 224, 227, 230, 232], "respons": [3, 34, 35, 36, 37, 38, 39, 40, 216, 236], "caller": [3, 4, 34, 35, 36, 37, 38, 39, 40, 62, 93, 97, 122, 215, 216, 219, 234], "ensur": 3, "ar": [3, 29, 43, 45, 47, 48, 59, 61, 72, 73, 135, 136, 137, 146, 149, 163, 165, 170, 176, 181, 193, 199, 203, 207, 209, 222, 223, 224, 226, 230, 232, 234, 236, 238, 239], "properli": [3, 226], "format": [3, 10, 34, 35, 36, 37, 38, 39, 40, 55, 56, 69, 72, 137, 155, 177, 179, 183, 184, 189, 201, 213, 214, 224, 226, 231, 232, 233, 238], "0": [3, 6, 32, 34, 35, 36, 38, 41, 43, 48, 51, 57, 72, 77, 117, 122, 136, 137, 146, 147, 155, 157, 166, 170, 172, 176, 179, 181, 184, 193, 194, 195, 196, 197, 201, 206, 207, 209, 213, 214, 221, 230, 232, 233, 234, 235, 238, 239], "so": [3, 4, 43, 140, 141, 142, 194, 230, 234, 235], "forth": 3, "true": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 42, 44, 55, 56, 61, 70, 72, 73, 76, 80, 85, 89, 90, 91, 92, 93, 97, 98, 103, 114, 124, 149, 156, 162, 165, 176, 180, 193, 207, 208, 209, 213, 215, 224, 238], "oper": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 44, 47, 137, 166, 176, 236], "appli": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33], "successfulli": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 73, 93, 97, 98, 180], "fail": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 73, 137, 165, 170, 209, 232, 234, 235, 238], "grow": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 176, 235], "larger": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33], "than": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 42, 43, 80, 102, 122, 147, 166, 195, 233], "int32_max": [3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 176], "child": [4, 5, 13, 14, 15, 114, 199, 213, 224, 234], "call": [4, 5, 14, 15, 22, 34, 35, 36, 37, 38, 39, 40, 45, 47, 51, 52, 53, 59, 60, 79, 80, 81, 85, 88, 93, 97, 99, 100, 102, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 119, 122, 134, 140, 141, 144, 160, 162, 166, 175, 176, 180, 193, 199, 206, 213, 215, 224], "begin": [4, 14, 141, 167, 206, 215, 234], "allow": [4, 9, 32, 48, 106, 107, 108, 109, 110, 111, 112, 113, 123, 142, 164, 168, 199, 207, 209, 214, 224, 232, 238], "increment": [4, 29, 68, 113, 119, 212, 233], "build": [4, 193, 221, 224, 231, 235], "sub": [4, 13, 14, 75, 86, 117], "do": [4, 32, 33, 140, 141, 142, 165, 174, 177, 193, 234, 235], "yield": 4, "better": 4, "perform": [4, 9, 137, 183, 193, 224, 234, 239], "you": [4, 33, 45, 59, 63, 64, 69, 79, 80, 85, 99, 100, 105, 119, 122, 137, 157, 170, 174, 176, 178, 180, 193, 208, 209, 218, 220, 221, 222, 224, 230, 232, 233, 234, 235, 236, 238, 239], "serial": [4, 144, 221, 235], "singl": [4, 72, 146, 199, 202, 204, 221, 233], "buffer": [4, 6, 60, 64, 73, 75, 79, 82, 86, 97, 98, 126, 133, 144, 145, 153, 161, 165, 166, 167, 175, 176, 178, 179, 192, 195, 199, 201, 215, 216, 217, 218, 219, 221, 224, 234, 235], "when": [4, 11, 14, 20, 21, 45, 59, 60, 65, 66, 67, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 122, 134, 143, 145, 160, 162, 168, 173, 176, 192, 199, 202, 210, 213, 215, 219, 221, 224, 226, 234], "done": [4, 59, 106, 107, 108, 109, 110, 111, 112, 113, 122], "For": [4, 89, 92, 141, 180, 199, 220, 221, 238], "element": [4, 6, 7, 8, 9, 10, 12, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 29, 31, 34, 35, 36, 54, 70, 75, 78, 79, 80, 82, 83, 84, 86, 89, 90, 92, 93, 97, 99, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 124, 234], "see": [4, 55, 56, 62, 70, 89, 92, 124, 137, 170, 198, 199, 208, 218, 232, 234, 235, 238], "initi": [5, 14, 15, 50, 55, 56, 60, 71, 72, 73, 91, 93, 94, 95, 96, 97, 98, 114, 144, 146, 153, 154, 175, 176, 180, 213, 218, 224, 235], "complet": [5, 14, 15, 215, 217], "start": [5, 34, 35, 36, 41, 51, 52, 98, 157, 209, 224], "invalid": [5, 15, 19, 41, 44, 72, 73, 81, 89, 91, 92, 103, 114, 115, 119, 122, 123, 176, 180, 206, 209, 227, 238], "after": [5, 15, 94, 95, 96, 103, 170, 175, 176, 180, 181, 193, 195, 213, 216, 232, 235], "success": [5, 15, 19, 34, 35, 36, 37, 38, 39, 40, 44, 72, 135, 136, 144, 145, 146, 163, 164], "subtyp": [6, 79, 198, 199, 212], "len": [6, 56, 64, 72, 98, 125, 137, 146, 193, 194, 199, 204, 212, 232], "uint8_t": [6, 60, 64, 73, 75, 79, 82, 86, 97, 98, 125, 144, 145, 146, 153, 157, 161, 170, 176, 199, 212, 213, 219, 221, 235], "binari": [6, 79, 198], "uint32_t": [6, 29, 54, 60, 62, 75, 79, 81, 82, 84, 86, 88, 98, 102, 104, 113, 116, 119, 122, 151, 176, 177, 193, 194, 199, 201, 202, 204, 212, 213], "indic": [6, 60, 74, 92, 96, 191, 199, 207, 209, 224, 238], "emb": 6, "data": [6, 57, 72, 73, 79, 97, 98, 104, 124, 125, 133, 136, 144, 145, 146, 153, 161, 164, 166, 169, 170, 180, 198, 199, 201, 212, 213, 222, 231, 234, 236], "mai": [6, 10, 47, 72, 106, 107, 108, 109, 110, 111, 112, 113, 117, 137, 142, 145, 146, 170, 175, 198, 199, 206, 213, 215, 221, 232, 233, 234, 238, 239], "null": [6, 8, 9, 19, 27, 32, 34, 35, 36, 37, 38, 39, 40, 41, 45, 48, 51, 52, 56, 59, 60, 79, 81, 115, 116, 128, 132, 135, 144, 145, 146, 152, 157, 159, 163, 164, 165, 170, 173, 174, 176, 177, 180, 182, 186, 187, 191, 192, 193, 195, 199, 203, 207, 209, 211, 213, 216, 221, 224, 227, 230, 232, 233, 234, 235, 238], "empti": [6, 144, 199, 224], "valu": [6, 7, 10, 12, 13, 16, 17, 18, 19, 20, 21, 22, 23, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 41, 57, 65, 66, 67, 76, 77, 80, 85, 98, 99, 100, 106, 107, 108, 109, 110, 111, 112, 123, 130, 147, 157, 166, 180, 199, 201, 202, 208, 209, 211, 212, 224, 232], "new": [6, 7, 8, 10, 12, 16, 17, 18, 23, 24, 25, 26, 27, 29, 31, 33, 47, 49, 51, 52, 72, 84, 106, 108, 109, 126, 129, 133, 134, 135, 141, 142, 143, 144, 145, 146, 152, 155, 161, 162, 163, 172, 176, 178, 182, 192, 194, 196, 199, 203, 215, 219, 224, 232, 234], "provid": [6, 7, 8, 9, 55, 56, 68, 73, 82, 115, 124, 130, 137, 144, 153, 160, 162, 164, 170, 202, 213, 221, 223, 224, 231, 232, 233, 234, 235, 236, 238], "fals": [7, 19, 44, 55, 56, 60, 70, 72, 73, 74, 80, 85, 89, 91, 92, 103, 114, 124, 137, 149, 165, 170, 176, 180, 191, 193, 208, 209, 213, 232, 238], "boolean": [7, 74, 76, 80, 130], "javascript": [8, 9, 31, 82], "utf": [8, 9, 32, 34, 35, 36, 37, 38, 39, 40, 72, 81, 82, 88, 122, 146, 187, 190, 193, 202, 203, 204, 205, 206, 207, 209, 223, 224, 228, 231, 234, 237], "8": [8, 9, 32, 34, 35, 36, 37, 38, 39, 40, 41, 72, 81, 82, 88, 122, 146, 155, 187, 190, 193, 202, 203, 204, 205, 206, 207, 209, 223, 224, 228, 231, 234, 237, 239], "encod": [8, 9, 32, 34, 35, 36, 37, 38, 39, 40, 55, 56, 72, 81, 82, 88, 122, 127, 129, 131, 135, 145, 146, 154, 156, 157, 158, 163, 187, 190, 193, 199, 203, 205, 206, 224, 226, 234], "termin": [8, 9, 32, 41, 51, 52, 56, 186, 195, 203, 238], "scope": [9, 82, 199], "fragment": 9, "option": [9, 19, 25, 26, 34, 35, 36, 37, 38, 39, 40, 72, 82, 88, 115, 122, 124, 131, 144, 146, 152, 155, 160, 191, 209, 212, 213], "like": [9, 69, 91, 166, 184, 189, 193, 199, 201, 213, 214, 222, 234, 236], "except": [9, 34, 35, 36, 51, 52, 53, 74, 82, 88, 137, 170, 173, 184, 203, 222, 232], "form": 9, "document": [9, 10, 11, 13, 14, 15, 16, 19, 20, 21, 33, 34, 35, 36, 39, 43, 44, 49, 60, 61, 64, 82, 86, 93, 97, 103, 106, 107, 108, 109, 110, 111, 112, 113, 114, 117, 121, 124, 126, 129, 131, 136, 137, 144, 145, 165, 170, 176, 178, 199, 208, 209, 213, 215, 218, 221, 227, 228, 231, 232, 237], "code": [9, 27, 31, 51, 52, 62, 82, 84, 151, 155, 177, 209, 212, 213, 227], "otherwis": [9, 55, 56, 59, 70, 72, 73, 85, 114, 135, 145, 146, 149, 163, 164, 171, 191, 208, 209], "int64_t": [10, 18, 41, 68, 78, 83, 100, 107, 111, 212, 213], "date": [10, 22, 107, 119], "time": [10, 22, 98, 101, 102, 104, 107, 117, 119, 150, 155, 157, 224, 232, 236], "millisecond": [10, 28, 30, 83, 107], "sinc": [10, 28, 30, 51, 83, 107, 118, 120, 150, 155, 157], "unix": [10, 28, 30, 83, 107, 118, 120, 150, 157, 166, 233, 236], "epoch": [10, 28, 30, 83, 107, 118, 120, 150, 157], "timezon": 10, "inform": [10, 62, 124, 198, 213, 232, 234, 235, 238], "assum": 10, "utc": [10, 22], "neg": [10, 181], "coll": [11, 199], "oid": [11, 24, 48, 84, 93, 97, 112, 150, 151, 152, 153, 154, 155, 157, 158, 199, 212, 233], "collect": [11, 84, 212], "target": [11, 57, 230], "identifi": [11, 233], "dbpointer": 11, "deprec": [11, 27, 31, 47, 51, 84, 116, 155, 213], "should": [11, 25, 26, 27, 31, 45, 47, 49, 51, 52, 59, 60, 62, 63, 64, 72, 81, 82, 84, 85, 88, 89, 91, 92, 98, 99, 100, 101, 105, 114, 115, 117, 123, 126, 133, 134, 143, 155, 162, 165, 168, 178, 182, 183, 184, 191, 192, 196, 199, 202, 203, 224, 238], "onli": [11, 29, 48, 68, 72, 73, 79, 106, 107, 108, 109, 110, 111, 112, 113, 114, 146, 155, 167, 168, 234, 239], "interact": 11, "legaci": [11, 27, 32, 35, 38], "decim": 12, "128": [12, 199], "uniniti": [14, 50, 72, 176, 180], "add": [14, 224], "avoid": [14, 50, 73, 234], "leak": [14, 50], "doubl": [16, 77, 87, 109, 212, 213], "int32_t": [17, 99, 110, 129, 131, 212, 213], "32": [17, 99, 151, 202, 205], "bit": [17, 18, 41, 57, 78, 83, 99, 100, 151, 155, 202, 205, 233], "sign": [17, 18, 41, 78], "integ": [17, 18, 34, 35, 36, 41, 54, 78, 83, 92, 96, 99, 100, 102, 104, 181], "64": [18, 41, 78, 83, 100, 155], "iter": [19, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 200, 202, 212, 213, 228, 231, 235, 237], "locat": [19, 34, 35, 36, 37, 38, 39, 40, 58, 60, 72, 75, 79, 81, 82, 84, 85, 86, 88, 90, 94, 95, 96, 122, 124, 146, 158, 185, 201, 204, 208, 213, 214, 234], "posit": [19, 54, 171, 181], "current": [19, 22, 76, 77, 78, 90, 98, 101, 102, 104, 114, 115, 122, 123, 155, 171, 194, 205, 206, 218, 220], "would": [19, 44, 193, 224], "overflow": [19, 44], "maximum": [19, 44, 129, 131, 197, 199, 213], "size": [19, 44, 57, 117, 126, 133, 144, 172, 173, 174, 176, 178, 179, 185, 195, 197, 199, 201, 214, 222], "anoth": [19, 44, 60, 157, 180], "state": [19, 44, 213, 224], "detect": [19, 44, 165, 208, 220], "bson_type_maxkei": [20, 121, 200], "primarili": [20, 21, 29], "queri": [20, 21], "unlik": [20, 21], "store": [20, 21, 60, 81, 82, 185, 199, 204, 222, 233], "mongodb": [20, 21, 29, 34, 35, 36, 37, 38, 39, 40, 72, 91, 127, 131, 137, 170, 199, 220, 227, 231, 232, 233, 234], "bson_type_minkei": [21, 121, 200], "helper": [22, 28, 30, 177, 238], "get": [22, 65, 66, 67, 176], "bson_type_date_tim": [22, 83, 107, 118, 120, 121, 200], "intern": [22, 43, 73, 133, 176, 185, 199, 227], "bson_type_nul": [23, 76, 121, 200], "bson_type_oid": [24, 105, 112, 121, 200], "opt": [25, 39, 128, 130, 131, 199], "regex": [25, 26, 115, 212], "bson_type_regex": [25, 26, 115, 121, 200], "valid": [25, 26, 32, 41, 55, 56, 72, 73, 79, 98, 117, 122, 146, 156, 161, 162, 167, 207, 208, 209, 227], "includ": [25, 26, 29, 34, 35, 36, 38, 48, 52, 57, 62, 78, 117, 127, 131, 137, 157, 170, 176, 186, 193, 198, 199, 200, 212, 213, 218, 221, 224, 232, 235], "case": [25, 26, 47, 89, 90, 92, 177, 181, 213], "insensit": [25, 26], "m": [25, 26], "match": [25, 26, 90, 195, 203, 234], "x": [25, 26], "verbos": [25, 26], "mode": [25, 26, 127, 129, 131, 162], "l": [25, 26], "make": [25, 26, 142, 223, 224, 234], "w": [25, 26], "local": [25, 26, 48, 90], "depend": [25, 26, 57, 233], "": [25, 26, 34, 35, 36, 37, 38, 39, 40, 41, 42, 52, 57, 62, 65, 66, 67, 69, 79, 93, 97, 98, 117, 137, 157, 170, 176, 193, 197, 201, 213, 224, 230, 232, 234, 235, 236], "dotal": [25, 26], "everyth": [25, 26], "u": [25, 26, 142, 157, 202, 233, 234, 235], "unicod": [25, 26, 190, 202, 204], "regex_length": 26, "symbol": [27, 34, 35, 36, 37, 38, 39, 40, 116, 212], "bson_type_symbol": [27, 116, 121, 200], "due": [27, 32, 124], "behavior": [27, 32, 48, 195, 199], "pass": [27, 32, 39, 41, 62, 98, 103, 123, 144, 160, 185, 218, 224, 238], "To": [27, 32, 129, 131, 142, 165, 175, 224, 232, 233, 234, 238], "directli": [27, 32, 176, 221], "prefer": [27, 32, 52, 224, 232], "time_t": [28, 118, 150, 233], "take": [28, 30, 53, 122, 173, 176, 184, 193, 224], "instead": [28, 30, 60, 141, 213, 226, 230], "inc": [29, 137, 170, 199, 232], "timestamp": [29, 113, 119, 212, 233], "similar": [29, 82, 88, 139, 166, 232], "differ": [29, 68, 224], "thei": [29, 149, 181, 226], "second": [29, 118, 120, 150, 157, 224, 234], "precis": 29, "intra": [29, 119], "server": [29, 119, 199], "commun": [29, 32, 119], "bson_type_timestamp": [29, 113, 119, 121, 200], "struct": [30, 48, 57, 62, 68, 98, 117, 120, 131, 137, 141, 157, 170, 180, 193, 199, 212, 213, 221], "timev": [30, 68, 120], "bson_type_undefin": [31, 76, 121, 200], "undefin": [31, 199, 213], "common": [31, 232], "howev": [31, 117, 142, 155], "exclud": [32, 51, 52, 53, 72, 146, 194, 214], "trail": [32, 72, 146, 179, 194, 195, 196, 234], "some": [32, 193, 227], "implement": [32, 68, 142, 168, 174, 226, 236], "within": [32, 54, 68, 70, 155, 171, 199, 206, 207, 208, 234, 238], "rememb": 32, "could": [32, 98, 156, 176, 213, 224, 227, 235], "caus": 32, "issu": 32, "extern": [32, 117], "support": [32, 78, 226, 232, 235], "It": [32, 60, 62, 68, 74, 79, 80, 81, 82, 103, 106, 107, 108, 109, 110, 111, 112, 113, 115, 117, 119, 122, 143, 155, 177, 179, 200, 201, 202, 206, 231, 232, 233], "suggest": [32, 122], "modifi": [32, 64, 69, 79, 81, 82, 101, 105, 115, 117, 122, 123, 165, 208, 209], "represent": [32, 69, 122, 190, 202, 205, 232], "embed": [32, 114, 187, 207, 209, 234], "mani": [32, 221, 226, 227], "libc": [32, 166], "utf8": [32, 122, 203, 204, 205, 206, 207], "box": [33, 123, 210, 212], "want": [33, 64, 119, 122, 130, 137, 218, 222, 224, 232, 233, 234, 235, 239], "copi": [33, 49, 50, 51, 52, 53, 64, 73, 137, 145, 148, 161, 170, 176, 182, 192, 195, 196, 210, 232, 234], "between": [33, 57, 117], "know": [33, 76, 123, 238], "until": [33, 79], "runtim": [33, 42, 122, 123, 200, 212], "result": [34, 35, 36, 37, 38, 39, 40, 41, 49, 58, 60, 63, 73, 82, 88, 116, 122, 129, 131, 140, 141, 158, 161, 178, 179, 201, 203, 204, 214], "canon": [34, 37, 232], "extend": [34, 35, 36, 37, 38, 39, 40, 72, 127, 131, 137, 227, 232], "json": [34, 35, 36, 37, 38, 39, 40, 72, 125, 126, 127, 129, 131, 134, 136, 137, 146, 170, 176, 203, 224, 227, 228, 229, 231, 234], "outermost": [34, 35, 36], "rather": [34, 35, 36, 195], "free": [34, 35, 36, 37, 38, 39, 40, 59, 60, 62, 63, 69, 132, 141, 186, 191, 199], "non": [34, 35, 36, 37, 38, 39, 40, 60, 76, 81, 116, 141, 203], "newli": [34, 35, 36, 37, 38, 39, 40, 47, 49, 88, 126, 129, 133, 134, 135, 143, 144, 145, 146, 161, 162, 163, 164, 178, 182, 183, 184, 192, 196, 203, 219], "upon": [34, 35, 36, 37, 38, 39, 40, 93, 97, 137, 235], "h": [34, 35, 36, 38, 48, 52, 57, 62, 117, 127, 131, 137, 157, 170, 176, 193, 198, 199, 200, 212, 213, 221, 224, 232, 235], "main": [34, 35, 36, 38, 48, 52, 57, 137, 157, 170, 176, 180, 213, 221, 230, 232, 235], "str": [34, 35, 36, 37, 38, 39, 40, 41, 52, 58, 154, 156, 157, 158, 170, 179, 182, 187, 188, 191, 192, 193, 196, 201, 202, 212, 214, 224, 232, 235], "normal": [34, 35, 36, 213], "continu": [34, 35, 36, 137, 170, 213, 232], "sequenti": [34, 35, 36, 155, 235], "bar": [34, 35, 36, 38, 199, 234], "print": [34, 35, 36, 38, 52, 137, 170, 232, 234], "numberint": [34, 232], "printf": [34, 35, 36, 37, 38, 39, 40, 52, 57, 93, 97, 117, 157, 176, 177, 179, 183, 184, 189, 193, 200, 201, 202, 212, 213, 214, 224, 230, 232, 233, 234, 235, 238], "n": [34, 35, 36, 37, 38, 39, 40, 52, 57, 62, 93, 97, 117, 137, 157, 165, 170, 176, 193, 200, 201, 202, 212, 213, 224, 230, 232, 233, 234, 235, 238], "supersed": [35, 38], "same": [35, 38, 43, 52, 53, 149, 199, 224], "all": [35, 38, 45, 51, 52, 53, 89, 90, 92, 122, 124, 127, 128, 159, 165, 200, 208, 209, 223, 230, 234, 236], "other": [35, 38, 43, 48, 61, 77, 80, 122, 164, 176, 203, 222, 227], "driver": [35, 38, 122, 231], "foo": [35, 38, 199, 200, 224, 234], "relax": [36, 40, 232], "3": [36, 69, 141, 157, 179, 189, 209, 213, 214, 224, 233], "14": [36, 155], "doc": [37, 39, 40, 93, 137, 165, 198, 199, 200, 213, 221, 224, 232, 234, 235], "structur": [39, 48, 57, 59, 60, 62, 117, 131, 137, 143, 157, 170, 175, 180, 191, 199, 209, 212, 213, 215, 219, 227, 233, 236], "pleas": [39, 51, 155], "refer": [39, 73, 122, 228, 231, 238], "more": [39, 169, 198, 209, 221, 233, 234, 235, 238], "detail": [39, 208, 209], "bson_json_opts_new": [39, 131, 228], "bson_json_mode_canon": [39, 127], "bson_max_len_unlimit": [39, 129, 131], "bson_json_opts_destroi": [39, 131, 228], "endptr": 41, "base": [41, 125, 147, 213, 224, 233, 239], "convert": [41, 58, 126, 134, 137, 157, 158, 170, 201, 203, 204, 205, 226, 231, 234], "address": 41, "first": [41, 51, 52, 53, 65, 89, 90, 92, 93, 97, 155, 176, 222, 224, 234], "convers": [41, 137, 213], "strtoll": 41, "accord": 41, "given": [41, 218], "16": [41, 57, 201, 239], "10": [41, 201], "lead": 41, "whitespac": 41, "ignor": [41, 226], "infer": 41, "from": [41, 51, 52, 53, 57, 75, 76, 85, 86, 98, 99, 100, 133, 134, 136, 162, 164, 165, 166, 167, 169, 170, 176, 195, 196, 199, 200, 201, 206, 210, 216, 221, 226, 231, 232, 233, 234, 236], "0x": 41, "digit": 41, "9": 41, "assign": 41, "its": [41, 175, 176, 190], "entir": [41, 195], "encount": [41, 103], "errno": [41, 185], "einval": 41, "out": [41, 62, 74, 85, 142, 144, 209, 215, 227], "rang": 41, "erang": 41, "llong_max": 41, "llong_min": 41, "required_major": 42, "required_minor": 42, "required_micro": 42, "minimum": [42, 230], "major": [42, 65, 66, 67, 239], "requir": [42, 62, 63, 137, 142, 170, 213, 224, 230, 232, 233, 236], "minor": [42, 65, 66, 67, 239], "micro": [42, 65, 66, 67, 239], "check": [42, 47, 70, 74, 79, 80, 149, 156, 165, 197, 199, 209, 218, 227, 234, 239], "releas": [42, 45, 65, 66, 67, 117, 128, 159, 211, 216], "meet": 42, "greater": [42, 43, 147, 166, 233], "equal": [42, 43, 61, 149, 157, 194, 233], "compar": 43, "two": [43, 57, 149, 192, 193, 224, 233, 234], "can": [43, 57, 64, 73, 75, 79, 80, 82, 86, 98, 117, 122, 129, 131, 133, 137, 157, 164, 170, 193, 199, 200, 202, 208, 209, 213, 221, 222, 224, 230, 233, 234, 235, 238, 239], "conjunct": [43, 64], "_qsort": 43, "_": [43, 219], "_memcmp": 43, "semant": 43, "less": [43, 147, 224, 233], "qsort": [43, 147, 157, 233], "style": [43, 147, 157, 177, 179, 183, 184, 189, 214, 234], "dst": [44, 50, 51, 52, 53, 148, 180, 195, 210], "src": [44, 50, 51, 52, 53, 148, 180, 195, 210], "content": [44, 49, 50, 60, 78, 81, 84, 87, 106, 107, 108, 109, 110, 111, 112, 113, 115, 116, 117, 119, 122, 145, 148, 176, 180, 207, 208, 209, 210, 218], "context": [45, 46, 47, 48, 152, 155, 173], "resourc": [45, 128, 159, 211], "associ": [45, 128, 159, 211], "doe": [45, 52, 53, 59, 62, 128, 132, 159, 195, 211, 213, 216], "noth": [45, 59, 128, 132, 159, 177, 195, 211, 216], "longer": [45, 60, 143, 192, 210], "have": [45, 47, 48, 178, 180, 199, 209, 224, 232, 234], "default": [46, 48, 140, 144, 152, 174], "creat": [46, 47, 98, 126, 129, 133, 134, 135, 143, 144, 145, 160, 161, 162, 163, 167, 178, 192, 219, 228, 231, 232, 234, 237], "flag": [46, 47, 48, 199, 208, 209], "bson_context_thread_saf": [46, 47, 48], "bson_context_disable_pid_cach": [46, 47, 48], "bson_context_flags_t": [47, 48], "follow": [47, 76, 77, 91, 155, 224, 232, 233, 238, 239], "bson_context_non": [47, 48], "mean": [47, 56, 195, 226], "objectid": [47, 48, 155, 156, 157, 228, 231, 236, 237], "thread": [47, 225, 228, 231, 233], "safe": [47, 236], "chang": [47, 117, 142], "getpid": 47, "everi": [47, 141], "effect": [47, 48, 209], "bson_context_disable_host_cach": 47, "bson_context_use_task_id": 47, "rare": [47, 142], "need": [47, 52, 193, 213, 224, 233, 234, 238], "serv": 47, "most": 47, "freed": [47, 49, 60, 64, 72, 79, 81, 82, 88, 101, 105, 115, 122, 123, 126, 133, 134, 140, 141, 143, 162, 165, 172, 175, 176, 178, 180, 182, 183, 184, 191, 192, 196, 203, 210, 216], "typedef": [48, 57, 62, 117, 121, 127, 131, 137, 141, 157, 160, 166, 170, 174, 180, 193, 198, 199, 200, 202, 209, 212, 213, 221], "enum": [48, 121, 127, 137, 198, 200, 209], "_bson_context_t": 48, "bson_gnuc_const": 48, "object": [48, 57, 72, 146, 157], "id": [48, 157], "overrid": 48, "ones": 48, "argc": [48, 57, 137, 157, 170, 180, 213, 221, 230, 232, 235], "argv": [48, 57, 137, 157, 170, 180, 213, 221, 230, 232, 235], "ctx": [48, 144, 173, 174], "via": [48, 72, 135, 136, 142, 146, 163], "addit": [48, 74, 195, 213, 234], "control": 48, "return": [48, 57, 79, 119, 120, 137, 157, 170, 193, 213, 221, 227, 230, 232, 233, 234, 235], "first_exclud": [51, 52, 53], "bson_gnuc_null_termin": [51, 52], "bson_gnuc_deprecated_for": [51, 155], "those": [51, 52, 53, 60, 223], "variad": [51, 52, 214, 224], "list": [51, 52, 199], "work": [52, 53, 137, 145, 173, 238], "wai": [52, 53, 68, 174, 233], "over": 52, "veri": 52, "special": [52, 203], "situat": [52, 98, 142], "bson2": 52, "va_list": [53, 184, 214], "arg": [53, 184], "method": [53, 216], "count": [54, 166, 213], "dec": [55, 56, 58, 85], "decimal128": [55, 56, 57, 108], "pars": [55, 56, 72, 137, 146, 154, 156, 213, 227, 228, 231, 237], "specif": [55, 56, 116, 137, 157, 170, 173, 174, 199, 200, 213, 224, 226, 227, 232], "exact": [55, 56], "nan": [55, 56, 57], "00": [55, 56, 57], "4": [56, 155, 157, 177, 179, 199, 209, 233, 239], "abstract": [57, 68, 142, 157, 193, 199, 202, 221], "bson_decimal128_str": [57, 58], "43": 57, "bson_decimal128_inf": 57, "infin": 57, "bson_decimal128_nan": 57, "bson_byte_ord": 57, "bson_little_endian": 57, "uint64_t": 57, "low": 57, "high": [57, 221], "elif": 57, "bson_big_endian": 57, "endif": [57, 239], "repres": [57, 102, 104, 157, 199, 233], "ieee": 57, "754": 57, "aggreg": 57, "declar": 57, "layout": [57, 98], "order": [57, 199], "them": [57, 137, 232], "endian": [57, 155, 157, 225, 228, 231, 233], "platform": [57, 68, 142, 223, 228, 231, 236], "alwai": [57, 59, 74, 76, 175, 195, 196, 201, 227, 238], "correspond": 57, "while": [57, 117, 119, 122, 137, 165, 170, 213, 232, 234, 235], "sixteen": 57, "cast": [57, 77, 78], "_decimal128": 57, "stdio": [57, 137, 157, 170, 176, 213, 230, 232, 235], "100": [57, 224], "printabl": 58, "decimal128_str": 58, "decimal128t": 58, "unless": [59, 137, 170, 232], "steal": 60, "underli": [60, 106, 107, 108, 109, 110, 111, 112, 113, 122, 135, 136, 165, 166, 167, 169, 171, 178, 199, 215, 218, 235], "stolen": 60, "destroi": [60, 128, 134, 159, 160, 162, 168, 180], "equival": [60, 71, 74, 181], "program": [60, 79, 80, 103, 106, 107, 108, 109, 110, 111, 112, 113, 137, 170, 228, 231, 232, 237], "error": [60, 62, 79, 80, 103, 106, 107, 108, 109, 110, 111, 112, 113, 117, 137, 165, 170, 177, 180, 208, 209, 213, 228, 231, 232, 235, 237], "top": 60, "level": [60, 142, 180, 213, 221, 235], "higher": [60, 142, 180, 213, 235], "effici": [60, 180], "transfer": [60, 180], "one": [60, 144, 167, 174, 209, 230, 234, 236], "both": [61, 91, 114, 181, 203, 226, 227], "encapsul": [62, 212, 224], "domain": [62, 177, 209, 227], "messag": [62, 137, 170, 209, 213, 220, 227, 232], "504": 62, "paramet": [62, 224], "stack": [62, 71, 73, 117, 142, 176, 199, 224], "handl": [62, 68, 160, 164, 166, 167, 170, 177, 228, 231, 237], "reader": [62, 125, 126, 132, 134, 136, 137, 159, 160, 162, 164, 165, 167, 168, 169, 170, 171, 232, 235], "dump": 62, "fprintf": [62, 137, 165, 170, 176, 213, 232, 234, 235], "stderr": [62, 137, 165, 170, 176, 213, 232, 234, 235], "d": [62, 70, 91, 117, 175, 193, 212, 213, 234], "mem": [63, 141, 172, 173, 174, 222], "suppli": [63, 129, 161, 216, 217, 219], "raw": [64, 75, 82, 86, 153, 180], "properti": 64, "around": [64, 123, 179, 185], "bson_major_vers": [65, 239], "compil": [65, 66, 67, 226, 239], "third": 66, "bson_micro_vers": [66, 239], "middl": 67, "bson_minor_vers": [67, 239], "bson_get_monotonic_tim": 68, "bson_gettimeofdai": 68, "tv": [68, 120], "cross": [68, 228, 231], "timeout": 68, "librari": [68, 174, 201, 230, 231, 236, 239], "gettimeofdai": 68, "well": [68, 222, 232], "monoton": [68, 201, 233], "microsecond": [68, 120], "someth": [69, 165], "pre": [69, 178], "accept": 70, "dotkei": [70, 91], "notat": [70, 91, 157], "found": [70, 72, 89, 90, 91, 92, 117, 135, 146, 197, 203, 213, 234, 235], "place": [71, 93, 97, 106, 107, 108, 109, 110, 111, 112, 113, 122, 194], "bson_initi": [71, 137, 176, 180, 198, 224, 232], "ssize_t": [72, 146, 166, 203, 213], "exist": [72, 146, 224, 234], "propag": [72, 135, 136, 146, 163], "On": [72, 236], "read": [73, 133, 134, 136, 137, 162, 164, 165, 166, 168, 169, 170, 176, 213, 232], "No": 73, "made": 73, "therefor": [73, 102, 199, 233], "remain": [73, 124, 195], "lifetim": [73, 117, 161], "dangl": 73, "safer": 74, "altern": [74, 93, 224], "isspac": 74, "bound": 74, "inclus": 74, "255": 74, "consid": [74, 89, 91, 92, 114, 117], "white": 74, "space": [74, 176, 195, 215], "bson_iter_holds_arrai": [75, 117], "bson_type_arrai": [75, 114, 121, 200], "array_len": 75, "immut": [75, 79, 82], "retriev": [75, 86, 101, 102, 115, 122], "verifi": [75, 85, 86, 99, 100, 105, 207], "macro": [75, 79, 86, 224], "fetch": [76, 77, 84, 85, 87, 99, 100, 101, 102, 104, 105, 123, 150, 218], "were": [76, 77, 78, 124], "how": [76, 124, 208, 209, 213], "bson_type_bool": [76, 77, 78, 80, 106, 110, 121, 200], "bson_type_doubl": [76, 77, 78, 87, 109, 121, 200], "bson_type_int32": [76, 77, 78, 99, 110, 121, 200, 212], "bson_type_int64": [76, 77, 78, 100, 111, 121, 200], "bson_type_utf8": [76, 121, 122, 200], "equat": 76, "ani": [77, 117, 137, 170, 175, 176, 211, 216, 232], "bson_iter_holds_binari": [79, 117], "bson_type_binari": [79, 121, 200], "binary_len": 79, "point": [79, 201], "bson_iter_holds_bool": [80, 117], "either": [80, 124, 137, 152, 170, 201, 213, 215, 232], "bson_iter_holds_cod": [81, 117], "bson_type_cod": [81, 121, 200], "bson_iter_holds_codewscop": [82, 117], "bson_type_codewscop": [82, 121, 200], "scope_len": [82, 212], "act": 82, "load": 82, "bson_iter_holds_date_tim": [83, 117], "collection_len": [84, 212], "bson_type_dbpoint": [84, 121, 200], "spec": 84, "bson_iter_holds_decimal128": [85, 117], "bson_type_decimal128": [85, 108, 200], "IN": 85, "befor": [85, 93, 97, 99, 100, 105, 122, 176, 180, 181, 203, 213], "bson_iter_holds_docu": [86, 117, 234], "bson_type_docu": [86, 114, 121, 200], "document_len": 86, "bson_iter_holds_doubl": [87, 117], "request": [89, 91, 92, 126, 133, 172, 173, 174], "advanc": [89, 90, 91, 92, 93, 97, 103, 206], "exhaust": [89, 90, 91, 92, 199], "sensit": [89, 90, 92], "fold": [89, 90, 92], "now": [89, 91, 92, 142, 180, 224], "descend": [91, 213], "dot": 91, "standard": [91, 195, 207], "recurs": 91, "subdocu": [91, 209], "keylen": [92, 96, 98], "static": [93, 97, 180, 199, 202, 213, 230, 239], "print_doc_id": [93, 97], "oidstr": [93, 97], "25": [93, 97, 157, 158], "_id": [93, 97], "bson_iter_holds_oid": [93, 97, 105, 117], "els": [93, 97, 137, 170, 213, 232, 238], "miss": [93, 97], "ident": [94, 95, 96, 173, 224], "offset": [98, 104, 171, 206, 208, 213, 218, 219, 221, 234], "previous": 98, "obtain": [98, 137, 170, 232], "where": [98, 177, 194, 208, 232], "progress": 98, "save": 98, "restor": [98, 140], "without": [98, 123, 137, 170, 232, 236], "reli": 98, "accomplish": 98, "Then": 98, "later": [98, 144], "reconstruct": [98, 104], "constant": [98, 101, 102, 104, 201], "bson_iter_holds_int32": [99, 117, 234], "bson_iter_holds_int64": [100, 117], "observ": [101, 102, 104, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 119, 121, 122, 123], "comput": 102, "faster": 102, "next": [103, 136, 155, 165, 166, 206], "last": 103, "unsign": [104, 157, 202, 233, 234, 235], "overwrit": [106, 107, 108, 109, 110, 111, 112, 113], "mutat": [106, 107, 108, 109, 110, 111, 112, 113, 234, 236], "http": [116, 137, 170, 198, 232], "bsonspec": [116, 198], "org": [116, 137, 170, 198, 232], "bson_iter_holds_utf8": [117, 122], "bson_iter_holds_undefin": 117, "bson_iter_holds_nul": 117, "bson_iter_holds_regex": 117, "bson_iter_holds_dbpoint": 117, "bson_iter_holds_symbol": 117, "bson_iter_holds_timestamp": [117, 119], "bson_iter_holds_maxkei": 117, "bson_iter_holds_minkei": 117, "bson_iter_holds_int": 117, "bson_iter_holds_numb": 117, "bson_iter_is_kei": 117, "strcmp": [117, 137, 170, 232], "privat": [117, 230], "through": [117, 174, 202, 208, 209, 238], "meant": [117, 166], "discard": 117, "my_bson_doc": 117, "my_field": 117, "sub_it": 117, "mysubdoc": 117, "my_doc": 117, "typic": [119, 233], "probabl": [119, 122, 222], "bson_type_eod": [121, 200], "0x00": [121, 198, 200], "0x01": [121, 198, 200], "0x02": [121, 198, 200], "0x03": [121, 198, 200], "0x04": [121, 198, 200], "0x05": [121, 198, 200], "0x06": [121, 200], "0x07": [121, 198, 200], "0x08": [121, 200], "0x09": [121, 200], "0x0a": [121, 200], "0x0b": [121, 200], "0x0c": [121, 200], "0x0d": [121, 200], "0x0e": [121, 200], "0x0f": [121, 200], "0x10": [121, 200], "0x11": [121, 200], "0x12": [121, 200], "0x7f": [121, 200], "0xff": [121, 200], "That": 122, "note": [122, 216, 222, 228, 231], "multi": [122, 190, 202, 204, 205, 233], "commonli": 122, "look": [122, 224], "marshal": 122, "further": [123, 165, 213, 234], "visitor": [124, 213], "conveni": [124, 223, 232, 234, 235], "callback": [124, 160, 166, 168, 170, 213, 227, 233], "vtabl": [124, 141], "visit": 124, "prematur": 124, "stop": [124, 129, 131, 213], "becaus": [124, 199], "corrupt": [124, 209, 235], "exampl": [124, 144, 180, 208, 209, 220, 224, 234], "your": [124, 201, 213, 228, 231, 233, 236, 237], "own": [124, 168, 213], "about": [124, 213], "unsupport": [124, 213], "entri": [124, 213], "feed": 125, "allow_multipl": [126, 133], "unus": [126, 133], "stream": [126, 133, 164, 166, 169, 170, 171, 176, 228, 229, 231], "enumer": [127, 198, 200], "bson_json_mode_legaci": 127, "bson_json_mode_relax": 127, "avail": [127, 223, 230], "max_len": [129, 131], "member": [129, 131], "hold": [129, 131], "onc": [129, 131], "serialis": [129, 131], "reach": [129, 131, 165], "full": [129, 131], "is_outermost_arrai": 130, "what": [130, 234], "we": [130, 165, 223, 224, 226, 232, 234], "variabl": 130, "_bson_json_opts_t": 131, "bson_json_opts_set_outermost_arrai": [131, 228], "bson_json_reader_cb": 133, "cb": 133, "bson_json_destroy_cb": 133, "dcb": 133, "buf_siz": 133, "user": [133, 164], "arbitrari": [133, 164], "sourc": [133, 136, 164], "fashion": 133, "fd": [134, 162, 170], "close_on_destroi": [134, 162, 170], "open": [134, 137, 170, 227, 232, 235], "file": [134, 135, 137, 162, 163, 164, 165, 166, 167, 170, 176, 213, 227, 230, 232, 235], "descriptor": [134, 162, 165, 166, 167, 170, 232, 235], "whether": [134, 162, 175, 191], "close": [134, 162, 170, 232], "filenam": [135, 137, 163, 170, 213, 232], "bulk": [137, 221], "_bson_json_reader_t": 137, "bson_json_error_read_corrupt_j": [137, 227], "bson_json_error_read_invalid_param": [137, 227], "bson_json_error_read_cb_failur": [137, 227], "bson_json_error_code_t": 137, "sequenc": [137, 155, 165, 170, 204, 205, 232], "transform": 137, "often": [137, 232], "copyright": [137, 170, 232], "2013": [137, 170, 232], "licens": [137, 170, 232], "under": [137, 142, 170, 232], "apach": [137, 170, 232], "complianc": [137, 170, 232], "www": [137, 170, 232], "applic": [137, 142, 170, 199, 232], "law": [137, 170, 232], "agre": [137, 170, 232], "write": [137, 170, 176, 195, 215, 217, 232], "softwar": [137, 170, 232], "distribut": [137, 170, 232, 238], "AS": [137, 170, 232], "basi": [137, 170, 232], "warranti": [137, 170, 232], "OR": [137, 170, 232], "condit": [137, 170, 232], "OF": [137, 170, 232], "kind": [137, 170, 232], "express": [137, 170, 232], "impli": [137, 170, 232], "languag": [137, 142, 145, 170, 213, 221, 232, 235], "govern": [137, 170, 232], "permiss": [137, 170, 232], "limit": [137, 170, 220, 232], "each": [137, 170, 186, 201, 232], "stdout": [137, 170, 232], "stdlib": [137, 213, 232], "usag": [137, 170, 213, 232], "argument": [137, 170, 232], "command": [137, 170, 230, 232], "line": [137, 170, 230, 232], "expect": [137, 145, 170, 219, 226, 232, 234, 238], "stdin_fileno": [137, 170, 232], "incom": [137, 170, 232], "fwrite": [137, 232], "exit": [137, 213, 232], "malloc": [138, 139, 141, 175], "calloc": [139, 141], "end": [140, 165, 166, 194, 199, 234, 238], "being": [140, 141, 218], "wrong": [140, 141], "_bson_mem_vtable_t": 141, "n_member": 141, "realloc": [141, 144, 172, 174, 235], "pad": [141, 199, 213], "bson_mem_vtable_t": 141, "instal": [141, 230], "backward": 141, "compat": [141, 231, 233], "lightweight": 142, "easier": 142, "addition": [142, 174], "help": [142, 145, 232], "integr": 142, "interest": 142, "One": 142, "caveat": 142, "design": 142, "deal": 142, "oom": 142, "extrem": 142, "dilig": 142, "throughout": 142, "correctli": 142, "futur": [142, 213], "As": [142, 193, 202], "stand": 142, "aid": 142, "bind": [142, 145], "custom": [142, 169, 170, 174, 208, 209], "revers": 142, "heap": [143, 145, 178, 199, 224], "buf": [144, 166, 185, 219, 221, 235], "buf_len": 144, "realloc_func": [144, 219, 221], "realloc_func_ctx": [144, 219, 221], "resiz": 144, "expand": 144, "bson_append": 144, "5": [144, 157, 177, 199, 233], "slower": 145, "oid1": [147, 149], "oid2": [147, 149], "lexicograph": [147, 181], "sort": [147, 181], "comparison": 147, "hash": 151, "suitabl": [151, 187], "hashtabl": [151, 157, 233], "12": [153, 157], "hex": [154, 156, 157, 158], "012345678901234567890123": 154, "big": [155, 157, 226, 233], "guarante": 155, "global": 155, "uniqu": [155, 236], "construct": 157, "random": [157, 233], "counter": [157, 233], "back": [157, 232], "direct": 157, "opaqu": [160, 166], "block": [162, 239], "close_fd": 162, "path": [163, 170, 230, 234], "host": [163, 226], "denot": 163, "rf": [164, 170], "df": [164, 170], "pluggabl": [164, 174], "socket": 164, "reached_eof": [165, 213], "unknown": 165, "reached_of": 165, "chunk": [166, 193], "part": 166, "seek": 167, "func": [168, 169], "execut": 168, "_bson_reader_t": 170, "come": 170, "nuse": [170, 232], "stdin": [170, 232], "cleanup": [170, 216, 232], "our": [170, 232], "off_t": 171, "tell": 171, "consum": [173, 174, 224], "pool": 173, "prototyp": 174, "wish": 174, "reiniti": 175, "reus": 175, "certain": [175, 239], "final": 175, "elimin": 176, "fill": [176, 195, 209, 227], "correct": 176, "read_into": 176, "fp": 176, "long": 176, "fseek": 176, "0l": 176, "seek_end": 176, "perror": 176, "couldn": 176, "t": [176, 233], "ftell": 176, "eof": [176, 235], "too": [176, 195], "larg": 176, "reserv": 176, "temporarili": 176, "ld": 176, "rewind": 176, "fread": 176, "fopen": 176, "rb": 176, "fclose": 176, "bson_gnuc_printf": [177, 179, 183, 184, 189, 214], "prealloc": 178, "good": 178, "idea": 178, "destin": [179, 195, 221, 224], "snprintf": [179, 201], "enforc": 179, "written": [179, 214, 218], "wrap": [180, 224], "bson_wrapper_t": 180, "wrap_bson": 180, "bson_wrapper_destroi": 180, "clean": [180, 219], "up": [180, 195, 196, 199, 219], "move": 180, "occur": [180, 194, 208, 209, 234], "lower": [180, 181], "s1": 181, "s2": 181, "strcasecmp": 181, "translat": 181, "err_cod": 185, "buflen": [185, 219, 221, 235], "strerror": 185, "strv": 186, "itself": 186, "builder": [188, 192], "unichar": [190, 204], "free_seg": 191, "growth": 192, "variou": [192, 198, 238, 239], "ad": [193, 224, 232], "api": [193, 221, 228, 231, 235, 238], "f": 193, "123": [193, 199], "ownership": 193, "might": [193, 232], "truncat": 194, "smaller": 194, "c11": 195, "strncpy_": 195, "strncpy": 195, "even": 195, "short": 195, "fit": 195, "left": 195, "n_byte": 196, "maxlen": 197, "strnlen": 197, "bson_subtype_binari": 198, "bson_subtype_funct": 198, "bson_subtype_binary_deprec": 198, "bson_subtype_uuid_deprec": 198, "bson_subtype_uuid": 198, "bson_subtype_md5": 198, "bson_subtype_column": 198, "bson_subtype_us": 198, "0x80": 198, "data_len": [198, 212], "bson_empti": 199, "nul": [199, 203], "bson_empty0": 199, "treat": 199, "bson_clear": 199, "easili": [199, 233], "bson_assert": [199, 213], "bptr": 199, "bson_max_s": 199, "bson_aligned_begin": 199, "120": 199, "bson_aligned_end": 199, "mutabl": 199, "attempt": 199, "inlin": 199, "speed": 199, "small": [199, 223], "dynam": [199, 221], "essenti": 199, "pair": 199, "refrain": 199, "create_on_heap": 199, "baz": [199, 224, 234], "23f": 199, "0x13": 200, "int32": 200, "strptr": 201, "999": 201, "section": 201, "etc": 201, "optim": [201, 226], "text": [202, 238], "print_each_char": 202, "utf8_len": [203, 207], "escap": 203, "backslash": 203, "u0000": 203, "input": [203, 232, 233], "preserv": [203, 232], "6": 204, "whose": 206, "allow_nul": 207, "rfc": 207, "3629": 207, "bson_validate_flags_t": [208, 209], "bitwis": [208, 209], "desir": [208, 209], "walk": [208, 209, 238], "inspect": [208, 209, 235], "bson_validate_non": [209, 234], "bson_validate_utf8": 209, "bson_validate_dollar_kei": 209, "bson_validate_dot_kei": 209, "bson_validate_utf8_allow_nul": 209, "bson_validate_empty_kei": 209, "below": [209, 213, 234], "basic": 209, "prohibit": 209, "outsid": 209, "dbref": 209, "anywher": 209, "bson_error_invalid": 209, "Its": 209, "give": 209, "possibl": [209, 226], "_bson_value_t": 212, "value_typ": 212, "union": 212, "v_oid": [212, 213], "v_int64": [212, 213], "v_int32": [212, 213], "int8_t": 212, "v_int8": 212, "v_doubl": [212, 213], "v_bool": [212, 213], "v_datetim": 212, "v_timestamp": [212, 213], "v_utf8": [212, 213], "v_doc": 212, "v_binari": [212, 213], "v_regex": [212, 213], "v_dbpointer": 212, "code_len": 212, "v_code": [212, 213], "scope_data": 212, "v_codewscop": 212, "v_symbol": [212, 213], "v_decimal128": [212, 213], "run": [213, 226], "visit_befor": 213, "visit_aft": 213, "visit_unsupported_typ": 213, "visit_corrupt": 213, "visit_doubl": 213, "visit_utf8": 213, "v_utf8_len": 213, "visit_docu": 213, "v_document": 213, "visit_arrai": 213, "v_arrai": 213, "visit_binari": 213, "v_subtyp": 213, "v_binary_len": 213, "visit_undefin": 213, "visit_oid": 213, "visit_bool": 213, "visit_date_tim": 213, "msec_since_epoch": 213, "visit_nul": 213, "visit_regex": 213, "v_option": 213, "visit_dbpoint": 213, "v_collection_len": 213, "v_collect": 213, "visit_cod": 213, "v_code_len": 213, "visit_symbol": 213, "v_symbol_len": 213, "visit_codewscop": 213, "v_scope": 213, "visit_int32": 213, "visit_timestamp": 213, "v_increment": 213, "visit_int64": 213, "visit_maxkei": 213, "visit_minkei": 213, "appar": 213, "unrecogn": 213, "type_cod": 213, "visit_decimal128": 213, "7": [213, 230], "seri": 213, "simplifi": 213, "report": [213, 227], "simpli": [213, 226, 230, 233], "proof": 213, "older": 213, "my_visit_befor": 213, "count_field": 213, "demonstr": 213, "err_offset": [213, 234], "my_state_t": 213, "my_visit_corrupt": 213, "off": 213, "my_visit_unsupported_typ": 213, "find_error_loc": 213, "had": 213, "depth": 213, "nest": 213, "assert": [213, 235], "inttyp": 213, "max_depth": 213, "check_depth_t": 213, "_check_depth_docu": 213, "check_depth_func": 213, "bson_unus": 213, "cancel": 213, "check_depth": 213, "exce": 213, "priu32": 213, "as_json": 213, "bson_read": 213, "atoi": 213, "bson_in_range_sign": 213, "ap": 214, "writer": [215, 216, 217, 218, 220, 221, 235], "partli": 218, "ve": 218, "boundari": 218, "cannot": 218, "sent": 218, "packet": [218, 221, 235], "instanc": 219, "_realloc": 219, "finish": 219, "went": 220, "past": 220, "particular": [220, 232], "48mb": 220, "_bson_writer_t": 221, "re": [221, 230], "demand": 221, "network": [221, 235], "python": 221, "dictionari": 221, "tcp": 221, "1000": 221, "behav": 222, "password": 222, "similarli": 222, "import": [222, 230], "truli": 222, "page": 222, "protect": 222, "mlock": 222, "prevent": 222, "swap": 222, "disk": 222, "substitut": 223, "manipul": 223, "necessari": [224, 234], "logic": 224, "At": 224, "core": 224, "live": 224, "let": [224, 234], "whenev": 224, "sure": 224, "proce": 224, "item": [224, 233], "varieti": 224, "prefix": 224, "bson_append_": 224, "notic": [224, 238], "goe": 224, "tediou": 224, "liter": 224, "few": 224, "hello": [224, 230], "world": 224, "omit": 224, "By": 224, "remov": 224, "creation": 224, "These": 224, "parent": 224, "hand": 224, "bcon": 224, "closer": 224, "show": 224, "bcon_": 224, "processor": 224, "bcon_new": [224, 230, 232, 234], "bcon_int32": [224, 232, 234], "bcon_utf8": [224, 230], "dictat": 226, "littl": 226, "altogeth": 226, "memcpi": 226, "appropri": 226, "dereferenc": 226, "intrins": 226, "derefer": 226, "subsystem": 227, "describ": 227, "overlap": 227, "bson_error_json": 227, "tri": 227, "mongodbextend": 227, "dure": 227, "bson_error_read": 227, "bson_error_reader_badfd": 227, "tutori": [228, 231], "guid": [228, 231], "header": [230, 235], "hello_bson": 230, "j": 230, "packag": 230, "find_packag": 230, "link": 230, "share": 230, "cmakelist": 230, "txt": 230, "sampl": 230, "among": 230, "four": 230, "test": 230, "add_execut": 230, "target_link_librari": 230, "mongo": 230, "bson_shar": 230, "bson_stat": 230, "gcc": 230, "o": 230, "lib": 230, "cflag": 230, "Or": 230, "nativ": [231, 236], "layer": 231, "There": 232, "debug": 232, "interchang": 232, "ambigu": 232, "e": 232, "g": 232, "numer": 232, "primit": 232, "fidel": 232, "enough": 232, "interfac": [232, 236], "simpl": 233, "manner": 233, "96": 233, "24": [233, 239], "rand": 233, "123456789012345678901234": 233, "bson_oid_init_from_string_unsaf": 233, "just": [233, 235], "purpos": 233, "djb": 233, "lazili": 234, "my_data": 234, "my_data_len": 234, "did": 234, "dive": 234, "down": 234, "exemplifi": 234, "abov": 234, "filedescriptor": 235, "yet": 235, "forward": 235, "mycollect": 235, "r": 235, "10000": 235, "access": 236, "posix": 236, "pthread": 236, "window": 236, "fallback": 236, "atom": 236, "built": 236, "anyth": 238, "my_str": 238, "my_string_len": 238, "preprocessor": 239, "against": 239, "enabl": 239, "featur": 239, "bson_version_": 239, "bson_version_hex": 239, "newer": 239, "do_someth": 239}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"api": 0, "refer": 0, "bson_aligned_alloc": 1, "synopsi": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 239], "paramet": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 47, 49, 50, 51, 52, 53, 54, 55, 56, 58, 59, 60, 61, 63, 64, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 118, 119, 120, 121, 122, 123, 124, 125, 126, 128, 129, 130, 132, 133, 134, 135, 136, 138, 139, 141, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 194, 195, 196, 197, 201, 203, 204, 205, 206, 207, 208, 209, 210, 211, 214, 215, 216, 217, 218, 219, 220, 222], "descript": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 227], "return": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 46, 47, 49, 54, 55, 56, 60, 61, 64, 65, 66, 67, 69, 70, 72, 73, 74, 76, 77, 78, 80, 81, 82, 83, 85, 87, 88, 89, 90, 91, 92, 93, 97, 98, 99, 100, 101, 102, 103, 104, 105, 114, 115, 116, 118, 121, 122, 123, 124, 126, 129, 133, 134, 135, 136, 138, 139, 143, 144, 145, 146, 147, 149, 150, 151, 156, 161, 162, 163, 164, 165, 166, 171, 172, 176, 178, 179, 180, 181, 182, 183, 184, 185, 191, 192, 196, 197, 201, 203, 205, 206, 207, 208, 209, 214, 215, 218, 219], "bson_aligned_alloc0": 2, "bson_append_arrai": 3, "bson_append_array_begin": 4, "bson_append_array_end": 5, "bson_append_binari": 6, "bson_append_bool": 7, "bson_append_cod": 8, "bson_append_code_with_scop": 9, "bson_append_date_tim": 10, "bson_append_dbpoint": 11, "bson_append_decimal128": 12, "bson_append_docu": 13, "bson_append_document_begin": 14, "bson_append_document_end": 15, "bson_append_doubl": 16, "bson_append_int32": 17, "bson_append_int64": 18, "bson_append_it": 19, "bson_append_maxkei": 20, "bson_append_minkei": 21, "bson_append_now_utc": 22, "bson_append_nul": 23, "bson_append_oid": 24, "bson_append_regex": 25, "bson_append_regex_w_len": 26, "bson_append_symbol": 27, "bson_append_time_t": 28, "bson_append_timestamp": 29, "bson_append_timev": 30, "bson_append_undefin": 31, "bson_append_utf8": 32, "bson_append_valu": 33, "bson_array_as_canonical_extended_json": 34, "exampl": [34, 35, 36, 37, 38, 39, 40, 48, 52, 55, 56, 57, 58, 62, 93, 97, 117, 137, 154, 157, 165, 170, 176, 193, 198, 199, 200, 202, 212, 213, 221, 232], "bson_array_as_json": 35, "bson_array_as_relaxed_extended_json": 36, "bson_as_canonical_extended_json": 37, "bson_as_json": 38, "bson_as_json_with_opt": 39, "bson_as_relaxed_extended_json": 40, "bson_ascii_strtol": 41, "bson_check_vers": 42, "bson_compar": 43, "bson_concat": 44, "bson_context_destroi": 45, "bson_context_get_default": 46, "bson_context_new": 47, "bson_context_t": 48, "function": [48, 57, 62, 68, 117, 131, 137, 142, 157, 170, 193, 198, 199, 200, 202, 212, 213, 221, 223, 239], "bson_copi": 49, "bson_copy_to": 50, "bson_copy_to_exclud": 51, "bson_copy_to_excluding_noinit": 52, "bson_copy_to_excluding_noinit_va": 53, "bson_count_kei": 54, "bson_decimal128_from_str": 55, "bson_decimal128_from_string_w_len": 56, "bson_decimal128_t": 57, "bson_decimal128_to_str": 58, "bson_destroi": 59, "bson_destroy_with_st": 60, "bson_equ": 61, "bson_error_t": 62, "bson_fre": 63, "bson_get_data": 64, "bson_get_major_vers": 65, "bson_get_micro_vers": 66, "bson_get_minor_vers": 67, "system": 68, "clock": 68, "bson_get_vers": 69, "bson_has_field": 70, "bson_init": 71, "bson_init_from_json": 72, "error": [72, 135, 136, 146, 163, 227], "bson_init_stat": 73, "bson_isspac": 74, "bson_iter_arrai": 75, "bson_iter_as_bool": 76, "bson_iter_as_doubl": 77, "bson_iter_as_int64": 78, "bson_iter_binari": 79, "bson_iter_bool": 80, "bson_iter_cod": 81, "bson_iter_codewscop": 82, "bson_iter_date_tim": 83, "bson_iter_dbpoint": 84, "bson_iter_decimal128": 85, "bson_iter_docu": 86, "bson_iter_doubl": 87, "bson_iter_dup_utf8": 88, "bson_iter_find": 89, "bson_iter_find_cas": 90, "bson_iter_find_descend": 91, "bson_iter_find_w_len": 92, "bson_iter_init": 93, "bson_iter_init_find": 94, "bson_iter_init_find_cas": 95, "bson_iter_init_find_w_len": 96, "bson_iter_init_from_data": 97, "bson_iter_init_from_data_at_offset": 98, "bson_iter_int32": 99, "bson_iter_int64": 100, "bson_iter_kei": 101, "bson_iter_key_len": 102, "bson_iter_next": 103, "bson_iter_offset": 104, "bson_iter_oid": 105, "bson_iter_overwrite_bool": 106, "bson_iter_overwrite_date_tim": 107, "bson_iter_overwrite_decimal128": 108, "bson_iter_overwrite_doubl": 109, "bson_iter_overwrite_int32": 110, "bson_iter_overwrite_int64": 111, "bson_iter_overwrite_oid": 112, "bson_iter_overwrite_timestamp": 113, "bson_iter_recurs": 114, "bson_iter_regex": 115, "bson_iter_symbol": 116, "bson_iter_t": 117, "bson_iter_time_t": 118, "bson_iter_timestamp": 119, "bson_iter_timev": 120, "bson_iter_typ": 121, "bson_iter_utf8": 122, "bson_iter_valu": 123, "bson_iter_visit_al": 124, "bson_json_data_reader_ingest": 125, "bson_json_data_reader_new": 126, "bson_json_mode_t": 127, "bson_json_opts_destroi": 128, "bson_json_opts_new": 129, "bson_json_opts_set_outermost_arrai": 130, "bson_json_opts_t": 131, "bson_json_reader_destroi": 132, "bson_json_reader_new": 133, "bson_json_reader_new_from_fd": 134, "bson_json_reader_new_from_fil": 135, "bson_json_reader_read": 136, "bson_json_reader_t": 137, "bson_malloc": 138, "bson_malloc0": 139, "bson_mem_restore_vt": 140, "bson_mem_set_vt": 141, "memori": 142, "manag": 142, "bson_new": 143, "bson_new_from_buff": 144, "bson_new_from_data": 145, "bson_new_from_json": 146, "bson_oid_compar": 147, "bson_oid_copi": 148, "bson_oid_equ": 149, "bson_oid_get_time_t": 150, "bson_oid_hash": 151, "bson_oid_init": 152, "bson_oid_init_from_data": 153, "bson_oid_init_from_str": 154, "bson_oid_init_sequ": 155, "bson_oid_is_valid": 156, "bson_oid_t": 157, "string": [157, 223, 233], "convers": 157, "hash": [157, 233], "compar": [157, 233], "valid": [157, 213, 234, 238], "bson_oid_to_str": 158, "bson_reader_destroi": 159, "bson_reader_destroy_func_t": 160, "bson_reader_new_from_data": 161, "bson_reader_new_from_fd": 162, "bson_reader_new_from_fil": 163, "bson_reader_new_from_handl": 164, "bson_reader_read": 165, "bson_reader_read_func_t": 166, "bson_reader_reset": 167, "bson_reader_set_destroy_func": 168, "bson_reader_set_read_func": 169, "bson_reader_t": 170, "bson_reader_tel": 171, "bson_realloc": 172, "bson_realloc_ctx": 173, "bson_realloc_func": 174, "bson_reinit": 175, "bson_reserve_buff": 176, "bson_set_error": 177, "bson_sized_new": 178, "bson_snprintf": 179, "bson_steal": 180, "bson_strcasecmp": 181, "bson_strdup": 182, "bson_strdup_printf": 183, "bson_strdupv_printf": 184, "bson_strerror_r": 185, "bson_strfreev": 186, "bson_string_append": 187, "bson_string_append_c": 188, "bson_string_append_printf": 189, "bson_string_append_unichar": 190, "bson_string_fre": 191, "bson_string_new": 192, "bson_string_t": 193, "bson_string_trunc": 194, "bson_strncpi": 195, "bson_strndup": 196, "bson_strnlen": 197, "bson_subtype_t": 198, "bson_t": [199, 224], "perform": 199, "note": [199, 225], "duplic": 199, "kei": [199, 201], "bson_type_t": 200, "bson_uint32_to_str": 201, "arrai": [201, 224], "element": 201, "build": 201, "bson_unichar_t": 202, "bson_utf8_escape_for_json": 203, "bson_utf8_from_unichar": 204, "bson_utf8_get_char": 205, "bson_utf8_next_char": 206, "bson_utf8_valid": 207, "bson_valid": 208, "bson_validate_with_error": 209, "bson_value_copi": 210, "bson_value_destroi": 211, "bson_value_t": 212, "bson_visitor_t": 213, "basic": 213, "corrupt": 213, "check": 213, "custom": 213, "bson_vsnprintf": 214, "bson_writer_begin": 215, "bson_writer_destroi": 216, "bson_writer_end": 217, "bson_writer_get_length": 218, "bson_writer_new": 219, "bson_writer_rollback": 220, "bson_writer_t": 221, "bson_zero_fre": 222, "charact": 223, "routin": 223, "creat": 224, "bson": [224, 230, 232, 234, 235], "document": [224, 234, 235], "The": 224, "structur": 224, "sub": [224, 234], "simplifi": 224, "c": [224, 230], "object": [224, 233], "notat": [224, 234], "cross": 225, "platform": 225, "endian": 226, "handl": 227, "index": 228, "guid": 229, "us": [230, 234], "libbson": [230, 231, 239], "In": 230, "your": 230, "program": 230, "includ": 230, "h": 230, "cmake": 230, "pkg": 230, "config": 230, "introduct": 231, "json": 232, "convert": 232, "stream": [232, 235], "pars": [232, 233, 234], "objectid": 233, "composit": 233, "sort": 233, "id": 233, "gener": 233, "fetch": 233, "creation": 233, "time": 233, "iter": 234, "recurs": 234, "find": 234, "field": 234, "dot": 234, "read": 235, "from": 235, "write": 235, "sequenc": [235, 238], "thread": 236, "tutori": 237, "utf": 238, "8": 238, "encod": 238, "version": 239, "macro": 239}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"API Reference": [[0, "api-reference"]], "bson_aligned_alloc()": [[1, "bson-aligned-alloc"]], "Synopsis": [[1, "synopsis"], [2, "synopsis"], [3, "synopsis"], [4, "synopsis"], [5, "synopsis"], [6, "synopsis"], [7, "synopsis"], [8, "synopsis"], [9, "synopsis"], [10, "synopsis"], [11, "synopsis"], [12, "synopsis"], [13, "synopsis"], [14, "synopsis"], [15, "synopsis"], [16, "synopsis"], [17, "synopsis"], [18, "synopsis"], [19, "synopsis"], [20, "synopsis"], [21, "synopsis"], [22, "synopsis"], [23, "synopsis"], [24, "synopsis"], [25, "synopsis"], [26, "synopsis"], [27, "synopsis"], [28, "synopsis"], [29, "synopsis"], [30, "synopsis"], [31, "synopsis"], [32, "synopsis"], [33, "synopsis"], [34, "synopsis"], [35, "synopsis"], [36, "synopsis"], [37, "synopsis"], [38, "synopsis"], [39, "synopsis"], [40, "synopsis"], [41, "synopsis"], [42, "synopsis"], [43, "synopsis"], [44, "synopsis"], [45, "synopsis"], [46, "synopsis"], [47, "synopsis"], [48, "synopsis"], [49, "synopsis"], [50, "synopsis"], [51, "synopsis"], [52, "synopsis"], [53, "synopsis"], [54, "synopsis"], [55, "synopsis"], [56, "synopsis"], [57, "synopsis"], [58, "synopsis"], [59, "synopsis"], [60, "synopsis"], [61, "synopsis"], [62, "synopsis"], [63, "synopsis"], [64, "synopsis"], [65, "synopsis"], [66, "synopsis"], [67, "synopsis"], [68, "synopsis"], [69, "synopsis"], [70, "synopsis"], [71, "synopsis"], [72, "synopsis"], [73, "synopsis"], [74, "synopsis"], [75, "synopsis"], [76, "synopsis"], [77, "synopsis"], [78, "synopsis"], [79, "synopsis"], [80, "synopsis"], [81, "synopsis"], [82, "synopsis"], [83, "synopsis"], [84, "synopsis"], [85, "synopsis"], [86, "synopsis"], [87, "synopsis"], [88, "synopsis"], [89, "synopsis"], [90, "synopsis"], [91, "synopsis"], [92, "synopsis"], [93, "synopsis"], [94, "synopsis"], [95, "synopsis"], [96, "synopsis"], [97, "synopsis"], [98, "synopsis"], [99, "synopsis"], [100, "synopsis"], [101, "synopsis"], [102, "synopsis"], [103, "synopsis"], [104, "synopsis"], [105, "synopsis"], [106, "synopsis"], [107, "synopsis"], [108, "synopsis"], [109, "synopsis"], [110, "synopsis"], [111, "synopsis"], [112, "synopsis"], [113, "synopsis"], [114, "synopsis"], [115, "synopsis"], [116, "synopsis"], [117, "synopsis"], [118, "synopsis"], [119, "synopsis"], [120, "synopsis"], [121, "synopsis"], [122, "synopsis"], [123, "synopsis"], [124, "synopsis"], [125, "synopsis"], [126, "synopsis"], [127, "synopsis"], [128, "synopsis"], [129, "synopsis"], [130, "synopsis"], [131, "synopsis"], [132, "synopsis"], [133, "synopsis"], [134, "synopsis"], [135, "synopsis"], [136, "synopsis"], [137, "synopsis"], [138, "synopsis"], [139, "synopsis"], [140, "synopsis"], [141, "synopsis"], [143, "synopsis"], [144, "synopsis"], [145, "synopsis"], [146, "synopsis"], [147, "synopsis"], [148, "synopsis"], [149, "synopsis"], [150, "synopsis"], [151, "synopsis"], [152, "synopsis"], [153, "synopsis"], [154, "synopsis"], [155, "synopsis"], [156, "synopsis"], [157, "synopsis"], [158, "synopsis"], [159, "synopsis"], [160, "synopsis"], [161, "synopsis"], [162, "synopsis"], [163, "synopsis"], [164, "synopsis"], [165, "synopsis"], [166, "synopsis"], [167, "synopsis"], [168, "synopsis"], [169, "synopsis"], [170, "synopsis"], [171, "synopsis"], [172, "synopsis"], [173, "synopsis"], [174, "synopsis"], [175, "synopsis"], [176, "synopsis"], [177, "synopsis"], [178, "synopsis"], [179, "synopsis"], [180, "synopsis"], [181, "synopsis"], [182, "synopsis"], [183, "synopsis"], [184, "synopsis"], [185, "synopsis"], [186, "synopsis"], [187, "synopsis"], [188, "synopsis"], [189, "synopsis"], [190, "synopsis"], [191, "synopsis"], [192, "synopsis"], [193, "synopsis"], [194, "synopsis"], [195, "synopsis"], [196, "synopsis"], [197, "synopsis"], [198, "synopsis"], [199, "synopsis"], [200, "synopsis"], [201, "synopsis"], [202, "synopsis"], [203, "synopsis"], [204, "synopsis"], [205, "synopsis"], [206, "synopsis"], [207, "synopsis"], [208, "synopsis"], [209, "synopsis"], [210, "synopsis"], [211, "synopsis"], [212, "synopsis"], [213, "synopsis"], [214, "synopsis"], [215, "synopsis"], [216, "synopsis"], [217, "synopsis"], [218, "synopsis"], [219, "synopsis"], [220, "synopsis"], [221, "synopsis"], [222, "synopsis"], [239, "synopsis"]], "Parameters": [[1, "parameters"], [2, "parameters"], [3, "parameters"], [4, "parameters"], [5, "parameters"], [6, "parameters"], [7, "parameters"], [8, "parameters"], [9, "parameters"], [10, "parameters"], [11, "parameters"], [12, "parameters"], [13, "parameters"], [14, "parameters"], [15, "parameters"], [16, "parameters"], [17, "parameters"], [18, "parameters"], [19, "parameters"], [20, "parameters"], [21, "parameters"], [22, "parameters"], [23, "parameters"], [24, "parameters"], [25, "parameters"], [26, "parameters"], [27, "parameters"], [28, "parameters"], [29, "parameters"], [30, "parameters"], [31, "parameters"], [32, "parameters"], [33, "parameters"], [34, "parameters"], [35, "parameters"], [36, "parameters"], [37, "parameters"], [38, "parameters"], [39, "parameters"], [40, "parameters"], [41, "parameters"], [42, "parameters"], [43, "parameters"], [44, "parameters"], [45, "parameters"], [47, "parameters"], [49, "parameters"], [50, "parameters"], [51, "parameters"], [52, "parameters"], [53, "parameters"], [54, "parameters"], [55, "parameters"], [56, "parameters"], [58, "parameters"], [59, "parameters"], [60, "parameters"], [61, "parameters"], [63, "parameters"], [64, "parameters"], [70, "parameters"], [71, "parameters"], [72, "parameters"], [73, "parameters"], [74, "parameters"], [75, "parameters"], [76, "parameters"], [77, "parameters"], [78, "parameters"], [79, "parameters"], [80, "parameters"], [81, "parameters"], [82, "parameters"], [83, "parameters"], [84, "parameters"], [85, "parameters"], [86, "parameters"], [87, "parameters"], [88, "parameters"], [89, "parameters"], [90, "parameters"], [91, "parameters"], [92, "parameters"], [93, "parameters"], [94, "parameters"], [95, "parameters"], [96, "parameters"], [97, "parameters"], [98, "parameters"], [99, "parameters"], [100, "parameters"], [101, "parameters"], [102, "parameters"], [103, "parameters"], [104, "parameters"], [105, "parameters"], [106, "parameters"], [107, "parameters"], [108, "parameters"], [109, "parameters"], [110, "parameters"], [111, "parameters"], [112, "parameters"], [113, "parameters"], [114, "parameters"], [115, "parameters"], [116, "parameters"], [118, "parameters"], [119, "parameters"], [120, "parameters"], [121, "parameters"], [122, "parameters"], [123, "parameters"], [124, "parameters"], [125, "parameters"], [126, "parameters"], [128, "parameters"], [129, "parameters"], [130, "parameters"], [132, "parameters"], [133, "parameters"], [134, "parameters"], [135, "parameters"], [136, "parameters"], [138, "parameters"], [139, "parameters"], [141, "parameters"], [144, "parameters"], [145, "parameters"], [146, "parameters"], [147, "parameters"], [148, "parameters"], [149, "parameters"], [150, "parameters"], [151, "parameters"], [152, "parameters"], [153, "parameters"], [154, "parameters"], [155, "parameters"], [156, "parameters"], [158, "parameters"], [159, "parameters"], [160, "parameters"], [161, "parameters"], [162, "parameters"], [163, "parameters"], [164, "parameters"], [165, "parameters"], [166, "parameters"], [167, "parameters"], [168, "parameters"], [169, "parameters"], [171, "parameters"], [172, "parameters"], [173, "parameters"], [174, "parameters"], [175, "parameters"], [176, "parameters"], [177, "parameters"], [178, "parameters"], [179, "parameters"], [180, "parameters"], [181, "parameters"], [182, "parameters"], [183, "parameters"], [184, "parameters"], [185, "parameters"], [186, "parameters"], [187, "parameters"], [188, "parameters"], [189, "parameters"], [190, "parameters"], [191, "parameters"], [192, "parameters"], [194, "parameters"], [195, "parameters"], [196, "parameters"], [197, "parameters"], [201, "parameters"], [203, "parameters"], [204, "parameters"], [205, "parameters"], [206, "parameters"], [207, "parameters"], [208, "parameters"], [209, "parameters"], [210, "parameters"], [211, "parameters"], [214, "parameters"], [215, "parameters"], [216, "parameters"], [217, "parameters"], [218, "parameters"], [219, "parameters"], [220, "parameters"], [222, "parameters"]], "Description": [[1, "description"], [2, "description"], [3, "description"], [4, "description"], [5, "description"], [6, "description"], [7, "description"], [8, "description"], [9, "description"], [10, "description"], [11, "description"], [12, "description"], [13, "description"], [14, "description"], [15, "description"], [16, "description"], [17, "description"], [18, "description"], [19, "description"], [20, "description"], [21, "description"], [22, "description"], [23, "description"], [24, "description"], [25, "description"], [26, "description"], [27, "description"], [28, "description"], [29, "description"], [30, "description"], [31, "description"], [32, "description"], [33, "description"], [34, "description"], [35, "description"], [36, "description"], [37, "description"], [38, "description"], [39, "description"], [40, "description"], [41, "description"], [42, "description"], [43, "description"], [44, "description"], [45, "description"], [47, "description"], [48, "description"], [49, "description"], [50, "description"], [51, "description"], [52, "description"], [53, "description"], [54, "description"], [55, "description"], [56, "description"], [57, "description"], [58, "description"], [59, "description"], [60, "description"], [61, "description"], [62, "description"], [63, "description"], [64, "description"], [65, "description"], [66, "description"], [67, "description"], [68, "description"], [69, "description"], [70, "description"], [71, "description"], [72, "description"], [73, "description"], [74, "description"], [75, "description"], [76, "description"], [77, "description"], [78, "description"], [79, "description"], [80, "description"], [81, "description"], [82, "description"], [83, "description"], [84, "description"], [85, "description"], [86, "description"], [87, "description"], [88, "description"], [89, "description"], [90, "description"], [91, "description"], [92, "description"], [93, "description"], [94, "description"], [95, "description"], [96, "description"], [97, "description"], [98, "description"], [99, "description"], [100, "description"], [101, "description"], [102, "description"], [103, "description"], [104, "description"], [105, "description"], [106, "description"], [107, "description"], [108, "description"], [109, "description"], [110, "description"], [111, "description"], [112, "description"], [113, "description"], [114, "description"], [115, "description"], [116, "description"], [117, "description"], [118, "description"], [119, "description"], [120, "description"], [121, "description"], [122, "description"], [123, "description"], [124, "description"], [125, "description"], [126, "description"], [127, "description"], [128, "description"], [129, "description"], [130, "description"], [131, "description"], [132, "description"], [133, "description"], [134, "description"], [135, "description"], [136, "description"], [137, "description"], [138, "description"], [139, "description"], [140, "description"], [141, "description"], [142, "description"], [143, "description"], [144, "description"], [145, "description"], [146, "description"], [147, "description"], [148, "description"], [149, "description"], [150, "description"], [151, "description"], [152, "description"], [153, "description"], [154, "description"], [155, "description"], [156, "description"], [157, "description"], [158, "description"], [159, "description"], [160, "description"], [161, "description"], [162, "description"], [163, "description"], [164, "description"], [165, "description"], [166, "description"], [167, "description"], [168, "description"], [169, "description"], [170, "description"], [171, "description"], [172, "description"], [173, "description"], [174, "description"], [175, "description"], [176, "description"], [177, "description"], [178, "description"], [179, "description"], [180, "description"], [181, "description"], [182, "description"], [183, "description"], [184, "description"], [185, "description"], [186, "description"], [187, "description"], [188, "description"], [189, "description"], [190, "description"], [191, "description"], [192, "description"], [193, "description"], [194, "description"], [195, "description"], [196, "description"], [197, "description"], [198, "description"], [199, "description"], [200, "description"], [201, "description"], [202, "description"], [203, "description"], [204, "description"], [205, "description"], [206, "description"], [207, "description"], [208, "description"], [209, "description"], [210, "description"], [211, "description"], [212, "description"], [213, "description"], [214, "description"], [215, "description"], [216, "description"], [217, "description"], [218, "description"], [219, "description"], [220, "description"], [221, "description"], [222, "description"], [227, "description"]], "Returns": [[1, "returns"], [2, "returns"], [3, "returns"], [4, "returns"], [5, "returns"], [6, "returns"], [7, "returns"], [8, "returns"], [9, "returns"], [10, "returns"], [11, "returns"], [12, "returns"], [13, "returns"], [14, "returns"], [15, "returns"], [16, "returns"], [17, "returns"], [18, "returns"], [19, "returns"], [20, "returns"], [21, "returns"], [22, "returns"], [23, "returns"], [24, "returns"], [25, "returns"], [26, "returns"], [27, "returns"], [28, "returns"], [29, "returns"], [30, "returns"], [31, "returns"], [32, "returns"], [33, "returns"], [34, "returns"], [35, "returns"], [36, "returns"], [37, "returns"], [38, "returns"], [39, "returns"], [40, "returns"], [41, "returns"], [42, "returns"], [43, "returns"], [44, "returns"], [46, "returns"], [47, "returns"], [49, "returns"], [54, "returns"], [55, "returns"], [56, "returns"], [60, "returns"], [61, "returns"], [64, "returns"], [65, "returns"], [66, "returns"], [67, "returns"], [69, "returns"], [70, "returns"], [72, "returns"], [73, "returns"], [74, "returns"], [76, "returns"], [77, "returns"], [78, "returns"], [80, "returns"], [81, "returns"], [82, "returns"], [83, "returns"], [85, "returns"], [87, "returns"], [88, "returns"], [89, "returns"], [90, "returns"], [91, "returns"], [92, "returns"], [93, "returns"], [97, "returns"], [98, "returns"], [99, "returns"], [100, "returns"], [101, "returns"], [102, "returns"], [103, "returns"], [104, "returns"], [105, "returns"], [114, "returns"], [115, "returns"], [116, "returns"], [118, "returns"], [121, "returns"], [122, "returns"], [123, "returns"], [124, "returns"], [126, "returns"], [129, "returns"], [133, "returns"], [134, "returns"], [135, "returns"], [136, "returns"], [138, "returns"], [139, "returns"], [143, "returns"], [144, "returns"], [145, "returns"], [146, "returns"], [147, "returns"], [149, "returns"], [150, "returns"], [151, "returns"], [156, "returns"], [161, "returns"], [162, "returns"], [163, "returns"], [164, "returns"], [165, "returns"], [166, "returns"], [171, "returns"], [172, "returns"], [176, "returns"], [178, "returns"], [179, "returns"], [180, "returns"], [181, "returns"], [182, "returns"], [183, "returns"], [184, "returns"], [185, "returns"], [191, "returns"], [192, "returns"], [196, "returns"], [197, "returns"], [201, "returns"], [203, "returns"], [205, "returns"], [206, "returns"], [207, "returns"], [208, "returns"], [209, "returns"], [214, "returns"], [215, "returns"], [218, "returns"], [219, "returns"]], "bson_aligned_alloc0()": [[2, "bson-aligned-alloc0"]], "bson_append_array()": [[3, "bson-append-array"]], "bson_append_array_begin()": [[4, "bson-append-array-begin"]], "bson_append_array_end()": [[5, "bson-append-array-end"]], "bson_append_binary()": [[6, "bson-append-binary"]], "bson_append_bool()": [[7, "bson-append-bool"]], "bson_append_code()": [[8, "bson-append-code"]], "bson_append_code_with_scope()": [[9, "bson-append-code-with-scope"]], "bson_append_date_time()": [[10, "bson-append-date-time"]], "bson_append_dbpointer()": [[11, "bson-append-dbpointer"]], "bson_append_decimal128()": [[12, "bson-append-decimal128"]], "bson_append_document()": [[13, "bson-append-document"]], "bson_append_document_begin()": [[14, "bson-append-document-begin"]], "bson_append_document_end()": [[15, "bson-append-document-end"]], "bson_append_double()": [[16, "bson-append-double"]], "bson_append_int32()": [[17, "bson-append-int32"]], "bson_append_int64()": [[18, "bson-append-int64"]], "bson_append_iter()": [[19, "bson-append-iter"]], "bson_append_maxkey()": [[20, "bson-append-maxkey"]], "bson_append_minkey()": [[21, "bson-append-minkey"]], "bson_append_now_utc()": [[22, "bson-append-now-utc"]], "bson_append_null()": [[23, "bson-append-null"]], "bson_append_oid()": [[24, "bson-append-oid"]], "bson_append_regex()": [[25, "bson-append-regex"]], "bson_append_regex_w_len()": [[26, "bson-append-regex-w-len"]], "bson_append_symbol()": [[27, "bson-append-symbol"]], "bson_append_time_t()": [[28, "bson-append-time-t"]], "bson_append_timestamp()": [[29, "bson-append-timestamp"]], "bson_append_timeval()": [[30, "bson-append-timeval"]], "bson_append_undefined()": [[31, "bson-append-undefined"]], "bson_append_utf8()": [[32, "bson-append-utf8"]], "bson_append_value()": [[33, "bson-append-value"]], "bson_array_as_canonical_extended_json()": [[34, "bson-array-as-canonical-extended-json"]], "Example": [[34, "example"], [35, "example"], [36, "example"], [37, "example"], [38, "example"], [39, "example"], [40, "example"], [48, "example"], [52, "example"], [55, "example"], [56, "example"], [57, "example"], [58, "example"], [62, "example"], [93, "example"], [97, "example"], [137, "example"], [154, "example"], [157, "example"], [165, "example"], [170, "example"], [176, "example"], [193, "example"], [198, "example"], [199, "example"], [200, "example"], [202, "example"], [212, "example"], [221, "example"]], "bson_array_as_json()": [[35, "bson-array-as-json"]], "bson_array_as_relaxed_extended_json()": [[36, "bson-array-as-relaxed-extended-json"]], "bson_as_canonical_extended_json()": [[37, "bson-as-canonical-extended-json"]], "bson_as_json()": [[38, "bson-as-json"]], "bson_as_json_with_opts()": [[39, "bson-as-json-with-opts"]], "bson_as_relaxed_extended_json()": [[40, "bson-as-relaxed-extended-json"]], "bson_ascii_strtoll()": [[41, "bson-ascii-strtoll"]], "bson_check_version()": [[42, "bson-check-version"]], "bson_compare()": [[43, "bson-compare"]], "bson_concat()": [[44, "bson-concat"]], "bson_context_destroy()": [[45, "bson-context-destroy"]], "bson_context_get_default()": [[46, "bson-context-get-default"]], "bson_context_new()": [[47, "bson-context-new"]], "bson_context_t": [[48, "bson-context-t"]], "Functions": [[48, "functions"], [57, "functions"], [62, "functions"], [68, "functions"], [117, "functions"], [131, "functions"], [137, "functions"], [142, "functions"], [157, "functions"], [170, "functions"], [193, "functions"], [198, "functions"], [199, "functions"], [200, "functions"], [202, "functions"], [212, "functions"], [213, "functions"], [221, "functions"], [223, "functions"], [239, "functions"]], "bson_copy()": [[49, "bson-copy"]], "bson_copy_to()": [[50, "bson-copy-to"]], "bson_copy_to_excluding()": [[51, "bson-copy-to-excluding"]], "bson_copy_to_excluding_noinit()": [[52, "bson-copy-to-excluding-noinit"]], "bson_copy_to_excluding_noinit_va()": [[53, "bson-copy-to-excluding-noinit-va"]], "bson_count_keys()": [[54, "bson-count-keys"]], "bson_decimal128_from_string()": [[55, "bson-decimal128-from-string"]], "bson_decimal128_from_string_w_len()": [[56, "bson-decimal128-from-string-w-len"]], "bson_decimal128_t": [[57, "bson-decimal128-t"]], "bson_decimal128_to_string()": [[58, "bson-decimal128-to-string"]], "bson_destroy()": [[59, "bson-destroy"]], "bson_destroy_with_steal()": [[60, "bson-destroy-with-steal"]], "bson_equal()": [[61, "bson-equal"]], "bson_error_t": [[62, "bson-error-t"]], "bson_free()": [[63, "bson-free"]], "bson_get_data()": [[64, "bson-get-data"]], "bson_get_major_version()": [[65, "bson-get-major-version"]], "bson_get_micro_version()": [[66, "bson-get-micro-version"]], "bson_get_minor_version()": [[67, "bson-get-minor-version"]], "System Clock": [[68, "system-clock"]], "bson_get_version()": [[69, "bson-get-version"]], "bson_has_field()": [[70, "bson-has-field"]], "bson_init()": [[71, "bson-init"]], "bson_init_from_json()": [[72, "bson-init-from-json"]], "Errors": [[72, "errors"], [135, "errors"], [136, "errors"], [146, "errors"], [163, "errors"]], "bson_init_static()": [[73, "bson-init-static"]], "bson_isspace()": [[74, "bson-isspace"]], "bson_iter_array()": [[75, "bson-iter-array"]], "bson_iter_as_bool()": [[76, "bson-iter-as-bool"]], "bson_iter_as_double()": [[77, "bson-iter-as-double"]], "bson_iter_as_int64()": [[78, "bson-iter-as-int64"]], "bson_iter_binary()": [[79, "bson-iter-binary"]], "bson_iter_bool()": [[80, "bson-iter-bool"]], "bson_iter_code()": [[81, "bson-iter-code"]], "bson_iter_codewscope()": [[82, "bson-iter-codewscope"]], "bson_iter_date_time()": [[83, "bson-iter-date-time"]], "bson_iter_dbpointer()": [[84, "bson-iter-dbpointer"]], "bson_iter_decimal128()": [[85, "bson-iter-decimal128"]], "bson_iter_document()": [[86, "bson-iter-document"]], "bson_iter_double()": [[87, "bson-iter-double"]], "bson_iter_dup_utf8()": [[88, "bson-iter-dup-utf8"]], "bson_iter_find()": [[89, "bson-iter-find"]], "bson_iter_find_case()": [[90, "bson-iter-find-case"]], "bson_iter_find_descendant()": [[91, "bson-iter-find-descendant"]], "bson_iter_find_w_len()": [[92, "bson-iter-find-w-len"]], "bson_iter_init()": [[93, "bson-iter-init"]], "bson_iter_init_find()": [[94, "bson-iter-init-find"]], "bson_iter_init_find_case()": [[95, "bson-iter-init-find-case"]], "bson_iter_init_find_w_len()": [[96, "bson-iter-init-find-w-len"]], "bson_iter_init_from_data()": [[97, "bson-iter-init-from-data"]], "bson_iter_init_from_data_at_offset()": [[98, "bson-iter-init-from-data-at-offset"]], "bson_iter_int32()": [[99, "bson-iter-int32"]], "bson_iter_int64()": [[100, "bson-iter-int64"]], "bson_iter_key()": [[101, "bson-iter-key"]], "bson_iter_key_len()": [[102, "bson-iter-key-len"]], "bson_iter_next()": [[103, "bson-iter-next"]], "bson_iter_offset()": [[104, "bson-iter-offset"]], "bson_iter_oid()": [[105, "bson-iter-oid"]], "bson_iter_overwrite_bool()": [[106, "bson-iter-overwrite-bool"]], "bson_iter_overwrite_date_time()": [[107, "bson-iter-overwrite-date-time"]], "bson_iter_overwrite_decimal128()": [[108, "bson-iter-overwrite-decimal128"]], "bson_iter_overwrite_double()": [[109, "bson-iter-overwrite-double"]], "bson_iter_overwrite_int32()": [[110, "bson-iter-overwrite-int32"]], "bson_iter_overwrite_int64()": [[111, "bson-iter-overwrite-int64"]], "bson_iter_overwrite_oid()": [[112, "bson-iter-overwrite-oid"]], "bson_iter_overwrite_timestamp()": [[113, "bson-iter-overwrite-timestamp"]], "bson_iter_recurse()": [[114, "bson-iter-recurse"]], "bson_iter_regex()": [[115, "bson-iter-regex"]], "bson_iter_symbol()": [[116, "bson-iter-symbol"]], "bson_iter_t": [[117, "bson-iter-t"]], "Examples": [[117, "examples"], [232, "examples"]], "bson_iter_time_t()": [[118, "bson-iter-time-t"]], "bson_iter_timestamp()": [[119, "bson-iter-timestamp"]], "bson_iter_timeval()": [[120, "bson-iter-timeval"]], "bson_iter_type()": [[121, "bson-iter-type"]], "bson_iter_utf8()": [[122, "bson-iter-utf8"]], "bson_iter_value()": [[123, "bson-iter-value"]], "bson_iter_visit_all()": [[124, "bson-iter-visit-all"]], "bson_json_data_reader_ingest()": [[125, "bson-json-data-reader-ingest"]], "bson_json_data_reader_new()": [[126, "bson-json-data-reader-new"]], "bson_json_mode_t": [[127, "bson-json-mode-t"]], "bson_json_opts_destroy()": [[128, "bson-json-opts-destroy"]], "bson_json_opts_new()": [[129, "bson-json-opts-new"]], "bson_json_opts_set_outermost_array()": [[130, "bson-json-opts-set-outermost-array"]], "bson_json_opts_t": [[131, "bson-json-opts-t"]], "bson_json_reader_destroy()": [[132, "bson-json-reader-destroy"]], "bson_json_reader_new()": [[133, "bson-json-reader-new"]], "bson_json_reader_new_from_fd()": [[134, "bson-json-reader-new-from-fd"]], "bson_json_reader_new_from_file()": [[135, "bson-json-reader-new-from-file"]], "bson_json_reader_read()": [[136, "bson-json-reader-read"]], "bson_json_reader_t": [[137, "bson-json-reader-t"]], "bson_malloc()": [[138, "bson-malloc"]], "bson_malloc0()": [[139, "bson-malloc0"]], "bson_mem_restore_vtable()": [[140, "bson-mem-restore-vtable"]], "bson_mem_set_vtable()": [[141, "bson-mem-set-vtable"]], "Memory Management": [[142, "memory-management"]], "bson_new()": [[143, "bson-new"]], "bson_new_from_buffer()": [[144, "bson-new-from-buffer"]], "bson_new_from_data()": [[145, "bson-new-from-data"]], "bson_new_from_json()": [[146, "bson-new-from-json"]], "bson_oid_compare()": [[147, "bson-oid-compare"]], "bson_oid_copy()": [[148, "bson-oid-copy"]], "bson_oid_equal()": [[149, "bson-oid-equal"]], "bson_oid_get_time_t()": [[150, "bson-oid-get-time-t"]], "bson_oid_hash()": [[151, "bson-oid-hash"]], "bson_oid_init()": [[152, "bson-oid-init"]], "bson_oid_init_from_data()": [[153, "bson-oid-init-from-data"]], "bson_oid_init_from_string()": [[154, "bson-oid-init-from-string"]], "bson_oid_init_sequence()": [[155, "bson-oid-init-sequence"]], "bson_oid_is_valid()": [[156, "bson-oid-is-valid"]], "bson_oid_t": [[157, "bson-oid-t"]], "String Conversion": [[157, "string-conversion"]], "Hashing": [[157, "hashing"]], "Comparing": [[157, "comparing"]], "Validating": [[157, "validating"]], "bson_oid_to_string()": [[158, "bson-oid-to-string"]], "bson_reader_destroy()": [[159, "bson-reader-destroy"]], "bson_reader_destroy_func_t": [[160, "bson-reader-destroy-func-t"]], "bson_reader_new_from_data()": [[161, "bson-reader-new-from-data"]], "bson_reader_new_from_fd()": [[162, "bson-reader-new-from-fd"]], "bson_reader_new_from_file()": [[163, "bson-reader-new-from-file"]], "bson_reader_new_from_handle()": [[164, "bson-reader-new-from-handle"]], "bson_reader_read()": [[165, "bson-reader-read"]], "bson_reader_read_func_t": [[166, "bson-reader-read-func-t"]], "bson_reader_reset()": [[167, "bson-reader-reset"]], "bson_reader_set_destroy_func()": [[168, "bson-reader-set-destroy-func"]], "bson_reader_set_read_func()": [[169, "bson-reader-set-read-func"]], "bson_reader_t": [[170, "bson-reader-t"]], "bson_reader_tell()": [[171, "bson-reader-tell"]], "bson_realloc()": [[172, "bson-realloc"]], "bson_realloc_ctx()": [[173, "bson-realloc-ctx"]], "bson_realloc_func": [[174, "bson-realloc-func"]], "bson_reinit()": [[175, "bson-reinit"]], "bson_reserve_buffer()": [[176, "bson-reserve-buffer"]], "bson_set_error()": [[177, "bson-set-error"]], "bson_sized_new()": [[178, "bson-sized-new"]], "bson_snprintf()": [[179, "bson-snprintf"]], "bson_steal()": [[180, "bson-steal"]], "bson_strcasecmp()": [[181, "bson-strcasecmp"]], "bson_strdup()": [[182, "bson-strdup"]], "bson_strdup_printf()": [[183, "bson-strdup-printf"]], "bson_strdupv_printf()": [[184, "bson-strdupv-printf"]], "bson_strerror_r()": [[185, "bson-strerror-r"]], "bson_strfreev()": [[186, "bson-strfreev"]], "bson_string_append()": [[187, "bson-string-append"]], "bson_string_append_c()": [[188, "bson-string-append-c"]], "bson_string_append_printf()": [[189, "bson-string-append-printf"]], "bson_string_append_unichar()": [[190, "bson-string-append-unichar"]], "bson_string_free()": [[191, "bson-string-free"]], "bson_string_new()": [[192, "bson-string-new"]], "bson_string_t": [[193, "bson-string-t"]], "bson_string_truncate()": [[194, "bson-string-truncate"]], "bson_strncpy()": [[195, "bson-strncpy"]], "bson_strndup()": [[196, "bson-strndup"]], "bson_strnlen()": [[197, "bson-strnlen"]], "bson_subtype_t": [[198, "bson-subtype-t"]], "bson_t": [[199, "bson-t"]], "Performance Notes": [[199, "performance-notes"]], "Duplicate Keys": [[199, "duplicate-keys"]], "bson_type_t": [[200, "bson-type-t"]], "bson_uint32_to_string()": [[201, "bson-uint32-to-string"]], "Array Element Key Building": [[201, "array-element-key-building"]], "bson_unichar_t": [[202, "bson-unichar-t"]], "bson_utf8_escape_for_json()": [[203, "bson-utf8-escape-for-json"]], "bson_utf8_from_unichar()": [[204, "bson-utf8-from-unichar"]], "bson_utf8_get_char()": [[205, "bson-utf8-get-char"]], "bson_utf8_next_char()": [[206, "bson-utf8-next-char"]], "bson_utf8_validate()": [[207, "bson-utf8-validate"]], "bson_validate()": [[208, "bson-validate"]], "bson_validate_with_error()": [[209, "bson-validate-with-error"]], "bson_value_copy()": [[210, "bson-value-copy"]], "bson_value_destroy()": [[211, "bson-value-destroy"]], "bson_value_t": [[212, "bson-value-t"]], "bson_visitor_t": [[213, "bson-visitor-t"]], "Basic Example": [[213, "basic-example"]], "Example Corruption Check": [[213, "example-corruption-check"]], "Example Custom Validation": [[213, "example-custom-validation"]], "bson_vsnprintf()": [[214, "bson-vsnprintf"]], "bson_writer_begin()": [[215, "bson-writer-begin"]], "bson_writer_destroy()": [[216, "bson-writer-destroy"]], "bson_writer_end()": [[217, "bson-writer-end"]], "bson_writer_get_length()": [[218, "bson-writer-get-length"]], "bson_writer_new()": [[219, "bson-writer-new"]], "bson_writer_rollback()": [[220, "bson-writer-rollback"]], "bson_writer_t": [[221, "bson-writer-t"]], "bson_zero_free()": [[222, "bson-zero-free"]], "Character and String Routines": [[223, "character-and-string-routines"]], "Creating a BSON Document": [[224, "creating-a-bson-document"]], "The bson_t structure": [[224, "the-bson-t-structure"]], "Sub-Documents and Sub-Arrays": [[224, "sub-documents-and-sub-arrays"]], "Simplified BSON C Object Notation": [[224, "simplified-bson-c-object-notation"]], "Cross Platform Notes": [[225, "cross-platform-notes"]], "Endianness": [[226, "endianness"]], "Handling Errors": [[227, "handling-errors"]], "Index": [[228, "index"]], "Guides": [[229, "guides"]], "Using libbson In Your C Program": [[230, "using-libbson-in-your-c-program"]], "Include bson.h": [[230, "include-bson-h"]], "CMake": [[230, "cmake"]], "pkg-config": [[230, "pkg-config"]], "libbson": [[231, "libbson"]], "Introduction": [[231, "introduction"]], "JSON": [[232, "json"]], "Converting BSON to JSON": [[232, "converting-bson-to-json"]], "Converting JSON to BSON": [[232, "converting-json-to-bson"]], "Streaming JSON Parsing": [[232, "streaming-json-parsing"]], "ObjectIDs": [[233, "objectids"]], "Composition": [[233, "composition"]], "Sorting ObjectIDs": [[233, "sorting-objectids"]], "Comparing Object IDs": [[233, "comparing-object-ids"]], "Generating": [[233, "generating"]], "Parsing ObjectID Strings": [[233, "parsing-objectid-strings"]], "Hashing ObjectIDs": [[233, "hashing-objectids"]], "Fetching ObjectID Creation Time": [[233, "fetching-objectid-creation-time"]], "Parsing and Iterating BSON Documents": [[234, "parsing-and-iterating-bson-documents"]], "Parsing": [[234, "parsing"]], "Recursing into Sub-Documents": [[234, "recursing-into-sub-documents"]], "Finding Fields using Dot Notation": [[234, "finding-fields-using-dot-notation"]], "Validating a BSON Document": [[234, "validating-a-bson-document"]], "Streaming BSON": [[235, "streaming-bson"]], "Reading from a BSON Stream": [[235, "reading-from-a-bson-stream"]], "Writing a sequence of BSON Documents": [[235, "writing-a-sequence-of-bson-documents"]], "Threading": [[236, "threading"]], "Tutorial": [[237, "tutorial"]], "UTF-8": [[238, "utf-8"]], "Encoding": [[238, "encoding"]], "Validating a UTF-8 Sequence": [[238, "validating-a-utf-8-sequence"]], "Libbson Versioning": [[239, "libbson-versioning"]], "Macros": [[239, "macros"]]}, "indexentries": {}}) \ No newline at end of file diff --git a/libbson/1.24.0/streaming-bson.html b/libbson/1.24.0/streaming-bson.html new file mode 100644 index 0000000000000000000000000000000000000000..f8cfe751981e70ad8678d09312ca7a7f5f664749 --- /dev/null +++ b/libbson/1.24.0/streaming-bson.html @@ -0,0 +1,196 @@ + + + + + + + + + + + + + + Streaming BSON — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Streaming BSON

    +

    bson_reader_t provides a streaming reader which can be initialized with a filedescriptor or memory region. bson_writer_t provides a streaming writer which can be initialized with a memory region. (Streaming BSON to a file descriptor is not yet supported.)

    +
    +

    Reading from a BSON Stream

    +

    bson_reader_t provides a convenient API to read sequential BSON documents from a file-descriptor or memory buffer. The bson_reader_read() function will read forward in the underlying stream and return a bson_t that can be inspected and iterated upon.

    +
    #include <stdio.h>
    +#include <bson/bson.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_reader_t *reader;
    +   const bson_t *doc;
    +   bson_error_t error;
    +   bool eof;
    +
    +   reader = bson_reader_new_from_file ("mycollection.bson", &error);
    +
    +   if (!reader) {
    +      fprintf (stderr, "Failed to open file.\n");
    +      return 1;
    +   }
    +
    +   while ((doc = bson_reader_read (reader, &eof))) {
    +      char *str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (!eof) {
    +      fprintf (stderr,
    +               "corrupted bson document found at %u\n",
    +               (unsigned) bson_reader_tell (reader));
    +   }
    +
    +   bson_reader_destroy (reader);
    +
    +   return 0;
    +}
    +
    +
    +

    See bson_reader_new_from_fd(), bson_reader_new_from_file(), and bson_reader_new_from_data() for more information.

    +
    +
    +

    Writing a sequence of BSON Documents

    +

    bson_writer_t provides a convenient API to write a sequence of BSON documents to a memory buffer that can grow with realloc(). The bson_writer_begin() and bson_writer_end() functions will manage the underlying buffer while building the sequence of documents.

    +

    This could also be useful if you want to write to a network packet while serializing the documents from a higher level language, (but do so just after the packets header).

    +
    #include <stdio.h>
    +#include <bson/bson.h>
    +#include <assert.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_writer_t *writer;
    +   bson_t *doc;
    +   uint8_t *buf = NULL;
    +   size_t buflen = 0;
    +   bool r;
    +   int i;
    +
    +   writer = bson_writer_new (&buf, &buflen, 0, bson_realloc_ctx, NULL);
    +
    +   for (i = 0; i < 10000; i++) {
    +      r = bson_writer_begin (writer, &doc);
    +      assert (r);
    +
    +      r = BSON_APPEND_INT32 (doc, "i", i);
    +      assert (r);
    +
    +      bson_writer_end (writer);
    +   }
    +
    +   bson_free (buf);
    +
    +   return 0;
    +}
    +
    +
    +

    See bson_writer_new() for more information.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/threading.html b/libbson/1.24.0/threading.html new file mode 100644 index 0000000000000000000000000000000000000000..33430a94692202686cf74c64a68d55435b50b8f2 --- /dev/null +++ b/libbson/1.24.0/threading.html @@ -0,0 +1,118 @@ + + + + + + + + + + + + + + Threading — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Threading

    +

    Libbson’s data structures are NOT thread-safe. You are responsible for accessing and mutating these structures from one thread at a time.

    +

    Libbson requires POSIX threads (pthreads) on all UNIX-like platforms. On Windows, the native threading interface is used. Libbson uses your system’s threading library to safely generate unique ObjectIds, and to provide a fallback implementation for atomic operations on platforms without built-in atomics.

    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/tutorial.html b/libbson/1.24.0/tutorial.html new file mode 100644 index 0000000000000000000000000000000000000000..5d115804f04a7ed5b31275d1099db80adcb6e07a --- /dev/null +++ b/libbson/1.24.0/tutorial.html @@ -0,0 +1,129 @@ + + + + + + + + + + + + + + Tutorial — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libbson/1.24.0/utf8.html b/libbson/1.24.0/utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..3f78519cdc8e221203592e5b906c09abf6a99ccc --- /dev/null +++ b/libbson/1.24.0/utf8.html @@ -0,0 +1,141 @@ + + + + + + + + + + + + + + UTF-8 — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    UTF-8

    +
    +

    Encoding

    +

    Libbson expects that you are always working with UTF-8 encoded text. Anything else is invalid API use.

    +

    If you should need to walk through UTF-8 sequences, you can use the various UTF-8 helper functions distributed with Libbson.

    +
    +
    +

    Validating a UTF-8 Sequence

    +

    To validate the string contained in my_string, use the following. You may pass -1 for the string length if you know the string is NULL-terminated.

    +
    if (!bson_utf8_validate (my_string, -1, false)) {
    +   printf ("Validation failed.\n");
    +}
    +
    +
    +

    If my_string has NULL bytes within the string, you must provide the string length. Use the following format. Notice the true at the end indicating \0 is allowed.

    +
    if (!bson_utf8_validate (my_string, my_string_len, true)) {
    +   printf ("Validation failed.\n");
    +}
    +
    +
    +

    For more information see the API reference for bson_utf8_validate().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/1.24.0/version.html b/libbson/1.24.0/version.html new file mode 100644 index 0000000000000000000000000000000000000000..6c5584ed01894607a59498e0db4dab7eeea43a84 --- /dev/null +++ b/libbson/1.24.0/version.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + Libbson Versioning — libbson 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Libbson Versioning

    +

    Versioning Macros and Functions

    +
    +

    Macros

    +

    The following preprocessor macros can be used to perform various checks based on the version of the library you are compiling against. This may be useful if you only want to enable a feature on a certain version of the library.

    +
    +
    +

    Synopsis

    +
    #define BSON_CHECK_VERSION(major, minor, micro)
    +
    +#define BSON_MAJOR_VERSION (1)
    +#define BSON_MINOR_VERSION (4)
    +#define BSON_MICRO_VERSION (1)
    +#define BSON_VERSION_S "1.4.1"
    +
    +#define BSON_VERSION_HEX                                  \
    +   (BSON_MAJOR_VERSION << 24 | BSON_MINOR_VERSION << 16 | \
    +    BSON_MICRO_VERSION << 8)
    +
    +
    +

    Only compile a block on Libbson 1.1.0 and newer.

    +
    #if BSON_CHECK_VERSION(1, 1, 0)
    +static void
    +do_something (void)
    +{
    +}
    +#endif
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libbson/current b/libbson/current index c7b21462fc8b9ce00826ee2d8a6b03cdb9ad0bea..d4370468344bcbc6fc43f88fa92bf0d4bd4c7a0a 120000 --- a/libbson/current +++ b/libbson/current @@ -1 +1 @@ -1.23.5 \ No newline at end of file +1.24.0 \ No newline at end of file diff --git a/libbson/index.html b/libbson/index.html index f1a908a5f8c3900671e97ea1a5c19b15bcce6fc7..ab91265ddc78c27fc2f36bd7a2004b96083cbc03 100644 --- a/libbson/index.html +++ b/libbson/index.html @@ -21,7 +21,7 @@ delighted.survey(); - libbson Releases — MongoDB C Driver 1.23.5 + libbson Releases — MongoDB C Driver 1.24.0 @@ -48,7 +48,7 @@
  • previous
  • - +
    @@ -58,103 +58,104 @@

    libbson Releases

    -

    Latest Release (1.23.5)

    +

    Latest Release (1.24.0)

    Current Development (master)

    diff --git a/libmongoc-releases.html b/libmongoc-releases.html index 5f9f06b5709950f266b14004cd115e3a79b9be46..7d1b95382198a5b26580591674a0b6f653442f43 100644 --- a/libmongoc-releases.html +++ b/libmongoc-releases.html @@ -21,7 +21,7 @@ delighted.survey(); - libmongoc Releases — MongoDB C Driver 1.23.5 + libmongoc Releases — MongoDB C Driver 1.24.0 @@ -52,7 +52,7 @@
  • previous |
  • - + @@ -62,104 +62,105 @@

    libmongoc Releases

    -

    Latest Release (1.23.5)

    +

    Latest Release (1.24.0)

    Current Development (master)

    diff --git a/libmongoc/1.23.5/advanced-connections.html b/libmongoc/1.23.5/advanced-connections.html index 14bf41283be23464a9376f08a7350ed95559b267..a144b8f9256b8589add802f5bde4ba4198b4c779 100644 --- a/libmongoc/1.23.5/advanced-connections.html +++ b/libmongoc/1.23.5/advanced-connections.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/aggregate.html b/libmongoc/1.23.5/aggregate.html index f4ff3a7949802209dac9f775b9a2df19b6f4566e..0b8aa85b703a66e2d9328b3bc041c7e79ef61a5a 100644 --- a/libmongoc/1.23.5/aggregate.html +++ b/libmongoc/1.23.5/aggregate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/api.html b/libmongoc/1.23.5/api.html index f39dd392cd203f895d9d3410da5c5cec5e99733e..777bf8870b168edb20a2031ae81bd8b9cf08a2c8 100644 --- a/libmongoc/1.23.5/api.html +++ b/libmongoc/1.23.5/api.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/application-performance-monitoring.html b/libmongoc/1.23.5/application-performance-monitoring.html index 5f533925b06a9ba4ebab428f27a233c99bb2c7c7..0dfa255b72496adcd92e811856999bfa1cdec091 100644 --- a/libmongoc/1.23.5/application-performance-monitoring.html +++ b/libmongoc/1.23.5/application-performance-monitoring.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/authentication.html b/libmongoc/1.23.5/authentication.html index b2893e1fcb8aca02fc62bfbddc58bd2b62bb1e65..c83a2024076ec3b0a8d63fe5b17da41918bc0e58 100644 --- a/libmongoc/1.23.5/authentication.html +++ b/libmongoc/1.23.5/authentication.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/basic-troubleshooting.html b/libmongoc/1.23.5/basic-troubleshooting.html index 7c6645227a782396fe4680ee94afa9ca17eaee50..b89446cc5d266b6b5b2888c28d0e4182b79ac49e 100644 --- a/libmongoc/1.23.5/basic-troubleshooting.html +++ b/libmongoc/1.23.5/basic-troubleshooting.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/bulk.html b/libmongoc/1.23.5/bulk.html index 1d53b6ca9dc13725967931a268c7680e14374920..806c2644b7f9159b19805f3794335c1fadf0d71f 100644 --- a/libmongoc/1.23.5/bulk.html +++ b/libmongoc/1.23.5/bulk.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/configuring_tls.html b/libmongoc/1.23.5/configuring_tls.html index 666cf11d72c55d3e1553b4ee0727bf87672cbead..dee8f296bcf2204a5451c8a4bb2fe8d75e7c9e44 100644 --- a/libmongoc/1.23.5/configuring_tls.html +++ b/libmongoc/1.23.5/configuring_tls.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/connection-pooling.html b/libmongoc/1.23.5/connection-pooling.html index a35c949e5c938c1106d889a1dc92fec857f2a2a5..4ab3a67e072753a621881237ba4c72bcb315f59d 100644 --- a/libmongoc/1.23.5/connection-pooling.html +++ b/libmongoc/1.23.5/connection-pooling.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/create-indexes.html b/libmongoc/1.23.5/create-indexes.html index a84afacbdbda92be8a72e0e03d8297e6703234d0..2154649a270e80940962825156cdea991a3c7b46 100644 --- a/libmongoc/1.23.5/create-indexes.html +++ b/libmongoc/1.23.5/create-indexes.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/cursors.html b/libmongoc/1.23.5/cursors.html index 98ff20516433702eaf01994a0312f9d314ff9357..0cf2ba5c90f12c6769f6dc96528332ef2d4a07aa 100644 --- a/libmongoc/1.23.5/cursors.html +++ b/libmongoc/1.23.5/cursors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/debugging.html b/libmongoc/1.23.5/debugging.html index 71400b6f844d6492aafb2f6edfdae06cc3b60fa1..3161376623f6ff18df9d7c38ffb4e1946c291bb5 100644 --- a/libmongoc/1.23.5/debugging.html +++ b/libmongoc/1.23.5/debugging.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/distinct-mapreduce.html b/libmongoc/1.23.5/distinct-mapreduce.html index 70e1474ebe5149619d51051c5f25b84ceea8cc70..657d6bd9c0214a60a5e1140ca07e8a6ff53628ea 100644 --- a/libmongoc/1.23.5/distinct-mapreduce.html +++ b/libmongoc/1.23.5/distinct-mapreduce.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/errors.html b/libmongoc/1.23.5/errors.html index 02dfd63a089d853081fbd367972d2356157df7ab..7dbe4045679f5126dfb37aa411e0d92a464ad7d4 100644 --- a/libmongoc/1.23.5/errors.html +++ b/libmongoc/1.23.5/errors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/full_index.html b/libmongoc/1.23.5/full_index.html index d132103c05cf7081f0ce02f271a679a6b41a5947..a6112427ee3dc2a51c3f6ea352d4e15cbe8cd733 100644 --- a/libmongoc/1.23.5/full_index.html +++ b/libmongoc/1.23.5/full_index.html @@ -38,6 +38,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/gridfs.html b/libmongoc/1.23.5/gridfs.html index 5e5506feea665b941f7bed86b8027cb7538006a6..de6fb45cc315c05bcde92ee04db414047236ee10 100644 --- a/libmongoc/1.23.5/gridfs.html +++ b/libmongoc/1.23.5/gridfs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/guides.html b/libmongoc/1.23.5/guides.html index 712c46a151deb363f47dc742264fb1dde06c81ff..45b3c2cadb8c3bfa8959b7feab5044ba70bbf878 100644 --- a/libmongoc/1.23.5/guides.html +++ b/libmongoc/1.23.5/guides.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/index.html b/libmongoc/1.23.5/index.html index 8aa2fd094b32d42a1a76daab9ef38fbc7a7178f9..a1153e0d3db84eb816865dc196a3f1c8e4f53588 100644 --- a/libmongoc/1.23.5/index.html +++ b/libmongoc/1.23.5/index.html @@ -39,6 +39,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/init-cleanup.html b/libmongoc/1.23.5/init-cleanup.html index 16ccd53939e3e47a0eba29778dbb8cd1b304327d..d33aa1b53c7f3c130384be240388a8d7d85b0491 100644 --- a/libmongoc/1.23.5/init-cleanup.html +++ b/libmongoc/1.23.5/init-cleanup.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/installing.html b/libmongoc/1.23.5/installing.html index 5354f417b1a8a810095a245675dcbfa322fd602f..b8769fa5387319052d0139c4edd7db5e97d6dea2 100644 --- a/libmongoc/1.23.5/installing.html +++ b/libmongoc/1.23.5/installing.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/lifecycle.html b/libmongoc/1.23.5/lifecycle.html index 59e62b89857472ddcb64b3a2aeb5239439d46c98..42fb63ebfea98a0755967ec318eb8d014a7261ce 100644 --- a/libmongoc/1.23.5/lifecycle.html +++ b/libmongoc/1.23.5/lifecycle.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/logging.html b/libmongoc/1.23.5/logging.html index c5ab1fbdb34f7824922836251b5897d26cba80fe..5077e81aec736f8260f20f9c506bc4cae986e2b3 100644 --- a/libmongoc/1.23.5/logging.html +++ b/libmongoc/1.23.5/logging.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/matcher.html b/libmongoc/1.23.5/matcher.html index 529948b91d21f6931ccd52adced87c95ae5510b9..c735eea3ece316bdd6f1935d88585ae2833c524e 100644 --- a/libmongoc/1.23.5/matcher.html +++ b/libmongoc/1.23.5/matcher.html @@ -38,6 +38,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc-common-task-examples.html b/libmongoc/1.23.5/mongoc-common-task-examples.html index 06f8d7b9f5dd28c836b65f2742e1c02a06c3da64..7c0c06c835d79140421b46eb4db77b2d91a651d1 100644 --- a/libmongoc/1.23.5/mongoc-common-task-examples.html +++ b/libmongoc/1.23.5/mongoc-common-task-examples.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_callbacks_destroy.html b/libmongoc/1.23.5/mongoc_apm_callbacks_destroy.html index 6bc319cebef156b2186a1caa3c58de34ebd410e0..3ef8f26ef1aea8bbd7a52c056fef85fdc9f5aa7b 100644 --- a/libmongoc/1.23.5/mongoc_apm_callbacks_destroy.html +++ b/libmongoc/1.23.5/mongoc_apm_callbacks_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_callbacks_new.html b/libmongoc/1.23.5/mongoc_apm_callbacks_new.html index 27f9eeb3bd62eec6bde4cde1520aaf78d0d52274..45486d37efa1481386039826903d9ac41e97a8ee 100644 --- a/libmongoc/1.23.5/mongoc_apm_callbacks_new.html +++ b/libmongoc/1.23.5/mongoc_apm_callbacks_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_callbacks_t.html b/libmongoc/1.23.5/mongoc_apm_callbacks_t.html index d2cd50b6e460eb5049af37ade05e733d1ac65af8..f47cdb65ff765b222d86d91167ea66620146dda0 100644 --- a/libmongoc/1.23.5/mongoc_apm_callbacks_t.html +++ b/libmongoc/1.23.5/mongoc_apm_callbacks_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_command_name.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_command_name.html index d5ee9a61b624a7ab0e1732bcfa20c2e482d5c662..f9792d4536c8a5a6d910ea30e40108fc90d917ee 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_command_name.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_command_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_context.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_context.html index e93c278738e7de373dcd23a50b4aea1b845b1fff..3c2b36074a55a3c0b4d4140fbb68cbf3cc3129b3 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_duration.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_duration.html index b37882711dc68edd41c65ef536c8e929e68c14fd..535267e34fb87b004bfa108cb2abe773ea94954b 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_duration.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_duration.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_error.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_error.html index 19992348f3c5b0825b13d82cc740de2cfe67de1b..3c54d9586ed5119d20b342ad8415cb0b6367b529 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_error.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_host.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_host.html index e7812f334ba09ba643c3e4c610fa7ba7ab6f0942..ac520949f5931ffe98672dae1c54b302caba0636 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_operation_id.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_operation_id.html index f847f6b62bbdb46b79f54973e7afc175b4c5720b..1a62f28250ad4aa042b8fd6ee5c24466fc9c219b 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_operation_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_operation_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_reply.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_reply.html index 46dfe989702e6b80a64387fd0bf979bb1ca34f9c..391333255f5e94b175436b26443ff7b06606c9fe 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_reply.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_reply.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_request_id.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_request_id.html index 34e52cfac5ca34451f8173dfbdfc73cececdf2ad..2b373e84b4c3c679183e198702c7bfcb799d8756 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_request_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_request_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_connection_id.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_connection_id.html index 22cc91c4a478f9fa7af05336423b217610c80061..5c03be7985f0ab51b47103137dca0d0cc03e02a2 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_connection_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_connection_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_id.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_id.html index ce6e4b2f02472b2a8affc26b5215876f4e3e2666..37561ecd4def8b7f5318e7097ae567eb1c0486ae 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_server_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_get_service_id.html b/libmongoc/1.23.5/mongoc_apm_command_failed_get_service_id.html index 84272431906e478a1d71676d2ac1b68001ecfefd..41580809795b041b323e65d6e79870efbcdd9017 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_get_service_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_get_service_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_failed_t.html b/libmongoc/1.23.5/mongoc_apm_command_failed_t.html index 6b2b9ed3c40f740360053a96b9be00bfcd874b4d..60c737983b35f04004dd45dc75241ffcf88377da 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_failed_t.html +++ b/libmongoc/1.23.5/mongoc_apm_command_failed_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_command.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_command.html index 73f4ac54bddca0d508036d27134aa640432788fa..df121bebd78460d29f27186a9d5787985a424b52 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_command.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_command.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_command_name.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_command_name.html index df75354a3114664dff1641bf05f27a882462bdd0..50ce8df9188fbdb8c978afa7a4305db0dc2b1c2f 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_command_name.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_command_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_context.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_context.html index 3b82369eeda10fa41bc533bee4b8b13007190e6d..ad692e51ff9ba9030a0cf2f3916b4f282cc7deb5 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_database_name.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_database_name.html index b97f7cac3af7e0566700f8f3d0a3aae37433e084..d310a56f843ac8201076201bda344c4cad7d2450 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_database_name.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_database_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_host.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_host.html index a63ade9020206173947b8c8d6d320067ad9b2b0a..6fc967b033ea42cf91b8bb1a43ef49788e41817f 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_operation_id.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_operation_id.html index 71ec5ab814f0cd95987340e1d3c81e4115706d7d..d530fe30263be2795ad98e23cf7183ad832bfd68 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_operation_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_operation_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_request_id.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_request_id.html index 64f1afbb3836ade83c1c2cff25999aa1ac146c20..2b691a8a1d2a068f5e6101caa7aeba3d453c8709 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_request_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_request_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_server_connection_id.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_server_connection_id.html index ccbafaf3da12c4f90ce420eaf0310d2407327149..c37f1cf6763a588ffae6a54e72df598b25bece32 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_server_connection_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_server_connection_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_server_id.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_server_id.html index 9617f0971922aa718b0167448c432e2b39f2b59d..a111fdd35dc5a8778743dd1fa05b4ddb4e419537 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_server_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_server_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_get_service_id.html b/libmongoc/1.23.5/mongoc_apm_command_started_get_service_id.html index 537957ba58e4f8020946baf7a285fceee7b28b7b..022a04405eb5c58902c6a30c3656700242343011 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_get_service_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_get_service_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_started_t.html b/libmongoc/1.23.5/mongoc_apm_command_started_t.html index 38072d8129118474195b4832379ae366fb3d2cf5..e88152f0633283d73796cd6df18699cf9a293709 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_started_t.html +++ b/libmongoc/1.23.5/mongoc_apm_command_started_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_command_name.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_command_name.html index dafb08c0a610718c338907ab7b201c1473c4c7e8..41fe106db30dc965a2eed2498938ce242ff3cd20 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_command_name.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_command_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_context.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_context.html index ca82e7fb1006a0eab557a8b5510d29414813da07..b18f6c9d2988931449b4425e3529ce68d22d8f2f 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_duration.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_duration.html index 09888cdf49fbf7b081c85006cd4f5acd7dc92520..c6f1fb6a04fdf970c34aeaa74fd0ae28517e240b 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_duration.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_duration.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_host.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_host.html index ab9ec39293cb3cd168fd2465bcd817fac583a194..5cfbbd1c43cd097233b59fafdc497b835dadeafe 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_operation_id.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_operation_id.html index 7d384fa1cfbb641dc46c48a5ce9f5b0b4fa856ad..8bc2daa8971da280036d709de450054ec90c65f1 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_operation_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_operation_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_reply.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_reply.html index b3e97fe0ba778ef7b0fe510553b0c251477116ca..7af5dc65f09c492d27f711702fa8b402e5f5cbd5 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_reply.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_reply.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_request_id.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_request_id.html index bb18e4392171fba74dc752abc299d8034b68a50b..01a3f80ed8b287acc12b3f051651bc5a56208b0d 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_request_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_request_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_connection_id.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_connection_id.html index 45cff2adb417987ad0375adbf1d0914c4536bcb0..418c37db81f7e2fb48ab14f5db555966b9cef722 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_connection_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_connection_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_id.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_id.html index 983334f489df9be682a2d674a9911ee42a977700..40ae83871c7675453ab4d7fdf5970c5063e5a00f 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_server_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_service_id.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_service_id.html index 7bf4fa75132811431b16f841c337f196d24fed8a..d5595efc6116ea338f07cb1b322bd414f75e9ea8 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_service_id.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_get_service_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_command_succeeded_t.html b/libmongoc/1.23.5/mongoc_apm_command_succeeded_t.html index f7acc5cd30b70b9d85f09da5bd5e814ae887ed06..861c9bec9dbda328d3186a81ecb56a124996f5dc 100644 --- a/libmongoc/1.23.5/mongoc_apm_command_succeeded_t.html +++ b/libmongoc/1.23.5/mongoc_apm_command_succeeded_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_changed_get_context.html b/libmongoc/1.23.5/mongoc_apm_server_changed_get_context.html index 104d92709a4f218b7eb7f89f81c21018bb59fcb1..828beacca2d60841154598d7cb3da8ea0c13a038 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_changed_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_server_changed_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_changed_get_host.html b/libmongoc/1.23.5/mongoc_apm_server_changed_get_host.html index d212d6864ce73f7bad3db55af647a5a9e01059b2..629cfe927c2ff10a52d9ad9a3fc34a9aff2b6a14 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_changed_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_server_changed_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_changed_get_new_description.html b/libmongoc/1.23.5/mongoc_apm_server_changed_get_new_description.html index 1b4c81bcc793fccb6e20b8783c4e8b8fd1df55ae..72968c3c2896c40661f89691a5d884b3d459a8ec 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_changed_get_new_description.html +++ b/libmongoc/1.23.5/mongoc_apm_server_changed_get_new_description.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_changed_get_previous_description.html b/libmongoc/1.23.5/mongoc_apm_server_changed_get_previous_description.html index cb010f2d4af0bd2e8627d511847dc9320980e294..b8281a817d38a7ecad4908c58663c13d41880fae 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_changed_get_previous_description.html +++ b/libmongoc/1.23.5/mongoc_apm_server_changed_get_previous_description.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_changed_get_topology_id.html b/libmongoc/1.23.5/mongoc_apm_server_changed_get_topology_id.html index 0e381dbd0be76991dfbc2b2c1c5b168e98de14a3..5c93ee6cd1e3f71e50827c2733ce981250723abd 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_changed_get_topology_id.html +++ b/libmongoc/1.23.5/mongoc_apm_server_changed_get_topology_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_changed_t.html b/libmongoc/1.23.5/mongoc_apm_server_changed_t.html index af2ef2a246284217aacfaf653776e466a1f1d462..7dc5230a1039b5a5774445f013560150fd94e115 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_changed_t.html +++ b/libmongoc/1.23.5/mongoc_apm_server_changed_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_closed_get_context.html b/libmongoc/1.23.5/mongoc_apm_server_closed_get_context.html index 83baa1a6e34e9b3e3b8d5b4c125fa0460a54530f..6af0fe4bd981e750a0a0687de62cdaa0b6054fce 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_closed_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_server_closed_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_closed_get_host.html b/libmongoc/1.23.5/mongoc_apm_server_closed_get_host.html index 747b5c9e1f3e937f867672d00073c0829b2ec093..3024cc9901f09e42475e214cd7a5b324fd6af825 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_closed_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_server_closed_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_closed_get_topology_id.html b/libmongoc/1.23.5/mongoc_apm_server_closed_get_topology_id.html index acb9f156ee696e4d3e9d7f4610c37bb138a4df30..83db9f8a9d8bed1ed80afa3eb1246fd46ef9a125 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_closed_get_topology_id.html +++ b/libmongoc/1.23.5/mongoc_apm_server_closed_get_topology_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_closed_t.html b/libmongoc/1.23.5/mongoc_apm_server_closed_t.html index 06a8bba948243dbc72cfa45d838b92bf576cb39c..db3897761723760bc8b8e11359901b48bccdbfcb 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_closed_t.html +++ b/libmongoc/1.23.5/mongoc_apm_server_closed_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_awaited.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_awaited.html index ba4768076dcafbc1678d2cc0b0f01d2ccc267de3..cd9703db2b1492d4cc08489035d629d2c7b76efa 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_awaited.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_awaited.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_context.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_context.html index 7d52899bb3b288c055226bcdcf17a3fc5cc3a9b2..2633d76ffd72190b2fac7ee8bb9224ee7a5acc8f 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_duration.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_duration.html index 9c0b24464cca1df8a226ddea161f90083a673a3a..38dfa652ca0e3bf61e0bd80c4e0d5f8e26f4bb37 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_duration.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_duration.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_error.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_error.html index ccc28694d8c8fbab289edea182ad3ce7154a6bd3..7e8dbb28a690a5738a43ac139e84dbd930420650 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_error.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_host.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_host.html index 4a736006250bc0b6af80ebd5aad0d2468197e6bc..e6710fd379dc2496b3a965987280b9c60e1ee28d 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_t.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_t.html index e14768081d6634711856c5e521ae8c3a18288a76..14fb6687ef4727268b10d19988bfdeaa33c300cb 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_t.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_failed_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_awaited.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_awaited.html index 39d10fc4623778121a7af89b2810790823f36f33..ceee9f482029784dead11baed9fec5a642106dea 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_awaited.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_awaited.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_context.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_context.html index aab502ef582353fe2aebef85f01e2129775f7c06..11efa325f8102ca0fb6d3c2b3341e5ef62e5cb79 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_host.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_host.html index 906023c7dde0fb917bb436ef0db81f1635f47e97..e5c9dc881d2ea9bdf9ed975c7df4eddea9c7dcde 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_t.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_t.html index 55f01921a0e34650f690e5d9b0ec0ce878f64425..4d4584708a81cd75d932e59dcc5995542b83b363 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_t.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_started_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_awaited.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_awaited.html index 02776dda0e368cead7bff7aa1bb249cbf3ba865c..5207b3d48f777dc15a0c10cf9c9e907cc1b7e556 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_awaited.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_awaited.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_context.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_context.html index 7bc411ba4826f3efdca56e2428370970aed2217a..5768c9bfbf18ee7e635405726e777a7c992e91c3 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_duration.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_duration.html index a5a8a91bdf22501bfc5658710a95566c9c5f7eeb..5f71a8499ae848b8ec68182272557d67e2bd665c 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_duration.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_duration.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_host.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_host.html index 5ebd44310cab0076ba64d61ad8191e8947523485..7b1f8f16fe93b5556cbb849881f635acfa1f0a8b 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_reply.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_reply.html index 6bbce54b99cc8fe919434c8656e8def801a272a1..baff325aa83a1ca40ea82fb4117a928e772a53fe 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_reply.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_get_reply.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_t.html b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_t.html index 8f52aebe40442f659bb7aea857b1f11a41905f62..c0bb84aa4921c37fe3864e839bb4a1f092739b36 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_t.html +++ b/libmongoc/1.23.5/mongoc_apm_server_heartbeat_succeeded_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_opening_get_context.html b/libmongoc/1.23.5/mongoc_apm_server_opening_get_context.html index 38ff989344f80b52f3ce61a1dad4dc58c673954b..a54a55b17c3d7a88de2bde72487fc7260be142f4 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_opening_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_server_opening_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_opening_get_host.html b/libmongoc/1.23.5/mongoc_apm_server_opening_get_host.html index fc57806a13f7d88560bc785c276fdd78f501d70b..71270319f93bcb358094a862b4da23b4a92b646d 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_opening_get_host.html +++ b/libmongoc/1.23.5/mongoc_apm_server_opening_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_opening_get_topology_id.html b/libmongoc/1.23.5/mongoc_apm_server_opening_get_topology_id.html index 8238d7e28a3ff1a9970d5b564b1c637271ce83ce..2259072352a6d44b1eee3a5baa3393cd73d23657 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_opening_get_topology_id.html +++ b/libmongoc/1.23.5/mongoc_apm_server_opening_get_topology_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_server_opening_t.html b/libmongoc/1.23.5/mongoc_apm_server_opening_t.html index fb33191ccd9d5bbe05d39b73a72703ef0db8dd2f..8f786471c0857c94290f74bdc3ea63ab36ccfbb1 100644 --- a/libmongoc/1.23.5/mongoc_apm_server_opening_t.html +++ b/libmongoc/1.23.5/mongoc_apm_server_opening_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_command_failed_cb.html b/libmongoc/1.23.5/mongoc_apm_set_command_failed_cb.html index 2146c72eaedad8df973901008f7944f125f832b2..f510506eafa4039b5d946eff9fe4866490874b66 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_command_failed_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_command_failed_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_command_started_cb.html b/libmongoc/1.23.5/mongoc_apm_set_command_started_cb.html index 2c4c07ece1ebb9b96837f9954939070d726248d1..c4c717200653028d9cfb9eaa8febccabc810f480 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_command_started_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_command_started_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_command_succeeded_cb.html b/libmongoc/1.23.5/mongoc_apm_set_command_succeeded_cb.html index e844db1f10ed864f7167077439b53820ae58db9e..b3b7a032a724d98f5f121c808ebca6d28f62bcf6 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_command_succeeded_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_command_succeeded_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_server_changed_cb.html b/libmongoc/1.23.5/mongoc_apm_set_server_changed_cb.html index b25a26553a9ba2b9dd8ddc36772fbb4015e507d5..f41cb8d76d442fc4a4a2bca9b6936a6c87eb8143 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_server_changed_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_server_changed_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_server_closed_cb.html b/libmongoc/1.23.5/mongoc_apm_set_server_closed_cb.html index d484a0dc07608243a286d065bcc2bbc77eaba7bd..811e2f298423dbf176b269b11a26f278f44c2eeb 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_server_closed_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_server_closed_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_failed_cb.html b/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_failed_cb.html index e3da39ab814f90e091c7aee373982684fdfd16e9..7ad11ed340cf19576c4de54864b5141b919e5161 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_failed_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_failed_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_started_cb.html b/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_started_cb.html index 77207c4f9f10a9da862ebdfa17937ca97523a5c2..66531595fcf8d267e1aa763986a4a5ddce29d6e7 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_started_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_started_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_succeeded_cb.html b/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_succeeded_cb.html index f9ec53b6fabc2ee956afd7688d1df3dab42bbf60..b56e04a083629c1ecf29e3f38096f7699ab0334a 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_succeeded_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_server_heartbeat_succeeded_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_server_opening_cb.html b/libmongoc/1.23.5/mongoc_apm_set_server_opening_cb.html index f19f6f84c2adc11b72be67053ea970af4b65160b..77f4fe8eb8ed8b5bb8fdcc321eb8aa559a408f9c 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_server_opening_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_server_opening_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_topology_changed_cb.html b/libmongoc/1.23.5/mongoc_apm_set_topology_changed_cb.html index d817ff858382632fc87f60ed48507bb716cee25d..cc778ca0c8c14ae3d439be0ad452c6285856c686 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_topology_changed_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_topology_changed_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_topology_closed_cb.html b/libmongoc/1.23.5/mongoc_apm_set_topology_closed_cb.html index a556641a9474fa2921f8dc0a931628722a1db49a..ec389d82026eeedd9e0044e31c3f0540a82c0347 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_topology_closed_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_topology_closed_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_set_topology_opening_cb.html b/libmongoc/1.23.5/mongoc_apm_set_topology_opening_cb.html index e117df60ba531617aa1e764820817ecb159f0c76..90b6af99fb880984015d1e07aef171efbb859d15 100644 --- a/libmongoc/1.23.5/mongoc_apm_set_topology_opening_cb.html +++ b/libmongoc/1.23.5/mongoc_apm_set_topology_opening_cb.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_context.html b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_context.html index b6191e18bd9bfba57cb6ffc235bd4dfe4f49eb73..4bb2e12e4540b93526708d9e1306a40d44b9b95b 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_new_description.html b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_new_description.html index 1f246e5b4127794a03767e69ec23ae26cec8df39..a4686750d08faf0fa56a12a94faa703aebcd508e 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_new_description.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_new_description.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_previous_description.html b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_previous_description.html index 6131ee2a2039a28c0ed79119e6a73556dc329d4b..15dcc14c68c6de824e118b2d66fe4e702174c0f6 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_previous_description.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_previous_description.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_topology_id.html b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_topology_id.html index d30688a55f1c54b619cab38eecbf4c9cda3c9f5d..86dd84cc89bc0f76ca209dfb3c02ed8a471bcb42 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_changed_get_topology_id.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_changed_get_topology_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_changed_t.html b/libmongoc/1.23.5/mongoc_apm_topology_changed_t.html index 0ae31b53f1a6e7f69912fc986d382b5d3444df33..93a611b7d524ebe77a8a20c7db243ab62f3b15e4 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_changed_t.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_changed_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_closed_get_context.html b/libmongoc/1.23.5/mongoc_apm_topology_closed_get_context.html index b251dda427cce81f2df2c78eb5ff0e2a77a60bbe..c20be859b2085c15aadef9ff134c511a916c5d2f 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_closed_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_closed_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_closed_get_topology_id.html b/libmongoc/1.23.5/mongoc_apm_topology_closed_get_topology_id.html index a2aa84f417f3224a6cd056e26a91b583b19b07b6..b529c85839e620720f78c8ad66294ef7caac3b68 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_closed_get_topology_id.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_closed_get_topology_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_closed_t.html b/libmongoc/1.23.5/mongoc_apm_topology_closed_t.html index 61686cc35834197b12048c8c6f120087045666a5..68e59b689a04a507f5e80e960cf71e42b64d5063 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_closed_t.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_closed_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_opening_get_context.html b/libmongoc/1.23.5/mongoc_apm_topology_opening_get_context.html index 192539d946e897aa70658ff05026add941d98698..2a83b4420e376a4863d8977d6dd46c0cfe717b51 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_opening_get_context.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_opening_get_context.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_opening_get_topology_id.html b/libmongoc/1.23.5/mongoc_apm_topology_opening_get_topology_id.html index 227dd1fc73566aa5c15b4146881704a8ddfa6922..8d9d76553541817333630065647909e3dfa203ef 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_opening_get_topology_id.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_opening_get_topology_id.html @@ -39,6 +39,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_apm_topology_opening_t.html b/libmongoc/1.23.5/mongoc_apm_topology_opening_t.html index b5233e448591ab3538b6c67b6934aed93cd8c63a..bd792eac4090e3bbdf33bbd0aea2f6bc9fb0c0e3 100644 --- a/libmongoc/1.23.5/mongoc_apm_topology_opening_t.html +++ b/libmongoc/1.23.5/mongoc_apm_topology_opening_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_destroy.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_destroy.html index df820df0edac431815a20b99cc6f40a28b8f2b24..367e932df8bc317352d2d772958c58709a258e8d 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_new.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_new.html index d83f8206b189170bb007f1ab57448234f1070768..1389d5636dcd1448d1cbf24e8e3cd7187ea082f2 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_new.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html index 0dfd13d3dd4baadae1de8ce6f15ea8073a53daea..7ed297918b3ed6f381de18f9a89f9d7202ee84ad 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_query_analysis.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_query_analysis.html index 5d2a268ee24ce15eb3884dadd3ef3f77ce2f0398..2957aca14cade30e6dcce7b3ffd10360d08ad613 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_query_analysis.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_bypass_query_analysis.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_encrypted_fields_map.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_encrypted_fields_map.html index 2a801505f54762c5e5140b9640953f6fce38d59f..494820ed234939bc066bc7c79c5baa6536d26e53 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_encrypted_fields_map.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_encrypted_fields_map.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_extra.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_extra.html index 031eb844ae7e9d61c9b776d684b7270f6e43fdee..35390bdce7bee54a959dbc13c013bbe8e558d072 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_extra.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_extra.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client.html index e6b8cc3f370d80ebbf64a94f80def742fa435096..f7a938244be424a2316314917f7589c8c8589c19 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client_pool.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client_pool.html index c6dd9bb798680dae822d9e904d3de333e6c2eaf1..690570c8045ca0a846b6502b7578c5828051b23f 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client_pool.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_client_pool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_namespace.html index 018359712349fa4d2663955e0ab79b5a66bfb3ed..468bcf242c4427e7d8a2defe0f4b953c2c341723 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_namespace.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_keyvault_namespace.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html index 2c8ad55902b1054a008d3522442a42b6c36dbfab..4485534fdd70a6ee2a20060eeab85e3ed7ee732b 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_providers.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_providers.html index e25b98c8a8539568b0f0fdf98e7506f8aaeb0f28..45604b58e5d4d2442ada635eda9a38fe71caad69 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_providers.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_kms_providers.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_schema_map.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_schema_map.html index 97ad935f3c3bd2809512abace334dd8ed158502f..d4837d1577838fe036e39070fc0ddfc0f0d0676c 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_schema_map.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_schema_map.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_tls_opts.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_tls_opts.html index 7d570c025a52e0f1be96839110018ada184d091d..4cb2501828d52fc430f88813fd423430705d6227 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_tls_opts.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_set_tls_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_auto_encryption_opts_t.html b/libmongoc/1.23.5/mongoc_auto_encryption_opts_t.html index 95db041e6e47c106831ff6d3550fdc5467132598..2fe91569b0ab53ae25403940315c9e0d2221d450 100644 --- a/libmongoc/1.23.5/mongoc_auto_encryption_opts_t.html +++ b/libmongoc/1.23.5/mongoc_auto_encryption_opts_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_delete.html b/libmongoc/1.23.5/mongoc_bulk_operation_delete.html index fc9094f00eae7b77e0e23f414b17d32767e1c95d..7579e47e30d427d5c88ac3ae67ffa90c48595832 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_delete.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_delete.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_delete_one.html b/libmongoc/1.23.5/mongoc_bulk_operation_delete_one.html index d966203c8520676284f87390a8d51570742accec..b1991ef93ac182e327e5ae2700b8de44391072d6 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_delete_one.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_delete_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_destroy.html b/libmongoc/1.23.5/mongoc_bulk_operation_destroy.html index d52e90727f9ef4e78b3cb6a10be635fc4ee262e3..e2d2599aebb7ca32d5e8d8897646ff6afd0fe4d3 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_destroy.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_execute.html b/libmongoc/1.23.5/mongoc_bulk_operation_execute.html index 99a53e18a0b69c50ee839addf3c2d9705e2cb790..513fa9eedc4918443e764d1198ce38efc1920cce 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_execute.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_execute.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_get_hint.html b/libmongoc/1.23.5/mongoc_bulk_operation_get_hint.html index a0d6ef08ba3f79dceaf5de224bcdc968df240dc4..b0031ca87539471709ac7e9553ac69bbb44618ee 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_get_hint.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_get_hint.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_get_write_concern.html b/libmongoc/1.23.5/mongoc_bulk_operation_get_write_concern.html index 6e279cbae86b95a27007dd7de3c49e4c813dcc60..83b287c65613a4cdd3588dc209ecca46feaeabc9 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_get_write_concern.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_get_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_insert.html b/libmongoc/1.23.5/mongoc_bulk_operation_insert.html index 74c49f428499e42d78d433e982056b396c48dd3d..f42fc7ccb52811bec4d0dde49881269d238934c1 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_insert.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_insert.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_insert_with_opts.html b/libmongoc/1.23.5/mongoc_bulk_operation_insert_with_opts.html index 7b90ce6a7bf1f264107078a697442287d6de44d1..e5822bf0a06585ec1a7dde8ac04cdc98928b0d96 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_insert_with_opts.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_insert_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_remove.html b/libmongoc/1.23.5/mongoc_bulk_operation_remove.html index 9ba51efe6518bc038573c0db590cc558692b249e..ea422de069c4ff9f9d664443f95e273be4caba83 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_remove.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_remove.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_remove_many_with_opts.html b/libmongoc/1.23.5/mongoc_bulk_operation_remove_many_with_opts.html index 0396e9bba83aa34e2c090ffdac0adfdf7f2ffe7a..e6f723d447d308197423c50f0dfd18fbb86736c9 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_remove_many_with_opts.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_remove_many_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_remove_one.html b/libmongoc/1.23.5/mongoc_bulk_operation_remove_one.html index 9a00ddf3418624822a91d3e8457bbe252a8fe6d6..31c8e377fdc563d4a82665b7d65ce33de7273cc6 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_remove_one.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_remove_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_remove_one_with_opts.html b/libmongoc/1.23.5/mongoc_bulk_operation_remove_one_with_opts.html index ea26bfe115b756e5e8f9f0cfd7630eff4cd64082..40e5ce2528521244ac875f28f2e8ba248be3ed24 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_remove_one_with_opts.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_remove_one_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_replace_one.html b/libmongoc/1.23.5/mongoc_bulk_operation_replace_one.html index f2994ce1d5498da75cea81e48ce262a965773ffa..2adb9012e086050bf83fdd8769ddcb692133e6d7 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_replace_one.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_replace_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_replace_one_with_opts.html b/libmongoc/1.23.5/mongoc_bulk_operation_replace_one_with_opts.html index 050f199cc37ba17a70b022b1ad0f09ddea250858..ccddf4e87fe13a57f3586f4f093d00a876516d11 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_replace_one_with_opts.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_replace_one_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_set_bypass_document_validation.html b/libmongoc/1.23.5/mongoc_bulk_operation_set_bypass_document_validation.html index 02513d7b98645e8987ed30de54fdbb6de86586a1..91486de35f80f58e55ae4588a0bb4c578acc5af4 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_set_bypass_document_validation.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_set_bypass_document_validation.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_set_client_session.html b/libmongoc/1.23.5/mongoc_bulk_operation_set_client_session.html index 1be0a9a8d115a1ea90f1c7348187e0f7c7940595..47df8ca50a7bbacda093c996bac2e93b33d2bebf 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_set_client_session.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_set_client_session.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_set_comment.html b/libmongoc/1.23.5/mongoc_bulk_operation_set_comment.html index 29da5674ee3d031a83c06afadec87ab4ff9c158d..b085ac93001c8d3131588ff1edd63f991024840d 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_set_comment.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_set_comment.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_set_hint.html b/libmongoc/1.23.5/mongoc_bulk_operation_set_hint.html index 4e67bf220d6a507ee50a093337a7e749b4200aaf..4d7109eed15c91a5f788dc12c1d820e5267a8147 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_set_hint.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_set_hint.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_set_let.html b/libmongoc/1.23.5/mongoc_bulk_operation_set_let.html index 195c0e1f67dafff00d767eeafdba5fcfa08d9ed0..2ceb6e610704d0e9e49dbd607c9687bd1e311602 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_set_let.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_set_let.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_t.html b/libmongoc/1.23.5/mongoc_bulk_operation_t.html index e2fb77b7700b47121124d28598bc4a46b57fe68a..3c80c396c1dc1810e3ee70ae437c04eb30184371 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_t.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_update.html b/libmongoc/1.23.5/mongoc_bulk_operation_update.html index b19f9ebd991db41890c16eb00ca0f0804ed41f8e..e816e90e243de6d55320dc5a76e67108216e55d4 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_update.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_update.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_update_many_with_opts.html b/libmongoc/1.23.5/mongoc_bulk_operation_update_many_with_opts.html index 48d6e63eb03c8fb8250cc3a3403ba54b40f68418..56280b1c34cac7126d37eef91d78fbe8121d3d82 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_update_many_with_opts.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_update_many_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_update_one.html b/libmongoc/1.23.5/mongoc_bulk_operation_update_one.html index 3a7e6c3735f47eed3a57169c6d7739b039aac875..c51f970fb3a5ea6ebfc4375b44322d1c2406257c 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_update_one.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_update_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_bulk_operation_update_one_with_opts.html b/libmongoc/1.23.5/mongoc_bulk_operation_update_one_with_opts.html index 152aec852666dabd84a1a546120e66c032d2214a..9f9d33f5af7b0b15d453709f13d916b1bc59dc84 100644 --- a/libmongoc/1.23.5/mongoc_bulk_operation_update_one_with_opts.html +++ b/libmongoc/1.23.5/mongoc_bulk_operation_update_one_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_change_stream_destroy.html b/libmongoc/1.23.5/mongoc_change_stream_destroy.html index dad3bfc3962ea1095705fdf0e2f87d7920c8d123..7be3d55b1a4ddad993e0577a4ddda81ca08783e2 100644 --- a/libmongoc/1.23.5/mongoc_change_stream_destroy.html +++ b/libmongoc/1.23.5/mongoc_change_stream_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_change_stream_error_document.html b/libmongoc/1.23.5/mongoc_change_stream_error_document.html index d58f0bfd70e8f1442a4e8c8a89ff728605943ff0..afff3dfcec9da9cd6f42d2f2b9b40fb3dc859475 100644 --- a/libmongoc/1.23.5/mongoc_change_stream_error_document.html +++ b/libmongoc/1.23.5/mongoc_change_stream_error_document.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_change_stream_get_resume_token.html b/libmongoc/1.23.5/mongoc_change_stream_get_resume_token.html index fe43e312d9cd6e9c6f79263cbacb9daf85a8ecf7..bd22e12325ea72cb60b70651a0a604441784ef94 100644 --- a/libmongoc/1.23.5/mongoc_change_stream_get_resume_token.html +++ b/libmongoc/1.23.5/mongoc_change_stream_get_resume_token.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_change_stream_next.html b/libmongoc/1.23.5/mongoc_change_stream_next.html index ce3589d1a7ae444b92ab5c9dd8fe0bdf49d47075..1da4c20425377ab888aca5cc89c9cdfa9197504e 100644 --- a/libmongoc/1.23.5/mongoc_change_stream_next.html +++ b/libmongoc/1.23.5/mongoc_change_stream_next.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_change_stream_t.html b/libmongoc/1.23.5/mongoc_change_stream_t.html index 8663557d6fe615f2be27f7ea8b8b4ad33450a418..eebd9ed583a33cd28d99822121d3e0386b44ed93 100644 --- a/libmongoc/1.23.5/mongoc_change_stream_t.html +++ b/libmongoc/1.23.5/mongoc_change_stream_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_check_version.html b/libmongoc/1.23.5/mongoc_check_version.html index f54d8e2031dd7ed276eb05c0da2608fa90800791..d146026471a5546688a7105877289f9c05dd40d3 100644 --- a/libmongoc/1.23.5/mongoc_check_version.html +++ b/libmongoc/1.23.5/mongoc_check_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cleanup.html b/libmongoc/1.23.5/mongoc_cleanup.html index 8b84f9eca7144d5b5faba640ee487bc83ca49add..0f39c97d483d9b3ede242c8e9e58285bb10d6867 100644 --- a/libmongoc/1.23.5/mongoc_cleanup.html +++ b/libmongoc/1.23.5/mongoc_cleanup.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_command.html b/libmongoc/1.23.5/mongoc_client_command.html index edee9748f7d8060ef6204e437249e9e50370345a..611f58b520b5926d09fa76afaf154160c143b2b2 100644 --- a/libmongoc/1.23.5/mongoc_client_command.html +++ b/libmongoc/1.23.5/mongoc_client_command.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_command_simple.html b/libmongoc/1.23.5/mongoc_client_command_simple.html index 2951247ac10a4c87432209782e28d13133f39cec..9dcd97266f03e3a34a57764dad57e89a5bf71840 100644 --- a/libmongoc/1.23.5/mongoc_client_command_simple.html +++ b/libmongoc/1.23.5/mongoc_client_command_simple.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_command_simple_with_server_id.html b/libmongoc/1.23.5/mongoc_client_command_simple_with_server_id.html index 37355069f2cf71089c015688889c8b37dcbea6e6..2386e9b35591b181171587b33a930495a31a722e 100644 --- a/libmongoc/1.23.5/mongoc_client_command_simple_with_server_id.html +++ b/libmongoc/1.23.5/mongoc_client_command_simple_with_server_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_command_with_opts.html b/libmongoc/1.23.5/mongoc_client_command_with_opts.html index 8890530f7767fac6efbf417d6dd5a0c2574f9114..f3663f3c41c7d3d364970be9f470a63df7a1a118 100644 --- a/libmongoc/1.23.5/mongoc_client_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_client_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_destroy.html b/libmongoc/1.23.5/mongoc_client_destroy.html index a64491d7abef2e6d82ea9258ea716d2944e3f3af..912168d4ceedc989c515a1844b13ddc4110db87d 100644 --- a/libmongoc/1.23.5/mongoc_client_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_enable_auto_encryption.html b/libmongoc/1.23.5/mongoc_client_enable_auto_encryption.html index 9eaab14c83b4e93f4d2b0e1a1a56a36016e93822..7164475ac1890f68ab9f233dbe8160e00b81fd72 100644 --- a/libmongoc/1.23.5/mongoc_client_enable_auto_encryption.html +++ b/libmongoc/1.23.5/mongoc_client_enable_auto_encryption.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_add_key_alt_name.html b/libmongoc/1.23.5/mongoc_client_encryption_add_key_alt_name.html index 978b33c0201671bb77afde9d5feb2917dc7c297c..ffa3d5f2318f6bd223513d6d98d6379cceabf81e 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_add_key_alt_name.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_add_key_alt_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_create_datakey.html b/libmongoc/1.23.5/mongoc_client_encryption_create_datakey.html index 722825ac40a053634a4d55a9bb897be80a8b9076..6ca00841f0452a43fb085fef2a9cd472dcaf331d 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_create_datakey.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_create_datakey.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_destroy.html b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_destroy.html index adbf794c80fb6c88a75904387c7ef631eba99c69..16308a97c7c9acc3a5a5159e59eb36eab75158b8 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_new.html b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_new.html index 77a36b8e99a77dd00adef30899ce9cafa0fbae91..17f833395e398c3b83d4979ec31be6fe71801c2e 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_new.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keyaltnames.html b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keyaltnames.html index bf6f8150fb3a5f1c1a28fd8c142194fca6addeda..2542511aa2e0db72a7f57ae3ef84be2aca60cbd7 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keyaltnames.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keyaltnames.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keymaterial.html b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keymaterial.html index dc9483eaf6460fd738642b637af73ecf0ee9b8ab..c52f76f328733bb4a53cbfb756a05d375107338e 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keymaterial.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_keymaterial.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_masterkey.html b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_masterkey.html index ede1ffbf1aba10860d79545bb591fba64be1a693..be3430076e1644230bdab1b036700a4185831b24 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_masterkey.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_set_masterkey.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_t.html b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_t.html index c526525eb9a4bdda64510e4ec173aba29704329b..1ac5e00733ac491f0932e7b5d739a08add5ce69e 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_t.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_datakey_opts_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_decrypt.html b/libmongoc/1.23.5/mongoc_client_encryption_decrypt.html index 634e80ef5850de3280df4fb24ae90ea43e403f7d..ef202d4261cbbb85c526e6724f6d90b07731649a 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_decrypt.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_decrypt.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_delete_key.html b/libmongoc/1.23.5/mongoc_client_encryption_delete_key.html index 97b27498de201651d661bc9ec3b44afc7830642b..a13356e8a6bb37b98ec082a8402c4d5784779c50 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_delete_key.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_delete_key.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_destroy.html b/libmongoc/1.23.5/mongoc_client_encryption_destroy.html index d5f562724b27172b59b70d01d0c04a7c175fe7b9..810364a12bd65760d6ee22e7991c548b138267cf 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt.html index 6a5a7d524cc04514484aec5ca20b1d0c4b2acce5..eed0d4856b1f7339ded444dcfba6f15befc739ca 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_destroy.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_destroy.html index ebd787f338200c8be00fe903e5d16a7c7fb1ad96..12b5e332a449e145954667a775db4ca18d5f4bc1 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_new.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_new.html index 5678d96fcd842c46a97d22ae4e7a9ff36f913a89..5c6b3e3d2048f11c221b541520440dab31eacc02 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_new.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_algorithm.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_algorithm.html index 89560bf583e8b37376181136a0626e0c920bf54e..7a8a5deb681b788270eb5c60d247edc4802a1f6d 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_algorithm.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_algorithm.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_contention_factor.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_contention_factor.html index 77e44baff5e573b56e8e78fe90e68ae26f55d23c..e42e0045bf1545955fae5710413587bcaa8e7452 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_contention_factor.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_contention_factor.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyaltname.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyaltname.html index 0be79fe02bb95c31366e1a7b50bda34c8ef5ee94..d0981f43f69c4a43bc78bc207c4d6e90bef60bcd 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyaltname.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyaltname.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyid.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyid.html index 68b3df09f381d633ff367d14a80ac86c835fa26a..94f2f1ba6532d4c9fdcbcfc288d4578f3812f5d3 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyid.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_keyid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_query_type.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_query_type.html index 230b3bd069d17029fc16dc23b00427ebce64e62f..f674ecdd55703bbe098bfff113ef6d178cfce004 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_query_type.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_set_query_type.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_t.html b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_t.html index ead5f44e6012089368a15ea524cb891f33125964..9ea60584d85fb66b50ab0666b3cd36a9a7b5b025 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_t.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_encrypt_opts_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_get_crypt_shared_version.html b/libmongoc/1.23.5/mongoc_client_encryption_get_crypt_shared_version.html index 459224a0d941b8f47a509f51bb5a41550a3e2224..f16492dfd82a64e56aa0bed22032b5361d14943b 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_get_crypt_shared_version.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_get_crypt_shared_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_get_key.html b/libmongoc/1.23.5/mongoc_client_encryption_get_key.html index 38e6caa90351f7fbf59b063a0fd80c424f348535..37a4bfdea5807c0b78a4aa3c56bf2d7bc5f31520 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_get_key.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_get_key.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_get_key_by_alt_name.html b/libmongoc/1.23.5/mongoc_client_encryption_get_key_by_alt_name.html index 1e1ac5635d8cc88759abd5c78824576c1a57b04a..164b9cd080c13bb8adcb28704bb5b9f72b01b408 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_get_key_by_alt_name.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_get_key_by_alt_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_get_keys.html b/libmongoc/1.23.5/mongoc_client_encryption_get_keys.html index 186f0ff3afcfd138676ad29351eab3190cda6021..cc4eb5ec400c783ab728be912e35729cb7bf150c 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_get_keys.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_get_keys.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_new.html b/libmongoc/1.23.5/mongoc_client_encryption_new.html index 35cc6d2230e8837ed31fdd4c30d776138af3f4b0..789aa65b52193222817bba1dbb5177c789154648 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_new.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_destroy.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_destroy.html index 12904867e89301285bca540fb5eca64259a527bb..daa65bce33a4d1f68fb04604708f5ec027bb5f41 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_new.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_new.html index 328f354785e6dfef3324b072a5d6d4a600498ea0..659fefc7754740405cb6f08b186f68be9748933f 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_new.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_client.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_client.html index ba2bdca3c7bb213b2459d1635b019e5219c0694a..3cffe4a39577a2e0be51195d9b5dc05528b3da24 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_client.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_client.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_namespace.html index cf94aa2c820b76167217192927214d62c8e41833..529457db25368bb0d30ff4fc85d9407e9a5d5a26 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_namespace.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_keyvault_namespace.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html index 0ddaa499d86e320c27dd1e342e321310bc54a156..53ede05befaa8f03367033f39168739229f261de 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_providers.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_providers.html index abe9bfa98d55475fc7455ea59c2e99cc1e1d2c7a..f8966de66d0d5b3d67a3880c52725fbd9e09360e 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_providers.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_kms_providers.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_tls_opts.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_tls_opts.html index 99c9146c756b32aa2e2a299016a92181ce7eae15..43d57b47cc50e3b24e82c514e5967750cd3262d1 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_set_tls_opts.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_set_tls_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_opts_t.html b/libmongoc/1.23.5/mongoc_client_encryption_opts_t.html index 588dceb5a0e371cfb87d6c2d03492ea9683adff9..df842af1fd9dd858d57b316c241ce901964ce852 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_opts_t.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_opts_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_remove_key_alt_name.html b/libmongoc/1.23.5/mongoc_client_encryption_remove_key_alt_name.html index 36d7950b7b3e056656aadc14664b1489136bba1d..6554cd1e8894eac66aa1e7a5e5147cbce90a53ec 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_remove_key_alt_name.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_remove_key_alt_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey.html b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey.html index 7c3b1d86c75b126895a3378d571fd9fe078e5058..7625906237595e20c3534b5263d95c4d169cabf4 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html index 6cafba8af1bf34ede52247c683ca114db638ade0..8663bc0c775d7f90a78a56e6e80c0d919322e966 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html index 0820ca47b9738cf858e24eabdda1b69c609a4067..fa5c97361126ec8b0d58a112017afc0bbddce60e 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_new.html b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_new.html index 1b6cb728999b781715183c01b0f46a48269089ec..0f271317918eb39a8047acaf859e4639c10461ff 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_new.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_t.html b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_t.html index 9c771c321d7445b249d836ceee99e3617c50f01d..c13422ea95f3a0272747e4c1d161f113dd11e015 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_t.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_rewrap_many_datakey_result_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_encryption_t.html b/libmongoc/1.23.5/mongoc_client_encryption_t.html index 4df2189f5f507a0ef4950ed6911fc4126df59dff..c2e611259655026453e355ba370bde1c82e269a9 100644 --- a/libmongoc/1.23.5/mongoc_client_encryption_t.html +++ b/libmongoc/1.23.5/mongoc_client_encryption_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_find_databases_with_opts.html b/libmongoc/1.23.5/mongoc_client_find_databases_with_opts.html index 69549cfe0de53498a1e43b79ad67ea7f6035efa5..7b70b9a3bd89e0cfd2bcd877d365ea41988c2cd5 100644 --- a/libmongoc/1.23.5/mongoc_client_find_databases_with_opts.html +++ b/libmongoc/1.23.5/mongoc_client_find_databases_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_collection.html b/libmongoc/1.23.5/mongoc_client_get_collection.html index 1bd3fd2f6f35b10f6988f78733b52a98357c29e0..565f056be4c98ee62101bd88a008a688d666296f 100644 --- a/libmongoc/1.23.5/mongoc_client_get_collection.html +++ b/libmongoc/1.23.5/mongoc_client_get_collection.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_crypt_shared_version.html b/libmongoc/1.23.5/mongoc_client_get_crypt_shared_version.html index adb84dcf6c1ae3286d9d5749e8034d18799a75d0..d16c0ba7be6d53c8a99217d403ef13e665dcc15c 100644 --- a/libmongoc/1.23.5/mongoc_client_get_crypt_shared_version.html +++ b/libmongoc/1.23.5/mongoc_client_get_crypt_shared_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_database.html b/libmongoc/1.23.5/mongoc_client_get_database.html index 5c1c4ac60e1af363f469b59d8267cd77e69f1822..e20711344cc4c1786f87fe0765a143740d81c82e 100644 --- a/libmongoc/1.23.5/mongoc_client_get_database.html +++ b/libmongoc/1.23.5/mongoc_client_get_database.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_database_names.html b/libmongoc/1.23.5/mongoc_client_get_database_names.html index 932d6f8767b23efca5f2613380ee9bdf5a6874c5..7c91a508c5dc3bcf0f43309f83b9ee80dc78bb1a 100644 --- a/libmongoc/1.23.5/mongoc_client_get_database_names.html +++ b/libmongoc/1.23.5/mongoc_client_get_database_names.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_database_names_with_opts.html b/libmongoc/1.23.5/mongoc_client_get_database_names_with_opts.html index d3481f8dae677fb60119bd3d0e534ca94bce3089..12e6dc670659b200666198d6de38256a7a897102 100644 --- a/libmongoc/1.23.5/mongoc_client_get_database_names_with_opts.html +++ b/libmongoc/1.23.5/mongoc_client_get_database_names_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_default_database.html b/libmongoc/1.23.5/mongoc_client_get_default_database.html index 7eb4b6c80830641df1ecdcbaa41b63ce3d07c233..eeba7ae4227eb16c7ae0cefceaab1c2eabe68504 100644 --- a/libmongoc/1.23.5/mongoc_client_get_default_database.html +++ b/libmongoc/1.23.5/mongoc_client_get_default_database.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_gridfs.html b/libmongoc/1.23.5/mongoc_client_get_gridfs.html index 7c346ade537750890b2f4d985df5f67d2dc4c184..b7db940f809abb0c68dc7f447effb79b6d4caea0 100644 --- a/libmongoc/1.23.5/mongoc_client_get_gridfs.html +++ b/libmongoc/1.23.5/mongoc_client_get_gridfs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_handshake_description.html b/libmongoc/1.23.5/mongoc_client_get_handshake_description.html index 283e242b141f5c4de9f50165c1bdc32e05f0f41b..d8293391f1f575d8883f2dcb7dedfbef8dcbce0e 100644 --- a/libmongoc/1.23.5/mongoc_client_get_handshake_description.html +++ b/libmongoc/1.23.5/mongoc_client_get_handshake_description.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_max_bson_size.html b/libmongoc/1.23.5/mongoc_client_get_max_bson_size.html index 1fbd45fb295ae0c3d8ffce1f08c52c829e6d925f..754b9dc1b893c7ccfc46ef86e6ef0d174a58e911 100644 --- a/libmongoc/1.23.5/mongoc_client_get_max_bson_size.html +++ b/libmongoc/1.23.5/mongoc_client_get_max_bson_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_max_message_size.html b/libmongoc/1.23.5/mongoc_client_get_max_message_size.html index cf792e867bdaed823056d666dd53a2ef3991b4c4..09997571fcec20ef7942ead7f41aa58566631493 100644 --- a/libmongoc/1.23.5/mongoc_client_get_max_message_size.html +++ b/libmongoc/1.23.5/mongoc_client_get_max_message_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_read_concern.html b/libmongoc/1.23.5/mongoc_client_get_read_concern.html index 75fd3dff8a4432f02ad8ef5e712f4474487cfb1e..1143526f5193030eefb3985146cf7b822b38b9bf 100644 --- a/libmongoc/1.23.5/mongoc_client_get_read_concern.html +++ b/libmongoc/1.23.5/mongoc_client_get_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_read_prefs.html b/libmongoc/1.23.5/mongoc_client_get_read_prefs.html index 8d4fde603160ba912a5adbe87eea1a0e49af7c7d..aa09d6b33b544f5e7b1fa24d94abe38105a7f5c6 100644 --- a/libmongoc/1.23.5/mongoc_client_get_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_client_get_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_server_description.html b/libmongoc/1.23.5/mongoc_client_get_server_description.html index fa8d814ca38a7a21cec84f4eb1642f2fc903b7e8..300edbb19526a65e148c682af6982e989f88c25b 100644 --- a/libmongoc/1.23.5/mongoc_client_get_server_description.html +++ b/libmongoc/1.23.5/mongoc_client_get_server_description.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_server_descriptions.html b/libmongoc/1.23.5/mongoc_client_get_server_descriptions.html index b45d184e767bf61289e69fe930d2d113dfe138b2..4cc33e376bb6ffd2701cea1473a47e3ce1a151b2 100644 --- a/libmongoc/1.23.5/mongoc_client_get_server_descriptions.html +++ b/libmongoc/1.23.5/mongoc_client_get_server_descriptions.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_server_status.html b/libmongoc/1.23.5/mongoc_client_get_server_status.html index b8b6302bca35f7cdb44e5c84ff8422d7a56e22bd..570d3099a9b75421aae5deda291f2c91b588a57b 100644 --- a/libmongoc/1.23.5/mongoc_client_get_server_status.html +++ b/libmongoc/1.23.5/mongoc_client_get_server_status.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_uri.html b/libmongoc/1.23.5/mongoc_client_get_uri.html index e21b9991b8ea98f524d437032aae59d5fab5ca76..089108f6e6734ec2880f2e27b64f45c6cf4088e7 100644 --- a/libmongoc/1.23.5/mongoc_client_get_uri.html +++ b/libmongoc/1.23.5/mongoc_client_get_uri.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_get_write_concern.html b/libmongoc/1.23.5/mongoc_client_get_write_concern.html index 4fe95e9efdd210ec22e6ee167aa9f2e7ac204035..a498fcb689aeea01315100199ee3dd64d40c56ed 100644 --- a/libmongoc/1.23.5/mongoc_client_get_write_concern.html +++ b/libmongoc/1.23.5/mongoc_client_get_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_new.html b/libmongoc/1.23.5/mongoc_client_new.html index e829c9c05566f56d51d894e39a465698e03ad2e9..bc8c2e10a0da055af2d75f8da8abc99c35f08716 100644 --- a/libmongoc/1.23.5/mongoc_client_new.html +++ b/libmongoc/1.23.5/mongoc_client_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_new_from_uri.html b/libmongoc/1.23.5/mongoc_client_new_from_uri.html index 3d1fcae4d92378e4e3b614ae61acc6f2de0f203e..9289171c473a8f6f39426bd2e1a9b5c43495410e 100644 --- a/libmongoc/1.23.5/mongoc_client_new_from_uri.html +++ b/libmongoc/1.23.5/mongoc_client_new_from_uri.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_new_from_uri_with_error.html b/libmongoc/1.23.5/mongoc_client_new_from_uri_with_error.html index 165ff396fed3ccf2821409966598627f1b26d5fd..1047af056f6bbbb9d35dc5ea9dc3f3164bd709ff 100644 --- a/libmongoc/1.23.5/mongoc_client_new_from_uri_with_error.html +++ b/libmongoc/1.23.5/mongoc_client_new_from_uri_with_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_destroy.html b/libmongoc/1.23.5/mongoc_client_pool_destroy.html index be3363b96188894e98fd230c0deea8f33c76f95f..477f04d63f3fe4451410571627493acfb947cc70 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_pool_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_enable_auto_encryption.html b/libmongoc/1.23.5/mongoc_client_pool_enable_auto_encryption.html index bc142b93daecde060bdd720240957c4af80c5d42..fad633cba0cb645008faf4c14eb800eda1a3ec62 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_enable_auto_encryption.html +++ b/libmongoc/1.23.5/mongoc_client_pool_enable_auto_encryption.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_max_size.html b/libmongoc/1.23.5/mongoc_client_pool_max_size.html index a787f6d42c9717ace312164e89c8b60e102ffea0..f062045ac34d2bb13d493090421d37f34f14a69f 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_max_size.html +++ b/libmongoc/1.23.5/mongoc_client_pool_max_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_min_size.html b/libmongoc/1.23.5/mongoc_client_pool_min_size.html index 1c0ea63c83c55564939bdee0fc8b0c263caf0205..9e8b8663b8e5a4ed81bdc674337edfa0b18bf1a6 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_min_size.html +++ b/libmongoc/1.23.5/mongoc_client_pool_min_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_new.html b/libmongoc/1.23.5/mongoc_client_pool_new.html index 61420633ba335a4b5199aeb598578c6363aedfd4..1405ae889db620f0eed0733453d454091cb180b9 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_new.html +++ b/libmongoc/1.23.5/mongoc_client_pool_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_new_with_error.html b/libmongoc/1.23.5/mongoc_client_pool_new_with_error.html index bc7ee62977b145357dd17b5d6df3577d8b41a7ae..0bdbce9df17b3c752c0b7e1a399560137215a876 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_new_with_error.html +++ b/libmongoc/1.23.5/mongoc_client_pool_new_with_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_pop.html b/libmongoc/1.23.5/mongoc_client_pool_pop.html index a2f0045f070efb16a0f8e053a40a94dcce376c2f..e7f8330622cea30038c744e0a58d6a86b07b99a9 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_pop.html +++ b/libmongoc/1.23.5/mongoc_client_pool_pop.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_push.html b/libmongoc/1.23.5/mongoc_client_pool_push.html index 4fc1e08d1eeaf79c91f76ffffc34ecbaba92ad06..d19f5ab53bf07b5c83a050928e92eccf67068b72 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_push.html +++ b/libmongoc/1.23.5/mongoc_client_pool_push.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_set_apm_callbacks.html b/libmongoc/1.23.5/mongoc_client_pool_set_apm_callbacks.html index e91c922fe7c4e6a999d1c1c9eeb61867475c44d0..e0dd273698a35107948c750096e4f09f6fe156c8 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_set_apm_callbacks.html +++ b/libmongoc/1.23.5/mongoc_client_pool_set_apm_callbacks.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_set_appname.html b/libmongoc/1.23.5/mongoc_client_pool_set_appname.html index fdb969dc78e9b33c3b1fc4c27ca01253dfa52edc..a8cb4dcfa81872cdff5801bcb7c1f6481cc0e859 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_set_appname.html +++ b/libmongoc/1.23.5/mongoc_client_pool_set_appname.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_set_error_api.html b/libmongoc/1.23.5/mongoc_client_pool_set_error_api.html index d4eeb0ad9e5bf6934c4901dce02ef234ab80ab9c..1d89f4f56226858918ad67fd66549707e33352cd 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_set_error_api.html +++ b/libmongoc/1.23.5/mongoc_client_pool_set_error_api.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_set_server_api.html b/libmongoc/1.23.5/mongoc_client_pool_set_server_api.html index a49459bb2b318f9bfeb985230cf7e3c9e5cf49e4..d0f6ba5257688a81ac69c48648266ab11e1dda80 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_set_server_api.html +++ b/libmongoc/1.23.5/mongoc_client_pool_set_server_api.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_set_ssl_opts.html b/libmongoc/1.23.5/mongoc_client_pool_set_ssl_opts.html index 8ffa12ea9099d464807506192c4270fe96e8b78b..3b2e27ca4aa315f26f19f01fc2c361d7e1850c4f 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_set_ssl_opts.html +++ b/libmongoc/1.23.5/mongoc_client_pool_set_ssl_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_t.html b/libmongoc/1.23.5/mongoc_client_pool_t.html index 870472c95341211fce01c49ccdc5ce7818b1244d..9f8ef1af437aa27d5ddc9c31d9dd097b4da840b3 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_t.html +++ b/libmongoc/1.23.5/mongoc_client_pool_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_pool_try_pop.html b/libmongoc/1.23.5/mongoc_client_pool_try_pop.html index 20e8775c968dbdac6db52406b8e082adbbad6f1e..7edacc00e11037a7c828b1cf5ea890b09000e07e 100644 --- a/libmongoc/1.23.5/mongoc_client_pool_try_pop.html +++ b/libmongoc/1.23.5/mongoc_client_pool_try_pop.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_read_command_with_opts.html b/libmongoc/1.23.5/mongoc_client_read_command_with_opts.html index 0e7d0650ed017c69776235ec6cfa3d3d7429f7ae..25de57f2e471abf6955424eaf5f546a7007a48bf 100644 --- a/libmongoc/1.23.5/mongoc_client_read_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_client_read_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_read_write_command_with_opts.html b/libmongoc/1.23.5/mongoc_client_read_write_command_with_opts.html index 01d07905e2c1671c1ffc289dd56c1ffc828edc74..d267fed9c965bfab04862cd0f572174a981f5c01 100644 --- a/libmongoc/1.23.5/mongoc_client_read_write_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_client_read_write_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_reset.html b/libmongoc/1.23.5/mongoc_client_reset.html index 2c75c9fe696436eb973f8d00be92c292a21b15df..13b4c477b1c2c9a2b191f20d10bd533c792e832b 100644 --- a/libmongoc/1.23.5/mongoc_client_reset.html +++ b/libmongoc/1.23.5/mongoc_client_reset.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_select_server.html b/libmongoc/1.23.5/mongoc_client_select_server.html index f1535b035d12d47e0631c3728181b0c19d0afc31..6d3293f44e1ba63301b7096b0cd87a23578788e7 100644 --- a/libmongoc/1.23.5/mongoc_client_select_server.html +++ b/libmongoc/1.23.5/mongoc_client_select_server.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_abort_transaction.html b/libmongoc/1.23.5/mongoc_client_session_abort_transaction.html index 50886840b0722a8b64c2ed2cac290893aadfe205..3fa460fb7e4195b630bbf1246924e4ad0769620d 100644 --- a/libmongoc/1.23.5/mongoc_client_session_abort_transaction.html +++ b/libmongoc/1.23.5/mongoc_client_session_abort_transaction.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_advance_cluster_time.html b/libmongoc/1.23.5/mongoc_client_session_advance_cluster_time.html index 11f5befdde644a1fbfbac9312433b1d2d11e8f86..bee490b8024816be15b6b78e9d3fb75749151ced 100644 --- a/libmongoc/1.23.5/mongoc_client_session_advance_cluster_time.html +++ b/libmongoc/1.23.5/mongoc_client_session_advance_cluster_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_advance_operation_time.html b/libmongoc/1.23.5/mongoc_client_session_advance_operation_time.html index 8ecca801daa83d2c75deb0fb534e2f5ccfae9cad..34e4fd9319a63bf1ef0887e0a508da513e77e108 100644 --- a/libmongoc/1.23.5/mongoc_client_session_advance_operation_time.html +++ b/libmongoc/1.23.5/mongoc_client_session_advance_operation_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_append.html b/libmongoc/1.23.5/mongoc_client_session_append.html index aafe00772d08aa0fda28dc7ad52115c5f1b12fc8..cf09be7b4ea2c6c376aca8eeef4cbf2ee6bafe98 100644 --- a/libmongoc/1.23.5/mongoc_client_session_append.html +++ b/libmongoc/1.23.5/mongoc_client_session_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_commit_transaction.html b/libmongoc/1.23.5/mongoc_client_session_commit_transaction.html index 1dccef685d103249d53a071642077171cf520a25..27eb99161632cc62c80531b8cf6c904fac0d085f 100644 --- a/libmongoc/1.23.5/mongoc_client_session_commit_transaction.html +++ b/libmongoc/1.23.5/mongoc_client_session_commit_transaction.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_destroy.html b/libmongoc/1.23.5/mongoc_client_session_destroy.html index 6ec6a6243a7b89baca0d5a1009089953520580ef..973b8b04f1e33c27858a1f5f51fa134af11bac05 100644 --- a/libmongoc/1.23.5/mongoc_client_session_destroy.html +++ b/libmongoc/1.23.5/mongoc_client_session_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_client.html b/libmongoc/1.23.5/mongoc_client_session_get_client.html index bb85f33af94c794c2a0fb2c0b017d4fa89c3037c..d3d356dc2f26279f63f406390cd2b64ec9d8363c 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_client.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_client.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_cluster_time.html b/libmongoc/1.23.5/mongoc_client_session_get_cluster_time.html index f38859e99186a1c68f122e0fa7fe9d9b26fd48da..9fafa1e834422ef9fdbaf1835179dfae0e7186da 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_cluster_time.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_cluster_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_dirty.html b/libmongoc/1.23.5/mongoc_client_session_get_dirty.html index d89a1d9a1ee91e088a43840fa91a3661123dd22f..63b1841b0cfc5072add9d991c0ae0b0f29a0d1b7 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_dirty.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_dirty.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_lsid.html b/libmongoc/1.23.5/mongoc_client_session_get_lsid.html index 9a489b2524ed5fe91620de9dc9cb226f0c4ed8af..ad2e6a87bfc20289c660ef5bc9b8159497c48554 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_lsid.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_lsid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_operation_time.html b/libmongoc/1.23.5/mongoc_client_session_get_operation_time.html index 331aa641124517149a4ab19d3f42dfc26a0537b3..0ce87bec0226cda3dfa37afbfbbacde91010d98b 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_operation_time.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_operation_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_opts.html b/libmongoc/1.23.5/mongoc_client_session_get_opts.html index b5b5bf9aaf32f51797561e99f3c755757b834c27..e30af741bde693a34576c3f7d0996e0ced530ff1 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_opts.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_server_id.html b/libmongoc/1.23.5/mongoc_client_session_get_server_id.html index 501cded9a2b85e7e9fd4b80503726cc99eb9a0c0..8f7d4f226308972270e2973f40946a73601bf563 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_server_id.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_server_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_get_transaction_state.html b/libmongoc/1.23.5/mongoc_client_session_get_transaction_state.html index f0f087ee0e01aaa9f5d1084ea53872dd9cde45be..d1b3c645e8ec0feffce420064e9837182cbda95f 100644 --- a/libmongoc/1.23.5/mongoc_client_session_get_transaction_state.html +++ b/libmongoc/1.23.5/mongoc_client_session_get_transaction_state.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_in_transaction.html b/libmongoc/1.23.5/mongoc_client_session_in_transaction.html index 89cf062c95779ff92a3567d594f2339cc9717ec5..aa414317f5ee159074c23a99ed50fd36ae63a03d 100644 --- a/libmongoc/1.23.5/mongoc_client_session_in_transaction.html +++ b/libmongoc/1.23.5/mongoc_client_session_in_transaction.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_start_transaction.html b/libmongoc/1.23.5/mongoc_client_session_start_transaction.html index e493a696b45b048603dac5b20d30b3b7197fa586..6e87503c5462339906817ee19d3bc99453bf2851 100644 --- a/libmongoc/1.23.5/mongoc_client_session_start_transaction.html +++ b/libmongoc/1.23.5/mongoc_client_session_start_transaction.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_t.html b/libmongoc/1.23.5/mongoc_client_session_t.html index f5bb21833158f6a13248a46e7613a0f34b3663af..bdf36c1b211e2fe9f8c8e26eb9402c41ec54681d 100644 --- a/libmongoc/1.23.5/mongoc_client_session_t.html +++ b/libmongoc/1.23.5/mongoc_client_session_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_with_transaction.html b/libmongoc/1.23.5/mongoc_client_session_with_transaction.html index 247dc88d01db2b863650330c6005263739410555..bcdfa559256e69473080e16a99b45bbebda7acf7 100644 --- a/libmongoc/1.23.5/mongoc_client_session_with_transaction.html +++ b/libmongoc/1.23.5/mongoc_client_session_with_transaction.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_session_with_transaction_cb_t.html b/libmongoc/1.23.5/mongoc_client_session_with_transaction_cb_t.html index b436cb1a2c495d5449c80cdbdf59407c1228daf2..b5b049a26e0c5c724bb87b3e40293b354441d155 100644 --- a/libmongoc/1.23.5/mongoc_client_session_with_transaction_cb_t.html +++ b/libmongoc/1.23.5/mongoc_client_session_with_transaction_cb_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_apm_callbacks.html b/libmongoc/1.23.5/mongoc_client_set_apm_callbacks.html index d31213a5870666bce1e3bc5293f152ac52362a0a..0ae50b200949a134113523626210644275638db9 100644 --- a/libmongoc/1.23.5/mongoc_client_set_apm_callbacks.html +++ b/libmongoc/1.23.5/mongoc_client_set_apm_callbacks.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_appname.html b/libmongoc/1.23.5/mongoc_client_set_appname.html index 03a03997112e90249f63d008205870bff578f45a..19c7b2b73db1bb9b18396feb525ce4a0224343de 100644 --- a/libmongoc/1.23.5/mongoc_client_set_appname.html +++ b/libmongoc/1.23.5/mongoc_client_set_appname.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_error_api.html b/libmongoc/1.23.5/mongoc_client_set_error_api.html index 61c427ff9b5094d5ebd3576b38d26f657faaa533..54cd552f75759e74190860c29387f09769fb8ec4 100644 --- a/libmongoc/1.23.5/mongoc_client_set_error_api.html +++ b/libmongoc/1.23.5/mongoc_client_set_error_api.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_read_concern.html b/libmongoc/1.23.5/mongoc_client_set_read_concern.html index 999287d802ff63d2d23ba185665b7eb5ec0328b4..f6b1e2dc3caa40036cc3b8f245f984d10a4564d5 100644 --- a/libmongoc/1.23.5/mongoc_client_set_read_concern.html +++ b/libmongoc/1.23.5/mongoc_client_set_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_read_prefs.html b/libmongoc/1.23.5/mongoc_client_set_read_prefs.html index 924f06ece43a84fb45ab809884e3ae64b440e179..01b389a90fef9857589f840aa7ba93a0e12be2ab 100644 --- a/libmongoc/1.23.5/mongoc_client_set_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_client_set_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_server_api.html b/libmongoc/1.23.5/mongoc_client_set_server_api.html index e7fc4e1722bee2181b7a65f7570038902eb0283a..4061542e9f2540a25036360cbb6817eef3ce71a6 100644 --- a/libmongoc/1.23.5/mongoc_client_set_server_api.html +++ b/libmongoc/1.23.5/mongoc_client_set_server_api.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_ssl_opts.html b/libmongoc/1.23.5/mongoc_client_set_ssl_opts.html index c8d3e4406476dae1309d2af2809bdc604f81e0b5..4e0378c5e1a90f594d978b33739303c175291c2b 100644 --- a/libmongoc/1.23.5/mongoc_client_set_ssl_opts.html +++ b/libmongoc/1.23.5/mongoc_client_set_ssl_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_stream_initiator.html b/libmongoc/1.23.5/mongoc_client_set_stream_initiator.html index 6a628d7dbfcfa31191dafdc3a6e83b887a044b13..a7b6ef34bbedce533ed1988d3d28328bda578381 100644 --- a/libmongoc/1.23.5/mongoc_client_set_stream_initiator.html +++ b/libmongoc/1.23.5/mongoc_client_set_stream_initiator.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_set_write_concern.html b/libmongoc/1.23.5/mongoc_client_set_write_concern.html index 51c53bc7d916dc23df84d07d64a5956d9d044b57..363967504cb945f2cae6572f0aef9591ddfdcae1 100644 --- a/libmongoc/1.23.5/mongoc_client_set_write_concern.html +++ b/libmongoc/1.23.5/mongoc_client_set_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_start_session.html b/libmongoc/1.23.5/mongoc_client_start_session.html index ba3f8d00e23f465d74453f4a52880290f9809f7c..e152fd2b6c831605d8b3a25cb6022fe51f411f15 100644 --- a/libmongoc/1.23.5/mongoc_client_start_session.html +++ b/libmongoc/1.23.5/mongoc_client_start_session.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_t.html b/libmongoc/1.23.5/mongoc_client_t.html index 1e2dc4b958ecfa27f5a986b4200f789a05b394dc..d35b8a38f78ef782931f295b8b6efe692635ec43 100644 --- a/libmongoc/1.23.5/mongoc_client_t.html +++ b/libmongoc/1.23.5/mongoc_client_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_watch.html b/libmongoc/1.23.5/mongoc_client_watch.html index 3b3f265c5d8405c44386c72fe542c1540efa73ce..04236e0cd80a11cfd1d9e88b6ad21ddf2aaa1235 100644 --- a/libmongoc/1.23.5/mongoc_client_watch.html +++ b/libmongoc/1.23.5/mongoc_client_watch.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_client_write_command_with_opts.html b/libmongoc/1.23.5/mongoc_client_write_command_with_opts.html index 910b69b2c6dfaa6575487e8a7f701864ef2e17cb..9d9d9d6422b7318685f5354ab7b4ffaa170c041a 100644 --- a/libmongoc/1.23.5/mongoc_client_write_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_client_write_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_aggregate.html b/libmongoc/1.23.5/mongoc_collection_aggregate.html index d93be148ce93ef29b0058bc971dc8a0ec736ca69..ed584489461ff32b15c5c9b5a29ea844f390791b 100644 --- a/libmongoc/1.23.5/mongoc_collection_aggregate.html +++ b/libmongoc/1.23.5/mongoc_collection_aggregate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_command.html b/libmongoc/1.23.5/mongoc_collection_command.html index 42face8a0ddc36a6f2127f36555e7372310fc200..76da5a91420f43827e3a06c9d5add3b60a736503 100644 --- a/libmongoc/1.23.5/mongoc_collection_command.html +++ b/libmongoc/1.23.5/mongoc_collection_command.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_command_simple.html b/libmongoc/1.23.5/mongoc_collection_command_simple.html index 544510fc28548b0cd4f7e8726b0654199778f738..9a9ab11b5b2153b5f3b4d6a5af254dc52002c78a 100644 --- a/libmongoc/1.23.5/mongoc_collection_command_simple.html +++ b/libmongoc/1.23.5/mongoc_collection_command_simple.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_command_with_opts.html b/libmongoc/1.23.5/mongoc_collection_command_with_opts.html index 309fbf48f41ada81d128ce76cec209823d83d28a..bf5449b2c4b46ee21bd18d58fb87cc86477a9aa4 100644 --- a/libmongoc/1.23.5/mongoc_collection_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_copy.html b/libmongoc/1.23.5/mongoc_collection_copy.html index 57d7a2c7f4710cf617bc1a108223724b81451347..fe79dd1950d71dba617e1b1f170ec43146f3f35f 100644 --- a/libmongoc/1.23.5/mongoc_collection_copy.html +++ b/libmongoc/1.23.5/mongoc_collection_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_count.html b/libmongoc/1.23.5/mongoc_collection_count.html index 9705813ece017d8c4803b0cfe6f3e1897e76dbcd..02a4abc113dbd06cf467d8f3fc377282f5dbe713 100644 --- a/libmongoc/1.23.5/mongoc_collection_count.html +++ b/libmongoc/1.23.5/mongoc_collection_count.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_count_documents.html b/libmongoc/1.23.5/mongoc_collection_count_documents.html index 001fde820e1c7e54eb9d1e601665524c3f25f4fa..aee73c7471174f625b5cc92ed7b670464714f980 100644 --- a/libmongoc/1.23.5/mongoc_collection_count_documents.html +++ b/libmongoc/1.23.5/mongoc_collection_count_documents.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_count_with_opts.html b/libmongoc/1.23.5/mongoc_collection_count_with_opts.html index 697536b790c82b593cb8be362d6da2e3354f733d..2ab724ebe637ffc97d8e84201c92c7218fc5c593 100644 --- a/libmongoc/1.23.5/mongoc_collection_count_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_count_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_create_bulk_operation.html b/libmongoc/1.23.5/mongoc_collection_create_bulk_operation.html index e75d2d857aa8494387ab2b22334163c34fff0748..760b74156432fcdb685cd42f790e5b460b8ce1d4 100644 --- a/libmongoc/1.23.5/mongoc_collection_create_bulk_operation.html +++ b/libmongoc/1.23.5/mongoc_collection_create_bulk_operation.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_create_bulk_operation_with_opts.html b/libmongoc/1.23.5/mongoc_collection_create_bulk_operation_with_opts.html index f787e6d7a976289aaaae3402118569ca78495e3e..71590a89c83270ee5970e6bcbf37b672b22b054b 100644 --- a/libmongoc/1.23.5/mongoc_collection_create_bulk_operation_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_create_bulk_operation_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_create_index.html b/libmongoc/1.23.5/mongoc_collection_create_index.html index 35a0739e5c0264d564257b3b636ad5c51b0556e2..573e0fd1c8925c7dbb3a65905bb391caefa0bae8 100644 --- a/libmongoc/1.23.5/mongoc_collection_create_index.html +++ b/libmongoc/1.23.5/mongoc_collection_create_index.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_create_index_with_opts.html b/libmongoc/1.23.5/mongoc_collection_create_index_with_opts.html index b9efbdc861c0c1a8c46b58b1a1185bf63b6d5cae..e881356d69197ad31e9d02eda4886f202e389cb2 100644 --- a/libmongoc/1.23.5/mongoc_collection_create_index_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_create_index_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_delete.html b/libmongoc/1.23.5/mongoc_collection_delete.html index fcc8dc97b40ed60c1e64a3a247d8c9aec41cea7a..398afe799593cf374cfe0c0fc4283d2f5a5c5924 100644 --- a/libmongoc/1.23.5/mongoc_collection_delete.html +++ b/libmongoc/1.23.5/mongoc_collection_delete.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_delete_many.html b/libmongoc/1.23.5/mongoc_collection_delete_many.html index c0315de0a9983c5f492ced19d911a66414e00117..224ba09153f51c42e2a5248ac192e77044dadfb5 100644 --- a/libmongoc/1.23.5/mongoc_collection_delete_many.html +++ b/libmongoc/1.23.5/mongoc_collection_delete_many.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_delete_one.html b/libmongoc/1.23.5/mongoc_collection_delete_one.html index 95a9dd584afa300aecd3a0f90422ce1f521c8e6e..9f2c11f96bf18a615afc7e80ce61cb249e580476 100644 --- a/libmongoc/1.23.5/mongoc_collection_delete_one.html +++ b/libmongoc/1.23.5/mongoc_collection_delete_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_destroy.html b/libmongoc/1.23.5/mongoc_collection_destroy.html index 1fe228f7151a576cb73e30e406f5972442bd2718..0846e44cdd228a1c8193abbb7ad7f3d2ab0d7121 100644 --- a/libmongoc/1.23.5/mongoc_collection_destroy.html +++ b/libmongoc/1.23.5/mongoc_collection_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_drop.html b/libmongoc/1.23.5/mongoc_collection_drop.html index 9bfbe7ef5344010bcdb2357c81441b46f15f0a71..aa9f42af7d7ca68906cc2cce0921e6017342266e 100644 --- a/libmongoc/1.23.5/mongoc_collection_drop.html +++ b/libmongoc/1.23.5/mongoc_collection_drop.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_drop_index.html b/libmongoc/1.23.5/mongoc_collection_drop_index.html index 89d588883cbba045004d8b8e677b38386d02c739..d9b28bd8404b0e96ad8dd07442a7aff0f3b94117 100644 --- a/libmongoc/1.23.5/mongoc_collection_drop_index.html +++ b/libmongoc/1.23.5/mongoc_collection_drop_index.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_drop_index_with_opts.html b/libmongoc/1.23.5/mongoc_collection_drop_index_with_opts.html index 552325d8618991a1db544cfc4acb3622d2eeaa94..d458d5bc354201fa54b943f9fc50985df91f3cd1 100644 --- a/libmongoc/1.23.5/mongoc_collection_drop_index_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_drop_index_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_drop_with_opts.html b/libmongoc/1.23.5/mongoc_collection_drop_with_opts.html index 63622b3a51139d180965c4c955bff8ae6b88ae54..495a04d2d1aaeccd5860520c17c830be037b2667 100644 --- a/libmongoc/1.23.5/mongoc_collection_drop_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_drop_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_ensure_index.html b/libmongoc/1.23.5/mongoc_collection_ensure_index.html index 319ee93026cdb6aa25e090264885b9b29d33402d..016de32a4db3ceea32931a279f267fec47e2940d 100644 --- a/libmongoc/1.23.5/mongoc_collection_ensure_index.html +++ b/libmongoc/1.23.5/mongoc_collection_ensure_index.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_estimated_document_count.html b/libmongoc/1.23.5/mongoc_collection_estimated_document_count.html index 8cb332056013ff3eee120858b2eb2ede6e744e9e..2004e6248956d54e8bc8b29aaa8d259f5fbd0c77 100644 --- a/libmongoc/1.23.5/mongoc_collection_estimated_document_count.html +++ b/libmongoc/1.23.5/mongoc_collection_estimated_document_count.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_find.html b/libmongoc/1.23.5/mongoc_collection_find.html index f151c16f818ebdc1bf9697fa4d6af748d0398e88..34541d6db2037f45925320fa2e1f886bd0199a43 100644 --- a/libmongoc/1.23.5/mongoc_collection_find.html +++ b/libmongoc/1.23.5/mongoc_collection_find.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_find_and_modify.html b/libmongoc/1.23.5/mongoc_collection_find_and_modify.html index cfb672382928843cd1322ccfc1d0f2333f10bc00..de39e5707c01fc31525d1bf8bb5bc4064b0efa86 100644 --- a/libmongoc/1.23.5/mongoc_collection_find_and_modify.html +++ b/libmongoc/1.23.5/mongoc_collection_find_and_modify.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_find_and_modify_with_opts.html b/libmongoc/1.23.5/mongoc_collection_find_and_modify_with_opts.html index 7392b4f33ff0578c46c9c7196c284621214089bb..470260c17a3e68d4cc1a0e899e4990bdaed25171 100644 --- a/libmongoc/1.23.5/mongoc_collection_find_and_modify_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_find_and_modify_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_find_indexes.html b/libmongoc/1.23.5/mongoc_collection_find_indexes.html index c45bba65719c72d1735d4e6f1b40e0d44357a792..ba92b86a56756ba4211c3c01439783a9efe7ee7b 100644 --- a/libmongoc/1.23.5/mongoc_collection_find_indexes.html +++ b/libmongoc/1.23.5/mongoc_collection_find_indexes.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_find_indexes_with_opts.html b/libmongoc/1.23.5/mongoc_collection_find_indexes_with_opts.html index 39529c08ca6e7e5ca526b9bac361335ad2e99058..2ce34100bbae1628f8e2c5ff0862c6754b6f917e 100644 --- a/libmongoc/1.23.5/mongoc_collection_find_indexes_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_find_indexes_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_find_with_opts.html b/libmongoc/1.23.5/mongoc_collection_find_with_opts.html index 68808d6bf7a80c7e0fe8d0376376c63a4baccf82..6f2ec9230a27f7639dae6e45c2080c7f71feb80a 100644 --- a/libmongoc/1.23.5/mongoc_collection_find_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_find_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_get_last_error.html b/libmongoc/1.23.5/mongoc_collection_get_last_error.html index 646ae1eb587f8f8178790228881e0680f607d322..8ce33200091ed642357b1ea0ebd2793c2b9e01a0 100644 --- a/libmongoc/1.23.5/mongoc_collection_get_last_error.html +++ b/libmongoc/1.23.5/mongoc_collection_get_last_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_get_name.html b/libmongoc/1.23.5/mongoc_collection_get_name.html index 699d6343b76e56494be3fdc3f941f5cdb3d5e811..e9ec4b4e2c2e830d33452900407498f401177bc0 100644 --- a/libmongoc/1.23.5/mongoc_collection_get_name.html +++ b/libmongoc/1.23.5/mongoc_collection_get_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_get_read_concern.html b/libmongoc/1.23.5/mongoc_collection_get_read_concern.html index cd53394c38844ccd994a7169f5eae189c602c43f..4aaa651f08d964208d986e2cd958b34b29a97002 100644 --- a/libmongoc/1.23.5/mongoc_collection_get_read_concern.html +++ b/libmongoc/1.23.5/mongoc_collection_get_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_get_read_prefs.html b/libmongoc/1.23.5/mongoc_collection_get_read_prefs.html index dd18d50d2fa876d8cc8609f07bf355594e66a98f..ca04e13eb63b227940186b2afb5519457592c13c 100644 --- a/libmongoc/1.23.5/mongoc_collection_get_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_collection_get_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_get_write_concern.html b/libmongoc/1.23.5/mongoc_collection_get_write_concern.html index 0fbff64e9fa02c1c98534be4ddd258c8df54c2f2..f92c7efc82d080bceadc3d024b6e845631d96924 100644 --- a/libmongoc/1.23.5/mongoc_collection_get_write_concern.html +++ b/libmongoc/1.23.5/mongoc_collection_get_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_insert.html b/libmongoc/1.23.5/mongoc_collection_insert.html index 09ca67d0b8f636f8f0d038e271983491acb82329..6e58577e982a73e10b7e83d236ab20d38ba2ad3b 100644 --- a/libmongoc/1.23.5/mongoc_collection_insert.html +++ b/libmongoc/1.23.5/mongoc_collection_insert.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_insert_bulk.html b/libmongoc/1.23.5/mongoc_collection_insert_bulk.html index d5d99a397b2ee34a84c890240625911695374494..b733af9693dee5b2a9097271ec4d1c3bd9ee4f4b 100644 --- a/libmongoc/1.23.5/mongoc_collection_insert_bulk.html +++ b/libmongoc/1.23.5/mongoc_collection_insert_bulk.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_insert_many.html b/libmongoc/1.23.5/mongoc_collection_insert_many.html index 0594ce43cee23e3af1b721e43bfcfae2d1545fc3..7089d572787b70cca47692d16bd134082214fa5c 100644 --- a/libmongoc/1.23.5/mongoc_collection_insert_many.html +++ b/libmongoc/1.23.5/mongoc_collection_insert_many.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_insert_one.html b/libmongoc/1.23.5/mongoc_collection_insert_one.html index f72055fa6d9a1df3effc2b685dc712c674382315..730aeb99c7a74819c9b894e4a83c55191facfb1d 100644 --- a/libmongoc/1.23.5/mongoc_collection_insert_one.html +++ b/libmongoc/1.23.5/mongoc_collection_insert_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_keys_to_index_string.html b/libmongoc/1.23.5/mongoc_collection_keys_to_index_string.html index 23d5e9d7bf83cf3845235807fe6371da516dde42..70c1dc2cb29114fe98e6b9c4880791122b358794 100644 --- a/libmongoc/1.23.5/mongoc_collection_keys_to_index_string.html +++ b/libmongoc/1.23.5/mongoc_collection_keys_to_index_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_read_command_with_opts.html b/libmongoc/1.23.5/mongoc_collection_read_command_with_opts.html index e12386a5eb31a5f109ea02bd361ff148627958ce..4b6f7e03aff46baf8420b62d926d4d8ad2526760 100644 --- a/libmongoc/1.23.5/mongoc_collection_read_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_read_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_read_write_command_with_opts.html b/libmongoc/1.23.5/mongoc_collection_read_write_command_with_opts.html index 0d6d6a7f639e67782d5b23f36a7d4e5200ff84b2..ad4652402e9803b37b260daacb401f319ceff67f 100644 --- a/libmongoc/1.23.5/mongoc_collection_read_write_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_read_write_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_remove.html b/libmongoc/1.23.5/mongoc_collection_remove.html index 5ff23e76270b4212144c0be74f3b0878bd0e64ff..81399f6cd0d4519e1d9f5908d99a78e62c63a9d2 100644 --- a/libmongoc/1.23.5/mongoc_collection_remove.html +++ b/libmongoc/1.23.5/mongoc_collection_remove.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_rename.html b/libmongoc/1.23.5/mongoc_collection_rename.html index b685fe5b89ffe649ec9c7f835bb9d3dbdfff44c1..37c9e9da634a4936eb452f955dbc5f6850a5c65a 100644 --- a/libmongoc/1.23.5/mongoc_collection_rename.html +++ b/libmongoc/1.23.5/mongoc_collection_rename.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_rename_with_opts.html b/libmongoc/1.23.5/mongoc_collection_rename_with_opts.html index 459e173f9d4e7096a29ca4a40de35759bae4a715..959bc4daccf5deb2f85a81a4f9ce47f6b786c80c 100644 --- a/libmongoc/1.23.5/mongoc_collection_rename_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_rename_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_replace_one.html b/libmongoc/1.23.5/mongoc_collection_replace_one.html index d39f948bf28115635c392fb1f534e5752f93fefc..c5558c93c579025ae3e638653395a0e16c1e8465 100644 --- a/libmongoc/1.23.5/mongoc_collection_replace_one.html +++ b/libmongoc/1.23.5/mongoc_collection_replace_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_save.html b/libmongoc/1.23.5/mongoc_collection_save.html index b56caf59eb1e63df25b21bb2f5f1e7e879c54b7c..1d3d4551317061e68813bff2eaf6039af3b9f784 100644 --- a/libmongoc/1.23.5/mongoc_collection_save.html +++ b/libmongoc/1.23.5/mongoc_collection_save.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_set_read_concern.html b/libmongoc/1.23.5/mongoc_collection_set_read_concern.html index c401da9bca79ad303123fa6733720470dcdf59de..6538b226bead8464c2ad4312eb224ded29f958f1 100644 --- a/libmongoc/1.23.5/mongoc_collection_set_read_concern.html +++ b/libmongoc/1.23.5/mongoc_collection_set_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_set_read_prefs.html b/libmongoc/1.23.5/mongoc_collection_set_read_prefs.html index e343285544218fe6b06fc393acfb631f5e8f0e26..4c92a223fd8d0624a696c552d8c3340f2165103e 100644 --- a/libmongoc/1.23.5/mongoc_collection_set_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_collection_set_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_set_write_concern.html b/libmongoc/1.23.5/mongoc_collection_set_write_concern.html index 3c7f67112676ae09c30eb69e4e53ab35fcb3dd9a..855e85e2b862927530a6831ebbc9deea73564325 100644 --- a/libmongoc/1.23.5/mongoc_collection_set_write_concern.html +++ b/libmongoc/1.23.5/mongoc_collection_set_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_stats.html b/libmongoc/1.23.5/mongoc_collection_stats.html index df0a6e30ee885f5ed9f92b755a1ad4b73d17e446..628c6dde9de0c2df4e4a7c37011c610ee78c049b 100644 --- a/libmongoc/1.23.5/mongoc_collection_stats.html +++ b/libmongoc/1.23.5/mongoc_collection_stats.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_t.html b/libmongoc/1.23.5/mongoc_collection_t.html index 49900efaec70fcd87e25c6ab893300dc31999cc4..06c438a0c7e7032f3519efbb5d19d3385f414720 100644 --- a/libmongoc/1.23.5/mongoc_collection_t.html +++ b/libmongoc/1.23.5/mongoc_collection_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_update.html b/libmongoc/1.23.5/mongoc_collection_update.html index 1310d476fb2d9f1a66c441e3ea1157cd46613b7f..eee4979d21e29c3f1b060d718baf74f1d12b4108 100644 --- a/libmongoc/1.23.5/mongoc_collection_update.html +++ b/libmongoc/1.23.5/mongoc_collection_update.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_update_many.html b/libmongoc/1.23.5/mongoc_collection_update_many.html index 9d8549aa3b628a1a50e3ae270d1bf1940ae252c1..796533f812f423938782edff6317c7a6b58cf4bb 100644 --- a/libmongoc/1.23.5/mongoc_collection_update_many.html +++ b/libmongoc/1.23.5/mongoc_collection_update_many.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_update_one.html b/libmongoc/1.23.5/mongoc_collection_update_one.html index 871cd0da881c666cfdf2a0582a80d7fed1167ae3..c4a036f2a7960fdede128f2a64098b6d1994f4f1 100644 --- a/libmongoc/1.23.5/mongoc_collection_update_one.html +++ b/libmongoc/1.23.5/mongoc_collection_update_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_validate.html b/libmongoc/1.23.5/mongoc_collection_validate.html index e053a100c5db15a56855a9b00adaeda922674516..42cbeccc7f3d700aed95d70f7c520f1429398b84 100644 --- a/libmongoc/1.23.5/mongoc_collection_validate.html +++ b/libmongoc/1.23.5/mongoc_collection_validate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_watch.html b/libmongoc/1.23.5/mongoc_collection_watch.html index 0af14e059bad952f41411f9c1903d66d2c519c9e..555d2649d961e729a2673fb1008427083c5f6cd4 100644 --- a/libmongoc/1.23.5/mongoc_collection_watch.html +++ b/libmongoc/1.23.5/mongoc_collection_watch.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_collection_write_command_with_opts.html b/libmongoc/1.23.5/mongoc_collection_write_command_with_opts.html index 7828f1f4330515fb9533b69106f933c78492f263..46041e7257c2cee235cda609d1db82132e06fe5c 100644 --- a/libmongoc/1.23.5/mongoc_collection_write_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_collection_write_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_clone.html b/libmongoc/1.23.5/mongoc_cursor_clone.html index 1ea643f3baa236e281c58fbe6ea01ab86139f69b..7bcc5ce1ae751f2e9059848ac2bafef0d4fc8de6 100644 --- a/libmongoc/1.23.5/mongoc_cursor_clone.html +++ b/libmongoc/1.23.5/mongoc_cursor_clone.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_current.html b/libmongoc/1.23.5/mongoc_cursor_current.html index e7a35f4b1535b48daebb20bff53e4d338de83dda..3776b8cee119ea724fa1f611118e3004ce228dab 100644 --- a/libmongoc/1.23.5/mongoc_cursor_current.html +++ b/libmongoc/1.23.5/mongoc_cursor_current.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_destroy.html b/libmongoc/1.23.5/mongoc_cursor_destroy.html index ff43d8241f3e2234f25c2c8105c1cb890f3fb5bd..25ffa08f62ce4ed69397622f7f8092735b7be8c9 100644 --- a/libmongoc/1.23.5/mongoc_cursor_destroy.html +++ b/libmongoc/1.23.5/mongoc_cursor_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_error.html b/libmongoc/1.23.5/mongoc_cursor_error.html index 426c6f7e2757e47b3c3576d9cf89f5dce063f970..9651afb0ad264f274aab1edec35b92f26039a5db 100644 --- a/libmongoc/1.23.5/mongoc_cursor_error.html +++ b/libmongoc/1.23.5/mongoc_cursor_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_error_document.html b/libmongoc/1.23.5/mongoc_cursor_error_document.html index 31d586e8f335af968bf1674618329bbe56551954..25c874c9e6957dd768df9bffe5c1110a46eeb298 100644 --- a/libmongoc/1.23.5/mongoc_cursor_error_document.html +++ b/libmongoc/1.23.5/mongoc_cursor_error_document.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_get_batch_size.html b/libmongoc/1.23.5/mongoc_cursor_get_batch_size.html index 22fe2b0e418f9c2bf490b2947ba7c680c83152c6..8d1e34599790271b48f6cc67093d0eef584c5823 100644 --- a/libmongoc/1.23.5/mongoc_cursor_get_batch_size.html +++ b/libmongoc/1.23.5/mongoc_cursor_get_batch_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_get_hint.html b/libmongoc/1.23.5/mongoc_cursor_get_hint.html index e4439bf367f7f23541e64051d5ad183b95743772..a772647f1d0188dc1f388b496b257b79ffcd85aa 100644 --- a/libmongoc/1.23.5/mongoc_cursor_get_hint.html +++ b/libmongoc/1.23.5/mongoc_cursor_get_hint.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_get_host.html b/libmongoc/1.23.5/mongoc_cursor_get_host.html index a29d4406ab528eb542b694d54e60a14a598b37a5..2f7cbf0bff5953463e1b997bcc461c90a2172f2f 100644 --- a/libmongoc/1.23.5/mongoc_cursor_get_host.html +++ b/libmongoc/1.23.5/mongoc_cursor_get_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_get_id.html b/libmongoc/1.23.5/mongoc_cursor_get_id.html index ea90cb459714ad87c796280e1e088e5aac7b41e3..12845adf78ada829bfe90295e72e7420fbc992ca 100644 --- a/libmongoc/1.23.5/mongoc_cursor_get_id.html +++ b/libmongoc/1.23.5/mongoc_cursor_get_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_get_limit.html b/libmongoc/1.23.5/mongoc_cursor_get_limit.html index 0fe7655a77a11604b2642b27e34c7218da47de08..5199b40a2133ad29d379a89be9a8ab7c7fd138ac 100644 --- a/libmongoc/1.23.5/mongoc_cursor_get_limit.html +++ b/libmongoc/1.23.5/mongoc_cursor_get_limit.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_get_max_await_time_ms.html b/libmongoc/1.23.5/mongoc_cursor_get_max_await_time_ms.html index 60b5d923b15240d73e900083edb26b5f77132113..0061e492618acde3401ad66c8c79a1a2a08f7309 100644 --- a/libmongoc/1.23.5/mongoc_cursor_get_max_await_time_ms.html +++ b/libmongoc/1.23.5/mongoc_cursor_get_max_await_time_ms.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_is_alive.html b/libmongoc/1.23.5/mongoc_cursor_is_alive.html index cf25541e5276d548f35df569b96e7483b725f728..9b5f40a2a9008273996fbfa7c17a666ef160d8a6 100644 --- a/libmongoc/1.23.5/mongoc_cursor_is_alive.html +++ b/libmongoc/1.23.5/mongoc_cursor_is_alive.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_more.html b/libmongoc/1.23.5/mongoc_cursor_more.html index 7990deef0336807f865beb1a58d9246ee82f4715..9754896825c39c8beb635a6ea50c377285063faa 100644 --- a/libmongoc/1.23.5/mongoc_cursor_more.html +++ b/libmongoc/1.23.5/mongoc_cursor_more.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply.html b/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply.html index 8032c8f515e09d8d37188005957402b32616ccc7..9200976e95e4094be65a4552b6fcbddc7dfadcf5 100644 --- a/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply.html +++ b/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply_with_opts.html b/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply_with_opts.html index a34047ad9d4f6f7837c2e954e7336937265e37b7..24d1466ea7f0a2473cea10cd855ef6ed93257c13 100644 --- a/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply_with_opts.html +++ b/libmongoc/1.23.5/mongoc_cursor_new_from_command_reply_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_next.html b/libmongoc/1.23.5/mongoc_cursor_next.html index 58b881a1dbb7e3cffea30f9a250815dc255d2ea1..00df838b591c4d356a5a908c6ca8fefb86b63d31 100644 --- a/libmongoc/1.23.5/mongoc_cursor_next.html +++ b/libmongoc/1.23.5/mongoc_cursor_next.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_set_batch_size.html b/libmongoc/1.23.5/mongoc_cursor_set_batch_size.html index d38db098593790be2167472cfcc31b0b8c085934..a8ea7d239c365347bf2b0079e577b03eb887502e 100644 --- a/libmongoc/1.23.5/mongoc_cursor_set_batch_size.html +++ b/libmongoc/1.23.5/mongoc_cursor_set_batch_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_set_hint.html b/libmongoc/1.23.5/mongoc_cursor_set_hint.html index 9cfb8805c005bb6bae6c510c28e8d7f7a7c64061..d1e960ddefecd4065f97ee4040c5ac4c1dd51bae 100644 --- a/libmongoc/1.23.5/mongoc_cursor_set_hint.html +++ b/libmongoc/1.23.5/mongoc_cursor_set_hint.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_set_limit.html b/libmongoc/1.23.5/mongoc_cursor_set_limit.html index 3b0da68ab5bdb94bcf3e2280de7f6f45577baf8a..cbea7d9bb53bf033371d3a9de234f8376ece2f7a 100644 --- a/libmongoc/1.23.5/mongoc_cursor_set_limit.html +++ b/libmongoc/1.23.5/mongoc_cursor_set_limit.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_set_max_await_time_ms.html b/libmongoc/1.23.5/mongoc_cursor_set_max_await_time_ms.html index 93ae017d3f12b2c5aa1e44445b8753818389d402..fdae8b00507a082e26891ebf539c5e3c8bf2b913 100644 --- a/libmongoc/1.23.5/mongoc_cursor_set_max_await_time_ms.html +++ b/libmongoc/1.23.5/mongoc_cursor_set_max_await_time_ms.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_cursor_t.html b/libmongoc/1.23.5/mongoc_cursor_t.html index 32fef7d68a4ab5e02b92de22c3dd9d78c75540d4..233f81e30b581089ab84ede54eba82104f5c4ad3 100644 --- a/libmongoc/1.23.5/mongoc_cursor_t.html +++ b/libmongoc/1.23.5/mongoc_cursor_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_add_user.html b/libmongoc/1.23.5/mongoc_database_add_user.html index 4d7b009b901a893a2db7acc424a8d405c60da75c..4e4b4957d76297ab9f9df4a76405fb2e4ca4133d 100644 --- a/libmongoc/1.23.5/mongoc_database_add_user.html +++ b/libmongoc/1.23.5/mongoc_database_add_user.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_aggregate.html b/libmongoc/1.23.5/mongoc_database_aggregate.html index bae154e84ead9fc12648f8c56710616432d5c5e0..152f8a916e1a12766f6efa5a1e5beb19ab7bd4d8 100644 --- a/libmongoc/1.23.5/mongoc_database_aggregate.html +++ b/libmongoc/1.23.5/mongoc_database_aggregate.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_command.html b/libmongoc/1.23.5/mongoc_database_command.html index 4714ccddf89afe6b7759ac154069eb91484d88dd..6bf79a91bda7886123d474cc72af785593cdf9f8 100644 --- a/libmongoc/1.23.5/mongoc_database_command.html +++ b/libmongoc/1.23.5/mongoc_database_command.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_command_simple.html b/libmongoc/1.23.5/mongoc_database_command_simple.html index 079daff51c1b48b8d1dcf73cbb0d322e2907704c..ef95fca8dd89f31d42d1983ff398daf6fbbf9571 100644 --- a/libmongoc/1.23.5/mongoc_database_command_simple.html +++ b/libmongoc/1.23.5/mongoc_database_command_simple.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_command_with_opts.html b/libmongoc/1.23.5/mongoc_database_command_with_opts.html index bc8441d4066aaa55714264baa4cace5956a4da9d..6d81a5ac9579ddf98574704fcf46ec988f24b2c8 100644 --- a/libmongoc/1.23.5/mongoc_database_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_copy.html b/libmongoc/1.23.5/mongoc_database_copy.html index 99bbb5483004135f676b40afd2594c917a00d111..12ac09e0ddb246bbbfac2a7ac50505e562e46824 100644 --- a/libmongoc/1.23.5/mongoc_database_copy.html +++ b/libmongoc/1.23.5/mongoc_database_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_create_collection.html b/libmongoc/1.23.5/mongoc_database_create_collection.html index be5962e6fcf182073d50fe71c4e988432d426c4b..e797563558eb4d953b3118148f743f129e172fbd 100644 --- a/libmongoc/1.23.5/mongoc_database_create_collection.html +++ b/libmongoc/1.23.5/mongoc_database_create_collection.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_destroy.html b/libmongoc/1.23.5/mongoc_database_destroy.html index 76a4bedf4f6d859cee2861709b102615ede68db0..1e51eb15a8d99c3b3d2f9eb1e31c2628d238f50e 100644 --- a/libmongoc/1.23.5/mongoc_database_destroy.html +++ b/libmongoc/1.23.5/mongoc_database_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_drop.html b/libmongoc/1.23.5/mongoc_database_drop.html index 30c33231e29972e8f47e1d2909b41283f6eea090..dc67650d3b15d9a87fd43036f247ed12a0132dfc 100644 --- a/libmongoc/1.23.5/mongoc_database_drop.html +++ b/libmongoc/1.23.5/mongoc_database_drop.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_drop_with_opts.html b/libmongoc/1.23.5/mongoc_database_drop_with_opts.html index 8c149666e663ef787db8e587a322592e88bb228b..72d5a5a9b929b59c8325ff7ac895a96185225ff6 100644 --- a/libmongoc/1.23.5/mongoc_database_drop_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_drop_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_find_collections.html b/libmongoc/1.23.5/mongoc_database_find_collections.html index 0f456d7a39ad3b52a50cb23f0836c3e46455e744..b668ca9359cf1f8031b58b0e5517aa14e92e8317 100644 --- a/libmongoc/1.23.5/mongoc_database_find_collections.html +++ b/libmongoc/1.23.5/mongoc_database_find_collections.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_find_collections_with_opts.html b/libmongoc/1.23.5/mongoc_database_find_collections_with_opts.html index 090339a993ffa278a29feffbe1506819875452d9..d78ecc00e99eeb1c0e0460ad0bdd7ebaeb0d49d0 100644 --- a/libmongoc/1.23.5/mongoc_database_find_collections_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_find_collections_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_collection.html b/libmongoc/1.23.5/mongoc_database_get_collection.html index 12a29000502636af84880858256963574730a4ec..f62e267d4e3d7d2babb9ed613706c352ceaac6be 100644 --- a/libmongoc/1.23.5/mongoc_database_get_collection.html +++ b/libmongoc/1.23.5/mongoc_database_get_collection.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_collection_names.html b/libmongoc/1.23.5/mongoc_database_get_collection_names.html index cc1579e180f9ef9ba645b6590ada47200ce4ff08..bcc69005738ebed6464e18c3c64d163edacb6d09 100644 --- a/libmongoc/1.23.5/mongoc_database_get_collection_names.html +++ b/libmongoc/1.23.5/mongoc_database_get_collection_names.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_collection_names_with_opts.html b/libmongoc/1.23.5/mongoc_database_get_collection_names_with_opts.html index 2fe1cf03e174c73260a24dee32e0e5b195e8f46d..bfda5d893bef5b874784ddc86a45b9d88f2e0194 100644 --- a/libmongoc/1.23.5/mongoc_database_get_collection_names_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_get_collection_names_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_name.html b/libmongoc/1.23.5/mongoc_database_get_name.html index 38d9186b7488e520157694811dbd127a0ad8d42b..e93c8c567043f09a74773d93f0fe4642e16152cf 100644 --- a/libmongoc/1.23.5/mongoc_database_get_name.html +++ b/libmongoc/1.23.5/mongoc_database_get_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_read_concern.html b/libmongoc/1.23.5/mongoc_database_get_read_concern.html index dc30980a26c02b1214fe619140aa8f26971a1127..e792aa55dd663d7a951da000ca99e844f80d33f1 100644 --- a/libmongoc/1.23.5/mongoc_database_get_read_concern.html +++ b/libmongoc/1.23.5/mongoc_database_get_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_read_prefs.html b/libmongoc/1.23.5/mongoc_database_get_read_prefs.html index 2cc237e4fd0fc491e3135ac0a52c1f0fac633e70..3b803c7a100eebe1da9ec63a94130ed994d2caca 100644 --- a/libmongoc/1.23.5/mongoc_database_get_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_database_get_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_get_write_concern.html b/libmongoc/1.23.5/mongoc_database_get_write_concern.html index 5a2c94c42d329ba5139d6788ec018e342f8f8d5b..39460fd807d0acf30a5f41c33a6458de2aefdfe2 100644 --- a/libmongoc/1.23.5/mongoc_database_get_write_concern.html +++ b/libmongoc/1.23.5/mongoc_database_get_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_has_collection.html b/libmongoc/1.23.5/mongoc_database_has_collection.html index cc2628bff5947a6f26a94dcb5b2027484b7fe78d..94e30c4c3950c0f34b7988311b2c4c7ac862d2c9 100644 --- a/libmongoc/1.23.5/mongoc_database_has_collection.html +++ b/libmongoc/1.23.5/mongoc_database_has_collection.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_read_command_with_opts.html b/libmongoc/1.23.5/mongoc_database_read_command_with_opts.html index af7076ef2751550a0c009debe64e741bac52eca7..d86ca8b3855315c443ebc0b76db3a5ae879564d4 100644 --- a/libmongoc/1.23.5/mongoc_database_read_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_read_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_read_write_command_with_opts.html b/libmongoc/1.23.5/mongoc_database_read_write_command_with_opts.html index 7c7f7cbe138817ee8a2fa71ef147c5828fb76239..b7399d80f58ff078437b5be7b5f68330dbccb41d 100644 --- a/libmongoc/1.23.5/mongoc_database_read_write_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_read_write_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_remove_all_users.html b/libmongoc/1.23.5/mongoc_database_remove_all_users.html index 36657e3f12c6029676fd94d1e0c4fd8d40faefaa..3e39f0bd625f2ddf4a876dc0570787c276d5f232 100644 --- a/libmongoc/1.23.5/mongoc_database_remove_all_users.html +++ b/libmongoc/1.23.5/mongoc_database_remove_all_users.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_remove_user.html b/libmongoc/1.23.5/mongoc_database_remove_user.html index 0ba5f1a0d7e434c398d9e3e6ff576e2d92ba3d63..f2f7cd369bdda90a3b16bfa76d46a2c43d9faf7c 100644 --- a/libmongoc/1.23.5/mongoc_database_remove_user.html +++ b/libmongoc/1.23.5/mongoc_database_remove_user.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_set_read_concern.html b/libmongoc/1.23.5/mongoc_database_set_read_concern.html index e7aa5eb511bfe159314ee439df2c0fb6a297e92b..3eec59eebc65e99424e2636e1f341e25f44804f6 100644 --- a/libmongoc/1.23.5/mongoc_database_set_read_concern.html +++ b/libmongoc/1.23.5/mongoc_database_set_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_set_read_prefs.html b/libmongoc/1.23.5/mongoc_database_set_read_prefs.html index d6b525cb38bd2b8b99bd5a5fa20fd4ad5bcab2da..6c6e53533ecf1e871f3baf6237f04d076c11bdc7 100644 --- a/libmongoc/1.23.5/mongoc_database_set_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_database_set_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_set_write_concern.html b/libmongoc/1.23.5/mongoc_database_set_write_concern.html index 4f3c67c5271ad2afd71073a6a51db08e65f9be1e..4e70ac2826e843c653c2ff844b0637ed44a32f4b 100644 --- a/libmongoc/1.23.5/mongoc_database_set_write_concern.html +++ b/libmongoc/1.23.5/mongoc_database_set_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_t.html b/libmongoc/1.23.5/mongoc_database_t.html index 3ace64216ad0422a17f79e53145a32d1aba98a53..121f2e58d27702655bd0d00462a73ccfa1024841 100644 --- a/libmongoc/1.23.5/mongoc_database_t.html +++ b/libmongoc/1.23.5/mongoc_database_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_watch.html b/libmongoc/1.23.5/mongoc_database_watch.html index 9ce2713ad50db561cec21c351711bfe227de77f8..16832dc1770eceaa728318952e785f40f6ea034e 100644 --- a/libmongoc/1.23.5/mongoc_database_watch.html +++ b/libmongoc/1.23.5/mongoc_database_watch.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_database_write_command_with_opts.html b/libmongoc/1.23.5/mongoc_database_write_command_with_opts.html index 5cebec01fbb026377da6856c5e1cb2fef0346d00..c68bab2800340df87bf65f3a0701fe3157d42902 100644 --- a/libmongoc/1.23.5/mongoc_database_write_command_with_opts.html +++ b/libmongoc/1.23.5/mongoc_database_write_command_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_delete_flags_t.html b/libmongoc/1.23.5/mongoc_delete_flags_t.html index 5b22fbb2752177d1d1a1dc07f31b757fa482f773..0ced77f6b8d9a6893a76e43dda0b550dc7dda384 100644 --- a/libmongoc/1.23.5/mongoc_delete_flags_t.html +++ b/libmongoc/1.23.5/mongoc_delete_flags_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_error_has_label.html b/libmongoc/1.23.5/mongoc_error_has_label.html index ee541c6f3aa47de2dd061336d55a9544c96d3cdb..485821182a1e4f0ba0ec400ceca99d9080ff82c6 100644 --- a/libmongoc/1.23.5/mongoc_error_has_label.html +++ b/libmongoc/1.23.5/mongoc_error_has_label.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_append.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_append.html index f906aedfd0f62033864ef26106d473e79120b13d..04ccc4ff0292d74344827bdcb28c4848b380d6d4 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_append.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_destroy.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_destroy.html index 3338dae9e4128188586ce4893c03c849949e3020..dd036cd0b9682a3c8c4b4e2868805c19b8048a25 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_bypass_document_validation.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_bypass_document_validation.html index 75c92e0480df8acd6959723d19e8f00b824928a1..6e10fec15285851802ec8c2723cf0d0931e9379f 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_bypass_document_validation.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_bypass_document_validation.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_fields.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_fields.html index da2eea73a9e05c51cd9222f8d83ec380da38eb05..1918322524bde819539995a34dd572848428d66f 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_fields.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_fields.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_flags.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_flags.html index 55f362c1451039f1f8e79821585c1baddfb9e3f0..df6fef706330b85e6be05a643c62d2dff92e2ec9 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_flags.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_flags.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_max_time_ms.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_max_time_ms.html index 556c5801e6ae45d454f1e2c1145affa58d809397..a2734e33a06d91f3d2e7415924e8bcdd4c47fa45 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_max_time_ms.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_max_time_ms.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_sort.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_sort.html index daa1d5c6f8f2e133e679caa6d187b3f47ad8307b..a3578a8c511f211e2c5f6bc1434e4fef52058264 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_sort.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_sort.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_update.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_update.html index 06b7d59807930d0c8175ba0688ddf88d2e09e48c..70f89fd14ae13fa72307a4b067a70cda05aa6141 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_update.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_get_update.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_new.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_new.html index d6188960b51de277cf8b65fb6f6bcef28d494763..8905e3f94d3fbc7b3430584069188ac6027d9e3d 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_new.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_bypass_document_validation.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_bypass_document_validation.html index f5ede8c3115f0d2e7736e8813d9f0e3690509950..66e60053caa0441d5098aa0ee62a51cc4f8cb084 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_bypass_document_validation.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_bypass_document_validation.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_fields.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_fields.html index 40f53d0757e09e23ef30ec47b0525fbce510e834..d6a4f047703f84b00d15849eba308f0c76a6e3e7 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_fields.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_fields.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_flags.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_flags.html index 5cf808ecdb17445df09728f388f2e4ae4bb435ec..17d8283732a4feaebdb78021605b50846d341e2d 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_flags.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_flags.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_max_time_ms.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_max_time_ms.html index 8f3aaf52867863cb8476d5f7e477da5ff60cb8b5..8a3d0532a484a3099714536a0a8bc81a1b4b384c 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_max_time_ms.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_max_time_ms.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_sort.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_sort.html index c3ee4cfddf15c971e17c7cc99b7ce0e5270ae44d..39abed7d558b83659d229cc9fdef689c798c8dbb 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_sort.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_sort.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_update.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_update.html index 28566d82672ad222d14bd57e1cb0f09b5e5a9542..d657297facb099274f980a1c7c47727628598d93 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_update.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_set_update.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_find_and_modify_opts_t.html b/libmongoc/1.23.5/mongoc_find_and_modify_opts_t.html index a978026ac8251f377666b34db38f3859b8cd07af..196d708763e3e69b2bbaf154c7381cbd777d883c 100644 --- a/libmongoc/1.23.5/mongoc_find_and_modify_opts_t.html +++ b/libmongoc/1.23.5/mongoc_find_and_modify_opts_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_get_major_version.html b/libmongoc/1.23.5/mongoc_get_major_version.html index 84191fa48fdc0732306dec31d14937c3830b5196..8ad03527506f65244e61990aced8e2191923aea6 100644 --- a/libmongoc/1.23.5/mongoc_get_major_version.html +++ b/libmongoc/1.23.5/mongoc_get_major_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_get_micro_version.html b/libmongoc/1.23.5/mongoc_get_micro_version.html index 712ab4bc41bdf43e0d4d178fe02dd4269a0374c4..b9d046356d9138b56ac549d7ba05be0dfdbd4ca1 100644 --- a/libmongoc/1.23.5/mongoc_get_micro_version.html +++ b/libmongoc/1.23.5/mongoc_get_micro_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_get_minor_version.html b/libmongoc/1.23.5/mongoc_get_minor_version.html index f6ccd55cdf284f944d55e030dc90cc127dec6996..f1017276c7ee35888c1f9751b7a2e1819bdae8cd 100644 --- a/libmongoc/1.23.5/mongoc_get_minor_version.html +++ b/libmongoc/1.23.5/mongoc_get_minor_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_get_version.html b/libmongoc/1.23.5/mongoc_get_version.html index ad7b27cecc67d2145446bb070685a5db9c1aec5d..32102c4c9eac61569e3dd45bc7eb17dd32fc5461 100644 --- a/libmongoc/1.23.5/mongoc_get_version.html +++ b/libmongoc/1.23.5/mongoc_get_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_abort_upload.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_abort_upload.html index 301c06e5434cae4d14d9929b7b86007b8f84dfaf..ec692162bb862119cfa9ffeb1df701c82a9a7b31 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_abort_upload.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_abort_upload.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_delete_by_id.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_delete_by_id.html index 7f908597c2dc562f4f75dca8bf2c2aef3ea29f6d..d4de48d2070382f6763dff1f94e58f8fe4332581 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_delete_by_id.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_delete_by_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_destroy.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_destroy.html index 540287ce251c1a8b3d86fcfae0da450b2b6d37e4..c2cd6f2e32cc3dd1a8101512419008c779b6039a 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_destroy.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_download_to_stream.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_download_to_stream.html index c30ab47199f7f63a400b4e8cd0f9b6d19f245f63..f26f6e76f710ecbe5a9fca55b1ebe8cb39add607 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_download_to_stream.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_download_to_stream.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_find.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_find.html index 84ec0162bfc817aacc996e74f9f9695bd27bb6f4..bbc8e53c31efb3c38fffc15ffb73f1351478ad89 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_find.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_find.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_new.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_new.html index 1cd4a7aef906dc3a750bfc50346748125f59181b..260bf078cc14a97f8329db112086155ba89ece4a 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_new.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_open_download_stream.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_open_download_stream.html index f5f2fc816f0cc1c8dd69eb04e3ddac5b488fc611..e5e2fa8cb998c3d63be8b17fa8e3fa234345bd98 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_open_download_stream.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_open_download_stream.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream.html index 7458b996c4eed8c4e0e8c5cf3f74a0d014104723..8ade686fca0c448f032e9f0a9a0b217dd5b7bd53 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream_with_id.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream_with_id.html index a969c343343a6dc5de7b47023a8bbab9730769ed..59a93bc6974c98f6a2b9f7799938f5645830f9d1 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream_with_id.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_open_upload_stream_with_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_stream_error.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_stream_error.html index 4844009892f0340afcfb61796b60e52c982d24f6..553ee2f4f525766f520ea147ef1a810c9ed7180e 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_stream_error.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_stream_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_t.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_t.html index f55d8efd5ff949bd5d0bb8c38a93726d20ca4cc0..7dbec9a32d4a59881a8e592ca6fc593f434cc4ea 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_t.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream.html index edcad4c55f5189c89d9e203396c4e3aff47a8402..95b4689b871b43a82d0916d0d765a806a0ece436 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream_with_id.html b/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream_with_id.html index 13d640de222f562477b6d7f7e458c07550b909b3..02ea2a6c5de9d21ebe09f63555e670f398ee9949 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream_with_id.html +++ b/libmongoc/1.23.5/mongoc_gridfs_bucket_upload_from_stream_with_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_create_file.html b/libmongoc/1.23.5/mongoc_gridfs_create_file.html index 126d2dc6fbdbcd7af8ffb6268fac92515b0097c7..083edfccc93fec0397205b46d0bae70fa7a29bfa 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_create_file.html +++ b/libmongoc/1.23.5/mongoc_gridfs_create_file.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_create_file_from_stream.html b/libmongoc/1.23.5/mongoc_gridfs_create_file_from_stream.html index 58b0857f3377407447b323c572bbcb2adc4e85c5..752a36af427990a438b4a14cde752f76b1de1bc6 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_create_file_from_stream.html +++ b/libmongoc/1.23.5/mongoc_gridfs_create_file_from_stream.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_destroy.html b/libmongoc/1.23.5/mongoc_gridfs_destroy.html index 5c564d82c1ad40195977fd9b8792f1244b666ec2..d8481a62bb01a81033fba1e8d427f66d659aea52 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_destroy.html +++ b/libmongoc/1.23.5/mongoc_gridfs_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_drop.html b/libmongoc/1.23.5/mongoc_gridfs_drop.html index e490836392489dc0bb4e11645fab6e8813154f07..5cba1c8219eb5f535901c65989a049b0b712a869 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_drop.html +++ b/libmongoc/1.23.5/mongoc_gridfs_drop.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_destroy.html b/libmongoc/1.23.5/mongoc_gridfs_file_destroy.html index 2d02eb315934abe938479a082f7ac5e206ed2603..8196891aeb1629518569f4649dba917f28fede99 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_destroy.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_error.html b/libmongoc/1.23.5/mongoc_gridfs_file_error.html index 94a4979d10cfec7b49b8b47c4128c26a1a68307f..fb34fea39adaf121cbde243ce333048a66bfa1f8 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_error.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_aliases.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_aliases.html index 7d206852c5094a87a94683c63ba0574a5d6db943..a59ac103934faff1d71f056dedd0981c01a2f810 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_aliases.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_aliases.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_chunk_size.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_chunk_size.html index 8c4f47ff67c76b08692c12765bcf50b7137d06c8..8a6e29106ad53459d20a5efba2b55b30bdd5f30a 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_chunk_size.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_chunk_size.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_content_type.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_content_type.html index 1f248a2a1c27a704571ae25096c21830e5a058c1..27b288665c76f4c85df63bd40e5f022131818930 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_content_type.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_content_type.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_filename.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_filename.html index 5c9668f2f03e20183a5cd3bcda2b856531784fed..aaf241fb1f482e433661d38feb0b7c6da7f34795 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_filename.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_filename.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_id.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_id.html index 80f2d6d7405daa74e704a18e4dd019b6398513af..25f28862d87f8a9688e69dfe3d38433799fefdd5 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_id.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_length.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_length.html index 21cb66a3f6e595e0f46fb22762286c1470faff60..26bc14ab3a8b3650098ac2ac5097ecbdc61d0df0 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_length.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_length.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_md5.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_md5.html index dcfee90be461ecc039615234dcfa0b09910a3b6c..828785534a84e807a3586fa405ccefe98ef129c3 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_md5.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_md5.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_metadata.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_metadata.html index a90730cadf8ff1ed4b7e333cbe111dbd8404c084..37b39c0bc7c8eeddd5f5e16e540468f8a6f5d0ad 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_metadata.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_metadata.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_get_upload_date.html b/libmongoc/1.23.5/mongoc_gridfs_file_get_upload_date.html index 814f48404d71da474b0fbdf0146d46ebf49f1b2d..29f5c87a20b8b922b4c376e371e085e892202f94 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_get_upload_date.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_get_upload_date.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_list_destroy.html b/libmongoc/1.23.5/mongoc_gridfs_file_list_destroy.html index 525fa30986769a5efe930af2ef064654e8c1190b..8e89ed950e2a355a7449643bb3ba73acff3999c6 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_list_destroy.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_list_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_list_error.html b/libmongoc/1.23.5/mongoc_gridfs_file_list_error.html index 1021382f3100904c9b131b6bbc4019318b3a7bdd..0db09c43614c7776102f0633b83c9bae6d302743 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_list_error.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_list_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_list_next.html b/libmongoc/1.23.5/mongoc_gridfs_file_list_next.html index 10a58467310853a68c5f25699d6ff41cfadac6cb..afa6b3b3d3faec6fb3f5ae2bc006af4b4935f3ef 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_list_next.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_list_next.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_list_t.html b/libmongoc/1.23.5/mongoc_gridfs_file_list_t.html index 8ca7baf0ab65c6fff271cfe0e753cdc75e076b2a..3d08f89a3d10c6b87f1fefc60790f0dc8ddfc32a 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_list_t.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_list_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_opt_t.html b/libmongoc/1.23.5/mongoc_gridfs_file_opt_t.html index 4b5956f8ca5c1ec540324f3ab8eb3b581be1390f..ab91b4725f73e370d53d6f2553caf326afb12626 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_opt_t.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_opt_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_readv.html b/libmongoc/1.23.5/mongoc_gridfs_file_readv.html index 12bd349487e7729a845dcbf594b5a76f1556b0ca..bb235d2ee6ccec7269ae5b6517c51bec9f09c25c 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_readv.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_readv.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_remove.html b/libmongoc/1.23.5/mongoc_gridfs_file_remove.html index 5b8201c3e53e1a7a4a23609a0f8500cd1d00810d..ec0fd3a4f2deba3848ca79693228b6a782039d29 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_remove.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_remove.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_save.html b/libmongoc/1.23.5/mongoc_gridfs_file_save.html index 1549c6f98e81c8964dc87d6a5639ab4ebcb652bc..36452cdad1ac20fd44576e5a06999e56d68f2a55 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_save.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_save.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_seek.html b/libmongoc/1.23.5/mongoc_gridfs_file_seek.html index 921bb5f7e5be0960826915ab99c11c07e98d1157..cb71efecb427ebf33a89393f038422e76399c449 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_seek.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_seek.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_set_aliases.html b/libmongoc/1.23.5/mongoc_gridfs_file_set_aliases.html index 6f23e232c4b19a2a3398ea5d4d1c22c25bcd82e5..9e7be8c6bda26b4f47f84a459188f269daf6217a 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_set_aliases.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_set_aliases.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_set_content_type.html b/libmongoc/1.23.5/mongoc_gridfs_file_set_content_type.html index e0b38cc6181d15e6d24b6904f2bf7501f1842046..c91b8064f13e9a3307a043e5e58c1a17032d5053 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_set_content_type.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_set_content_type.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_set_filename.html b/libmongoc/1.23.5/mongoc_gridfs_file_set_filename.html index 6e3c7b7a3ecfce2735676fd964d47774e82d6a76..d302360b2084a0d43cd94d5fdb902313f4f4118c 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_set_filename.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_set_filename.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_set_id.html b/libmongoc/1.23.5/mongoc_gridfs_file_set_id.html index b9006409b0b90635a229291e6788dc391d114ca4..3db7633a08120f093fa524e070ec4e7b276cc19a 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_set_id.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_set_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_set_md5.html b/libmongoc/1.23.5/mongoc_gridfs_file_set_md5.html index 0adb6ffd8b7b34bdb36012863e42f0f6ce83f50b..db23a591e9891e0043760bc3d4600ce77baa8c4c 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_set_md5.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_set_md5.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_set_metadata.html b/libmongoc/1.23.5/mongoc_gridfs_file_set_metadata.html index b376d5697b9fee5f5769a1f73f5aacef4b35d1c1..beb612242d94ab1e39b349f33e9b1e340388a7f0 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_set_metadata.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_set_metadata.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_t.html b/libmongoc/1.23.5/mongoc_gridfs_file_t.html index 1548b8e7553557230258746a5de4934a7390a19c..74fbf8c09e3c172881c0c7d0c64104f50dcacf76 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_t.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_tell.html b/libmongoc/1.23.5/mongoc_gridfs_file_tell.html index 811138a83ec4e5fa02ca5e0f878addcacfd2e2be..a0611d38ab9fcc5318ba98a3e8a95ed8a0f92fe5 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_tell.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_tell.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_file_writev.html b/libmongoc/1.23.5/mongoc_gridfs_file_writev.html index 7ec16f35c16c1e247d96fa6e8a718ef53a1ab33f..8fc10d1c342aeab518666ee83bcd32bc8e33edf4 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_file_writev.html +++ b/libmongoc/1.23.5/mongoc_gridfs_file_writev.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_find.html b/libmongoc/1.23.5/mongoc_gridfs_find.html index ddba75c99ea3992ddd404866ec524f65c4e5ed94..b1497a9fb389d07aa00ca70fb3d9d1d8041e573d 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_find.html +++ b/libmongoc/1.23.5/mongoc_gridfs_find.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_find_one.html b/libmongoc/1.23.5/mongoc_gridfs_find_one.html index 5beaf6b3fcad8048cf795d895e9fc41f04fe0fe7..085e8d9db394fa18b1efabe57ef9a1abef8cdcce 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_find_one.html +++ b/libmongoc/1.23.5/mongoc_gridfs_find_one.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_find_one_by_filename.html b/libmongoc/1.23.5/mongoc_gridfs_find_one_by_filename.html index f49e24a3c3660e65637fb2cee49b802380e59438..e9d79b984f54737fd9a1e4cb5e6124cdeebacdfc 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_find_one_by_filename.html +++ b/libmongoc/1.23.5/mongoc_gridfs_find_one_by_filename.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_find_one_with_opts.html b/libmongoc/1.23.5/mongoc_gridfs_find_one_with_opts.html index 3456f563a7e45fa0e3c0a756fdab3c521f0319f2..5f70f4b4592a496ba28133c2fbe340e8aa5897da 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_find_one_with_opts.html +++ b/libmongoc/1.23.5/mongoc_gridfs_find_one_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_find_with_opts.html b/libmongoc/1.23.5/mongoc_gridfs_find_with_opts.html index 15d74b8fefdd09cd0be09cfe646ce13f9714da00..dc37e47ce78f929b28abacce86ed1817fae992a2 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_find_with_opts.html +++ b/libmongoc/1.23.5/mongoc_gridfs_find_with_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_get_chunks.html b/libmongoc/1.23.5/mongoc_gridfs_get_chunks.html index 5dea089d73a2e6422fa87afb5904a97214e5ad93..f69ca739591a16af05b3c0bfb26b742925fa53b0 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_get_chunks.html +++ b/libmongoc/1.23.5/mongoc_gridfs_get_chunks.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_get_files.html b/libmongoc/1.23.5/mongoc_gridfs_get_files.html index 55cb7de022b3af2d5b7adbf289e455853890952c..2051cc9ad35741a43be017e4a7dd743cff6ab4fc 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_get_files.html +++ b/libmongoc/1.23.5/mongoc_gridfs_get_files.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_remove_by_filename.html b/libmongoc/1.23.5/mongoc_gridfs_remove_by_filename.html index 3c268881c44d276e4cd653c80f159a97deaeccb6..cbc665c3806d2a6e3d970d37576c5b5e02415b0e 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_remove_by_filename.html +++ b/libmongoc/1.23.5/mongoc_gridfs_remove_by_filename.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_gridfs_t.html b/libmongoc/1.23.5/mongoc_gridfs_t.html index 06212944d75195fdb0b9ee29d6d6df34e99d08e8..f9ef7fad8e380d5ec8cf16686c13fb75e2084980 100644 --- a/libmongoc/1.23.5/mongoc_gridfs_t.html +++ b/libmongoc/1.23.5/mongoc_gridfs_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_handshake_data_append.html b/libmongoc/1.23.5/mongoc_handshake_data_append.html index 22cfaeb5d3cf36f5a201c0cec17d9856f2c7ec21..4b57178636f41ce3a09acbfc7c974206b24c9f83 100644 --- a/libmongoc/1.23.5/mongoc_handshake_data_append.html +++ b/libmongoc/1.23.5/mongoc_handshake_data_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_host_list_t.html b/libmongoc/1.23.5/mongoc_host_list_t.html index f4a7ed7cdf19e81d4fb6c5cb6fe93e1ff7d62f46..5322418a047b038c5459dcc58ea360c5a425b6e1 100644 --- a/libmongoc/1.23.5/mongoc_host_list_t.html +++ b/libmongoc/1.23.5/mongoc_host_list_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_geo_get_default.html b/libmongoc/1.23.5/mongoc_index_opt_geo_get_default.html index 4edc2ac5688ba8f629b66669c0c14b7857c7d92f..6279edd5d9a738af781edd2c073ca63c4e3aff1e 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_geo_get_default.html +++ b/libmongoc/1.23.5/mongoc_index_opt_geo_get_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_geo_init.html b/libmongoc/1.23.5/mongoc_index_opt_geo_init.html index 582a376478192fb0a8136dbe62fc5c7d87c813cb..946df059e55d13a40c60b4c64af0cf4dd0e53f21 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_geo_init.html +++ b/libmongoc/1.23.5/mongoc_index_opt_geo_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_geo_t.html b/libmongoc/1.23.5/mongoc_index_opt_geo_t.html index 36c604d3a19d15089c04b819f9ba11697713cd43..efc39e882499a48b6eafa8cdfdb31721de15a2f0 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_geo_t.html +++ b/libmongoc/1.23.5/mongoc_index_opt_geo_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_get_default.html b/libmongoc/1.23.5/mongoc_index_opt_get_default.html index ed7517ab7f1d9e3b77b745a4eed271f47fd1e746..4cc6aa336eaee69c837c0cc8e74824915f2905b2 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_get_default.html +++ b/libmongoc/1.23.5/mongoc_index_opt_get_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_init.html b/libmongoc/1.23.5/mongoc_index_opt_init.html index 114149c06b35f5dc0ce983ee1cda675cee8a17b4..ab268b2f34988367e9c00aefb4ca03d35533cc7d 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_init.html +++ b/libmongoc/1.23.5/mongoc_index_opt_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_t.html b/libmongoc/1.23.5/mongoc_index_opt_t.html index 8445456112710a622f6f6387cc7a3601d6e91f20..910b8c9e740035e4124ff929079197b6a8f59920 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_t.html +++ b/libmongoc/1.23.5/mongoc_index_opt_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_wt_get_default.html b/libmongoc/1.23.5/mongoc_index_opt_wt_get_default.html index f7ec365e7ad8c5bbda78de2f6da4c1143c37dbf1..63e65e4b3618e054d2204dc8aa00180a66ec2122 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_wt_get_default.html +++ b/libmongoc/1.23.5/mongoc_index_opt_wt_get_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_wt_init.html b/libmongoc/1.23.5/mongoc_index_opt_wt_init.html index 8220bb671a830e97c8118104de3236971ea260fd..c341334eedd36fcdaf192e750c93f89dd4f3b556 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_wt_init.html +++ b/libmongoc/1.23.5/mongoc_index_opt_wt_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_index_opt_wt_t.html b/libmongoc/1.23.5/mongoc_index_opt_wt_t.html index ac7194dbcc02dabba4efaf0071b2fe1b9d335d27..062f4371a2f8c8a2e8814c058914b612814cd450 100644 --- a/libmongoc/1.23.5/mongoc_index_opt_wt_t.html +++ b/libmongoc/1.23.5/mongoc_index_opt_wt_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_init.html b/libmongoc/1.23.5/mongoc_init.html index c34f43033f90f9bb0d00037ba82c5f51dfbecded..b7aed452393afca9c5f11ec2a061a5d3ebcf1348 100644 --- a/libmongoc/1.23.5/mongoc_init.html +++ b/libmongoc/1.23.5/mongoc_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_insert_flags_t.html b/libmongoc/1.23.5/mongoc_insert_flags_t.html index e92df97a6cd4140bd49b025cf149ef0bfdae5916..293decbc3814f776a9273281ec3d6e06a4e50c41 100644 --- a/libmongoc/1.23.5/mongoc_insert_flags_t.html +++ b/libmongoc/1.23.5/mongoc_insert_flags_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_iovec_t.html b/libmongoc/1.23.5/mongoc_iovec_t.html index a3302fbb84c819556dfed26b9bc084fe59d923f5..455f75a67478dfd54ba222880f3c741770ed187d 100644 --- a/libmongoc/1.23.5/mongoc_iovec_t.html +++ b/libmongoc/1.23.5/mongoc_iovec_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_matcher_destroy.html b/libmongoc/1.23.5/mongoc_matcher_destroy.html index 463e079fe5348bbc87a9d7243682ec7b435dac95..63c4598a18b6607d3fb3b191ea6e9386902a0232 100644 --- a/libmongoc/1.23.5/mongoc_matcher_destroy.html +++ b/libmongoc/1.23.5/mongoc_matcher_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc_matcher_match.html b/libmongoc/1.23.5/mongoc_matcher_match.html index 9893080ea668877e5b8064cd1efafba3e7c9afeb..9daf491469c80082bbea52b168a86a9ebe719a69 100644 --- a/libmongoc/1.23.5/mongoc_matcher_match.html +++ b/libmongoc/1.23.5/mongoc_matcher_match.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc_matcher_new.html b/libmongoc/1.23.5/mongoc_matcher_new.html index 7f6bc4fb11e15c3127fae47265dfd1cb76545068..c75d3fd4817e1c407f0e0a39df1d65596aa68601 100644 --- a/libmongoc/1.23.5/mongoc_matcher_new.html +++ b/libmongoc/1.23.5/mongoc_matcher_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc_matcher_t.html b/libmongoc/1.23.5/mongoc_matcher_t.html index 48870042b02af955983c5821b61555f3312fc27e..c21b09ffd66a3ccda450cb5eb07ad92ffdc9182f 100644 --- a/libmongoc/1.23.5/mongoc_matcher_t.html +++ b/libmongoc/1.23.5/mongoc_matcher_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/mongoc_optional_copy.html b/libmongoc/1.23.5/mongoc_optional_copy.html index 1543478d10924771f8c4e052b01b93ee7ac1e968..98d6ae0ccb1ddec3b517756546d77303535dfc69 100644 --- a/libmongoc/1.23.5/mongoc_optional_copy.html +++ b/libmongoc/1.23.5/mongoc_optional_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_optional_init.html b/libmongoc/1.23.5/mongoc_optional_init.html index c8691d8c39102a8523e8aa86d829c1dc691dc4ed..e3e0575aea5c22250099efd71c2df83e42989029 100644 --- a/libmongoc/1.23.5/mongoc_optional_init.html +++ b/libmongoc/1.23.5/mongoc_optional_init.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_optional_is_set.html b/libmongoc/1.23.5/mongoc_optional_is_set.html index c7467b7e358ed01b4258b2ff9ccd6cede114670d..922ddc7c50e379a5b41844ebadd9b35f5ec17618 100644 --- a/libmongoc/1.23.5/mongoc_optional_is_set.html +++ b/libmongoc/1.23.5/mongoc_optional_is_set.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_optional_set_value.html b/libmongoc/1.23.5/mongoc_optional_set_value.html index f1acd980f36978488298e7a6aa40f909bd1b0e83..9690b7c275f66e0291de04f7c70c5718a1f84a20 100644 --- a/libmongoc/1.23.5/mongoc_optional_set_value.html +++ b/libmongoc/1.23.5/mongoc_optional_set_value.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_optional_t.html b/libmongoc/1.23.5/mongoc_optional_t.html index 915765cbc6fe27d6f0289a9aaf7d98eaec35cec6..a7a62d626d495ef00870253f816cfcf106f6180b 100644 --- a/libmongoc/1.23.5/mongoc_optional_t.html +++ b/libmongoc/1.23.5/mongoc_optional_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_optional_value.html b/libmongoc/1.23.5/mongoc_optional_value.html index b0ab8508401df8305f1d13daebc0d2b7ed0330d7..cf16ef25294f661e17b704a7e3a0058351f160fc 100644 --- a/libmongoc/1.23.5/mongoc_optional_value.html +++ b/libmongoc/1.23.5/mongoc_optional_value.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_query_flags_t.html b/libmongoc/1.23.5/mongoc_query_flags_t.html index 94782c5605173aa8bac3ac8da8764a0bb80e94c3..a00208ffd33271f319264c8aa90d86d1a4f549fd 100644 --- a/libmongoc/1.23.5/mongoc_query_flags_t.html +++ b/libmongoc/1.23.5/mongoc_query_flags_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_rand.html b/libmongoc/1.23.5/mongoc_rand.html index ee40701fb767e93526b69ea5a2262a94c84f77c9..d3ad3b30ded544f55bfc591a3560fdbb8c9da6ba 100644 --- a/libmongoc/1.23.5/mongoc_rand.html +++ b/libmongoc/1.23.5/mongoc_rand.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_rand_add.html b/libmongoc/1.23.5/mongoc_rand_add.html index e2ea905967696e68afc79cce103f595c197c0b04..71c4df15bb729619d3acaa1258aadc45d722a823 100644 --- a/libmongoc/1.23.5/mongoc_rand_add.html +++ b/libmongoc/1.23.5/mongoc_rand_add.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_rand_seed.html b/libmongoc/1.23.5/mongoc_rand_seed.html index e4edc50153a180708bc983b9138ff865ff872009..889db0481521d7fe4481b1ef0c46b9b036f84157 100644 --- a/libmongoc/1.23.5/mongoc_rand_seed.html +++ b/libmongoc/1.23.5/mongoc_rand_seed.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_rand_status.html b/libmongoc/1.23.5/mongoc_rand_status.html index ca39ae6669dfa5746ce6dc46e7efeae1c5853b56..fb0badc91def5f8724fd4f2691f894ed1e867876 100644 --- a/libmongoc/1.23.5/mongoc_rand_status.html +++ b/libmongoc/1.23.5/mongoc_rand_status.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_append.html b/libmongoc/1.23.5/mongoc_read_concern_append.html index 28b19bc251adfbd2fd75e8e78b01cbd0a4ac891f..c74fcdb0ef7508d5c73fcffa4190276384975537 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_append.html +++ b/libmongoc/1.23.5/mongoc_read_concern_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_copy.html b/libmongoc/1.23.5/mongoc_read_concern_copy.html index 7626e3d1d5f5a2d8652a156d79281d52c6585ff2..965c044bc13ef05840263eb14f0daf5beb4b0fd3 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_copy.html +++ b/libmongoc/1.23.5/mongoc_read_concern_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_destroy.html b/libmongoc/1.23.5/mongoc_read_concern_destroy.html index 0533b90723308b2bd6434d293bfaad00468ade01..46aafc74c8dfdd643e618821b28b45cd3fdf2f0f 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_destroy.html +++ b/libmongoc/1.23.5/mongoc_read_concern_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_get_level.html b/libmongoc/1.23.5/mongoc_read_concern_get_level.html index f15ee0db6a76fae2d4afd3077c3049224ca35e17..6c14689ff7a2cb076fd754228b67dbfa8c92a6b2 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_get_level.html +++ b/libmongoc/1.23.5/mongoc_read_concern_get_level.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_is_default.html b/libmongoc/1.23.5/mongoc_read_concern_is_default.html index 3a67f4fe16e48a2043a5622fe353e31de80f46ed..7361155ae5cf77c69c9023a7c05022c16c3e05a7 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_is_default.html +++ b/libmongoc/1.23.5/mongoc_read_concern_is_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_new.html b/libmongoc/1.23.5/mongoc_read_concern_new.html index 3275f7a62ddb2eb669e1df1fa56a9c8b65379b4c..be07cd3835415686e393e39c6bfa6ac05285d443 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_new.html +++ b/libmongoc/1.23.5/mongoc_read_concern_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_set_level.html b/libmongoc/1.23.5/mongoc_read_concern_set_level.html index a9377227da085de146fbff243e562a921e7500d3..50820e9ebff15fdcbe371790e5fa2f9fe8408c82 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_set_level.html +++ b/libmongoc/1.23.5/mongoc_read_concern_set_level.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_concern_t.html b/libmongoc/1.23.5/mongoc_read_concern_t.html index 8d1771bfb8bde7eab11e12cdcbb992b83e4c9467..e45b5e4a44c6f28365582514a72dad6639d6de0b 100644 --- a/libmongoc/1.23.5/mongoc_read_concern_t.html +++ b/libmongoc/1.23.5/mongoc_read_concern_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_mode_t.html b/libmongoc/1.23.5/mongoc_read_mode_t.html index 398f04c2a08f24a8ec4fd9a94889effd9f88bd60..97e53b38444a45c7a09ae4c9d3ac703c4ca8a34a 100644 --- a/libmongoc/1.23.5/mongoc_read_mode_t.html +++ b/libmongoc/1.23.5/mongoc_read_mode_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_add_tag.html b/libmongoc/1.23.5/mongoc_read_prefs_add_tag.html index 36463d503fdd4da99539c44e6983e72a550303f1..7cbbe5de7852e8b26bc8c4e2c47e665c60df2b04 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_add_tag.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_add_tag.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_copy.html b/libmongoc/1.23.5/mongoc_read_prefs_copy.html index 6ea9b3c1ea5bf94b4f5bb5c98baec7e3762ab47e..3d300a50a431897107a01826c72db4595354e209 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_copy.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_destroy.html b/libmongoc/1.23.5/mongoc_read_prefs_destroy.html index 3c80edfa02e1fa87fe25d0a14defb1162bf5e7d6..0843cb1fd56311b1a48409de0c87ae0a4871094e 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_destroy.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_get_hedge.html b/libmongoc/1.23.5/mongoc_read_prefs_get_hedge.html index d09362e58778c3e656d71b38febd543e74d81bec..6bdb2846c4d2608f58e2b895d81aedcd913728d3 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_get_hedge.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_get_hedge.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_get_max_staleness_seconds.html b/libmongoc/1.23.5/mongoc_read_prefs_get_max_staleness_seconds.html index 8d490b6387696250fd2b715ba16cc98280b61526..c9c80a0292a8771e47feac04341b6bb9d360d4d0 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_get_max_staleness_seconds.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_get_max_staleness_seconds.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_get_mode.html b/libmongoc/1.23.5/mongoc_read_prefs_get_mode.html index 8a93946b01ba78d9b45d1e46c74fe9e896550d29..8880377040c4a5940b56a7810eedf22ac3342cee 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_get_mode.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_get_mode.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_get_tags.html b/libmongoc/1.23.5/mongoc_read_prefs_get_tags.html index cc8002da76f57d5759bc33bd633504c70127f51e..7aa278630912f081bda5fb3e40fb40157cd2c691 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_get_tags.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_get_tags.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_is_valid.html b/libmongoc/1.23.5/mongoc_read_prefs_is_valid.html index 9112d5a7d1d588b9eb8d6bf8ae73c741bcedd591..18dfebd1a093109d23cd29d6e67cf56a856e8f2f 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_is_valid.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_is_valid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_new.html b/libmongoc/1.23.5/mongoc_read_prefs_new.html index 1804b7fba2c4f70c335f1834e57b98dc5cbe8bdf..386a0bad5285ba2601fb4ab1547197b731e36c9b 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_new.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_set_hedge.html b/libmongoc/1.23.5/mongoc_read_prefs_set_hedge.html index e4aff21b6e76ebeb3fb6f317df83a68b6bf25b88..9be4e5cbc3fb66441c531b4a04c491bf004d5d42 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_set_hedge.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_set_hedge.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_set_max_staleness_seconds.html b/libmongoc/1.23.5/mongoc_read_prefs_set_max_staleness_seconds.html index 293d385d25ac95075adfc75cc6006e0cff46215f..8d664657d70f169b96945b203a4c91a3a394f356 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_set_max_staleness_seconds.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_set_max_staleness_seconds.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_set_mode.html b/libmongoc/1.23.5/mongoc_read_prefs_set_mode.html index 0e14fdc0815f99eef468fde4ba993ac27531ead2..f42505f88659f8f3e41b09c31b679614ac55bda4 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_set_mode.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_set_mode.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_set_tags.html b/libmongoc/1.23.5/mongoc_read_prefs_set_tags.html index f69d1c5fe992ccb03b587709f7246da1ee2e01aa..c8e1dc86115c0d7699ee5595fe74272d8a39bd8e 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_set_tags.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_set_tags.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_read_prefs_t.html b/libmongoc/1.23.5/mongoc_read_prefs_t.html index e2be050ab59c1002ee823b646f974ade7ae4a3fc..491ab5b4f63a9d00114965fdbff4f64f3653e400 100644 --- a/libmongoc/1.23.5/mongoc_read_prefs_t.html +++ b/libmongoc/1.23.5/mongoc_read_prefs_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_remove_flags_t.html b/libmongoc/1.23.5/mongoc_remove_flags_t.html index 401d01c3a1454aed0658492b955e0449db77f18d..9e1766439ddcf3bdef59b8f8eda28cf5cd7ebad0 100644 --- a/libmongoc/1.23.5/mongoc_remove_flags_t.html +++ b/libmongoc/1.23.5/mongoc_remove_flags_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_reply_flags_t.html b/libmongoc/1.23.5/mongoc_reply_flags_t.html index 17adb3913d6a76905953a0c8c1de6e4b4e842047..8d03517232e7c55cb7f839ffbeabacf0db5fd817 100644 --- a/libmongoc/1.23.5/mongoc_reply_flags_t.html +++ b/libmongoc/1.23.5/mongoc_reply_flags_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_copy.html b/libmongoc/1.23.5/mongoc_server_api_copy.html index 2acf59d88bfe2cd25707bd4b3904797f45254478..747b3043602234b55d57877c5ec7c5ad57761133 100644 --- a/libmongoc/1.23.5/mongoc_server_api_copy.html +++ b/libmongoc/1.23.5/mongoc_server_api_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_deprecation_errors.html b/libmongoc/1.23.5/mongoc_server_api_deprecation_errors.html index 92eb468dda0fc9990cc93e04b513b487668bb753..17e78c292ad148a14c3c410f2b801e6a03aa2915 100644 --- a/libmongoc/1.23.5/mongoc_server_api_deprecation_errors.html +++ b/libmongoc/1.23.5/mongoc_server_api_deprecation_errors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_destroy.html b/libmongoc/1.23.5/mongoc_server_api_destroy.html index 7e5e0be3bb543191632f2c32f67000bf55372a06..f4830455910a3aeeda9282bd13d7502595d76af6 100644 --- a/libmongoc/1.23.5/mongoc_server_api_destroy.html +++ b/libmongoc/1.23.5/mongoc_server_api_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_get_deprecation_errors.html b/libmongoc/1.23.5/mongoc_server_api_get_deprecation_errors.html index 11cb7060eef6e74c86eb39e106b1d91c85684e37..4e13c62711284c1c0472a2d0c320b4dc653121b4 100644 --- a/libmongoc/1.23.5/mongoc_server_api_get_deprecation_errors.html +++ b/libmongoc/1.23.5/mongoc_server_api_get_deprecation_errors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_get_strict.html b/libmongoc/1.23.5/mongoc_server_api_get_strict.html index 9d59f9ee0636241b5193357f7b74b5572fd5ec7e..6a66b20a11d92024ccf189980a51c8f5d8b305ee 100644 --- a/libmongoc/1.23.5/mongoc_server_api_get_strict.html +++ b/libmongoc/1.23.5/mongoc_server_api_get_strict.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_get_version.html b/libmongoc/1.23.5/mongoc_server_api_get_version.html index b5a82962dbafc830a3cd8f271063900726f40331..c85745c93105579b758add6b0c00d0f0dcdcc3e1 100644 --- a/libmongoc/1.23.5/mongoc_server_api_get_version.html +++ b/libmongoc/1.23.5/mongoc_server_api_get_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_new.html b/libmongoc/1.23.5/mongoc_server_api_new.html index e1810a51c6959ebbc8a843f842a8864de4990937..d37f7b0a398d7f8cdf21559d6cd3c8de0213fd76 100644 --- a/libmongoc/1.23.5/mongoc_server_api_new.html +++ b/libmongoc/1.23.5/mongoc_server_api_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_strict.html b/libmongoc/1.23.5/mongoc_server_api_strict.html index 5ac62bb575e8991153121e011beb043e2c89a3df..7e196686173f31022d810ea1f2d91845c700f998 100644 --- a/libmongoc/1.23.5/mongoc_server_api_strict.html +++ b/libmongoc/1.23.5/mongoc_server_api_strict.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_t.html b/libmongoc/1.23.5/mongoc_server_api_t.html index 456fe12dc1b68a500ab4b6825a9a88d9d524b7af..d4a51b1faa7c6f6448cfb234ba59394356bef1bb 100644 --- a/libmongoc/1.23.5/mongoc_server_api_t.html +++ b/libmongoc/1.23.5/mongoc_server_api_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_version_from_string.html b/libmongoc/1.23.5/mongoc_server_api_version_from_string.html index 5cdda5d3f1effe1066c34ec58b9ef3118a7b535c..e254f5014db5a0000304c0b896413cab73130aca 100644 --- a/libmongoc/1.23.5/mongoc_server_api_version_from_string.html +++ b/libmongoc/1.23.5/mongoc_server_api_version_from_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_version_t.html b/libmongoc/1.23.5/mongoc_server_api_version_t.html index b76aa9daf1d862fa6832babe2b511b8053470c34..7283366fc9eb2be074e38a270df06e51a4f7b51a 100644 --- a/libmongoc/1.23.5/mongoc_server_api_version_t.html +++ b/libmongoc/1.23.5/mongoc_server_api_version_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_api_version_to_string.html b/libmongoc/1.23.5/mongoc_server_api_version_to_string.html index 92a342edeaae4e4a6d515e3e00430cf596d176ec..5249b90d0ba244d72b671d129cbc3d5352d34d57 100644 --- a/libmongoc/1.23.5/mongoc_server_api_version_to_string.html +++ b/libmongoc/1.23.5/mongoc_server_api_version_to_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_destroy.html b/libmongoc/1.23.5/mongoc_server_description_destroy.html index 30dc2e1c843e64141cc82130812b43dfe1aa207a..24f065148062ecc4ec1b17b353437b8e6244ee44 100644 --- a/libmongoc/1.23.5/mongoc_server_description_destroy.html +++ b/libmongoc/1.23.5/mongoc_server_description_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_hello_response.html b/libmongoc/1.23.5/mongoc_server_description_hello_response.html index 53546c6188b5a6b2fd873bf8001fae296173f2e7..22ee0bb02ea4c83da4510472413290d5a7dd4e11 100644 --- a/libmongoc/1.23.5/mongoc_server_description_hello_response.html +++ b/libmongoc/1.23.5/mongoc_server_description_hello_response.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_host.html b/libmongoc/1.23.5/mongoc_server_description_host.html index 85f4ff40294e2c8ee465972b9ad148a1625cfebe..28101b0fb9f4abc57dcb442dc08aa3b903fd8cb3 100644 --- a/libmongoc/1.23.5/mongoc_server_description_host.html +++ b/libmongoc/1.23.5/mongoc_server_description_host.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_id.html b/libmongoc/1.23.5/mongoc_server_description_id.html index cc0b2fd72c12eac6317b3d54eff6118d2e875863..9af77b9072d1ae362a7d418959fc7f84fbcd2b45 100644 --- a/libmongoc/1.23.5/mongoc_server_description_id.html +++ b/libmongoc/1.23.5/mongoc_server_description_id.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_ismaster.html b/libmongoc/1.23.5/mongoc_server_description_ismaster.html index da196e78405d951e7bfb268db24580efbe2ebf3b..771a67806ad5af07c2623f6baeae14115cab2fdf 100644 --- a/libmongoc/1.23.5/mongoc_server_description_ismaster.html +++ b/libmongoc/1.23.5/mongoc_server_description_ismaster.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_last_update_time.html b/libmongoc/1.23.5/mongoc_server_description_last_update_time.html index 9c4babe662ae88c75e888b49161b8877b70c6c99..e4f9e1f6aa90e28783eba2e3c8b457d4865e035b 100644 --- a/libmongoc/1.23.5/mongoc_server_description_last_update_time.html +++ b/libmongoc/1.23.5/mongoc_server_description_last_update_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_new_copy.html b/libmongoc/1.23.5/mongoc_server_description_new_copy.html index 8b79d1d4504bd96cae759d4a8f05d5a9b2f5b478..fe9f26cf53ad2530badae6280e900ce72074881c 100644 --- a/libmongoc/1.23.5/mongoc_server_description_new_copy.html +++ b/libmongoc/1.23.5/mongoc_server_description_new_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_round_trip_time.html b/libmongoc/1.23.5/mongoc_server_description_round_trip_time.html index 5101e3628bd7fd7e47466e4c19eed7d4f1bc776e..bf3ac4d00abce691be2e79078361f06e8ec54805 100644 --- a/libmongoc/1.23.5/mongoc_server_description_round_trip_time.html +++ b/libmongoc/1.23.5/mongoc_server_description_round_trip_time.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_t.html b/libmongoc/1.23.5/mongoc_server_description_t.html index 91e3931279b23fd26354c2647531af4dfd42be94..421fc1428abc007ff7c8c39a7c5ca3e5eea9c862 100644 --- a/libmongoc/1.23.5/mongoc_server_description_t.html +++ b/libmongoc/1.23.5/mongoc_server_description_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_description_type.html b/libmongoc/1.23.5/mongoc_server_description_type.html index d99798f37a085f32a8fd47b8667e4046395ec113..492e7f23b70022f3312e524e705d2f1d50bd1e8e 100644 --- a/libmongoc/1.23.5/mongoc_server_description_type.html +++ b/libmongoc/1.23.5/mongoc_server_description_type.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_server_descriptions_destroy_all.html b/libmongoc/1.23.5/mongoc_server_descriptions_destroy_all.html index 9988989c477cceaf636c4778a3bdd56df03189d3..4449facf3c0e89e7aedecfeb927486c1c9741408 100644 --- a/libmongoc/1.23.5/mongoc_server_descriptions_destroy_all.html +++ b/libmongoc/1.23.5/mongoc_server_descriptions_destroy_all.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opt_t.html b/libmongoc/1.23.5/mongoc_session_opt_t.html index e24f4d326d04f04f1ce432b49f86812a018971d7..b17966ac116233489d7f2ffe282553459a501c99 100644 --- a/libmongoc/1.23.5/mongoc_session_opt_t.html +++ b/libmongoc/1.23.5/mongoc_session_opt_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_clone.html b/libmongoc/1.23.5/mongoc_session_opts_clone.html index c11ee776dc6e76e6ff37dd223d7318084a9e7e88..cf21da0eec2d4f1d1d5e33be8061b8ce9e6246a1 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_clone.html +++ b/libmongoc/1.23.5/mongoc_session_opts_clone.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_destroy.html b/libmongoc/1.23.5/mongoc_session_opts_destroy.html index 0968830e052d89b1768b6d76e1e33d36e486c093..d5240c1b3fbba904e86145af7d287d73fa4b8cc4 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_session_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_get_causal_consistency.html b/libmongoc/1.23.5/mongoc_session_opts_get_causal_consistency.html index d29d5a0d9b4489d26623bc7e0779753f10173079..fb61101d396a5bea9188a33eacf99e0de76306ba 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_get_causal_consistency.html +++ b/libmongoc/1.23.5/mongoc_session_opts_get_causal_consistency.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_get_default_transaction_opts.html b/libmongoc/1.23.5/mongoc_session_opts_get_default_transaction_opts.html index a159b92fab30a127706e8450797f53c50a48d31e..677d92a8f312793a6e2d6bab7d6fbe15b7c81330 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_get_default_transaction_opts.html +++ b/libmongoc/1.23.5/mongoc_session_opts_get_default_transaction_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_get_snapshot.html b/libmongoc/1.23.5/mongoc_session_opts_get_snapshot.html index 1a071629ddb7dc8b6544e752aa11a9186335f3db..84d78766123e8d7ca8512fdf4912df0994bbd1f9 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_get_snapshot.html +++ b/libmongoc/1.23.5/mongoc_session_opts_get_snapshot.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_get_transaction_opts.html b/libmongoc/1.23.5/mongoc_session_opts_get_transaction_opts.html index 828dd8ec47d7e1e7fd5296d6ea5ec7f3702abc3d..207a5aebef371ba6c8432d6306c85ad86d2aead0 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_get_transaction_opts.html +++ b/libmongoc/1.23.5/mongoc_session_opts_get_transaction_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_new.html b/libmongoc/1.23.5/mongoc_session_opts_new.html index d07e34c6ad6cfffdce0f4e31d640d31857b110c0..74dedc7f0877cdd0dd2bfa274681338dce54405b 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_new.html +++ b/libmongoc/1.23.5/mongoc_session_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_set_causal_consistency.html b/libmongoc/1.23.5/mongoc_session_opts_set_causal_consistency.html index 5bb550615fd3e8cd494ea4649aa8b546dee938c1..d1703eb02fd0297528ba41c5287d9cf43696348f 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_set_causal_consistency.html +++ b/libmongoc/1.23.5/mongoc_session_opts_set_causal_consistency.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_set_default_transaction_opts.html b/libmongoc/1.23.5/mongoc_session_opts_set_default_transaction_opts.html index 664c8effc816e5f325e8dcebc5861a8cc6cea0df..55b8e96752c19f05d285004241ea8e5b3dce4431 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_set_default_transaction_opts.html +++ b/libmongoc/1.23.5/mongoc_session_opts_set_default_transaction_opts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_session_opts_set_snapshot.html b/libmongoc/1.23.5/mongoc_session_opts_set_snapshot.html index e6e52c4567133da2ea7adf7e680661dfe2ac83a2..f9d3137d084e88dd982769d5460dc3e233268983 100644 --- a/libmongoc/1.23.5/mongoc_session_opts_set_snapshot.html +++ b/libmongoc/1.23.5/mongoc_session_opts_set_snapshot.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_accept.html b/libmongoc/1.23.5/mongoc_socket_accept.html index cb7c131f158964a013a809707f7995f22c69bddc..37cebba3761555040391b48c8f1f47d4e1b21770 100644 --- a/libmongoc/1.23.5/mongoc_socket_accept.html +++ b/libmongoc/1.23.5/mongoc_socket_accept.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_bind.html b/libmongoc/1.23.5/mongoc_socket_bind.html index 6d6a569b9cf09e34249a6a71393a923a17a9014a..8235cff79243b8cbb72b3176077b1df92da28470 100644 --- a/libmongoc/1.23.5/mongoc_socket_bind.html +++ b/libmongoc/1.23.5/mongoc_socket_bind.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_close.html b/libmongoc/1.23.5/mongoc_socket_close.html index f8add86251a73bd9bbc9982b6cb7bf0f5fa8bba9..9b6394dc299a3295d9ace8ed8177d351d2b9c6ec 100644 --- a/libmongoc/1.23.5/mongoc_socket_close.html +++ b/libmongoc/1.23.5/mongoc_socket_close.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_connect.html b/libmongoc/1.23.5/mongoc_socket_connect.html index b3dbd409e32b71eb3408f328bb9663326cfb6992..f33f0f0fa7c9fde52f653dfebd14346d948b4e48 100644 --- a/libmongoc/1.23.5/mongoc_socket_connect.html +++ b/libmongoc/1.23.5/mongoc_socket_connect.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_destroy.html b/libmongoc/1.23.5/mongoc_socket_destroy.html index f33068c6a110e652ba7d9fd24e74cf0acc7d9740..96ed6b02684c88210fb48b8f40d798e5feebfbd3 100644 --- a/libmongoc/1.23.5/mongoc_socket_destroy.html +++ b/libmongoc/1.23.5/mongoc_socket_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_errno.html b/libmongoc/1.23.5/mongoc_socket_errno.html index b1b8121b0e456802f970f5dc92ffa96f5d6a9af4..368f69f1a2f398034fbd467b7d058f0b32653ad8 100644 --- a/libmongoc/1.23.5/mongoc_socket_errno.html +++ b/libmongoc/1.23.5/mongoc_socket_errno.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_getnameinfo.html b/libmongoc/1.23.5/mongoc_socket_getnameinfo.html index 1cb4df63e12c2f098b1f5c3feebc54fa39ed0890..3d7d08eb6cccf96b579394d541ee156456c801e3 100644 --- a/libmongoc/1.23.5/mongoc_socket_getnameinfo.html +++ b/libmongoc/1.23.5/mongoc_socket_getnameinfo.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_getsockname.html b/libmongoc/1.23.5/mongoc_socket_getsockname.html index cb716faff52a32b69c01cfb372ea29c2ec8b712f..b3860e04b8fb82141f44fac39f5ccb9fbd0d3b81 100644 --- a/libmongoc/1.23.5/mongoc_socket_getsockname.html +++ b/libmongoc/1.23.5/mongoc_socket_getsockname.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_listen.html b/libmongoc/1.23.5/mongoc_socket_listen.html index 5f07244423cde33d3c521119c9002bcd4670de65..12edeaab6f5f78a09805fdb9b123a16324a29e9a 100644 --- a/libmongoc/1.23.5/mongoc_socket_listen.html +++ b/libmongoc/1.23.5/mongoc_socket_listen.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_new.html b/libmongoc/1.23.5/mongoc_socket_new.html index abb6b58c9d0b4f29cb0d694dc3a9a86b1e6780e0..ca08d36348ea5453ffda5147571477a83aec819a 100644 --- a/libmongoc/1.23.5/mongoc_socket_new.html +++ b/libmongoc/1.23.5/mongoc_socket_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_recv.html b/libmongoc/1.23.5/mongoc_socket_recv.html index 777653fda78c9baaf64416a1134411fee6d65bc4..4eecad9094949f68d697ecb21441f87c44520fce 100644 --- a/libmongoc/1.23.5/mongoc_socket_recv.html +++ b/libmongoc/1.23.5/mongoc_socket_recv.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_send.html b/libmongoc/1.23.5/mongoc_socket_send.html index a63e863a08491b466d3fa75267398ff55b32959a..5ff7c5dde03ec98e3408027b1e033261f564a2b4 100644 --- a/libmongoc/1.23.5/mongoc_socket_send.html +++ b/libmongoc/1.23.5/mongoc_socket_send.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_sendv.html b/libmongoc/1.23.5/mongoc_socket_sendv.html index 5a1c441b291661fe60ca00d861fa19d117c5ef48..f789e6ded1d4ba6be99be8cf53a623039c8d01b7 100644 --- a/libmongoc/1.23.5/mongoc_socket_sendv.html +++ b/libmongoc/1.23.5/mongoc_socket_sendv.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_setsockopt.html b/libmongoc/1.23.5/mongoc_socket_setsockopt.html index 1a0de49df44f88839db59ee49587405f73b56414..fe4b01cf85f9ac739564096b65293ee7e7560934 100644 --- a/libmongoc/1.23.5/mongoc_socket_setsockopt.html +++ b/libmongoc/1.23.5/mongoc_socket_setsockopt.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_socket_t.html b/libmongoc/1.23.5/mongoc_socket_t.html index b547c6ea1d4bc248d45de0665603827ac26e9963..7df7e99282dfea6e8797cae1e881b0907afcb86b 100644 --- a/libmongoc/1.23.5/mongoc_socket_t.html +++ b/libmongoc/1.23.5/mongoc_socket_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_ssl_opt_get_default.html b/libmongoc/1.23.5/mongoc_ssl_opt_get_default.html index 1420e58a5816c7e05004c9ad73794d4bd669a163..63f17f3ed7b6602365553b36488b6b135314a1a0 100644 --- a/libmongoc/1.23.5/mongoc_ssl_opt_get_default.html +++ b/libmongoc/1.23.5/mongoc_ssl_opt_get_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_ssl_opt_t.html b/libmongoc/1.23.5/mongoc_ssl_opt_t.html index c7298bc3930f27df3fed1a00d9b67779b28e6a59..ecd2a50a1df24151793a499cf58702049bd9e004 100644 --- a/libmongoc/1.23.5/mongoc_ssl_opt_t.html +++ b/libmongoc/1.23.5/mongoc_ssl_opt_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_buffered_new.html b/libmongoc/1.23.5/mongoc_stream_buffered_new.html index 6ec8be3f84eb45e63fdb0eebb2ba78604f4e613d..6c5db9aba181e3c1e8678e96a72614d7853a0012 100644 --- a/libmongoc/1.23.5/mongoc_stream_buffered_new.html +++ b/libmongoc/1.23.5/mongoc_stream_buffered_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_buffered_t.html b/libmongoc/1.23.5/mongoc_stream_buffered_t.html index 67ca6c4bf95c59af245e2c2eb9dfae3477ec6b5e..bc81208f1fc93c9b67704682579f1abf097f4ad8 100644 --- a/libmongoc/1.23.5/mongoc_stream_buffered_t.html +++ b/libmongoc/1.23.5/mongoc_stream_buffered_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_close.html b/libmongoc/1.23.5/mongoc_stream_close.html index d1c32af0476f00ac0b17a81b4bc610363d7c32b5..f2a7db9e8c89c03432b44fc83c21b12bc38970b7 100644 --- a/libmongoc/1.23.5/mongoc_stream_close.html +++ b/libmongoc/1.23.5/mongoc_stream_close.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_cork.html b/libmongoc/1.23.5/mongoc_stream_cork.html index 55928f14091f458c604d2d656f2f3518c3788705..74ed6e1a6bc0f272dab7372f6d8ecf50e23abc84 100644 --- a/libmongoc/1.23.5/mongoc_stream_cork.html +++ b/libmongoc/1.23.5/mongoc_stream_cork.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_destroy.html b/libmongoc/1.23.5/mongoc_stream_destroy.html index 64306ae149b934aadab5bee27f95ee52980d0ab6..777c46b622f292b85a81e63998fba767efafde9b 100644 --- a/libmongoc/1.23.5/mongoc_stream_destroy.html +++ b/libmongoc/1.23.5/mongoc_stream_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_file_get_fd.html b/libmongoc/1.23.5/mongoc_stream_file_get_fd.html index b50e262d9cbbac5d32f87523b40fb753bf771446..a9e1bdfee35f2cb6ca8fecf9810d0b3b4afe0c32 100644 --- a/libmongoc/1.23.5/mongoc_stream_file_get_fd.html +++ b/libmongoc/1.23.5/mongoc_stream_file_get_fd.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_file_new.html b/libmongoc/1.23.5/mongoc_stream_file_new.html index 8fda7572fb5cd9620e79d075b6f4c72689b50228..95db127d1dae278d5bde419a2fe0dd227fa8ea8c 100644 --- a/libmongoc/1.23.5/mongoc_stream_file_new.html +++ b/libmongoc/1.23.5/mongoc_stream_file_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_file_new_for_path.html b/libmongoc/1.23.5/mongoc_stream_file_new_for_path.html index 8bf7c9c356ad0051a650f02ad9486950f33c314e..3583ea24f8e86e46f90ed2f07ce6ed2ad704f70b 100644 --- a/libmongoc/1.23.5/mongoc_stream_file_new_for_path.html +++ b/libmongoc/1.23.5/mongoc_stream_file_new_for_path.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_file_t.html b/libmongoc/1.23.5/mongoc_stream_file_t.html index 0d7f091a34127c9bc0b7c22613ac642219fcdf98..94019407f88db19726d98b6d4eebdc3cf87023d5 100644 --- a/libmongoc/1.23.5/mongoc_stream_file_t.html +++ b/libmongoc/1.23.5/mongoc_stream_file_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_flush.html b/libmongoc/1.23.5/mongoc_stream_flush.html index efbc9e4b1b0c0638f2f779e68c50a39bb2895798..79aeb93f3e09b646fa531f27f98e750b43f60176 100644 --- a/libmongoc/1.23.5/mongoc_stream_flush.html +++ b/libmongoc/1.23.5/mongoc_stream_flush.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_get_base_stream.html b/libmongoc/1.23.5/mongoc_stream_get_base_stream.html index 429c6259ef45a67e6ef6952d585e334883750717..6fede50ae6fc64e3a11cd3c4b16d3bff467ed405 100644 --- a/libmongoc/1.23.5/mongoc_stream_get_base_stream.html +++ b/libmongoc/1.23.5/mongoc_stream_get_base_stream.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_gridfs_new.html b/libmongoc/1.23.5/mongoc_stream_gridfs_new.html index 9721ff65be110fbd3f48fd166b37ac003ccfd6bf..39735cd2c92939d443e171734311fbdcaf22c06e 100644 --- a/libmongoc/1.23.5/mongoc_stream_gridfs_new.html +++ b/libmongoc/1.23.5/mongoc_stream_gridfs_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_read.html b/libmongoc/1.23.5/mongoc_stream_read.html index 7af4e5ece908b1a61c77ffd139991fb3806619df..7adf1a2a24ad1068fec07dbc914f2b2a3a17c412 100644 --- a/libmongoc/1.23.5/mongoc_stream_read.html +++ b/libmongoc/1.23.5/mongoc_stream_read.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_readv.html b/libmongoc/1.23.5/mongoc_stream_readv.html index 6689d7d7cec2405af873004e5c35721e0d6db0a6..e68b507a0d15912d8f40df3c6c9627ebce55669c 100644 --- a/libmongoc/1.23.5/mongoc_stream_readv.html +++ b/libmongoc/1.23.5/mongoc_stream_readv.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_setsockopt.html b/libmongoc/1.23.5/mongoc_stream_setsockopt.html index 3f2fb8213c113f3f17cd0fef7e9bdb57dc64db19..95d3253b75bae9a7866b93f466b6bb46bddc20b2 100644 --- a/libmongoc/1.23.5/mongoc_stream_setsockopt.html +++ b/libmongoc/1.23.5/mongoc_stream_setsockopt.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_should_retry.html b/libmongoc/1.23.5/mongoc_stream_should_retry.html index fd1162081487a9e32e8c99bbafd691f972b87d48..05920a0451705fb3a32fff580bbf7c69cce6c2ca 100644 --- a/libmongoc/1.23.5/mongoc_stream_should_retry.html +++ b/libmongoc/1.23.5/mongoc_stream_should_retry.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_socket_get_socket.html b/libmongoc/1.23.5/mongoc_stream_socket_get_socket.html index dad7d96d3666b0ac6e3ddbe8ef9df6d0d38706a2..1ceeb086e118e906228db85f1c8b50246fd84e28 100644 --- a/libmongoc/1.23.5/mongoc_stream_socket_get_socket.html +++ b/libmongoc/1.23.5/mongoc_stream_socket_get_socket.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_socket_new.html b/libmongoc/1.23.5/mongoc_stream_socket_new.html index 6b364987e5e29708f8535a653e5e576ccf929576..357be30d261bf56c212e9ce7ed97be8e917feec9 100644 --- a/libmongoc/1.23.5/mongoc_stream_socket_new.html +++ b/libmongoc/1.23.5/mongoc_stream_socket_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_socket_t.html b/libmongoc/1.23.5/mongoc_stream_socket_t.html index 754d89fe65f90996c1f7247dc60ae3b178e07d58..5c169243b630592aef35908eaaa4bc2871eafa7f 100644 --- a/libmongoc/1.23.5/mongoc_stream_socket_t.html +++ b/libmongoc/1.23.5/mongoc_stream_socket_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_t.html b/libmongoc/1.23.5/mongoc_stream_t.html index 86549badbeb0edd72d4f1244d767d2d894cb7903..435108ee3253d3ef9215ec2e0b181a3f6250dac9 100644 --- a/libmongoc/1.23.5/mongoc_stream_t.html +++ b/libmongoc/1.23.5/mongoc_stream_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_timed_out.html b/libmongoc/1.23.5/mongoc_stream_timed_out.html index 53ba4feffb12b842f1f2b0e6cc11380795a9b1d4..fea8d2ce821407e01db3f2f9808385e0bf8024bf 100644 --- a/libmongoc/1.23.5/mongoc_stream_timed_out.html +++ b/libmongoc/1.23.5/mongoc_stream_timed_out.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_tls_t.html b/libmongoc/1.23.5/mongoc_stream_tls_t.html index 5cabff84db39b2f8dc5850ac2750c74be3e479e5..0d33e9931de220764513d5e8f4ec3dea11c7fc18 100644 --- a/libmongoc/1.23.5/mongoc_stream_tls_t.html +++ b/libmongoc/1.23.5/mongoc_stream_tls_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_uncork.html b/libmongoc/1.23.5/mongoc_stream_uncork.html index 9d0e7b81266b675cedc962df21050b123fd20f1d..e5c0b7ba7871d7c63f937f4565502965bd50a339 100644 --- a/libmongoc/1.23.5/mongoc_stream_uncork.html +++ b/libmongoc/1.23.5/mongoc_stream_uncork.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_write.html b/libmongoc/1.23.5/mongoc_stream_write.html index 8e0777b9ab94697e58d46aea8c6dde44805e4e4e..23caba60056ebdcc495cc20e1ed1487ec0ed86a1 100644 --- a/libmongoc/1.23.5/mongoc_stream_write.html +++ b/libmongoc/1.23.5/mongoc_stream_write.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_stream_writev.html b/libmongoc/1.23.5/mongoc_stream_writev.html index 8831cbbaf080ed5e5c06315b0cd9c96a10e7d258..4fea9bc88fdb2da3106ec41a2ff42a1820dd3e71 100644 --- a/libmongoc/1.23.5/mongoc_stream_writev.html +++ b/libmongoc/1.23.5/mongoc_stream_writev.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_destroy.html b/libmongoc/1.23.5/mongoc_topology_description_destroy.html index 8c3f94991848df0d310b48f5227fe950c4b32c09..5559879e28b501c31c4d9cdbb694d0cac1b4739d 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_destroy.html +++ b/libmongoc/1.23.5/mongoc_topology_description_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_get_servers.html b/libmongoc/1.23.5/mongoc_topology_description_get_servers.html index 3718ade9a16408e74436766784485d650fbfa676..b7e40f3d4660012992fd39e77d8fb0aabc491a8f 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_get_servers.html +++ b/libmongoc/1.23.5/mongoc_topology_description_get_servers.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_has_readable_server.html b/libmongoc/1.23.5/mongoc_topology_description_has_readable_server.html index 263015fc1a73dbf5595ec0608749ec7a8d1a2f5b..66d3f16ab91e6a3a197d931a9e0ac327c44a0a8d 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_has_readable_server.html +++ b/libmongoc/1.23.5/mongoc_topology_description_has_readable_server.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_has_writable_server.html b/libmongoc/1.23.5/mongoc_topology_description_has_writable_server.html index dc4cd03a5b555e611769b1412283898c375eee1d..d21d0c4e7191269a70318820f53f0723ad6c479c 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_has_writable_server.html +++ b/libmongoc/1.23.5/mongoc_topology_description_has_writable_server.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_new_copy.html b/libmongoc/1.23.5/mongoc_topology_description_new_copy.html index a7b963a55273c2f8daa1302ef8a3709265a966a2..d84929c7d6bb652086c741b25155aa2a4af8d402 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_new_copy.html +++ b/libmongoc/1.23.5/mongoc_topology_description_new_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_t.html b/libmongoc/1.23.5/mongoc_topology_description_t.html index ae6fc40fced4198c7e8b1da1865a31990ae3599e..b8a8fb6d6b20c172af7a551026842a89c50adeb5 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_t.html +++ b/libmongoc/1.23.5/mongoc_topology_description_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_topology_description_type.html b/libmongoc/1.23.5/mongoc_topology_description_type.html index 84436427c866ce93d8ff2685587af0b4bbdd26ed..6b2f658291ee5ec063e8b120689390f2d77201f1 100644 --- a/libmongoc/1.23.5/mongoc_topology_description_type.html +++ b/libmongoc/1.23.5/mongoc_topology_description_type.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opt_t.html b/libmongoc/1.23.5/mongoc_transaction_opt_t.html index aa914db7a9bb54431967bcdc5b5cc232871b5aa6..0411b6000e432f0b67ad1f5ba3a5a51a706612f7 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opt_t.html +++ b/libmongoc/1.23.5/mongoc_transaction_opt_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_clone.html b/libmongoc/1.23.5/mongoc_transaction_opts_clone.html index 857a1cc67509dcf8b3135407e037c4ff842af1ea..600d501b793dab9d9e39a947d2854eba096b4ac1 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_clone.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_clone.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_destroy.html b/libmongoc/1.23.5/mongoc_transaction_opts_destroy.html index b4c6db13dbb9f5240a4ff23a57bc134e60d7172c..ba246e5a511e3a88be79fc3b3d30eaf2f538e627 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_destroy.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_get_max_commit_time_ms.html b/libmongoc/1.23.5/mongoc_transaction_opts_get_max_commit_time_ms.html index 2a00822d837c91e7bc44afa1857ee58cfdee838a..9344af2a6b493b8ed2c0e08335f129acc779e989 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_get_max_commit_time_ms.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_get_max_commit_time_ms.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_get_read_concern.html b/libmongoc/1.23.5/mongoc_transaction_opts_get_read_concern.html index e938a1a2a1ee346fbed687cca95ceef4bceefb79..15b242d5b4554deab023ad6a49a1590afdfc8101 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_get_read_concern.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_get_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_get_read_prefs.html b/libmongoc/1.23.5/mongoc_transaction_opts_get_read_prefs.html index 3fd1596115d2b9690d992c53fc46df4594f2fa63..b365963e4b52a66deb79f09e75b0521534b80f9b 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_get_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_get_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_get_write_concern.html b/libmongoc/1.23.5/mongoc_transaction_opts_get_write_concern.html index c3eb730f48833869434201cc643d1432c0db7a65..10a022537e77e7b6a017ace610c9c32652d91276 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_get_write_concern.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_get_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_new.html b/libmongoc/1.23.5/mongoc_transaction_opts_new.html index c8b8b4a2dee7405f67bbd5b41a3ccc80f22650b3..1563050b47e9f0a584f8b15e8897530da882fb6d 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_new.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_set_max_commit_time_ms.html b/libmongoc/1.23.5/mongoc_transaction_opts_set_max_commit_time_ms.html index eb82c1d03f2894859c0185a25ce36a0b5169a82e..4addb88b81896b3e9ffdbb56d8b4f878a0b131b5 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_set_max_commit_time_ms.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_set_max_commit_time_ms.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_set_read_concern.html b/libmongoc/1.23.5/mongoc_transaction_opts_set_read_concern.html index 21382e7add69879e8f817a6e042c09e8296d29ef..ac72e90fe925b68d8304eb991903adca474418d7 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_set_read_concern.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_set_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_set_read_prefs.html b/libmongoc/1.23.5/mongoc_transaction_opts_set_read_prefs.html index 4773b6419865668e09de40bf898b3b8b1f94896d..fd43f56248ed0b38d9647e5b254c7b7c6f91d90e 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_set_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_set_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_opts_set_write_concern.html b/libmongoc/1.23.5/mongoc_transaction_opts_set_write_concern.html index e3df6a698a3f74b38686599b006fbc0f049485cc..8c8346273e800a3ecf1727ab6da64ec1414353bb 100644 --- a/libmongoc/1.23.5/mongoc_transaction_opts_set_write_concern.html +++ b/libmongoc/1.23.5/mongoc_transaction_opts_set_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_transaction_state_t.html b/libmongoc/1.23.5/mongoc_transaction_state_t.html index a59e5aa2b4c7315a6fd84d365b443d7b3a086ac8..970330fd4da7366f09744046d7e68e5bb4edd19d 100644 --- a/libmongoc/1.23.5/mongoc_transaction_state_t.html +++ b/libmongoc/1.23.5/mongoc_transaction_state_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_update_flags_t.html b/libmongoc/1.23.5/mongoc_update_flags_t.html index 15e5d233aac7751079d5b8c7cba4bf4dbcd5edef..7cb1b8a429a54f4a70ea295c70f539c2db3d28ba 100644 --- a/libmongoc/1.23.5/mongoc_update_flags_t.html +++ b/libmongoc/1.23.5/mongoc_update_flags_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_copy.html b/libmongoc/1.23.5/mongoc_uri_copy.html index 388433406b09937af5818ac935e66288eaa08da5..455f9d6d1deee1b4037dd8b4de32e37ad7569e93 100644 --- a/libmongoc/1.23.5/mongoc_uri_copy.html +++ b/libmongoc/1.23.5/mongoc_uri_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_destroy.html b/libmongoc/1.23.5/mongoc_uri_destroy.html index c82be79265e4e3bec7ccf79bc898a7c7daea75ad..0038556536cb3e397c5e89bbcf1e308fcf0a1735 100644 --- a/libmongoc/1.23.5/mongoc_uri_destroy.html +++ b/libmongoc/1.23.5/mongoc_uri_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_auth_mechanism.html b/libmongoc/1.23.5/mongoc_uri_get_auth_mechanism.html index 74d6a70411e28b5ab41e51811cc02d29e845a033..0f6d1e6f7ce8d3d85adb169b56aee859b37bcb9e 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_auth_mechanism.html +++ b/libmongoc/1.23.5/mongoc_uri_get_auth_mechanism.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_auth_source.html b/libmongoc/1.23.5/mongoc_uri_get_auth_source.html index b4e5b4f2c65bbe3ff1f2a34496363c4d30480cca..29ac3972ae34dc539769ee975caf5398a656b29a 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_auth_source.html +++ b/libmongoc/1.23.5/mongoc_uri_get_auth_source.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_compressors.html b/libmongoc/1.23.5/mongoc_uri_get_compressors.html index f9acee7069ebc2e4d98c60e10381e7e065413e68..d00b7d538990ca562a5ec065fc2d6568283f2c1d 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_compressors.html +++ b/libmongoc/1.23.5/mongoc_uri_get_compressors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_database.html b/libmongoc/1.23.5/mongoc_uri_get_database.html index 6d8b1d53930807ae23d358acdaa45f2d870b656c..92188860c75430f5f0bebc9d3d87b39f92af08ca 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_database.html +++ b/libmongoc/1.23.5/mongoc_uri_get_database.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_hosts.html b/libmongoc/1.23.5/mongoc_uri_get_hosts.html index afa34199d0d01f6f63ee9971be551688a817e59d..c6823ceed03b61f8727e97a74906b2f4f48d1500 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_hosts.html +++ b/libmongoc/1.23.5/mongoc_uri_get_hosts.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_mechanism_properties.html b/libmongoc/1.23.5/mongoc_uri_get_mechanism_properties.html index c37138680f688241182e637c17413502e5acdb55..c8c0a3d791c06cc19f26307a61a89369fc393435 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_mechanism_properties.html +++ b/libmongoc/1.23.5/mongoc_uri_get_mechanism_properties.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_option_as_bool.html b/libmongoc/1.23.5/mongoc_uri_get_option_as_bool.html index 3cf7270a73e82858ca152979bc8f65475d7be95a..dfb8c4e28b7d3e6c4312c64d090d68ebe33c1ea1 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_option_as_bool.html +++ b/libmongoc/1.23.5/mongoc_uri_get_option_as_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_option_as_int32.html b/libmongoc/1.23.5/mongoc_uri_get_option_as_int32.html index c2022b20e2b2f7c992c0392dadf4a0bcb06a8a7b..fb621112156fd2cb882e6412bd1d18df5ff0e7c8 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_option_as_int32.html +++ b/libmongoc/1.23.5/mongoc_uri_get_option_as_int32.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_option_as_int64.html b/libmongoc/1.23.5/mongoc_uri_get_option_as_int64.html index 6c3435f3c5144a9b121b52e589ee47a0258bc8e3..ed5a62fc8f916397727fed4ac5739888d15d41cf 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_option_as_int64.html +++ b/libmongoc/1.23.5/mongoc_uri_get_option_as_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_option_as_utf8.html b/libmongoc/1.23.5/mongoc_uri_get_option_as_utf8.html index ce1f8b7708c459f18f607cefc0f7098d4b25d0ec..a5c7b7d99bbf2a242d6222a0d3f170a99c511ca5 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_option_as_utf8.html +++ b/libmongoc/1.23.5/mongoc_uri_get_option_as_utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_options.html b/libmongoc/1.23.5/mongoc_uri_get_options.html index 34ec809d14c458ffc92e732dae92c7eeb953a0ef..59a2ac06c59d9e939b058f820b5f5935109c5f02 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_options.html +++ b/libmongoc/1.23.5/mongoc_uri_get_options.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_password.html b/libmongoc/1.23.5/mongoc_uri_get_password.html index 2d62e439a3883eacadf90fc873955e9a0242c7d6..fb3c8a464d604c346eb9806e6aabd0719af21216 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_password.html +++ b/libmongoc/1.23.5/mongoc_uri_get_password.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_read_concern.html b/libmongoc/1.23.5/mongoc_uri_get_read_concern.html index ce1e70be2dcc1a436c89500eb7ea150767163d6b..ccbad2d668b72f7bed0e999b0f72019ba4672cc4 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_read_concern.html +++ b/libmongoc/1.23.5/mongoc_uri_get_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_read_prefs.html b/libmongoc/1.23.5/mongoc_uri_get_read_prefs.html index ad162a45357881e7f31c1ca2482d3777a81f2aa2..5cbef75a61361137058954c437d2e3a1423f6101 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_read_prefs.html +++ b/libmongoc/1.23.5/mongoc_uri_get_read_prefs.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_read_prefs_t.html b/libmongoc/1.23.5/mongoc_uri_get_read_prefs_t.html index 69fc0ad1d05fd95e4c526e155a795d14a7108000..ffb02b21e26585fb20b7fd45e42f08f660c066da 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_read_prefs_t.html +++ b/libmongoc/1.23.5/mongoc_uri_get_read_prefs_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_replica_set.html b/libmongoc/1.23.5/mongoc_uri_get_replica_set.html index ec60bde216f775e01a6c6475bc21e9dfd7a5dcb3..83279585a3e15495dcab4adccb5bbbdb0cceb928 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_replica_set.html +++ b/libmongoc/1.23.5/mongoc_uri_get_replica_set.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_service.html b/libmongoc/1.23.5/mongoc_uri_get_service.html index fca8cec751c00cd8ac2a613a77628f863f10cc94..85ad8ef33847623982ae0cc671cede765d737eeb 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_service.html +++ b/libmongoc/1.23.5/mongoc_uri_get_service.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_srv_hostname.html b/libmongoc/1.23.5/mongoc_uri_get_srv_hostname.html index 5956a0a911301c8ff34916d68085ff2de6e75919..c9cd5ceed716af421e68be681f03ca90b91c7cc1 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_srv_hostname.html +++ b/libmongoc/1.23.5/mongoc_uri_get_srv_hostname.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_srv_service_name.html b/libmongoc/1.23.5/mongoc_uri_get_srv_service_name.html index f831c760c5436c7bb231356ce11ca533dfff9945..1394707cf5a90e77e71ce2ecfa28fe37c89b8ca9 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_srv_service_name.html +++ b/libmongoc/1.23.5/mongoc_uri_get_srv_service_name.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_ssl.html b/libmongoc/1.23.5/mongoc_uri_get_ssl.html index 98ee30b20a4a5a45b0735f7cf58526f38aeff4b3..1127606ba79c0fae642fd9fcf2d6d1dac58fec79 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_ssl.html +++ b/libmongoc/1.23.5/mongoc_uri_get_ssl.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_string.html b/libmongoc/1.23.5/mongoc_uri_get_string.html index c6bc3e3bb813d4996ee3380c4bf5f5f01f70b160..6ccf9e4b41e8cae4113ab9609e2b584e23f03750 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_string.html +++ b/libmongoc/1.23.5/mongoc_uri_get_string.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_tls.html b/libmongoc/1.23.5/mongoc_uri_get_tls.html index 55154606f83b852f3fa65fc9fe346665733a3c2a..665d4b67bd8f9ae77c1100050c8d19b1352d6704 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_tls.html +++ b/libmongoc/1.23.5/mongoc_uri_get_tls.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_username.html b/libmongoc/1.23.5/mongoc_uri_get_username.html index d77bac6d8214c3034521249106ffdd8a8aca1a87..c85e64e1cc4651b9751f0b17fbb387f3167df8cd 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_username.html +++ b/libmongoc/1.23.5/mongoc_uri_get_username.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_get_write_concern.html b/libmongoc/1.23.5/mongoc_uri_get_write_concern.html index 78b5559e1ccf9e2e10c834e37093087b24fa48d9..ecf9e32da2f42afde41feafc9c68737252557b2b 100644 --- a/libmongoc/1.23.5/mongoc_uri_get_write_concern.html +++ b/libmongoc/1.23.5/mongoc_uri_get_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_has_option.html b/libmongoc/1.23.5/mongoc_uri_has_option.html index 1ec8879aa9ff872d874ef77839ef64458e2662cf..b081a76d31caa23f037587357a38550ba1c028d7 100644 --- a/libmongoc/1.23.5/mongoc_uri_has_option.html +++ b/libmongoc/1.23.5/mongoc_uri_has_option.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_new.html b/libmongoc/1.23.5/mongoc_uri_new.html index f1644339d262c8b8f371f11cba8e13d4ed8af9e1..f9a9c9666c11cf1ca5ab986c34b9b2d012a54d97 100644 --- a/libmongoc/1.23.5/mongoc_uri_new.html +++ b/libmongoc/1.23.5/mongoc_uri_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_new_for_host_port.html b/libmongoc/1.23.5/mongoc_uri_new_for_host_port.html index 280e589520e37317ab1557be6a2bd09f180f4da9..08c2de2485d30062262c3014622b704aec0684a5 100644 --- a/libmongoc/1.23.5/mongoc_uri_new_for_host_port.html +++ b/libmongoc/1.23.5/mongoc_uri_new_for_host_port.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_new_with_error.html b/libmongoc/1.23.5/mongoc_uri_new_with_error.html index c40328bceb12c5a86b869ef3034d862c9b324558..27898814b283e833ff277371cea76c7a64173609 100644 --- a/libmongoc/1.23.5/mongoc_uri_new_with_error.html +++ b/libmongoc/1.23.5/mongoc_uri_new_with_error.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_option_is_bool.html b/libmongoc/1.23.5/mongoc_uri_option_is_bool.html index f16008088d0e4bb0854f4686f648c42bf8d6c7cd..858024dd5ee0969697c96a6faf0ec7abe5118773 100644 --- a/libmongoc/1.23.5/mongoc_uri_option_is_bool.html +++ b/libmongoc/1.23.5/mongoc_uri_option_is_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_option_is_int32.html b/libmongoc/1.23.5/mongoc_uri_option_is_int32.html index aed2ad007dbbc6228080aaff8d9b0a45dc58c2cd..3aef74c271e9f19d77b88f252f3887b90c221e2e 100644 --- a/libmongoc/1.23.5/mongoc_uri_option_is_int32.html +++ b/libmongoc/1.23.5/mongoc_uri_option_is_int32.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_option_is_int64.html b/libmongoc/1.23.5/mongoc_uri_option_is_int64.html index 5677a7da55d040b602eb791619efc6b858eacd6b..bf07b47e81cdb8c70332ef0ac6f064c1257c5010 100644 --- a/libmongoc/1.23.5/mongoc_uri_option_is_int64.html +++ b/libmongoc/1.23.5/mongoc_uri_option_is_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_option_is_utf8.html b/libmongoc/1.23.5/mongoc_uri_option_is_utf8.html index 815ec0a31a78fde11c24dd6b814efbfe5bd1ce33..b72ad97224bdfbdea77f40630f060a284505cb32 100644 --- a/libmongoc/1.23.5/mongoc_uri_option_is_utf8.html +++ b/libmongoc/1.23.5/mongoc_uri_option_is_utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_auth_mechanism.html b/libmongoc/1.23.5/mongoc_uri_set_auth_mechanism.html index 10bec0aa0ffea8fb2e5c49b204b13dc2efe8de03..255873cb485842acf9d68a53abf64f5e4a47b5c2 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_auth_mechanism.html +++ b/libmongoc/1.23.5/mongoc_uri_set_auth_mechanism.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_auth_source.html b/libmongoc/1.23.5/mongoc_uri_set_auth_source.html index dd19a4016e4ecc810e134d5ee269a1ad0d501342..2753dac66c221b8ff556824be3598f2be48fa2ef 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_auth_source.html +++ b/libmongoc/1.23.5/mongoc_uri_set_auth_source.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_compressors.html b/libmongoc/1.23.5/mongoc_uri_set_compressors.html index 00308881d5c5c432b89ce00cec2e02f09dd012b0..e322212492c9b1c3e2034f93ec4ada8a54165aac 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_compressors.html +++ b/libmongoc/1.23.5/mongoc_uri_set_compressors.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_database.html b/libmongoc/1.23.5/mongoc_uri_set_database.html index dbe9bc922083f3150a8d946c6ad6eed47b40453a..f7703ffab727ff13273ac5c93477495932709c15 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_database.html +++ b/libmongoc/1.23.5/mongoc_uri_set_database.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_mechanism_properties.html b/libmongoc/1.23.5/mongoc_uri_set_mechanism_properties.html index 75e0f7dd4cd89eb676a037eeed770a70bfc187ec..8db7fdacc50c40f081c610e60c27d000738ab294 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_mechanism_properties.html +++ b/libmongoc/1.23.5/mongoc_uri_set_mechanism_properties.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_option_as_bool.html b/libmongoc/1.23.5/mongoc_uri_set_option_as_bool.html index e87184459ebf48abb3922d89e970f1465d4fc98b..cba7f24cc4d0c471204dad4d7974d186e4ee0297 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_option_as_bool.html +++ b/libmongoc/1.23.5/mongoc_uri_set_option_as_bool.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_option_as_int32.html b/libmongoc/1.23.5/mongoc_uri_set_option_as_int32.html index e9f0f806fa60a54089c5c619bad2dbeaec4a417c..1be20d45e7688e082b1d140383f125df7c7ec992 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_option_as_int32.html +++ b/libmongoc/1.23.5/mongoc_uri_set_option_as_int32.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_option_as_int64.html b/libmongoc/1.23.5/mongoc_uri_set_option_as_int64.html index 96d7c8c145d199671ef381a5666d29e2ee1e17ad..0646038cb3f555545414f52eb28f7c19dc7b0b8e 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_option_as_int64.html +++ b/libmongoc/1.23.5/mongoc_uri_set_option_as_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_option_as_utf8.html b/libmongoc/1.23.5/mongoc_uri_set_option_as_utf8.html index 1b860c51ff79d8699378e944a7e13c3c10e0c75a..8a07787889ac390e014fff104732f998b9e882e1 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_option_as_utf8.html +++ b/libmongoc/1.23.5/mongoc_uri_set_option_as_utf8.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_password.html b/libmongoc/1.23.5/mongoc_uri_set_password.html index fe944778fa134c86056183861c0308558c5b19e1..cc607bc98456f4eef79112be5c30ded1cad9cf11 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_password.html +++ b/libmongoc/1.23.5/mongoc_uri_set_password.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_read_concern.html b/libmongoc/1.23.5/mongoc_uri_set_read_concern.html index 2bd086d43c6b6328de23d09e8470cb8cb416041d..d4dd702b443b38ec725dc02c4992d45306d161f0 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_read_concern.html +++ b/libmongoc/1.23.5/mongoc_uri_set_read_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_read_prefs_t.html b/libmongoc/1.23.5/mongoc_uri_set_read_prefs_t.html index 3df4af8d6ce8c245bedbd6d4fe3e731be5f86b80..e909925af361a6ad3c8826b16b4eb9d3e8b8f461 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_read_prefs_t.html +++ b/libmongoc/1.23.5/mongoc_uri_set_read_prefs_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_username.html b/libmongoc/1.23.5/mongoc_uri_set_username.html index 352b6b82d7c6dfe4607c0c229e65bdda5ddb6828..67ee6b06100499095dec2e2360f7ccd5cebb9b95 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_username.html +++ b/libmongoc/1.23.5/mongoc_uri_set_username.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_set_write_concern.html b/libmongoc/1.23.5/mongoc_uri_set_write_concern.html index c91d9eb378f7c6949c07f9bcc082f9c040f5091c..ff7496df80d089c84c8e104abfb6f367b10252bf 100644 --- a/libmongoc/1.23.5/mongoc_uri_set_write_concern.html +++ b/libmongoc/1.23.5/mongoc_uri_set_write_concern.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_t.html b/libmongoc/1.23.5/mongoc_uri_t.html index e6ab04ec8e71db424ddc0f0055f457385e026099..9849ae6da8d08738d7137316ab34438eba7374eb 100644 --- a/libmongoc/1.23.5/mongoc_uri_t.html +++ b/libmongoc/1.23.5/mongoc_uri_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_uri_unescape.html b/libmongoc/1.23.5/mongoc_uri_unescape.html index b9928a4ff61333904608ea8104b3796f6d8ea62e..6f9782f25ed68fe3700b74ade7f599ff765559f4 100644 --- a/libmongoc/1.23.5/mongoc_uri_unescape.html +++ b/libmongoc/1.23.5/mongoc_uri_unescape.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_version.html b/libmongoc/1.23.5/mongoc_version.html index 2839d539eb87e01f3483d2736feadc17558afe77..08b8ace3453ece1ed397b016e2e0e3621afbc258 100644 --- a/libmongoc/1.23.5/mongoc_version.html +++ b/libmongoc/1.23.5/mongoc_version.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_append.html b/libmongoc/1.23.5/mongoc_write_concern_append.html index 44213d93b62e029637b3d8aa904da260cb3d51cf..b699824d48fae83af079f3bf299e562bc6ca0f52 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_append.html +++ b/libmongoc/1.23.5/mongoc_write_concern_append.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_copy.html b/libmongoc/1.23.5/mongoc_write_concern_copy.html index 8ac4a013273ff308a81e42bb86130504c7132ece..fc534138ce67cceebf34db80b1e00ce0b961a00b 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_copy.html +++ b/libmongoc/1.23.5/mongoc_write_concern_copy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_destroy.html b/libmongoc/1.23.5/mongoc_write_concern_destroy.html index 6214846fda02e78d169701ad76e38fb5a68ae2ae..a1b52c17cc5ef3722f7054ffe9b47a16932cf9f9 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_destroy.html +++ b/libmongoc/1.23.5/mongoc_write_concern_destroy.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_fsync.html b/libmongoc/1.23.5/mongoc_write_concern_get_fsync.html index 6f030601c2d5b168bd98229487064de378618478..7c6c6ad899b5a1b73d8cfd61e741f58298e9f6aa 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_fsync.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_fsync.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_journal.html b/libmongoc/1.23.5/mongoc_write_concern_get_journal.html index 2b38dbd2ee0e1fc89c13640e9fff51a0d75831e1..ffe68b4e5f14105c21b288aa2a68537cf174b470 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_journal.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_journal.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_w.html b/libmongoc/1.23.5/mongoc_write_concern_get_w.html index 0fee231b23dc51b68768c683cb185a70c0c2d5d3..f8fe660314c21e3c90e3baed799297f8e36e3098 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_w.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_w.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_wmajority.html b/libmongoc/1.23.5/mongoc_write_concern_get_wmajority.html index 403624701bc918de7575757929de13f4a9c8d246..bdc670ea2d0ce6607942af4636710a978b04fa45 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_wmajority.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_wmajority.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_wtag.html b/libmongoc/1.23.5/mongoc_write_concern_get_wtag.html index 59e38bba2c22554e458113c57ca68784151d5032..ae014accbc7b7b65694676c5412c3f7c145396ed 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_wtag.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_wtag.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout.html b/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout.html index fb99f3c615ba536b4e9651befc8ed693061a3ef6..354cb4ee4a4686c2e21f53fec3e4907b380d2b6e 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout_int64.html b/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout_int64.html index 30ea01fc57a63d97b8dbcdfa937948bbd039ff66..68c922a13cc2f9c8ec4ef7ca8eff66ad652a1dd4 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout_int64.html +++ b/libmongoc/1.23.5/mongoc_write_concern_get_wtimeout_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_is_acknowledged.html b/libmongoc/1.23.5/mongoc_write_concern_is_acknowledged.html index 5d18413cc50cdc581e7fc04b964e70d37f5c3432..edddd9e3cba57e8a6e926f6dd8dfd05d3981c068 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_is_acknowledged.html +++ b/libmongoc/1.23.5/mongoc_write_concern_is_acknowledged.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_is_default.html b/libmongoc/1.23.5/mongoc_write_concern_is_default.html index e4b426aa3bae7fc69cafd8896c70325e7ed39ad3..7c07078b2930d1334eb4f5bb1dfc0e9c06171ba6 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_is_default.html +++ b/libmongoc/1.23.5/mongoc_write_concern_is_default.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_is_valid.html b/libmongoc/1.23.5/mongoc_write_concern_is_valid.html index c0da27b12e4a27e82a018ba70d38659a3fc5dd1b..8c8450ca697972a9a5eebdaff8fd227f2dcd5ab8 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_is_valid.html +++ b/libmongoc/1.23.5/mongoc_write_concern_is_valid.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_journal_is_set.html b/libmongoc/1.23.5/mongoc_write_concern_journal_is_set.html index bb4d59ce371a839c87372acc9f0c533af7674466..704f0214be277b91119d6cf50a328b90ce43917d 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_journal_is_set.html +++ b/libmongoc/1.23.5/mongoc_write_concern_journal_is_set.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_new.html b/libmongoc/1.23.5/mongoc_write_concern_new.html index c868403b4162eb1c65789a603ad272e4e8482939..b404e6c0e8617ff9c0386c50db62595ef651daa9 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_new.html +++ b/libmongoc/1.23.5/mongoc_write_concern_new.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_fsync.html b/libmongoc/1.23.5/mongoc_write_concern_set_fsync.html index 850603bc71ab19a0b5035c5a6bcbcc9819c56b5d..14558a0b76b39efa33b59d81a6907ba0e84929e4 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_fsync.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_fsync.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_journal.html b/libmongoc/1.23.5/mongoc_write_concern_set_journal.html index 3405adfb1d7f062eef43d92c92b629012b04e4ad..23fb9d42c32f1dabbb4b32945255e720afcff2a0 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_journal.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_journal.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_w.html b/libmongoc/1.23.5/mongoc_write_concern_set_w.html index 6744a7325c04462063bb7b3badd73fb57adba2c8..47d300380fcceea45d1efaa91fdde89ce611b328 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_w.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_w.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_wmajority.html b/libmongoc/1.23.5/mongoc_write_concern_set_wmajority.html index 531249fe1b172e11e4e5ea0eddfc635e0e054c86..8219ceeff1a4097b66b9ed5efb5eb98630282c3e 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_wmajority.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_wmajority.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_wtag.html b/libmongoc/1.23.5/mongoc_write_concern_set_wtag.html index affb23e350a5e4c7c475b8412891d3d9e29740bd..d63ed82c66a722f52d50ab98c2209530d10ebf90 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_wtag.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_wtag.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout.html b/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout.html index d3b55e81af0ac86133c3ed8f24ada3ae7beb5278..8d1f1557de8478dcef151c983eb7dac5e82bcb2b 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout_int64.html b/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout_int64.html index 52b597d9662ad1c207defc9ff9906b3fc9e6acd2..a884f32343927c190c87a1d5d3fa66291f5f69b7 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout_int64.html +++ b/libmongoc/1.23.5/mongoc_write_concern_set_wtimeout_int64.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/mongoc_write_concern_t.html b/libmongoc/1.23.5/mongoc_write_concern_t.html index ffbb56b963e1982af5847039222c3c86da8f1736..1fa9acb84464b1e3ad805481b32b39cac790258f 100644 --- a/libmongoc/1.23.5/mongoc_write_concern_t.html +++ b/libmongoc/1.23.5/mongoc_write_concern_t.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/queryable-encryption.html b/libmongoc/1.23.5/queryable-encryption.html index 11c7a7a9d9040d179efa58726b4c69e65ccf4c97..e82b2ea7fc8b60e1e49eb20ebf1049525f3276fd 100644 --- a/libmongoc/1.23.5/queryable-encryption.html +++ b/libmongoc/1.23.5/queryable-encryption.html @@ -38,6 +38,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/search.html b/libmongoc/1.23.5/search.html index b6b53ce8d08a6964729135a1e4cefc8149c4ef5f..4915d82ccd347755e61084bac640beaafa4696e1 100644 --- a/libmongoc/1.23.5/search.html +++ b/libmongoc/1.23.5/search.html @@ -45,6 +45,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/tutorial.html b/libmongoc/1.23.5/tutorial.html index 372f4cbadafb82d0656aaf1cf0e547de7f431aaf..2cc246b3733103892378345c39dfa941df874761 100644 --- a/libmongoc/1.23.5/tutorial.html +++ b/libmongoc/1.23.5/tutorial.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.23.5/using_client_side_encryption.html b/libmongoc/1.23.5/using_client_side_encryption.html index 13a74ead799c09e00d7303516df464baf7b7cfba..e17155d96c5678c7f8621f1318f920fe822f3b9c 100644 --- a/libmongoc/1.23.5/using_client_side_encryption.html +++ b/libmongoc/1.23.5/using_client_side_encryption.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version. +
    diff --git a/libmongoc/1.23.5/visual-studio-guide.html b/libmongoc/1.23.5/visual-studio-guide.html index 64d693e3b846ce2535d2dd10261bc284ae263dcf..e25afe4f37b60d001ffd10ef325a8f0239f8bcc8 100644 --- a/libmongoc/1.23.5/visual-studio-guide.html +++ b/libmongoc/1.23.5/visual-studio-guide.html @@ -40,6 +40,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.0/.nojekyll b/libmongoc/1.24.0/.nojekyll new file mode 100644 index 0000000000000000000000000000000000000000..19102815663d23f8b75a47e7a01965dcdc96468c --- /dev/null +++ b/libmongoc/1.24.0/.nojekyll @@ -0,0 +1 @@ +foo \ No newline at end of file diff --git a/libmongoc/1.24.0/CMakeLists.txt b/libmongoc/1.24.0/CMakeLists.txt new file mode 100644 index 0000000000000000000000000000000000000000..202daf7bc716d73f8e8ace2890c0af6889b1f658 --- /dev/null +++ b/libmongoc/1.24.0/CMakeLists.txt @@ -0,0 +1,39 @@ +file (GLOB_RECURSE _images_pngs + RELATIVE ${PROJECT_SOURCE_DIR}/doc/static + ${PROJECT_SOURCE_DIR}/doc/static/*.png +) +foreach (png IN LISTS _images_pngs) + extra_dist_generated (_images/${png}) +endforeach () + +# Additional generated static files +extra_dist_generated ( + .nojekyll + objects.inv + _static/ajax-loader.gif + _static/basic.css + _static/comment-bright.png + _static/comment-close.png + _static/comment.png + _static/doctools.js + _static/documentation_options.js + _static/down-pressed.png + _static/down.png + _static/file.png + _static/jquery.js + _static/minus.png + _static/plus.png + _static/pygments.css + _static/readable.css + _static/searchtools.js + _static/underscore.js + _static/up-pressed.png + _static/up.png + _static/websupport.js + search.html + searchindex.js +) + +set_dist_list (src_libmongoc_doc_html_DIST + CMakeLists.txt +) diff --git a/libmongoc/1.24.0/_images/msvc-add-dependencies-static.png b/libmongoc/1.24.0/_images/msvc-add-dependencies-static.png new file mode 100644 index 0000000000000000000000000000000000000000..b70984e5b94463f3292966ed74d2fb4fc7a92343 Binary files /dev/null and b/libmongoc/1.24.0/_images/msvc-add-dependencies-static.png differ diff --git a/libmongoc/1.24.0/_images/msvc-add-dependencies.png b/libmongoc/1.24.0/_images/msvc-add-dependencies.png new file mode 100644 index 0000000000000000000000000000000000000000..3fe2c7ae74660fb2096f6442aba0972d42f77aec Binary files /dev/null and b/libmongoc/1.24.0/_images/msvc-add-dependencies.png differ diff --git a/libmongoc/1.24.0/_images/msvc-add-include-directories.png b/libmongoc/1.24.0/_images/msvc-add-include-directories.png new file mode 100644 index 0000000000000000000000000000000000000000..afd181272db5fc0d6457868e0c4849628a17a12b Binary files /dev/null and b/libmongoc/1.24.0/_images/msvc-add-include-directories.png differ diff --git a/libmongoc/1.24.0/_images/msvc-create-project.png b/libmongoc/1.24.0/_images/msvc-create-project.png new file mode 100644 index 0000000000000000000000000000000000000000..8c7f749c65be2289f93a0e5ddbc0568fe9b982ab Binary files /dev/null and b/libmongoc/1.24.0/_images/msvc-create-project.png differ diff --git a/libmongoc/1.24.0/_images/msvc-set-path.png b/libmongoc/1.24.0/_images/msvc-set-path.png new file mode 100644 index 0000000000000000000000000000000000000000..c135b1a014a61186b2873a9caf80b972d2384c5e Binary files /dev/null and b/libmongoc/1.24.0/_images/msvc-set-path.png differ diff --git a/libmongoc/1.24.0/_images/msvc-switch-architecture.png b/libmongoc/1.24.0/_images/msvc-switch-architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..fdc52d1590a958d565d0a1f13aeb17f5bec62e4d Binary files /dev/null and b/libmongoc/1.24.0/_images/msvc-switch-architecture.png differ diff --git a/libmongoc/1.24.0/_static/ajax-loader.gif b/libmongoc/1.24.0/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 Binary files /dev/null and b/libmongoc/1.24.0/_static/ajax-loader.gif differ diff --git a/libmongoc/1.24.0/_static/basic.css b/libmongoc/1.24.0/_static/basic.css new file mode 100644 index 0000000000000000000000000000000000000000..19ced1057aebf39d3dac6f6a5d864491231a3e33 --- /dev/null +++ b/libmongoc/1.24.0/_static/basic.css @@ -0,0 +1,665 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 450px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +div.code-block-caption { + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +div.code-block-caption + div > div.highlight > pre { + margin-top: 0; +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + padding: 1em 1em 0; +} + +div.literal-block-wrapper div.highlight { + margin: 0; +} + +code.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +code.descclassname { + background-color: transparent; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: relative; + left: 0px; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/libmongoc/1.24.0/_static/comment-bright.png b/libmongoc/1.24.0/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..15e27edb12ac25701ac0ac21b97b52bb4e45415e Binary files /dev/null and b/libmongoc/1.24.0/_static/comment-bright.png differ diff --git a/libmongoc/1.24.0/_static/comment-close.png b/libmongoc/1.24.0/_static/comment-close.png new file mode 100644 index 0000000000000000000000000000000000000000..4d91bcf57de866a901a89a2a68c0f36af1114841 Binary files /dev/null and b/libmongoc/1.24.0/_static/comment-close.png differ diff --git a/libmongoc/1.24.0/_static/comment.png b/libmongoc/1.24.0/_static/comment.png new file mode 100644 index 0000000000000000000000000000000000000000..dfbc0cbd512bdeefcb1984c99d8e577efb77f006 Binary files /dev/null and b/libmongoc/1.24.0/_static/comment.png differ diff --git a/libmongoc/1.24.0/_static/doctools.js b/libmongoc/1.24.0/_static/doctools.js new file mode 100644 index 0000000000000000000000000000000000000000..d8928926bf24bb081d91a12f7b92e1b2d8b142b6 --- /dev/null +++ b/libmongoc/1.24.0/_static/doctools.js @@ -0,0 +1,313 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var bbox = span.getBBox(); + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + var parentOfText = node.parentNode.parentNode; + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated === 'undefined') + return string; + return (typeof translated === 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated === 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + if (!body.length) { + body = $('body'); + } + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) === 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this === '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + }, + + initOnKeyListeners: function() { + $(document).keyup(function(event) { + var activeElementType = document.activeElement.tagName; + // don't navigate when in search box or textarea + if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') { + switch (event.keyCode) { + case 37: // left + var prevHref = $('link[rel="prev"]').prop('href'); + if (prevHref) { + window.location.href = prevHref; + return false; + } + case 39: // right + var nextHref = $('link[rel="next"]').prop('href'); + if (nextHref) { + window.location.href = nextHref; + return false; + } + } + } + }); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); \ No newline at end of file diff --git a/libmongoc/1.24.0/_static/documentation_options.js b/libmongoc/1.24.0/_static/documentation_options.js new file mode 100644 index 0000000000000000000000000000000000000000..bc12cb35cdbb5228850f6e53832f07a9febac8ed --- /dev/null +++ b/libmongoc/1.24.0/_static/documentation_options.js @@ -0,0 +1,9 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + FILE_SUFFIX: '.html', + HAS_SOURCE: false, + SOURCELINK_SUFFIX: '.txt' +}; \ No newline at end of file diff --git a/libmongoc/1.24.0/_static/down-pressed.png b/libmongoc/1.24.0/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..5756c8cad8854722893dc70b9eb4bb0400343a39 Binary files /dev/null and b/libmongoc/1.24.0/_static/down-pressed.png differ diff --git a/libmongoc/1.24.0/_static/down.png b/libmongoc/1.24.0/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..1b3bdad2ceffae91cee61b32f3295f9bbe646e48 Binary files /dev/null and b/libmongoc/1.24.0/_static/down.png differ diff --git a/libmongoc/1.24.0/_static/file.png b/libmongoc/1.24.0/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 Binary files /dev/null and b/libmongoc/1.24.0/_static/file.png differ diff --git a/libmongoc/1.24.0/_static/jquery-3.2.1.js b/libmongoc/1.24.0/_static/jquery-3.2.1.js new file mode 100644 index 0000000000000000000000000000000000000000..d2d8ca4790e52b0537f3cbb7dcd766099b789583 --- /dev/null +++ b/libmongoc/1.24.0/_static/jquery-3.2.1.js @@ -0,0 +1,10253 @@ +/*! + * jQuery JavaScript Library v3.2.1 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2017-03-20T18:59Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var document = window.document; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var concat = arr.concat; + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + + + + function DOMEval( code, doc ) { + doc = doc || document; + + var script = doc.createElement( "script" ); + + script.text = code; + doc.head.appendChild( script ).parentNode.removeChild( script ); + } +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.2.1", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }, + + // Support: Android <=4.0 only + // Make sure we trim BOM and NBSP + rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, + + // Matches dashed string for camelizing + rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g, + + // Used by jQuery.camelCase as callback to replace() + fcamelCase = function( all, letter ) { + return letter.toUpperCase(); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + + if ( copyIsArray ) { + copyIsArray = false; + clone = src && Array.isArray( src ) ? src : []; + + } else { + clone = src && jQuery.isPlainObject( src ) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isFunction: function( obj ) { + return jQuery.type( obj ) === "function"; + }, + + isWindow: function( obj ) { + return obj != null && obj === obj.window; + }, + + isNumeric: function( obj ) { + + // As of jQuery 3.0, isNumeric is limited to + // strings and numbers (primitives or objects) + // that can be coerced to finite numbers (gh-2662) + var type = jQuery.type( obj ); + return ( type === "number" || type === "string" ) && + + // parseFloat NaNs numeric-cast false positives ("") + // ...but misinterprets leading-number strings, particularly hex literals ("0x...") + // subtraction forces infinities to NaN + !isNaN( obj - parseFloat( obj ) ); + }, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + + /* eslint-disable no-unused-vars */ + // See https://github.com/eslint/eslint/issues/6125 + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + type: function( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; + }, + + // Evaluates a script in a global context + globalEval: function( code ) { + DOMEval( code ); + }, + + // Convert dashed to camelCase; used by the css and data modules + // Support: IE <=9 - 11, Edge 12 - 13 + // Microsoft forgot to hump their vendor prefix (#9572) + camelCase: function( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // Support: Android <=4.0 only + trim: function( text ) { + return text == null ? + "" : + ( text + "" ).replace( rtrim, "" ); + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // Bind a function to a context, optionally partially applying any + // arguments. + proxy: function( fn, context ) { + var tmp, args, proxy; + + if ( typeof context === "string" ) { + tmp = fn[ context ]; + context = fn; + fn = tmp; + } + + // Quick check to determine if target is callable, in the spec + // this throws a TypeError, but we will just return undefined. + if ( !jQuery.isFunction( fn ) ) { + return undefined; + } + + // Simulated bind + args = slice.call( arguments, 2 ); + proxy = function() { + return fn.apply( context || this, args.concat( slice.call( arguments ) ) ); + }; + + // Set the guid of unique handler to the same of original handler, so it can be removed + proxy.guid = fn.guid = fn.guid || jQuery.guid++; + + return proxy; + }, + + now: Date.now, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), +function( i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +} ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = jQuery.type( obj ); + + if ( type === "function" || jQuery.isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.3 + * https://sizzlejs.com/ + * + * Copyright jQuery Foundation and other contributors + * Released under the MIT license + * http://jquery.org/license + * + * Date: 2016-08-08 + */ +(function( window ) { + +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ({}).hasOwnProperty, + arr = [], + pop = arr.pop, + push_native = arr.push, + push = arr.push, + slice = arr.slice, + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[i] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier + identifier = "(?:\\\\.|[\\w-]|[^\0-\\xa0])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + // "Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace + + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ), + + rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*?)" + whitespace + "*\\]", "g" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace + + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + + whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ), + funescape = function( _, escaped, escapedWhitespace ) { + var high = "0x" + escaped - 0x10000; + // NaN means non-codepoint + // Support: Firefox<24 + // Workaround erroneous numeric interpretation of +"0x" + return high !== high || escapedWhitespace ? + escaped : + high < 0 ? + // BMP codepoint + String.fromCharCode( high + 0x10000 ) : + // Supplemental Plane codepoint (surrogate pair) + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + disabledAncestor = addCombinator( + function( elem ) { + return elem.disabled === true && ("form" in elem || "label" in elem); + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + (arr = slice.call( preferredDoc.childNodes )), + preferredDoc.childNodes + ); + // Support: Android<4.0 + // Detect silently failing push.apply + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + push_native.apply( target, slice.call(els) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + // Can't trust NodeList.length + while ( (target[j++] = els[i++]) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + + if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) { + setDocument( context ); + } + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && (match = rquickExpr.exec( selector )) ) { + + // ID selector + if ( (m = match[1]) ) { + + // Document context + if ( nodeType === 9 ) { + if ( (elem = context.getElementById( m )) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && (elem = newContext.getElementById( m )) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[2] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( (m = match[3]) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !compilerCache[ selector + " " ] && + (!rbuggyQSA || !rbuggyQSA.test( selector )) ) { + + if ( nodeType !== 1 ) { + newContext = context; + newSelector = selector; + + // qSA looks outside Element context, which is not what we want + // Thanks to Andrew Dupont for this workaround technique + // Support: IE <=8 + // Exclude object elements + } else if ( context.nodeName.toLowerCase() !== "object" ) { + + // Capture the context ID, setting it first if necessary + if ( (nid = context.getAttribute( "id" )) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", (nid = expando) ); + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[i] = "#" + nid + " " + toSelector( groups[i] ); + } + newSelector = groups.join( "," ); + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + } + + if ( newSelector ) { + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return (cache[ key + " " ] = value); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement("fieldset"); + + try { + return !!fn( el ); + } catch (e) { + return false; + } finally { + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split("|"), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[i] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( (cur = cur.nextSibling) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + disabledAncestor( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction(function( argument ) { + argument = +argument; + return markFunction(function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ (j = matchIndexes[i]) ] ) { + seed[j] = !(matches[j] = seed[j]); + } + } + }); + }); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = elem && (elem.ownerDocument || elem).documentElement; + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9-11, Edge + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + if ( preferredDoc !== document && + (subWindow = document.defaultView) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert(function( el ) { + el.className = "i"; + return !el.getAttribute("className"); + }); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert(function( el ) { + el.appendChild( document.createComment("") ); + return !el.getElementsByTagName("*").length; + }); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert(function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + }); + + // ID filter and find + if ( support.getById ) { + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute("id") === attrId; + }; + }; + Expr.find["ID"] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode("id"); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find["ID"] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode("id"); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( (elem = elems[i++]) ) { + node = elem.getAttributeNode("id"); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find["TAG"] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( (elem = results[i++]) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( (support.qsa = rnative.test( document.querySelectorAll )) ) { + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert(function( el ) { + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll("[msallowcapture^='']").length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll("[selected]").length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push("~="); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll(":checked").length ) { + rbuggyQSA.push(":checked"); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push(".#.+[+~]"); + } + }); + + assert(function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement("input"); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll("[name=d]").length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll(":enabled").length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll(":disabled").length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll("*,:x"); + rbuggyQSA.push(",.*:"); + }); + } + + if ( (support.matchesSelector = rnative.test( (matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector) )) ) { + + assert(function( el ) { + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + }); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + )); + } : + function( a, b ) { + if ( b ) { + while ( (b = b.parentNode) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + compare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + (!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) { + + // Choose the first element that is related to our preferred document + if ( a === document || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) { + return -1; + } + if ( b === document || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + return a === document ? -1 : + b === document ? 1 : + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( (cur = cur.parentNode) ) { + ap.unshift( cur ); + } + cur = b; + while ( (cur = cur.parentNode) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[i] === bp[i] ) { + i++; + } + + return i ? + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[i], bp[i] ) : + + // Otherwise nodes in our document sort first + ap[i] === preferredDoc ? -1 : + bp[i] === preferredDoc ? 1 : + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + // Make sure that attribute selectors are quoted + expr = expr.replace( rattributeQuotes, "='$1']" ); + + if ( support.matchesSelector && documentIsHTML && + !compilerCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch (e) {} + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + // Set document vars if needed + if ( ( context.ownerDocument || context ) !== document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + (val = elem.getAttributeNode(name)) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return (sel + "").replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( (elem = results[i++]) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + // If no nodeType, this is expected to be an array + while ( (node = elem[i++]) ) { + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[1] = match[1].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[3] = ( match[3] || match[4] || match[5] || "" ).replace( runescape, funescape ); + + if ( match[2] === "~=" ) { + match[3] = " " + match[3] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[1] = match[1].toLowerCase(); + + if ( match[1].slice( 0, 3 ) === "nth" ) { + // nth-* requires argument + if ( !match[3] ) { + Sizzle.error( match[0] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) ); + match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" ); + + // other types prohibit arguments + } else if ( match[3] ) { + Sizzle.error( match[0] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[6] && match[2]; + + if ( matchExpr["CHILD"].test( match[0] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[3] ) { + match[2] = match[4] || match[5] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + // Get excess from tokenize (recursively) + (excess = tokenize( unquoted, true )) && + // advance to the next closing parenthesis + (excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) { + + // excess is a negative index + match[0] = match[0].slice( 0, excess ); + match[2] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { return true; } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + (pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) && + classCache( className, function( elem ) { + return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== "undefined" && elem.getAttribute("class") || "" ); + }); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + }; + }, + + "CHILD": function( type, what, argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( (node = node[ dir ]) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || (node[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + (outerCache[ node.uniqueID ] = {}); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( (node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + (diff = nodeIndex = 0) || start.pop()) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + // Use previously-cached element index if available + if ( useCache ) { + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || (node[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + (outerCache[ node.uniqueID ] = {}); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + // Use the same loop as above to seek `elem` from the start + while ( (node = ++nodeIndex && node && node[ dir ] || + (diff = nodeIndex = 0) || start.pop()) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || (node[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + (outerCache[ node.uniqueID ] = {}); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction(function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[i] ); + seed[ idx ] = !( matches[ idx ] = matched[i] ); + } + }) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + // Potentially complex pseudos + "not": markFunction(function( selector ) { + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction(function( seed, matches, context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( (elem = unmatched[i]) ) { + seed[i] = !(matches[i] = elem); + } + } + }) : + function( elem, context, xml ) { + input[0] = elem; + matcher( input, null, xml, results ); + // Don't keep the element (issue #299) + input[0] = null; + return !results.pop(); + }; + }), + + "has": markFunction(function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + }), + + "contains": markFunction(function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1; + }; + }), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + // lang value must be a valid identifier + if ( !ridentifier.test(lang || "") ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( (elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( (elem = elem.parentNode) && elem.nodeType === 1 ); + return false; + }; + }), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected); + }, + + "selected": function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos["empty"]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo(function() { + return [ 0 ]; + }), + + "last": createPositionalPseudo(function( matchIndexes, length ) { + return [ length - 1 ]; + }), + + "eq": createPositionalPseudo(function( matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + }), + + "even": createPositionalPseudo(function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "odd": createPositionalPseudo(function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "lt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "gt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }) + } +}; + +Expr.pseudos["nth"] = Expr.pseudos["eq"]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || (match = rcomma.exec( soFar )) ) { + if ( match ) { + // Don't consume trailing commas as valid + soFar = soFar.slice( match[0].length ) || soFar; + } + groups.push( (tokens = []) ); + } + + matched = false; + + // Combinators + if ( (match = rcombinators.exec( soFar )) ) { + matched = match.shift(); + tokens.push({ + value: matched, + // Cast descendant combinators to space + type: match[0].replace( rtrim, " " ) + }); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] || + (match = preFilters[ type ]( match ))) ) { + matched = match.shift(); + tokens.push({ + value: matched, + type: type, + matches: match + }); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[i].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || (elem[ expando ] = {}); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || (outerCache[ elem.uniqueID ] = {}); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( (oldCache = uniqueCache[ key ]) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return (newCache[ 2 ] = oldCache[ 2 ]); + } else { + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( (newCache[ 2 ] = matcher( elem, context, xml )) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[i]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[0]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[i], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( (elem = unmatched[i]) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction(function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( (elem = temp[i]) ) { + matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) ) { + // Restore matcherIn since elem is not yet a final match + temp.push( (matcherIn[i] = elem) ); + } + } + postFinder( null, (matcherOut = []), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) && + (temp = postFinder ? indexOf( seed, elem ) : preMap[i]) > -1 ) { + + seed[temp] = !(results[temp] = elem); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + }); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[0].type ], + implicitRelative = leadingRelative || Expr.relative[" "], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + (checkContext = context).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( (matcher = Expr.relative[ tokens[i].type ]) ) { + matchers = [ addCombinator(elementMatcher( matchers ), matcher) ]; + } else { + matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[j].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" }) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( (tokens = tokens.slice( j )) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find["TAG"]( "*", outermost ), + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1), + len = elems.length; + + if ( outermost ) { + outermostContext = context === document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && (elem = elems[i]) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + if ( !context && elem.ownerDocument !== document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( (matcher = elementMatchers[j++]) ) { + if ( matcher( elem, context || document, xml) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + // They will have gone through all possible matchers + if ( (elem = !matcher && elem) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( (matcher = setMatchers[j++]) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !(unmatched[i] || setMatched[i]) ) { + setMatched[i] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[i] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( (selector = compiled.selector || selector) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[0] = match[0].slice( 0 ); + if ( tokens.length > 2 && (token = tokens[0]).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[1].type ] ) { + + context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[i]; + + // Abort if we hit a combinator + if ( Expr.relative[ (type = token.type) ] ) { + break; + } + if ( (find = Expr.find[ type ]) ) { + // Search, expanding context for leading sibling combinators + if ( (seed = find( + token.matches[0].replace( runescape, funescape ), + rsibling.test( tokens[0].type ) && testContext( context.parentNode ) || context + )) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split("").sort( sortOrder ).join("") === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert(function( el ) { + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement("fieldset") ) & 1; +}); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert(function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute("href") === "#" ; +}) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + }); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert(function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +}) ) { + addHandle( "value", function( elem, name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + }); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert(function( el ) { + return el.getAttribute("disabled") == null; +}) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + (val = elem.getAttributeNode( name )) && val.specified ? + val.value : + null; + } + }); +} + +return Sizzle; + +})( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +}; +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +var risSimple = /^.[^:#\[\.,]*$/; + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Simple selector that can be filtered directly, removing non-Elements + if ( risSimple.test( qualifier ) ) { + return jQuery.filter( qualifier, elements, not ); + } + + // Complex selector, compare the two sets, removing non-Elements + qualifier = jQuery.filter( qualifier, elements ); + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not && elem.nodeType === 1; + } ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( jQuery.isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( nodeName( elem, "iframe" ) ) { + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( jQuery.isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && jQuery.type( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && jQuery.isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && jQuery.isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = jQuery.isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && jQuery.isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( jQuery.isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + jQuery.isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + jQuery.isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + jQuery.isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the master Deferred + master = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + master.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( master.state() === "pending" || + jQuery.isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return master.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); + } + + return master.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( jQuery.type( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !jQuery.isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ jQuery.camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ jQuery.camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ jQuery.camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( jQuery.camelCase ); + } else { + key = jQuery.camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = jQuery.camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + jQuery.contains( elem.ownerDocument, elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + +var swap = function( elem, options, callback, args ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.apply( elem, args || [] ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, + scale = 1, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + do { + + // If previous iteration zeroed out, double until we get *something*. + // Use string for doubling so we don't accidentally see scale as unchanged below + scale = scale || ".5"; + + // Adjust and apply + initialInUnit = initialInUnit / scale; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Update scale, tolerating zero or NaN from tween.cur() + // Break the loop if scale is unchanged or perfect, or if we've just had enough. + } while ( + scale !== ( scale = currentValue() / initial ) && scale !== 1 && --maxIterations + ); + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]+)/i ); + +var rscriptType = ( /^$|\/(?:java|ecma)script/i ); + + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // Support: IE <=9 only + option: [ 1, "" ], + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
    " ], + col: [ 2, "", "
    " ], + tr: [ 2, "", "
    " ], + td: [ 3, "", "
    " ], + + _default: [ 0, "", "" ] +}; + +// Support: IE <=9 only +wrapMap.optgroup = wrapMap.option; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, contains, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( jQuery.type( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + contains = jQuery.contains( elem.ownerDocument, elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( contains ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; +} )(); +var documentElement = document.documentElement; + + + +var + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, + rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 only +// See #13393 for more info +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Don't attach events to noData or text/comment nodes (but allow plain objects) + if ( !elemData ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = {}; + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + // Make a writable jQuery.Event from the native event object + var event = jQuery.event.fix( nativeEvent ); + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + handlers = ( dataPriv.get( this, "events" ) || {} )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // Triggered event must either 1) have no namespace, or 2) have namespace(s) + // a subset or equal to those in the bound event (both can have no namespace). + if ( !event.rnamespace || event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: jQuery.isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + focus: { + + // Fire native event if possible so blur/focus sequence is correct + trigger: function() { + if ( this !== safeActiveElement() && this.focus ) { + this.focus(); + return false; + } + }, + delegateType: "focusin" + }, + blur: { + trigger: function() { + if ( this === safeActiveElement() && this.blur ) { + this.blur(); + return false; + } + }, + delegateType: "focusout" + }, + click: { + + // For checkbox, fire native event so checked state will be right + trigger: function() { + if ( this.type === "checkbox" && this.click && nodeName( this, "input" ) ) { + this.click(); + return false; + } + }, + + // For cross-browser consistency, don't fire native .click() on links + _default: function( event ) { + return nodeName( event.target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + + which: function( event ) { + var button = event.button; + + // Add which for key events + if ( event.which == null && rkeyEvent.test( event.type ) ) { + return event.charCode != null ? event.charCode : event.keyCode; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { + if ( button & 1 ) { + return 1; + } + + if ( button & 2 ) { + return 3; + } + + if ( button & 4 ) { + return 2; + } + + return 0; + } + + return event.which; + } +}, jQuery.event.addProp ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + /* eslint-disable max-len */ + + // See https://github.com/eslint/eslint/issues/3229 + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi, + + /* eslint-enable */ + + // Support: IE <=10 - 11, Edge 12 - 13 + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( ">tbody", elem )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + var match = rscriptTypeMasked.exec( elem.type ); + + if ( match ) { + elem.type = match[ 1 ]; + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, pdataCur, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.access( src ); + pdataCur = dataPriv.set( dest, pdataOld ); + events = pdataOld.events; + + if ( events ) { + delete pdataCur.handle; + pdataCur.events = {}; + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = concat.apply( [], args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + isFunction = jQuery.isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( isFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( isFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl ) { + jQuery._evalUrl( node.src ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && jQuery.contains( node.ownerDocument, node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html.replace( rxhtmlTag, "<$1>" ); + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = jQuery.contains( elem.ownerDocument, elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rmargin = ( /^margin/ ); + +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + div.style.cssText = + "box-sizing:border-box;" + + "position:relative;display:block;" + + "margin:auto;border:1px;padding:1px;" + + "top:1%;width:50%"; + div.innerHTML = ""; + documentElement.appendChild( container ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = divStyle.marginLeft === "2px"; + boxSizingReliableVal = divStyle.width === "4px"; + + // Support: Android 4.0 - 4.3 only + // Some styles come back with percentage values, even though they shouldn't + div.style.marginRight = "50%"; + pixelMarginRightVal = divStyle.marginRight === "4px"; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + var pixelPositionVal, boxSizingReliableVal, pixelMarginRightVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + container.style.cssText = "border:0;width:8px;height:0;top:0;left:-9999px;" + + "padding:0;margin-top:1px;position:absolute"; + container.appendChild( div ); + + jQuery.extend( support, { + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelMarginRight: function() { + computeStyleTests(); + return pixelMarginRightVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelMarginRight() && rnumnonpx.test( ret ) && rmargin.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }, + + cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style; + +// Return a css property mapped to a potentially vendor prefixed property +function vendorPropName( name ) { + + // Shortcut for names that are not vendor prefixed + if ( name in emptyStyle ) { + return name; + } + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a property mapped along what jQuery.cssProps suggests or to +// a vendor prefixed property. +function finalPropName( name ) { + var ret = jQuery.cssProps[ name ]; + if ( !ret ) { + ret = jQuery.cssProps[ name ] = vendorPropName( name ) || name; + } + return ret; +} + +function setPositiveNumber( elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function augmentWidthOrHeight( elem, name, extra, isBorderBox, styles ) { + var i, + val = 0; + + // If we already have the right measurement, avoid augmentation + if ( extra === ( isBorderBox ? "border" : "content" ) ) { + i = 4; + + // Otherwise initialize for horizontal or vertical properties + } else { + i = name === "width" ? 1 : 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin, so add it if we want it + if ( extra === "margin" ) { + val += jQuery.css( elem, extra + cssExpand[ i ], true, styles ); + } + + if ( isBorderBox ) { + + // border-box includes padding, so remove it if we want content + if ( extra === "content" ) { + val -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // At this point, extra isn't border nor margin, so remove border + if ( extra !== "margin" ) { + val -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } else { + + // At this point, extra isn't content, so add padding + val += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // At this point, extra isn't content nor padding, so add border + if ( extra !== "padding" ) { + val += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + return val; +} + +function getWidthOrHeight( elem, name, extra ) { + + // Start with computed style + var valueIsBorderBox, + styles = getStyles( elem ), + val = curCSS( elem, name, styles ), + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Computed unit is not pixels. Stop here and return. + if ( rnumnonpx.test( val ) ) { + return val; + } + + // Check for style in case a browser which returns unreliable values + // for getComputedStyle silently falls back to the reliable elem.style + valueIsBorderBox = isBorderBox && + ( support.boxSizingReliable() || val === elem.style[ name ] ); + + // Fall back to offsetWidth/Height when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + if ( val === "auto" ) { + val = elem[ "offset" + name[ 0 ].toUpperCase() + name.slice( 1 ) ]; + } + + // Normalize "", auto, and prepare for extra + val = parseFloat( val ) || 0; + + // Use the active box-sizing model to add/subtract irrelevant styles + return ( val + + augmentWidthOrHeight( + elem, + name, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: { + "float": "cssFloat" + }, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = jQuery.camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + if ( type === "number" ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = jQuery.camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( i, name ) { + jQuery.cssHooks[ name ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, name, extra ); + } ) : + getWidthOrHeight( elem, name, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = extra && getStyles( elem ), + subtract = extra && augmentWidthOrHeight( + elem, + name, + extra, + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + styles + ); + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ name ] = value; + value = jQuery.css( elem, name ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( !rmargin.test( prefix ) ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && + ( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null || + jQuery.cssHooks[ tween.prop ] ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = jQuery.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 13 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = jQuery.camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( jQuery.isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + jQuery.proxy( result.stop, result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( jQuery.isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( jQuery.isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + jQuery.isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !jQuery.isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( jQuery.isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue && type !== false ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = jQuery.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://html.spec.whatwg.org/multipage/infrastructure.html#strip-and-collapse-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( jQuery.isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( typeof value === "string" && value ) { + classes = value.match( rnothtmlwhite ) || []; + + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( jQuery.isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + if ( typeof value === "string" && value ) { + classes = value.match( rnothtmlwhite ) || []; + + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value; + + if ( typeof stateVal === "boolean" && type === "string" ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( jQuery.isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( type === "string" ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = value.match( rnothtmlwhite ) || []; + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, isFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + isFunction = jQuery.isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( isFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( dataPriv.get( cur, "events" ) || {} )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && jQuery.isFunction( elem[ type ] ) && !jQuery.isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + elem[ type ](); + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " + + "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + + "change select submit keydown keypress keyup contextmenu" ).split( " " ), + function( i, name ) { + + // Handle event binding + jQuery.fn[ name ] = function( data, fn ) { + return arguments.length > 0 ? + this.on( name, null, data, fn ) : + this.trigger( name ); + }; +} ); + +jQuery.fn.extend( { + hover: function( fnOver, fnOut ) { + return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); + } +} ); + + + + +support.focusin = "onfocusin" in window; + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + var doc = this.ownerDocument || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = jQuery.now(); + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) { + xml = undefined; + } + + if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && jQuery.type( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = jQuery.isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ) + .filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ) + .map( function( i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( jQuery.isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() ] = match[ 2 ]; + } + } + match = responseHeaders[ key.toLowerCase() ]; + } + return match == null ? null : match; + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 13 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available, append data to url + if ( s.data ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce++ ) + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( jQuery.isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + + +jQuery._evalUrl = function( url ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + "throws": true + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( jQuery.isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( jQuery.isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var isFunction = jQuery.isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( isFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain requests + if ( s.crossDomain ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + + Advanced Connections — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Advanced Connections

    +

    The following guide contains information specific to certain types of MongoDB configurations.

    +

    For an example of connecting to a simple standalone server, see the Tutorial. To establish a connection with authentication options enabled, see the Authentication page.

    +
    +

    Connecting to a Replica Set

    +

    Connecting to a replica set is much like connecting to a standalone MongoDB server. Simply specify the replica set name using the ?replicaSet=myreplset URI option.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +
    +   mongoc_init ();
    +
    +   /* Create our MongoDB Client */
    +   client = mongoc_client_new (
    +      "mongodb://host01:27017,host02:27017,host03:27017/?replicaSet=myreplset");
    +
    +   /* Do some work */
    +   /* TODO */
    +
    +   /* Clean up */
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +
    +

    Tip

    +

    Multiple hostnames can be specified in the MongoDB connection string URI, with a comma separating hosts in the seed list.

    +

    It is recommended to use a seed list of members of the replica set to allow the driver to connect to any node.

    +
    +
    +
    +

    Connecting to a Sharded Cluster

    +

    To connect to a sharded cluster, specify the mongos nodes the client should connect to. The C Driver will automatically detect that it has connected to a mongos sharding server.

    +

    If more than one hostname is specified, a seed list will be created to attempt failover between the mongos instances.

    +
    +

    Warning

    +

    Specifying the replicaSet parameter when connecting to a mongos sharding server is invalid.

    +
    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +
    +   mongoc_init ();
    +
    +   /* Create our MongoDB Client */
    +   client = mongoc_client_new ("mongodb://myshard01:27017/");
    +
    +   /* Do something with client ... */
    +
    +   /* Free the client */
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +
    +
    +

    Connecting to an IPv6 Address

    +

    The MongoDB C Driver will automatically resolve IPv6 addresses from host names. However, to specify an IPv6 address directly, wrap the address in [].

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://[::1]:27017");
    +
    +
    +
    +
    +

    Connecting with IPv4 and IPv6

    +

    If connecting to a hostname that has both IPv4 and IPv6 DNS records, the behavior follows RFC-6555. A connection to the IPv6 address is attempted first. If IPv6 fails, then a connection is attempted to the IPv4 address. If the connection attempt to IPv6 does not complete within 250ms, then IPv4 is tried in parallel. Whichever succeeds connection first cancels the other. The successful DNS result is cached for 10 minutes.

    +

    As a consequence, attempts to connect to a mongod only listening on IPv4 may be delayed if there are both A (IPv4) and AAAA (IPv6) DNS records associated with the host.

    +

    To avoid a delay, configure hostnames to match the MongoDB configuration. That is, only create an A record if the mongod is only listening on IPv4.

    +
    +
    +

    Connecting to a UNIX Domain Socket

    +

    On UNIX-like systems, the C Driver can connect directly to a MongoDB server using a UNIX domain socket. Pass the URL-encoded path to the socket, which must be suffixed with .sock. For example, to connect to a domain socket at /tmp/mongodb-27017.sock:

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://%2Ftmp%2Fmongodb-27017.sock");
    +
    +
    +

    Include username and password like so:

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://user:pass@%2Ftmp%2Fmongodb-27017.sock");
    +
    +
    +
    +
    +

    Connecting to a server over TLS

    +

    These are instructions for configuring TLS/SSL connections.

    +

    To run a server locally (on port 27017, for example):

    +
    $ mongod --port 27017 --tlsMode requireTLS --tlsCertificateKeyFile server.pem --tlsCAFile ca.pem
    +
    +
    +

    Add /?tls=true to the end of a client URI.

    +
    mongoc_client_t *client = NULL;
    +client = mongoc_client_new ("mongodb://localhost:27017/?tls=true");
    +
    +
    +

    MongoDB requires client certificates by default, unless the --tlsAllowConnectionsWithoutCertificates is provided. The C Driver can be configured to present a client certificate using the URI option tlsCertificateKeyFile, which may be referenced through the constant MONGOC_URI_TLSCERTIFICATEKEYFILE.

    +
    mongoc_client_t *client = NULL;
    +mongoc_uri_t *uri = mongoc_uri_new ("mongodb://localhost:27017/?tls=true");
    +mongoc_uri_set_option_as_utf8 (uri, MONGOC_URI_TLSCERTIFICATEKEYFILE, "client.pem");
    +
    +client = mongoc_client_new_from_uri (uri);
    +
    +
    +

    The client certificate provided by tlsCertificateKeyFile must be issued by one of the server trusted Certificate Authorities listed in --tlsCAFile, or issued by a CA in the native certificate store on the server when omitted.

    +

    See Configuring TLS for more information on the various TLS related options.

    +
    +
    +

    Compressing data to and from MongoDB

    +

    MongoDB 3.4 added Snappy compression support, zlib compression in 3.6, and zstd compression in 4.2. +To enable compression support the client must be configured with which compressors to use:

    +
    mongoc_client_t *client = NULL;
    +client = mongoc_client_new ("mongodb://localhost:27017/?compressors=snappy,zlib,zstd");
    +
    +
    +

    The compressors option specifies the priority order of compressors the +client wants to use. Messages are compressed if the client and server share any +compressors in common.

    +

    Note that the compressor used by the server might not be the same compressor as +the client used. For example, if the client uses the connection string +compressors=zlib,snappy the client will use zlib compression to send +data (if possible), but the server might still reply using snappy, +depending on how the server was configured.

    +

    The driver must be built with zlib and/or snappy and/or zstd support to enable compression +support, any unknown (or not compiled in) compressor value will be ignored. Note: to build with zstd requires cmake 3.12 or higher.

    +
    +
    +

    Additional Connection Options

    +

    The full list of connection options can be found in the mongoc_uri_t docs.

    +

    Certain socket/connection related options are not configurable:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Option

    Description

    Value

    SO_KEEPALIVE

    TCP Keep Alive

    Enabled

    TCP_KEEPIDLE

    How long a connection needs to remain idle before TCP +starts sending keepalive probes

    120 seconds

    TCP_KEEPINTVL

    The time in seconds between TCP probes

    10 seconds

    TCP_KEEPCNT

    How many probes to send, without acknowledgement, +before dropping the connection

    9 probes

    TCP_NODELAY

    Send packets as soon as possible or buffer small +packets (Nagle algorithm)

    Enabled (no buffering)

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/aggregate.html b/libmongoc/1.24.0/aggregate.html new file mode 100644 index 0000000000000000000000000000000000000000..9d80b895e1042322aa14e6a23eb19023679ebdbb --- /dev/null +++ b/libmongoc/1.24.0/aggregate.html @@ -0,0 +1,335 @@ + + + + + + + + + + + + + + Aggregation Framework Examples — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Aggregation Framework Examples

    +

    This document provides a number of practical examples that display the capabilities of the aggregation framework.

    +

    The Aggregations using the Zip Codes Data Set examples uses a publicly available data set of all zipcodes and populations in the United States. These data are available at: zips.json.

    +
    +

    Requirements

    +

    Let’s check if everything is installed.

    +

    Use the following command to load zips.json data set into mongod instance:

    +
    $ mongoimport --drop -d test -c zipcodes zips.json
    +
    +
    +

    Let’s use the MongoDB shell to verify that everything was imported successfully.

    +
    $ mongo test
    +connecting to: test
    +> db.zipcodes.count()
    +29467
    +> db.zipcodes.findOne()
    +{
    +      "_id" : "35004",
    +      "city" : "ACMAR",
    +      "loc" : [
    +              -86.51557,
    +              33.584132
    +      ],
    +      "pop" : 6055,
    +      "state" : "AL"
    +}
    +
    +
    +
    +
    +

    Aggregations using the Zip Codes Data Set

    +

    Each document in this collection has the following form:

    +
    {
    +  "_id" : "35004",
    +  "city" : "Acmar",
    +  "state" : "AL",
    +  "pop" : 6055,
    +  "loc" : [-86.51557, 33.584132]
    +}
    +
    +
    +

    In these documents:

    +
      +
    • The _id field holds the zipcode as a string.

    • +
    • The city field holds the city name.

    • +
    • The state field holds the two letter state abbreviation.

    • +
    • The pop field holds the population.

    • +
    • The loc field holds the location as a [latitude, longitude] array.

    • +
    +
    +
    +

    States with Populations Over 10 Million

    +

    To get all states with a population greater than 10 million, use the following aggregation pipeline:

    +
    +
    aggregation1.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_pipeline (mongoc_collection_t *collection)
    +{
    +   mongoc_cursor_t *cursor;
    +   bson_error_t error;
    +   const bson_t *doc;
    +   bson_t *pipeline;
    +   char *str;
    +
    +   pipeline = BCON_NEW ("pipeline",
    +                        "[",
    +                        "{",
    +                        "$group",
    +                        "{",
    +                        "_id",
    +                        "$state",
    +                        "total_pop",
    +                        "{",
    +                        "$sum",
    +                        "$pop",
    +                        "}",
    +                        "}",
    +                        "}",
    +                        "{",
    +                        "$match",
    +                        "{",
    +                        "total_pop",
    +                        "{",
    +                        "$gte",
    +                        BCON_INT32 (10000000),
    +                        "}",
    +                        "}",
    +                        "}",
    +                        "]");
    +
    +   cursor = mongoc_collection_aggregate (
    +      collection, MONGOC_QUERY_NONE, pipeline, NULL, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "Cursor Failure: %s\n", error.message);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   bson_destroy (pipeline);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string =
    +      "mongodb://localhost:27017/?appname=aggregation-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "zipcodes");
    +
    +   print_pipeline (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    You should see a result like the following:

    +
    { "_id" : "PA", "total_pop" : 11881643 }
    +{ "_id" : "OH", "total_pop" : 10847115 }
    +{ "_id" : "NY", "total_pop" : 17990455 }
    +{ "_id" : "FL", "total_pop" : 12937284 }
    +{ "_id" : "TX", "total_pop" : 16986510 }
    +{ "_id" : "IL", "total_pop" : 11430472 }
    +{ "_id" : "CA", "total_pop" : 29760021 }
    +
    +
    +

    The above aggregation pipeline is build from two pipeline operators: $group and $match.

    +

    The $group pipeline operator requires _id field where we specify grouping; remaining fields specify how to generate composite value and must use one of the group aggregation functions: $addToSet, $first, $last, $max, $min, $avg, $push, $sum. The $match pipeline operator syntax is the same as the read operation query syntax.

    +

    The $group process reads all documents and for each state it creates a separate document, for example:

    +
    { "_id" : "WA", "total_pop" : 4866692 }
    +
    +
    +

    The total_pop field uses the $sum aggregation function to sum the values of all pop fields in the source documents.

    +

    Documents created by $group are piped to the $match pipeline operator. It returns the documents with the value of total_pop field greater than or equal to 10 million.

    +
    +
    +

    Average City Population by State

    +

    To get the first three states with the greatest average population per city, use the following aggregation:

    +
    pipeline = BCON_NEW ("pipeline", "[",
    +   "{", "$group", "{", "_id", "{", "state", "$state", "city", "$city", "}", "pop", "{", "$sum", "$pop", "}", "}", "}",
    +   "{", "$group", "{", "_id", "$_id.state", "avg_city_pop", "{", "$avg", "$pop", "}", "}", "}",
    +   "{", "$sort", "{", "avg_city_pop", BCON_INT32 (-1), "}", "}",
    +   "{", "$limit", BCON_INT32 (3) "}",
    +"]");
    +
    +
    +

    This aggregate pipeline produces:

    +
    { "_id" : "DC", "avg_city_pop" : 303450.0 }
    +{ "_id" : "FL", "avg_city_pop" : 27942.29805615551 }
    +{ "_id" : "CA", "avg_city_pop" : 27735.341099720412 }
    +
    +
    +

    The above aggregation pipeline is build from three pipeline operators: $group, $sort and $limit.

    +

    The first $group operator creates the following documents:

    +
    { "_id" : { "state" : "WY", "city" : "Smoot" }, "pop" : 414 }
    +
    +
    +

    Note, that the $group operator can’t use nested documents except the _id field.

    +

    The second $group uses these documents to create the following documents:

    +
    { "_id" : "FL", "avg_city_pop" : 27942.29805615551 }
    +
    +
    +

    These documents are sorted by the avg_city_pop field in descending order. Finally, the $limit pipeline operator returns the first 3 documents from the sorted set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/api.html b/libmongoc/1.24.0/api.html new file mode 100644 index 0000000000000000000000000000000000000000..def27df24bce95c6a0cd2c05ab519f4b72e81488 --- /dev/null +++ b/libmongoc/1.24.0/api.html @@ -0,0 +1,246 @@ + + + + + + + + + + + + + + API Reference — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/application-performance-monitoring.html b/libmongoc/1.24.0/application-performance-monitoring.html new file mode 100644 index 0000000000000000000000000000000000000000..5a35bacc7ccfd94e5b10d6c12c23fda524aa30d9 --- /dev/null +++ b/libmongoc/1.24.0/application-performance-monitoring.html @@ -0,0 +1,709 @@ + + + + + + + + + + + + + + Application Performance Monitoring (APM) — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Application Performance Monitoring (APM)

    +

    The MongoDB C Driver allows you to monitor all the MongoDB operations the driver executes. This event-notification system conforms to two MongoDB driver specs:

    + +

    To receive notifications, create a mongoc_apm_callbacks_t with mongoc_apm_callbacks_new(), set callbacks on it, then pass it to mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    Command-Monitoring Example

    +
    +
    example-command-monitoring.c
    +
    /* gcc example-command-monitoring.c -o example-command-monitoring \
    + *     $(pkg-config --cflags --libs libmongoc-1.0) */
    +
    +/* ./example-command-monitoring [CONNECTION_STRING] */
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +
    +typedef struct {
    +   int started;
    +   int succeeded;
    +   int failed;
    +} stats_t;
    +
    +
    +void
    +command_started (const mongoc_apm_command_started_t *event)
    +{
    +   char *s;
    +
    +   s = bson_as_relaxed_extended_json (
    +      mongoc_apm_command_started_get_command (event), NULL);
    +   printf ("Command %s started on %s:\n%s\n\n",
    +           mongoc_apm_command_started_get_command_name (event),
    +           mongoc_apm_command_started_get_host (event)->host,
    +           s);
    +
    +   ((stats_t *) mongoc_apm_command_started_get_context (event))->started++;
    +
    +   bson_free (s);
    +}
    +
    +
    +void
    +command_succeeded (const mongoc_apm_command_succeeded_t *event)
    +{
    +   char *s;
    +
    +   s = bson_as_relaxed_extended_json (
    +      mongoc_apm_command_succeeded_get_reply (event), NULL);
    +   printf ("Command %s succeeded:\n%s\n\n",
    +           mongoc_apm_command_succeeded_get_command_name (event),
    +           s);
    +
    +   ((stats_t *) mongoc_apm_command_succeeded_get_context (event))->succeeded++;
    +
    +   bson_free (s);
    +}
    +
    +
    +void
    +command_failed (const mongoc_apm_command_failed_t *event)
    +{
    +   bson_error_t error;
    +
    +   mongoc_apm_command_failed_get_error (event, &error);
    +   printf ("Command %s failed:\n\"%s\"\n\n",
    +           mongoc_apm_command_failed_get_command_name (event),
    +           error.message);
    +
    +   ((stats_t *) mongoc_apm_command_failed_get_context (event))->failed++;
    +}
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_apm_callbacks_t *callbacks;
    +   stats_t stats = {0};
    +   mongoc_collection_t *collection;
    +   bson_error_t error;
    +   const char *uri_string =
    +      "mongodb://127.0.0.1/?appname=cmd-monitoring-example";
    +   mongoc_uri_t *uri;
    +   const char *collection_name = "test";
    +   bson_t *docs[2];
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   callbacks = mongoc_apm_callbacks_new ();
    +   mongoc_apm_set_command_started_cb (callbacks, command_started);
    +   mongoc_apm_set_command_succeeded_cb (callbacks, command_succeeded);
    +   mongoc_apm_set_command_failed_cb (callbacks, command_failed);
    +   mongoc_client_set_apm_callbacks (
    +      client, callbacks, (void *) &stats /* context pointer */);
    +
    +   collection = mongoc_client_get_collection (client, "test", collection_name);
    +   mongoc_collection_drop (collection, NULL);
    +
    +   docs[0] = BCON_NEW ("_id", BCON_INT32 (0));
    +   docs[1] = BCON_NEW ("_id", BCON_INT32 (1));
    +   mongoc_collection_insert_many (
    +      collection, (const bson_t **) docs, 2, NULL, NULL, NULL);
    +
    +   /* duplicate key error on the second insert */
    +   mongoc_collection_insert_one (collection, docs[0], NULL, NULL, NULL);
    +
    +   mongoc_collection_destroy (collection);
    +   mongoc_apm_callbacks_destroy (callbacks);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   printf ("started: %d\nsucceeded: %d\nfailed: %d\n",
    +           stats.started,
    +           stats.succeeded,
    +           stats.failed);
    +
    +   bson_destroy (docs[0]);
    +   bson_destroy (docs[1]);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    This example program prints:

    +
    Command drop started on 127.0.0.1:
    +{ "drop" : "test" }
    +
    +Command drop succeeded:
    +{ "ns" : "test.test", "nIndexesWas" : 1, "ok" : 1.0 }
    +
    +Command insert started on 127.0.0.1:
    +{
    +  "insert" : "test",
    +  "ordered" : true,
    +  "documents" : [
    +    { "_id" : 0 }, { "_id" : 1 }
    +  ]
    +}
    +
    +Command insert succeeded:
    +{ "n" : 2, "ok" : 1.0 }
    +
    +Command insert started on 127.0.0.1:
    +{
    +  "insert" : "test",
    +  "ordered" : true,
    +  "documents" : [
    +    { "_id" : 0 }
    +  ]
    +}
    +
    +Command insert succeeded:
    +{
    +  "n" : 0,
    +  "writeErrors" : [
    +    { "index" : 0, "code" : 11000, "errmsg" : "duplicate key" }
    +  ],
    +  "ok" : 1.0
    +}
    +
    +started: 3
    +succeeded: 3
    +failed: 0
    +
    +
    +

    The output has been edited and formatted for clarity. Depending on your server configuration, messages may include metadata like database name, logical session ids, or cluster times that are not shown here.

    +

    The final “insert” command is considered successful, despite the writeError, because the server replied to the overall command with "ok": 1.

    +
    +
    +

    SDAM Monitoring Example

    +
    +
    example-sdam-monitoring.c
    +
    /* gcc example-sdam-monitoring.c -o example-sdam-monitoring \
    + *     $(pkg-config --cflags --libs libmongoc-1.0) */
    +
    +/* ./example-sdam-monitoring [CONNECTION_STRING] */
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +
    +typedef struct {
    +   int server_changed_events;
    +   int server_opening_events;
    +   int server_closed_events;
    +   int topology_changed_events;
    +   int topology_opening_events;
    +   int topology_closed_events;
    +   int heartbeat_started_events;
    +   int heartbeat_succeeded_events;
    +   int heartbeat_failed_events;
    +} stats_t;
    +
    +
    +static void
    +server_changed (const mongoc_apm_server_changed_t *event)
    +{
    +   stats_t *context;
    +   const mongoc_server_description_t *prev_sd, *new_sd;
    +
    +   context = (stats_t *) mongoc_apm_server_changed_get_context (event);
    +   context->server_changed_events++;
    +
    +   prev_sd = mongoc_apm_server_changed_get_previous_description (event);
    +   new_sd = mongoc_apm_server_changed_get_new_description (event);
    +
    +   printf ("server changed: %s %s -> %s\n",
    +           mongoc_apm_server_changed_get_host (event)->host_and_port,
    +           mongoc_server_description_type (prev_sd),
    +           mongoc_server_description_type (new_sd));
    +}
    +
    +
    +static void
    +server_opening (const mongoc_apm_server_opening_t *event)
    +{
    +   stats_t *context;
    +
    +   context = (stats_t *) mongoc_apm_server_opening_get_context (event);
    +   context->server_opening_events++;
    +
    +   printf ("server opening: %s\n",
    +           mongoc_apm_server_opening_get_host (event)->host_and_port);
    +}
    +
    +
    +static void
    +server_closed (const mongoc_apm_server_closed_t *event)
    +{
    +   stats_t *context;
    +
    +   context = (stats_t *) mongoc_apm_server_closed_get_context (event);
    +   context->server_closed_events++;
    +
    +   printf ("server closed: %s\n",
    +           mongoc_apm_server_closed_get_host (event)->host_and_port);
    +}
    +
    +
    +static void
    +topology_changed (const mongoc_apm_topology_changed_t *event)
    +{
    +   stats_t *context;
    +   const mongoc_topology_description_t *prev_td;
    +   const mongoc_topology_description_t *new_td;
    +   mongoc_server_description_t **prev_sds;
    +   size_t n_prev_sds;
    +   mongoc_server_description_t **new_sds;
    +   size_t n_new_sds;
    +   size_t i;
    +   mongoc_read_prefs_t *prefs;
    +
    +   context = (stats_t *) mongoc_apm_topology_changed_get_context (event);
    +   context->topology_changed_events++;
    +
    +   prev_td = mongoc_apm_topology_changed_get_previous_description (event);
    +   prev_sds = mongoc_topology_description_get_servers (prev_td, &n_prev_sds);
    +   new_td = mongoc_apm_topology_changed_get_new_description (event);
    +   new_sds = mongoc_topology_description_get_servers (new_td, &n_new_sds);
    +
    +   printf ("topology changed: %s -> %s\n",
    +           mongoc_topology_description_type (prev_td),
    +           mongoc_topology_description_type (new_td));
    +
    +   if (n_prev_sds) {
    +      printf ("  previous servers:\n");
    +      for (i = 0; i < n_prev_sds; i++) {
    +         printf ("      %s %s\n",
    +                 mongoc_server_description_type (prev_sds[i]),
    +                 mongoc_server_description_host (prev_sds[i])->host_and_port);
    +      }
    +   }
    +
    +   if (n_new_sds) {
    +      printf ("  new servers:\n");
    +      for (i = 0; i < n_new_sds; i++) {
    +         printf ("      %s %s\n",
    +                 mongoc_server_description_type (new_sds[i]),
    +                 mongoc_server_description_host (new_sds[i])->host_and_port);
    +      }
    +   }
    +
    +   prefs = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +
    +   /* it is safe, and unfortunately necessary, to cast away const here */
    +   if (mongoc_topology_description_has_readable_server (
    +          (mongoc_topology_description_t *) new_td, prefs)) {
    +      printf ("  secondary AVAILABLE\n");
    +   } else {
    +      printf ("  secondary UNAVAILABLE\n");
    +   }
    +
    +   if (mongoc_topology_description_has_writable_server (
    +          (mongoc_topology_description_t *) new_td)) {
    +      printf ("  primary AVAILABLE\n");
    +   } else {
    +      printf ("  primary UNAVAILABLE\n");
    +   }
    +
    +   mongoc_read_prefs_destroy (prefs);
    +   mongoc_server_descriptions_destroy_all (prev_sds, n_prev_sds);
    +   mongoc_server_descriptions_destroy_all (new_sds, n_new_sds);
    +}
    +
    +
    +static void
    +topology_opening (const mongoc_apm_topology_opening_t *event)
    +{
    +   stats_t *context;
    +
    +   context = (stats_t *) mongoc_apm_topology_opening_get_context (event);
    +   context->topology_opening_events++;
    +
    +   printf ("topology opening\n");
    +}
    +
    +
    +static void
    +topology_closed (const mongoc_apm_topology_closed_t *event)
    +{
    +   stats_t *context;
    +
    +   context = (stats_t *) mongoc_apm_topology_closed_get_context (event);
    +   context->topology_closed_events++;
    +
    +   printf ("topology closed\n");
    +}
    +
    +
    +static void
    +server_heartbeat_started (const mongoc_apm_server_heartbeat_started_t *event)
    +{
    +   stats_t *context;
    +
    +   context =
    +      (stats_t *) mongoc_apm_server_heartbeat_started_get_context (event);
    +   context->heartbeat_started_events++;
    +
    +   printf ("%s heartbeat started\n",
    +           mongoc_apm_server_heartbeat_started_get_host (event)->host_and_port);
    +}
    +
    +
    +static void
    +server_heartbeat_succeeded (
    +   const mongoc_apm_server_heartbeat_succeeded_t *event)
    +{
    +   stats_t *context;
    +   char *reply;
    +
    +   context =
    +      (stats_t *) mongoc_apm_server_heartbeat_succeeded_get_context (event);
    +   context->heartbeat_succeeded_events++;
    +
    +   reply = bson_as_canonical_extended_json (
    +      mongoc_apm_server_heartbeat_succeeded_get_reply (event), NULL);
    +
    +   printf (
    +      "%s heartbeat succeeded: %s\n",
    +      mongoc_apm_server_heartbeat_succeeded_get_host (event)->host_and_port,
    +      reply);
    +
    +   bson_free (reply);
    +}
    +
    +
    +static void
    +server_heartbeat_failed (const mongoc_apm_server_heartbeat_failed_t *event)
    +{
    +   stats_t *context;
    +   bson_error_t error;
    +
    +   context = (stats_t *) mongoc_apm_server_heartbeat_failed_get_context (event);
    +   context->heartbeat_failed_events++;
    +   mongoc_apm_server_heartbeat_failed_get_error (event, &error);
    +
    +   printf ("%s heartbeat failed: %s\n",
    +           mongoc_apm_server_heartbeat_failed_get_host (event)->host_and_port,
    +           error.message);
    +}
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_apm_callbacks_t *cbs;
    +   stats_t stats = {0};
    +   const char *uri_string =
    +      "mongodb://127.0.0.1/?appname=sdam-monitoring-example";
    +   mongoc_uri_t *uri;
    +   bson_t cmd = BSON_INITIALIZER;
    +   bson_t reply;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   cbs = mongoc_apm_callbacks_new ();
    +   mongoc_apm_set_server_changed_cb (cbs, server_changed);
    +   mongoc_apm_set_server_opening_cb (cbs, server_opening);
    +   mongoc_apm_set_server_closed_cb (cbs, server_closed);
    +   mongoc_apm_set_topology_changed_cb (cbs, topology_changed);
    +   mongoc_apm_set_topology_opening_cb (cbs, topology_opening);
    +   mongoc_apm_set_topology_closed_cb (cbs, topology_closed);
    +   mongoc_apm_set_server_heartbeat_started_cb (cbs, server_heartbeat_started);
    +   mongoc_apm_set_server_heartbeat_succeeded_cb (cbs,
    +                                                 server_heartbeat_succeeded);
    +   mongoc_apm_set_server_heartbeat_failed_cb (cbs, server_heartbeat_failed);
    +   mongoc_client_set_apm_callbacks (
    +      client, cbs, (void *) &stats /* context pointer */);
    +
    +   /* the driver connects on demand to perform first operation */
    +   BSON_APPEND_INT32 (&cmd, "buildinfo", 1);
    +   mongoc_client_command_simple (client, "admin", &cmd, NULL, &reply, &error);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   printf ("Events:\n"
    +           "   server changed: %d\n"
    +           "   server opening: %d\n"
    +           "   server closed: %d\n"
    +           "   topology changed: %d\n"
    +           "   topology opening: %d\n"
    +           "   topology closed: %d\n"
    +           "   heartbeat started: %d\n"
    +           "   heartbeat succeeded: %d\n"
    +           "   heartbeat failed: %d\n",
    +           stats.server_changed_events,
    +           stats.server_opening_events,
    +           stats.server_closed_events,
    +           stats.topology_changed_events,
    +           stats.topology_opening_events,
    +           stats.topology_closed_events,
    +           stats.heartbeat_started_events,
    +           stats.heartbeat_succeeded_events,
    +           stats.heartbeat_failed_events);
    +
    +   bson_destroy (&cmd);
    +   bson_destroy (&reply);
    +   mongoc_apm_callbacks_destroy (cbs);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Start a 3-node replica set on localhost with set name “rs” and start the program:

    +
    ./example-sdam-monitoring "mongodb://localhost:27017,localhost:27018/?replicaSet=rs"
    +
    +
    +

    This example program prints something like:

    +
    topology opening
    +topology changed: Unknown -> ReplicaSetNoPrimary
    +  secondary UNAVAILABLE
    +  primary UNAVAILABLE
    +server opening: localhost:27017
    +server opening: localhost:27018
    +localhost:27017 heartbeat started
    +localhost:27018 heartbeat started
    +localhost:27017 heartbeat succeeded: { ... reply ... }
    +server changed: localhost:27017 Unknown -> RSPrimary
    +server opening: localhost:27019
    +topology changed: ReplicaSetNoPrimary -> ReplicaSetWithPrimary
    +  new servers:
    +      RSPrimary localhost:27017
    +  secondary UNAVAILABLE
    +  primary AVAILABLE
    +localhost:27019 heartbeat started
    +localhost:27018 heartbeat succeeded: { ... reply ... }
    +server changed: localhost:27018 Unknown -> RSSecondary
    +topology changed: ReplicaSetWithPrimary -> ReplicaSetWithPrimary
    +  previous servers:
    +      RSPrimary localhost:27017
    +  new servers:
    +      RSPrimary localhost:27017
    +      RSSecondary localhost:27018
    +  secondary AVAILABLE
    +  primary AVAILABLE
    +localhost:27019 heartbeat succeeded: { ... reply ... }
    +server changed: localhost:27019 Unknown -> RSSecondary
    +topology changed: ReplicaSetWithPrimary -> ReplicaSetWithPrimary
    +  previous servers:
    +      RSPrimary localhost:27017
    +      RSSecondary localhost:27018
    +  new servers:
    +      RSPrimary localhost:27017
    +      RSSecondary localhost:27018
    +      RSSecondary localhost:27019
    +  secondary AVAILABLE
    +  primary AVAILABLE
    +topology closed
    +
    +Events:
    +   server changed: 3
    +   server opening: 3
    +   server closed: 0
    +   topology changed: 4
    +   topology opening: 1
    +   topology closed: 1
    +   heartbeat started: 3
    +   heartbeat succeeded: 3
    +   heartbeat failed: 0
    +
    +
    +

    The driver connects to the mongods on ports 27017 and 27018, which were specified in the URI, and determines which is primary. It also discovers the third member, “localhost:27019”, and adds it to the topology.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/authentication.html b/libmongoc/1.24.0/authentication.html new file mode 100644 index 0000000000000000000000000000000000000000..d544150eda2ed435099d53e7cfbb7696544576c6 --- /dev/null +++ b/libmongoc/1.24.0/authentication.html @@ -0,0 +1,345 @@ + + + + + + + + + + + + + + Authentication — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Authentication

    +

    This guide covers the use of authentication options with the MongoDB C Driver. Ensure that the MongoDB server is also properly configured for authentication before making a connection. For more information, see the MongoDB security documentation.

    +

    The MongoDB C driver supports several authentication mechanisms through the use of MongoDB connection URIs.

    +

    By default, if a username and password are provided as part of the connection string (and an optional authentication database), they are used to connect via the default authentication mechanism of the server.

    +

    To select a specific authentication mechanism other than the default, see the list of supported mechanism below.

    +
    mongoc_client_t *client = mongoc_client_new ("mongodb://user:password@localhost/?authSource=mydb");
    +
    +
    +

    Currently supported values for the authMechanism connection string option are:

    + +
    +

    Basic Authentication (SCRAM-SHA-256)

    +

    MongoDB 4.0 introduces support for authenticating using the SCRAM protocol +with the more secure SHA-256 hash described in RFC 7677. Using this authentication mechanism +means that the password is never actually sent over the wire when +authenticating, but rather a computed proof that the client password is the +same as the password the server knows. In MongoDB 4.0, the C driver can +determine the correct default authentication mechanism for users with stored +SCRAM-SHA-1 and SCRAM-SHA-256 credentials:

    +
    mongoc_client_t *client =  mongoc_client_new ("mongodb://user:password@localhost/?authSource=mydb");
    +/* the correct authMechanism is negotiated between the driver and server. */
    +
    +
    +

    Alternatively, SCRAM-SHA-256 can be explicitly specified as an authMechanism.

    +
    mongoc_client_t *client =  mongoc_client_new ("mongodb://user:password@localhost/?authMechanism=SCRAM-SHA-256&authSource=mydb");
    +
    +
    +

    Passwords for SCRAM-SHA-256 undergo the preprocessing step known as SASLPrep +specified in RFC 4013. SASLPrep will +only be performed for passwords containing non-ASCII characters. SASLPrep +requires libicu. If libicu is not available, attempting to authenticate over +SCRAM-SHA-256 with non-ASCII passwords will result in error.

    +

    Usernames never undergo SASLPrep.

    +

    By default, when building the C driver libicu is linked if available. This can +be changed with the ENABLE_ICU cmake option. To specify an installation +path of libicu, specify ICU_ROOT as a cmake option. See the +FindICU documentation +for more information.

    +
    +
    +

    Basic Authentication (SCRAM-SHA-1)

    +

    The default authentication mechanism before MongoDB 4.0 is SCRAM-SHA-1 (RFC 5802). Using this authentication mechanism means that the password is never actually sent over the wire when authenticating, but rather a computed proof that the client password is the same as the password the server knows.

    +
    mongoc_client_t *client = mongoc_client_new ("mongodb://user:password@localhost/?authMechanism=SCRAM-SHA-1&authSource=mydb");
    +
    +
    +
    +

    Note

    +

    SCRAM-SHA-1 authenticates against the admin database by default. If the user is created in another database, then specifying the authSource is required.

    +
    +
    +
    +

    Legacy Authentication (MONGODB-CR)

    +

    The MONGODB-CR authMechanism is deprecated and will no longer function in MongoDB 4.0. Instead, specify no authMechanism and the driver +will use an authentication mechanism compatible with your server.

    +
    +
    +

    GSSAPI (Kerberos) Authentication

    +
    +

    Note

    +

    On UNIX-like environments, Kerberos support requires compiling the driver against cyrus-sasl.

    +

    On Windows, Kerberos support requires compiling the driver against Windows Native SSPI or cyrus-sasl. The default configuration of the driver will use Windows Native SSPI.

    +

    To modify the default configuration, use the cmake option ENABLE_SASL.

    +
    +

    GSSAPI (Kerberos) authentication is available in the Enterprise Edition of MongoDB. To authenticate using GSSAPI, the MongoDB C driver must be installed with SASL support.

    +

    On UNIX-like environments, run the kinit command before using the following authentication methods:

    +
    $ kinit mongodbuser@EXAMPLE.COM
    +mongodbuser@EXAMPLE.COM's Password:
    +$ klistCredentials cache: FILE:/tmp/krb5cc_1000
    +        Principal: mongodbuser@EXAMPLE.COM
    +
    +  Issued                Expires               Principal
    +Feb  9 13:48:51 2013  Feb  9 23:48:51 2013  krbtgt/EXAMPLE.COM@EXAMPLE.COM
    +
    +
    +

    Now authenticate using the MongoDB URI. GSSAPI authenticates against the $external virtual database, so a database does not need to be specified in the URI. Note that the Kerberos principal must be URL-encoded:

    +
    mongoc_client_t *client;
    +
    +client = mongoc_client_new ("mongodb://mongodbuser%40EXAMPLE.COM@mongo-server.example.com/?authMechanism=GSSAPI");
    +
    +
    +
    +

    Note

    +

    GSSAPI authenticates against the $external database, so specifying the authSource database is not required.

    +
    +

    The driver supports these GSSAPI properties:

    +
      +
    • CANONICALIZE_HOST_NAME: This might be required with Cyrus-SASL when the hosts report different hostnames than what is used in the Kerberos database. The default is “false”.

    • +
    • SERVICE_NAME: Use a different service name than the default, “mongodb”.

    • +
    +

    Set properties in the URL:

    +
    mongoc_client_t *client;
    +
    +client = mongoc_client_new ("mongodb://mongodbuser%40EXAMPLE.COM@mongo-server.example.com/?authMechanism=GSSAPI&"
    +                            "authMechanismProperties=SERVICE_NAME:other,CANONICALIZE_HOST_NAME:true");
    +
    +
    +

    If you encounter errors such as Invalid net address, check if the application is behind a NAT (Network Address Translation) firewall. If so, create a ticket that uses forwardable and addressless Kerberos tickets. This can be done by passing -f -A to kinit.

    +
    $ kinit -f -A mongodbuser@EXAMPLE.COM
    +
    +
    +
    +
    +

    SASL Plain Authentication

    +
    +

    Note

    +

    The MongoDB C Driver must be compiled with SASL support in order to use SASL PLAIN authentication.

    +
    +

    MongoDB Enterprise Edition supports the SASL PLAIN authentication mechanism, initially intended for delegating authentication to an LDAP server. Using the SASL PLAIN mechanism is very similar to the challenge response mechanism with usernames and passwords. This authentication mechanism uses the $external virtual database for LDAP support:

    +
    +

    Note

    +

    SASL PLAIN is a clear-text authentication mechanism. It is strongly recommended to connect to MongoDB using TLS with certificate validation when using the PLAIN mechanism.

    +
    +
    mongoc_client_t *client;
    +
    +client = mongoc_client_new ("mongodb://user:password@example.com/?authMechanism=PLAIN");
    +
    +
    +

    PLAIN authenticates against the $external database, so specifying the authSource database is not required.

    +
    +
    +

    X.509 Certificate Authentication

    +
    +

    Note

    +

    The MongoDB C Driver must be compiled with TLS support for X.509 authentication support. Once this is done, start a server with the following options:

    +
    $ mongod --tlsMode requireTLS --tlsCertificateKeyFile server.pem --tlsCAFile ca.pem
    +
    +
    +
    +

    The MONGODB-X509 mechanism authenticates a username derived from the distinguished subject name of the X.509 certificate presented by the driver during TLS negotiation. This authentication method requires the use of TLS connections with certificate validation.

    +
    mongoc_client_t *client;
    +mongoc_ssl_opt_t ssl_opts = { 0 };
    +
    +ssl_opts.pem_file = "mycert.pem";
    +ssl_opts.pem_pwd = "mycertpassword";
    +ssl_opts.ca_file = "myca.pem";
    +ssl_opts.ca_dir = "trust_dir";
    +ssl_opts.weak_cert_validation = false;
    +
    +client = mongoc_client_new ("mongodb://x509_derived_username@localhost/?authMechanism=MONGODB-X509");
    +mongoc_client_set_ssl_opts (client, &ssl_opts);
    +
    +
    +

    MONGODB-X509 authenticates against the $external database, so specifying the authSource database is not required. For more information on the x509_derived_username, see the MongoDB server x.509 tutorial.

    +
    +

    Note

    +

    The MongoDB C Driver will attempt to determine the x509 derived username when none is provided, and as of MongoDB 3.4 providing the username is not required at all.

    +
    +
    +
    +

    Authentication via AWS IAM

    +

    The MONGODB-AWS mechanism authenticates to MongoDB servers with credentials provided by AWS Identity and Access Management (IAM).

    +

    To authenticate, create a user with an associated Amazon Resource Name (ARN) on the $external database, and specify the MONGODB-AWS authMechanism in the URI.

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://localhost/?authMechanism=MONGODB-AWS");
    +
    +
    +

    Since MONGODB-AWS always authenticates against the $external database, so specifying the authSource database is not required.

    +

    Credentials include the access key id, secret access key, and optional session token. They may be obtained from the following ways.

    +
    +

    AWS credentials via URI

    +

    Credentials may be passed directly in the URI as username/password.

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://<access key id>:<secret access key>localhost/?authMechanism=MONGODB-AWS");
    +
    +
    +

    This may include a session token passed with authMechanismProperties.

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://<access key id>:<secret access key>localhost/?authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<token>");
    +
    +
    +
    +
    +

    AWS credentials via environment

    +

    If credentials are not passed through the URI, libmongoc will check for the following environment variables.

    +
      +
    • AWS_ACCESS_KEY_ID

    • +
    • AWS_SECRET_ACCESS_KEY

    • +
    • AWS_SESSION_TOKEN (optional)

    • +
    +
    +
    +

    AWS Credentials via ECS

    +

    If credentials are not passed in the URI or with environment variables, libmongoc will check if the environment variable AWS_CONTAINER_CREDENTIALS_RELATIVE_URI is set, and if so, attempt to retrieve temporary credentials from the ECS task metadata by querying a link local address.

    +
    +
    +

    AWS Credentials via EC2

    +

    If credentials are not passed in the URI or with environment variables, and the environment variable AWS_CONTAINER_CREDENTIALS_RELATIVE_URI is not set, libmongoc will attempt to retrieve temporary credentials from the EC2 machine metadata by querying link local addresses.

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/basic-troubleshooting.html b/libmongoc/1.24.0/basic-troubleshooting.html new file mode 100644 index 0000000000000000000000000000000000000000..66dcc4f65b894260da20c985c4cec2d51ad6e2cc --- /dev/null +++ b/libmongoc/1.24.0/basic-troubleshooting.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + Basic Troubleshooting — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Basic Troubleshooting

    +
    +

    Troubleshooting Checklist

    +

    The following is a short list of things to check when you have a problem.

    +
      +
    • Did you call mongoc_init() in main()? If not, you will likely see a segfault.

    • +
    • Have you leaked any clients or cursors as can be found with mongoc-stat <PID>?

    • +
    • Have packets been delivered to the server? See egress bytes from mongoc-stat <PID>.

    • +
    • Does ASAN show any leaks? Ensure you call mongoc_cleanup() at the end of your process to cleanup lingering allocations from the MongoDB C driver.

    • +
    • If compiling your own copy of MongoDB C Driver, consider using the cmake option -DENABLE_TRACING=ON to enable function tracing and hex dumps of network packets to STDERR and STDOUT.

    • +
    +
    +
    +

    Performance Counters

    +

    The MongoDB C Driver comes with an optional and unique feature to help developers and sysadmins troubleshoot problems in production. +Performance counters are available for each process using the C Driver. +If available, the counters can be accessed outside of the application process via a shared memory segment. +The counters may be used graph statistics about your application process easily from tools like Munin or Nagios. +For example, the command watch --interval=0.5 -d mongoc-stat $PID may be used to monitor an application.

    +

    Performance counters are only available on Linux platforms and macOS arm64 platforms that support shared memory segments. +On supported platforms, they are enabled by default. +Applications can be built without the counters by specifying the cmake option -DENABLE_SHM_COUNTERS=OFF. +Additionally, if performance counters are already compiled, they can be disabled at runtime by specifying the environment variable MONGOC_DISABLE_SHM.

    +

    Performance counters keep track of the following:

    +
      +
    • Active and Disposed Cursors

    • +
    • Active and Disposed Clients, Client Pools, and Socket Streams.

    • +
    • Number of operations sent and received, by type.

    • +
    • Bytes transferred and received.

    • +
    • Authentication successes and failures.

    • +
    • Number of wire protocol errors.

    • +
    +
    +

    Note

    +

    An operation is considered “sent” when one or more bytes of the corresponding message is written to the stream, regardless of whether the entire message is successfully written or if the operation ultimately succeeds or fails. +This does not include bytes that may be written during the stream connection process, such as TLS handshake messages.

    +
    +

    To access counters for a given process, simply provide the process id to the mongoc-stat program installed with the MongoDB C Driver.

    +
    $ mongoc-stat 22203
    +   Operations : Egress Total        : The number of sent operations.                    : 13247
    +   Operations : Ingress Total       : The number of received operations.                : 13246
    +   Operations : Egress Queries      : The number of sent Query operations.              : 13247
    +   Operations : Ingress Queries     : The number of received Query operations.          : 0
    +   Operations : Egress GetMore      : The number of sent GetMore operations.            : 0
    +   Operations : Ingress GetMore     : The number of received GetMore operations.        : 0
    +   Operations : Egress Insert       : The number of sent Insert operations.             : 0
    +   Operations : Ingress Insert      : The number of received Insert operations.         : 0
    +   Operations : Egress Delete       : The number of sent Delete operations.             : 0
    +   Operations : Ingress Delete      : The number of received Delete operations.         : 0
    +   Operations : Egress Update       : The number of sent Update operations.             : 0
    +   Operations : Ingress Update      : The number of received Update operations.         : 0
    +   Operations : Egress KillCursors  : The number of sent KillCursors operations.        : 0
    +   Operations : Ingress KillCursors : The number of received KillCursors operations.    : 0
    +   Operations : Egress Msg          : The number of sent Msg operations.                : 0
    +   Operations : Ingress Msg         : The number of received Msg operations.            : 0
    +   Operations : Egress Reply        : The number of sent Reply operations.              : 0
    +   Operations : Ingress Reply       : The number of received Reply operations.          : 13246
    +      Cursors : Active              : The number of active cursors.                     : 1
    +      Cursors : Disposed            : The number of disposed cursors.                   : 13246
    +      Clients : Active              : The number of active clients.                     : 1
    +      Clients : Disposed            : The number of disposed clients.                   : 0
    +      Streams : Active              : The number of active streams.                     : 1
    +      Streams : Disposed            : The number of disposed streams.                   : 0
    +      Streams : Egress Bytes        : The number of bytes sent.                         : 794931
    +      Streams : Ingress Bytes       : The number of bytes received.                     : 589694
    +      Streams : N Socket Timeouts   : The number of socket timeouts.                    : 0
    + Client Pools : Active              : The number of active client pools.                : 1
    + Client Pools : Disposed            : The number of disposed client pools.              : 0
    +     Protocol : Ingress Errors      : The number of protocol errors on ingress.         : 0
    +         Auth : Failures            : The number of failed authentication requests.     : 0
    +         Auth : Success             : The number of successful authentication requests. : 0
    +
    +
    +
    +
    +

    Submitting a Bug Report

    +

    Think you’ve found a bug? Want to see a new feature in the MongoDB C driver? Please open a case in our issue management tool, JIRA:

    + +

    Bug reports in JIRA for all driver projects (i.e. CDRIVER, CSHARP, JAVA) and the Core Server (i.e. SERVER) project are public.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/bulk.html b/libmongoc/1.24.0/bulk.html new file mode 100644 index 0000000000000000000000000000000000000000..fd6308df8f1336e4fa51970e1480011186912643 --- /dev/null +++ b/libmongoc/1.24.0/bulk.html @@ -0,0 +1,992 @@ + + + + + + + + + + + + + + Bulk Write Operations — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Bulk Write Operations

    +

    This tutorial explains how to take advantage of MongoDB C driver bulk write operation features. Executing write operations in batches reduces the number of network round trips, increasing write throughput.

    +
    +

    Bulk Insert

    +

    First we need to fetch a bulk operation handle from the mongoc_collection_t.

    +
    mongoc_bulk_operation_t *bulk =
    +   mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +
    +

    We can now start inserting documents to the bulk operation. These will be buffered until we execute the operation.

    +

    The bulk operation will coalesce insertions as a single batch for each consecutive call to mongoc_bulk_operation_insert(). This creates a pipelined effect when possible.

    +

    To execute the bulk operation and receive the result we call mongoc_bulk_operation_execute().

    +
    +
    bulk1.c
    +
    #include <assert.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk1 (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *doc;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +   int i;
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +   for (i = 0; i < 10000; i++) {
    +      doc = BCON_NEW ("i", BCON_INT32 (i));
    +      mongoc_bulk_operation_insert (bulk, doc);
    +      bson_destroy (doc);
    +   }
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      fprintf (stderr, "Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk1-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   bulk1 (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Example reply document:

    +
    {"nInserted"   : 10000,
    + "nMatched"    : 0,
    + "nModified"   : 0,
    + "nRemoved"    : 0,
    + "nUpserted"   : 0,
    + "writeErrors" : []
    + "writeConcernErrors" : [] }
    +
    +
    +
    +
    +

    Mixed Bulk Write Operations

    +

    MongoDB C driver also supports executing mixed bulk write operations. A batch of insert, update, and remove operations can be executed together using the bulk write operations API.

    +
    +
    +

    Ordered Bulk Write Operations

    +

    Ordered bulk write operations are batched and sent to the server in the order provided for serial execution. The reply document describes the type and count of operations performed.

    +
    +
    bulk2.c
    +
    #include <assert.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk2 (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *query;
    +   bson_t *doc;
    +   bson_t *opts;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +   int i;
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +   /* Remove everything */
    +   query = bson_new ();
    +   mongoc_bulk_operation_remove (bulk, query);
    +   bson_destroy (query);
    +
    +   /* Add a few documents */
    +   for (i = 1; i < 4; i++) {
    +      doc = BCON_NEW ("_id", BCON_INT32 (i));
    +      mongoc_bulk_operation_insert (bulk, doc);
    +      bson_destroy (doc);
    +   }
    +
    +   /* {_id: 1} => {$set: {foo: "bar"}} */
    +   query = BCON_NEW ("_id", BCON_INT32 (1));
    +   doc = BCON_NEW ("$set", "{", "foo", BCON_UTF8 ("bar"), "}");
    +   mongoc_bulk_operation_update_many_with_opts (bulk, query, doc, NULL, &error);
    +   bson_destroy (query);
    +   bson_destroy (doc);
    +
    +   /* {_id: 4} => {'$inc': {'j': 1}} (upsert) */
    +   opts = BCON_NEW ("upsert", BCON_BOOL (true));
    +   query = BCON_NEW ("_id", BCON_INT32 (4));
    +   doc = BCON_NEW ("$inc", "{", "j", BCON_INT32 (1), "}");
    +   mongoc_bulk_operation_update_many_with_opts (bulk, query, doc, opts, &error);
    +   bson_destroy (query);
    +   bson_destroy (doc);
    +   bson_destroy (opts);
    +
    +   /* replace {j:1} with {j:2} */
    +   query = BCON_NEW ("j", BCON_INT32 (1));
    +   doc = BCON_NEW ("j", BCON_INT32 (2));
    +   mongoc_bulk_operation_replace_one_with_opts (bulk, query, doc, NULL, &error);
    +   bson_destroy (query);
    +   bson_destroy (doc);
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk2-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   bulk2 (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Example reply document:

    +
    { "nInserted"   : 3,
    +  "nMatched"    : 2,
    +  "nModified"   : 2,
    +  "nRemoved"    : 10000,
    +  "nUpserted"   : 1,
    +  "upserted"    : [{"index" : 5, "_id" : 4}],
    +  "writeErrors" : []
    +  "writeConcernErrors" : [] }
    +
    +
    +

    The index field in the upserted array is the 0-based index of the upsert operation; in this example, the sixth operation of the overall bulk operation was an upsert, so its index is 5.

    +
    +
    +

    Unordered Bulk Write Operations

    +

    Unordered bulk write operations are batched and sent to the server in arbitrary order where they may be executed in parallel. Any errors that occur are reported after all operations are attempted.

    +

    In the next example the first and third operations fail due to the unique constraint on _id. Since we are doing unordered execution the second and fourth operations succeed.

    +
    +
    bulk3.c
    +
    #include <assert.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk3 (mongoc_collection_t *collection)
    +{
    +   bson_t opts = BSON_INITIALIZER;
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *query;
    +   bson_t *doc;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +
    +   /* false indicates unordered */
    +   BSON_APPEND_BOOL (&opts, "ordered", false);
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, &opts);
    +   bson_destroy (&opts);
    +
    +   /* Add a document */
    +   doc = BCON_NEW ("_id", BCON_INT32 (1));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   /* remove {_id: 2} */
    +   query = BCON_NEW ("_id", BCON_INT32 (2));
    +   mongoc_bulk_operation_remove_one (bulk, query);
    +   bson_destroy (query);
    +
    +   /* insert {_id: 3} */
    +   doc = BCON_NEW ("_id", BCON_INT32 (3));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   /* replace {_id:4} {'i': 1} */
    +   query = BCON_NEW ("_id", BCON_INT32 (4));
    +   doc = BCON_NEW ("i", BCON_INT32 (1));
    +   mongoc_bulk_operation_replace_one (bulk, query, doc, false);
    +   bson_destroy (query);
    +   bson_destroy (doc);
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +   bson_destroy (&opts);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk3-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   bulk3 (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Example reply document:

    +
    { "nInserted"    : 0,
    +  "nMatched"     : 1,
    +  "nModified"    : 1,
    +  "nRemoved"     : 1,
    +  "nUpserted"    : 0,
    +  "writeErrors"  : [
    +    { "index"  : 0,
    +      "code"   : 11000,
    +      "errmsg" : "E11000 duplicate key error index: test.test.$_id_ dup key: { : 1 }" },
    +    { "index"  : 2,
    +      "code"   : 11000,
    +      "errmsg" : "E11000 duplicate key error index: test.test.$_id_ dup key: { : 3 }" } ],
    +  "writeConcernErrors" : [] }
    +
    +Error: E11000 duplicate key error index: test.test.$_id_ dup key: { : 1 }
    +
    +
    +

    The bson_error_t domain is MONGOC_ERROR_COMMAND and its code is 11000.

    +
    +
    +

    Bulk Operation Bypassing Document Validation

    +

    This feature is only available when using MongoDB 3.2 and later.

    +

    By default bulk operations are validated against the schema, if any is defined. In certain cases however it may be necessary to bypass the document validation.

    +
    +
    bulk5.c
    +
    #include <assert.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk5_fail (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *doc;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +   /* Two inserts */
    +   doc = BCON_NEW ("_id", BCON_INT32 (31));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   doc = BCON_NEW ("_id", BCON_INT32 (32));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   /* The above documents do not comply to the schema validation rules
    +    * we created previously, so this will result in an error */
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +}
    +
    +static void
    +bulk5_success (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *doc;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +   /* Allow this document to bypass document validation.
    +    * NOTE: When authentication is enabled, the authenticated user must have
    +    * either the "dbadmin" or "restore" roles to bypass document validation */
    +   mongoc_bulk_operation_set_bypass_document_validation (bulk, true);
    +
    +   /* Two inserts */
    +   doc = BCON_NEW ("_id", BCON_INT32 (31));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   doc = BCON_NEW ("_id", BCON_INT32 (32));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +}
    +
    +int
    +main (void)
    +{
    +   bson_t *options;
    +   bson_error_t error;
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   mongoc_database_t *database;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk5-example";
    +   mongoc_uri_t *uri;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   database = mongoc_client_get_database (client, "testasdf");
    +
    +   /* Create schema validator */
    +   options = BCON_NEW (
    +      "validator", "{", "number", "{", "$gte", BCON_INT32 (5), "}", "}");
    +   collection =
    +      mongoc_database_create_collection (database, "collname", options, &error);
    +
    +   if (collection) {
    +      bulk5_fail (collection);
    +      bulk5_success (collection);
    +      mongoc_collection_destroy (collection);
    +   } else {
    +      fprintf (stderr, "Couldn't create collection: '%s'\n", error.message);
    +   }
    +
    +   bson_free (options);
    +   mongoc_uri_destroy (uri);
    +   mongoc_database_destroy (database);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Running the above example will result in:

    +
    { "nInserted" : 0,
    +  "nMatched" : 0,
    +  "nModified" : 0,
    +  "nRemoved" : 0,
    +  "nUpserted" : 0,
    +  "writeErrors" : [
    +    { "index" : 0,
    +      "code" : 121,
    +      "errmsg" : "Document failed validation" } ] }
    +
    +Error: Document failed validation
    +
    +{ "nInserted" : 2,
    +  "nMatched" : 0,
    +  "nModified" : 0,
    +  "nRemoved" : 0,
    +  "nUpserted" : 0,
    +  "writeErrors" : [] }
    +
    +
    +

    The bson_error_t domain is MONGOC_ERROR_COMMAND.

    +
    +
    +

    Bulk Operation Write Concerns

    +

    By default bulk operations are executed with the write_concern of the collection they are executed against. A custom write concern can be passed to the mongoc_collection_create_bulk_operation_with_opts() method. Write concern errors (e.g. wtimeout) will be reported after all operations are attempted, regardless of execution order.

    +
    +
    bulk4.c
    +
    #include <assert.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk4 (mongoc_collection_t *collection)
    +{
    +   bson_t opts = BSON_INITIALIZER;
    +   mongoc_write_concern_t *wc;
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *doc;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +
    +   wc = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_w (wc, 4);
    +   mongoc_write_concern_set_wtimeout_int64 (wc, 100); /* milliseconds */
    +   mongoc_write_concern_append (wc, &opts);
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, &opts);
    +
    +   /* Two inserts */
    +   doc = BCON_NEW ("_id", BCON_INT32 (10));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   doc = BCON_NEW ("_id", BCON_INT32 (11));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +   mongoc_write_concern_destroy (wc);
    +   bson_destroy (&opts);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk4-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   bulk4 (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Example reply document and error message:

    +
    { "nInserted"    : 2,
    +  "nMatched"     : 0,
    +  "nModified"    : 0,
    +  "nRemoved"     : 0,
    +  "nUpserted"    : 0,
    +  "writeErrors"  : [],
    +  "writeConcernErrors" : [
    +    { "code"   : 64,
    +      "errmsg" : "waiting for replication timed out" }
    +] }
    +
    +Error: waiting for replication timed out
    +
    +
    +

    The bson_error_t domain is MONGOC_ERROR_WRITE_CONCERN if there are write concern errors and no write errors. Write errors indicate failed operations, so they take precedence over write concern errors, which mean merely that the write concern is not satisfied yet.

    +
    +
    +

    Setting Collation Order

    +

    This feature is only available when using MongoDB 3.4 and later.

    +
    +
    bulk-collation.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk_collation (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   bson_t *opts;
    +   bson_t *doc;
    +   bson_t *selector;
    +   bson_t *update;
    +   bson_error_t error;
    +   bson_t reply;
    +   char *str;
    +   uint32_t ret;
    +
    +   /* insert {_id: "one"} and {_id: "One"} */
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +   doc = BCON_NEW ("_id", BCON_UTF8 ("one"));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   doc = BCON_NEW ("_id", BCON_UTF8 ("One"));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   /* "One" normally sorts before "one"; make "one" come first */
    +   opts = BCON_NEW ("collation",
    +                    "{",
    +                    "locale",
    +                    BCON_UTF8 ("en_US"),
    +                    "caseFirst",
    +                    BCON_UTF8 ("lower"),
    +                    "}");
    +
    +   /* set x=1 on the document with _id "One", which now sorts after "one" */
    +   update = BCON_NEW ("$set", "{", "x", BCON_INT64 (1), "}");
    +   selector = BCON_NEW ("_id", "{", "$gt", BCON_UTF8 ("one"), "}");
    +   mongoc_bulk_operation_update_one_with_opts (
    +      bulk, selector, update, opts, &error);
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (selector);
    +   bson_destroy (opts);
    +   mongoc_bulk_operation_destroy (bulk);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk-collation";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "db", "collection");
    +   bulk_collation (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Running the above example will result in:

    +
    { "nInserted" : 2,
    +   "nMatched" : 1,
    +   "nModified" : 1,
    +   "nRemoved" : 0,
    +   "nUpserted" : 0,
    +   "writeErrors" : [  ]
    +}
    +
    +
    +
    +
    +

    Unacknowledged Bulk Writes

    +

    Set “w” to zero for an unacknowledged write. The driver sends unacknowledged writes using the legacy opcodes OP_INSERT, OP_UPDATE, and OP_DELETE.

    +
    +
    bulk6.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +bulk6 (mongoc_collection_t *collection)
    +{
    +   bson_t opts = BSON_INITIALIZER;
    +   mongoc_write_concern_t *wc;
    +   mongoc_bulk_operation_t *bulk;
    +   bson_error_t error;
    +   bson_t *doc;
    +   bson_t *selector;
    +   bson_t reply;
    +   char *str;
    +   bool ret;
    +
    +   wc = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_w (wc, 0);
    +   mongoc_write_concern_append (wc, &opts);
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, &opts);
    +
    +   doc = BCON_NEW ("_id", BCON_INT32 (10));
    +   mongoc_bulk_operation_insert (bulk, doc);
    +   bson_destroy (doc);
    +
    +   selector = BCON_NEW ("_id", BCON_INT32 (11));
    +   mongoc_bulk_operation_remove_one (bulk, selector);
    +   bson_destroy (selector);
    +
    +   ret = mongoc_bulk_operation_execute (bulk, &reply, &error);
    +
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   if (!ret) {
    +      printf ("Error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   mongoc_bulk_operation_destroy (bulk);
    +   mongoc_write_concern_destroy (wc);
    +   bson_destroy (&opts);
    +}
    +
    +int
    +main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   const char *uri_string = "mongodb://localhost/?appname=bulk6-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   bulk6 (collection);
    +
    +   mongoc_uri_destroy (uri);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    The reply document is empty:

    +
    { }
    +
    +
    +
    +
    +

    Further Reading

    +

    See the Driver Bulk API Spec, which describes bulk write operations for all MongoDB drivers.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/client-side-field-level-encryption.html b/libmongoc/1.24.0/client-side-field-level-encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..5bcbcef37da0eefd1680e105dae5e6bea21b42f5 --- /dev/null +++ b/libmongoc/1.24.0/client-side-field-level-encryption.html @@ -0,0 +1,1194 @@ + + + + + + + + + + + + + + Client-Side Field Level Encryption — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Client-Side Field Level Encryption

    +

    New in MongoDB 4.2, Client-Side Field Level Encryption (also referred to as CSFLE) allows administrators and developers to encrypt specific data fields in addition to other MongoDB encryption features.

    +

    With CSFLE, developers can encrypt fields client side without any server-side configuration or directives. CSFLE supports workloads where applications must guarantee that unauthorized parties, including server administrators, cannot read the encrypted data.

    +

    Automatic encryption, where sensitive fields in commands are encrypted automatically, requires an Enterprise-only dependency for Query Analysis. See In-Use Encryption for more information.

    +
    +

    See also

    +
    +
    The MongoDB Manual for Client-Side Field Level Encryption
    +
    +
    +
    +

    Automatic Client-Side Field Level Encryption

    +

    Automatic encryption is enabled by calling mongoc_client_enable_auto_encryption() on a mongoc_client_t. The following examples show how to set up automatic encryption using mongoc_client_encryption_t to create a new encryption data key.

    +
    +

    Note

    +

    Automatic encryption requires MongoDB 4.2 enterprise or a MongoDB 4.2 Atlas cluster. The community version of the server supports automatic decryption as well as Explicit Encryption.

    +
    +
    +

    Providing Local Automatic Encryption Rules

    +

    The following example shows how to specify automatic encryption rules using a schema map set with mongoc_auto_encryption_opts_set_schema_map(). The automatic encryption rules are expressed using a strict subset of the JSON Schema syntax.

    +

    Supplying a schema map provides more security than relying on JSON Schemas obtained from the server. It protects against a malicious server advertising a false JSON Schema, which could trick the client into sending unencrypted data that should be encrypted.

    +

    JSON Schemas supplied in the schema map only apply to configuring automatic encryption. Other validation rules in the JSON schema will not be enforced by the driver and will result in an error:

    +
    +
    client-side-encryption-schema-map.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +#include "client-side-encryption-helpers.h"
    +
    +/* Helper method to create a new data key in the key vault, a schema to use that
    + * key, and writes the schema to a file for later use. */
    +static bool
    +create_schema_file (bson_t *kms_providers,
    +                    const char *keyvault_db,
    +                    const char *keyvault_coll,
    +                    mongoc_client_t *keyvault_client,
    +                    bson_error_t *error)
    +{
    +   mongoc_client_encryption_t *client_encryption = NULL;
    +   mongoc_client_encryption_opts_t *client_encryption_opts = NULL;
    +   mongoc_client_encryption_datakey_opts_t *datakey_opts = NULL;
    +   bson_value_t datakey_id = {0};
    +   char *keyaltnames[] = {"mongoc_encryption_example_1"};
    +   bson_t *schema = NULL;
    +   char *schema_string = NULL;
    +   size_t schema_string_len;
    +   FILE *outfile = NULL;
    +   bool ret = false;
    +
    +   client_encryption_opts = mongoc_client_encryption_opts_new ();
    +   mongoc_client_encryption_opts_set_kms_providers (client_encryption_opts,
    +                                                    kms_providers);
    +   mongoc_client_encryption_opts_set_keyvault_namespace (
    +      client_encryption_opts, keyvault_db, keyvault_coll);
    +   mongoc_client_encryption_opts_set_keyvault_client (client_encryption_opts,
    +                                                      keyvault_client);
    +
    +   client_encryption =
    +      mongoc_client_encryption_new (client_encryption_opts, error);
    +   if (!client_encryption) {
    +      goto fail;
    +   }
    +
    +   /* Create a new data key and json schema for the encryptedField.
    +    * https://dochub.mongodb.org/core/client-side-field-level-encryption-automatic-encryption-rules
    +    */
    +   datakey_opts = mongoc_client_encryption_datakey_opts_new ();
    +   mongoc_client_encryption_datakey_opts_set_keyaltnames (
    +      datakey_opts, keyaltnames, 1);
    +   if (!mongoc_client_encryption_create_datakey (
    +          client_encryption, "local", datakey_opts, &datakey_id, error)) {
    +      goto fail;
    +   }
    +
    +   /* Create a schema describing that "encryptedField" is a string encrypted
    +    * with the newly created data key using deterministic encryption. */
    +   schema = BCON_NEW ("properties",
    +                      "{",
    +                      "encryptedField",
    +                      "{",
    +                      "encrypt",
    +                      "{",
    +                      "keyId",
    +                      "[",
    +                      BCON_BIN (datakey_id.value.v_binary.subtype,
    +                                datakey_id.value.v_binary.data,
    +                                datakey_id.value.v_binary.data_len),
    +                      "]",
    +                      "bsonType",
    +                      "string",
    +                      "algorithm",
    +                      MONGOC_AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC,
    +                      "}",
    +                      "}",
    +                      "}",
    +                      "bsonType",
    +                      "object");
    +
    +   /* Use canonical JSON so that other drivers and tools will be
    +    * able to parse the MongoDB extended JSON file. */
    +   schema_string = bson_as_canonical_extended_json (schema, &schema_string_len);
    +   outfile = fopen ("jsonSchema.json", "w");
    +   if (0 == fwrite (schema_string, sizeof (char), schema_string_len, outfile)) {
    +      fprintf (stderr, "failed to write to file\n");
    +      goto fail;
    +   }
    +
    +   ret = true;
    +fail:
    +   mongoc_client_encryption_destroy (client_encryption);
    +   mongoc_client_encryption_datakey_opts_destroy (datakey_opts);
    +   mongoc_client_encryption_opts_destroy (client_encryption_opts);
    +   bson_free (schema_string);
    +   bson_destroy (schema);
    +   bson_value_destroy (&datakey_id);
    +   if (outfile) {
    +      fclose (outfile);
    +   }
    +   return ret;
    +}
    +
    +/* This example demonstrates how to use automatic encryption with a client-side
    + * schema map using the enterprise version of MongoDB */
    +int
    +main (void)
    +{
    +/* The collection used to store the encryption data keys. */
    +#define KEYVAULT_DB "encryption"
    +#define KEYVAULT_COLL "__libmongocTestKeyVault"
    +/* The collection used to store the encrypted documents in this example. */
    +#define ENCRYPTED_DB "test"
    +#define ENCRYPTED_COLL "coll"
    +
    +   int exit_status = EXIT_FAILURE;
    +   bool ret;
    +   uint8_t *local_masterkey = NULL;
    +   uint32_t local_masterkey_len;
    +   bson_t *kms_providers = NULL;
    +   bson_error_t error = {0};
    +   bson_t *index_keys = NULL;
    +   bson_t *index_opts = NULL;
    +   mongoc_index_model_t *index_model = NULL;
    +   bson_json_reader_t *reader = NULL;
    +   bson_t schema = BSON_INITIALIZER;
    +   bson_t *schema_map = NULL;
    +
    +   /* The MongoClient used to access the key vault (keyvault_namespace). */
    +   mongoc_client_t *keyvault_client = NULL;
    +   mongoc_collection_t *keyvault_coll = NULL;
    +   mongoc_auto_encryption_opts_t *auto_encryption_opts = NULL;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *coll = NULL;
    +   bson_t *to_insert = NULL;
    +   mongoc_client_t *unencrypted_client = NULL;
    +   mongoc_collection_t *unencrypted_coll = NULL;
    +
    +   mongoc_init ();
    +
    +   /* Configure the master key. This must be the same master key that was used
    +    * to create the encryption key. */
    +   local_masterkey =
    +      hex_to_bin (getenv ("LOCAL_MASTERKEY"), &local_masterkey_len);
    +   if (!local_masterkey || local_masterkey_len != 96) {
    +      fprintf (stderr,
    +               "Specify LOCAL_MASTERKEY environment variable as a "
    +               "secure random 96 byte hex value.\n");
    +      goto fail;
    +   }
    +
    +   kms_providers = BCON_NEW ("local",
    +                             "{",
    +                             "key",
    +                             BCON_BIN (0, local_masterkey, local_masterkey_len),
    +                             "}");
    +
    +   /* Set up the key vault for this example. */
    +   keyvault_client = mongoc_client_new (
    +      "mongodb://localhost/?appname=client-side-encryption-keyvault");
    +   BSON_ASSERT (keyvault_client);
    +
    +   keyvault_coll = mongoc_client_get_collection (
    +      keyvault_client, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_collection_drop (keyvault_coll, NULL);
    +
    +   /* Create a unique index to ensure that two data keys cannot share the same
    +    * keyAltName. This is recommended practice for the key vault. */
    +   index_keys = BCON_NEW ("keyAltNames", BCON_INT32 (1));
    +   index_opts = BCON_NEW ("unique",
    +                          BCON_BOOL (true),
    +                          "partialFilterExpression",
    +                          "{",
    +                          "keyAltNames",
    +                          "{",
    +                          "$exists",
    +                          BCON_BOOL (true),
    +                          "}",
    +                          "}");
    +   index_model = mongoc_index_model_new (index_keys, index_opts);
    +   ret = mongoc_collection_create_indexes_with_opts (keyvault_coll,
    +                                                     &index_model,
    +                                                     1,
    +                                                     NULL /* opts */,
    +                                                     NULL /* reply */,
    +                                                     &error);
    +
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   /* Create a new data key and a schema using it for encryption. Save the
    +    * schema to the file jsonSchema.json */
    +   ret = create_schema_file (
    +      kms_providers, KEYVAULT_DB, KEYVAULT_COLL, keyvault_client, &error);
    +
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   /* Load the JSON Schema and construct the local schema_map option. */
    +   reader = bson_json_reader_new_from_file ("jsonSchema.json", &error);
    +   if (!reader) {
    +      goto fail;
    +   }
    +
    +   bson_json_reader_read (reader, &schema, &error);
    +
    +   /* Construct the schema map, mapping the namespace of the collection to the
    +    * schema describing encryption. */
    +   schema_map =
    +      BCON_NEW (ENCRYPTED_DB "." ENCRYPTED_COLL, BCON_DOCUMENT (&schema));
    +
    +   auto_encryption_opts = mongoc_auto_encryption_opts_new ();
    +   mongoc_auto_encryption_opts_set_keyvault_client (auto_encryption_opts,
    +                                                    keyvault_client);
    +   mongoc_auto_encryption_opts_set_keyvault_namespace (
    +      auto_encryption_opts, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_auto_encryption_opts_set_kms_providers (auto_encryption_opts,
    +                                                  kms_providers);
    +   mongoc_auto_encryption_opts_set_schema_map (auto_encryption_opts,
    +                                               schema_map);
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost/?appname=client-side-encryption");
    +   BSON_ASSERT (client);
    +
    +   /* Enable automatic encryption. It will determine that encryption is
    +    * necessary from the schema map instead of relying on the server to provide
    +    * a schema. */
    +   ret = mongoc_client_enable_auto_encryption (
    +      client, auto_encryption_opts, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   coll = mongoc_client_get_collection (client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +
    +   /* Clear old data */
    +   mongoc_collection_drop (coll, NULL);
    +
    +   to_insert = BCON_NEW ("encryptedField", "123456789");
    +   ret = mongoc_collection_insert_one (
    +      coll, to_insert, NULL /* opts */, NULL /* reply */, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +   printf ("decrypted document: ");
    +   if (!print_one_document (coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   unencrypted_client = mongoc_client_new (
    +      "mongodb://localhost/?appname=client-side-encryption-unencrypted");
    +   BSON_ASSERT (unencrypted_client);
    +
    +   unencrypted_coll = mongoc_client_get_collection (
    +      unencrypted_client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +   printf ("encrypted document: ");
    +   if (!print_one_document (unencrypted_coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   exit_status = EXIT_SUCCESS;
    +fail:
    +   if (error.code) {
    +      fprintf (stderr, "error: %s\n", error.message);
    +   }
    +
    +   bson_free (local_masterkey);
    +   bson_destroy (kms_providers);
    +   mongoc_collection_destroy (keyvault_coll);
    +   mongoc_index_model_destroy (index_model);
    +   bson_destroy (index_opts);
    +   bson_destroy (index_keys);
    +   bson_json_reader_destroy (reader);
    +   mongoc_auto_encryption_opts_destroy (auto_encryption_opts);
    +   mongoc_collection_destroy (coll);
    +   mongoc_client_destroy (client);
    +   bson_destroy (to_insert);
    +   mongoc_collection_destroy (unencrypted_coll);
    +   mongoc_client_destroy (unencrypted_client);
    +   mongoc_client_destroy (keyvault_client);
    +   bson_destroy (&schema);
    +   bson_destroy (schema_map);
    +   mongoc_cleanup ();
    +   return exit_status;
    +}
    +
    +
    +
    +
    +
    +

    Server-Side Field Level Encryption Enforcement

    +

    The MongoDB 4.2 server supports using schema validation to enforce encryption of specific fields in a collection. This schema validation will prevent an application from inserting unencrypted values for any fields marked with the “encrypt” JSON schema keyword.

    +

    The following example shows how to set up automatic encryption using mongoc_client_encryption_t to create a new encryption data key and create a collection with the necessary JSON Schema:

    +
    +
    client-side-encryption-server-schema.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +#include "client-side-encryption-helpers.h"
    +
    +/* Helper method to create and return a JSON schema to use for encryption.
    +The caller will use the returned schema for server-side encryption validation.
    +*/
    +static bson_t *
    +create_schema (bson_t *kms_providers,
    +               const char *keyvault_db,
    +               const char *keyvault_coll,
    +               mongoc_client_t *keyvault_client,
    +               bson_error_t *error)
    +{
    +   mongoc_client_encryption_t *client_encryption = NULL;
    +   mongoc_client_encryption_opts_t *client_encryption_opts = NULL;
    +   mongoc_client_encryption_datakey_opts_t *datakey_opts = NULL;
    +   bson_value_t datakey_id = {0};
    +   char *keyaltnames[] = {"mongoc_encryption_example_2"};
    +   bson_t *schema = NULL;
    +
    +   client_encryption_opts = mongoc_client_encryption_opts_new ();
    +   mongoc_client_encryption_opts_set_kms_providers (client_encryption_opts,
    +                                                    kms_providers);
    +   mongoc_client_encryption_opts_set_keyvault_namespace (
    +      client_encryption_opts, keyvault_db, keyvault_coll);
    +   mongoc_client_encryption_opts_set_keyvault_client (client_encryption_opts,
    +                                                      keyvault_client);
    +
    +   client_encryption =
    +      mongoc_client_encryption_new (client_encryption_opts, error);
    +   if (!client_encryption) {
    +      goto fail;
    +   }
    +
    +   /* Create a new data key and json schema for the encryptedField.
    +    * https://dochub.mongodb.org/core/client-side-field-level-encryption-automatic-encryption-rules
    +    */
    +   datakey_opts = mongoc_client_encryption_datakey_opts_new ();
    +   mongoc_client_encryption_datakey_opts_set_keyaltnames (
    +      datakey_opts, keyaltnames, 1);
    +   if (!mongoc_client_encryption_create_datakey (
    +          client_encryption, "local", datakey_opts, &datakey_id, error)) {
    +      goto fail;
    +   }
    +
    +   /* Create a schema describing that "encryptedField" is a string encrypted
    +    * with the newly created data key using deterministic encryption. */
    +   schema = BCON_NEW ("properties",
    +                      "{",
    +                      "encryptedField",
    +                      "{",
    +                      "encrypt",
    +                      "{",
    +                      "keyId",
    +                      "[",
    +                      BCON_BIN (datakey_id.value.v_binary.subtype,
    +                                datakey_id.value.v_binary.data,
    +                                datakey_id.value.v_binary.data_len),
    +                      "]",
    +                      "bsonType",
    +                      "string",
    +                      "algorithm",
    +                      MONGOC_AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC,
    +                      "}",
    +                      "}",
    +                      "}",
    +                      "bsonType",
    +                      "object");
    +
    +fail:
    +   mongoc_client_encryption_destroy (client_encryption);
    +   mongoc_client_encryption_datakey_opts_destroy (datakey_opts);
    +   mongoc_client_encryption_opts_destroy (client_encryption_opts);
    +   bson_value_destroy (&datakey_id);
    +   return schema;
    +}
    +
    +/* This example demonstrates how to use automatic encryption with a server-side
    + * schema using the enterprise version of MongoDB */
    +int
    +main (void)
    +{
    +/* The collection used to store the encryption data keys. */
    +#define KEYVAULT_DB "encryption"
    +#define KEYVAULT_COLL "__libmongocTestKeyVault"
    +/* The collection used to store the encrypted documents in this example. */
    +#define ENCRYPTED_DB "test"
    +#define ENCRYPTED_COLL "coll"
    +
    +   int exit_status = EXIT_FAILURE;
    +   bool ret;
    +   uint8_t *local_masterkey = NULL;
    +   uint32_t local_masterkey_len;
    +   bson_t *kms_providers = NULL;
    +   bson_error_t error = {0};
    +   bson_t *index_keys = NULL;
    +   bson_t *index_opts = NULL;
    +   mongoc_index_model_t *index_model = NULL;
    +   bson_json_reader_t *reader = NULL;
    +   bson_t *schema = NULL;
    +
    +   /* The MongoClient used to access the key vault (keyvault_namespace). */
    +   mongoc_client_t *keyvault_client = NULL;
    +   mongoc_collection_t *keyvault_coll = NULL;
    +   mongoc_auto_encryption_opts_t *auto_encryption_opts = NULL;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *coll = NULL;
    +   bson_t *to_insert = NULL;
    +   mongoc_client_t *unencrypted_client = NULL;
    +   mongoc_collection_t *unencrypted_coll = NULL;
    +   bson_t *create_cmd = NULL;
    +   bson_t *create_cmd_opts = NULL;
    +   mongoc_write_concern_t *wc = NULL;
    +
    +   mongoc_init ();
    +
    +   /* Configure the master key. This must be the same master key that was used
    +    * to create
    +    * the encryption key. */
    +   local_masterkey =
    +      hex_to_bin (getenv ("LOCAL_MASTERKEY"), &local_masterkey_len);
    +   if (!local_masterkey || local_masterkey_len != 96) {
    +      fprintf (stderr,
    +               "Specify LOCAL_MASTERKEY environment variable as a "
    +               "secure random 96 byte hex value.\n");
    +      goto fail;
    +   }
    +
    +   kms_providers = BCON_NEW ("local",
    +                             "{",
    +                             "key",
    +                             BCON_BIN (0, local_masterkey, local_masterkey_len),
    +                             "}");
    +
    +   /* Set up the key vault for this example. */
    +   keyvault_client = mongoc_client_new (
    +      "mongodb://localhost/?appname=client-side-encryption-keyvault");
    +   BSON_ASSERT (keyvault_client);
    +
    +   keyvault_coll = mongoc_client_get_collection (
    +      keyvault_client, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_collection_drop (keyvault_coll, NULL);
    +
    +   /* Create a unique index to ensure that two data keys cannot share the same
    +    * keyAltName. This is recommended practice for the key vault. */
    +   index_keys = BCON_NEW ("keyAltNames", BCON_INT32 (1));
    +   index_opts = BCON_NEW ("unique",
    +                          BCON_BOOL (true),
    +                          "partialFilterExpression",
    +                          "{",
    +                          "keyAltNames",
    +                          "{",
    +                          "$exists",
    +                          BCON_BOOL (true),
    +                          "}",
    +                          "}");
    +   index_model = mongoc_index_model_new (index_keys, index_opts);
    +   ret = mongoc_collection_create_indexes_with_opts (keyvault_coll,
    +                                                     &index_model,
    +                                                     1,
    +                                                     NULL /* opts */,
    +                                                     NULL /* reply */,
    +                                                     &error);
    +
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   auto_encryption_opts = mongoc_auto_encryption_opts_new ();
    +   mongoc_auto_encryption_opts_set_keyvault_client (auto_encryption_opts,
    +                                                    keyvault_client);
    +   mongoc_auto_encryption_opts_set_keyvault_namespace (
    +      auto_encryption_opts, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_auto_encryption_opts_set_kms_providers (auto_encryption_opts,
    +                                                  kms_providers);
    +   schema = create_schema (
    +      kms_providers, KEYVAULT_DB, KEYVAULT_COLL, keyvault_client, &error);
    +
    +   if (!schema) {
    +      goto fail;
    +   }
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost/?appname=client-side-encryption");
    +   BSON_ASSERT (client);
    +
    +   ret = mongoc_client_enable_auto_encryption (
    +      client, auto_encryption_opts, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   coll = mongoc_client_get_collection (client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +
    +   /* Clear old data */
    +   mongoc_collection_drop (coll, NULL);
    +
    +   /* Create the collection with the encryption JSON Schema. */
    +   create_cmd = BCON_NEW ("create",
    +                          ENCRYPTED_COLL,
    +                          "validator",
    +                          "{",
    +                          "$jsonSchema",
    +                          BCON_DOCUMENT (schema),
    +                          "}");
    +   wc = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_wmajority (wc, 0);
    +   create_cmd_opts = bson_new ();
    +   mongoc_write_concern_append (wc, create_cmd_opts);
    +   ret = mongoc_client_command_with_opts (client,
    +                                          ENCRYPTED_DB,
    +                                          create_cmd,
    +                                          NULL /* read prefs */,
    +                                          create_cmd_opts,
    +                                          NULL /* reply */,
    +                                          &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   to_insert = BCON_NEW ("encryptedField", "123456789");
    +   ret = mongoc_collection_insert_one (
    +      coll, to_insert, NULL /* opts */, NULL /* reply */, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +   printf ("decrypted document: ");
    +   if (!print_one_document (coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   unencrypted_client = mongoc_client_new (
    +      "mongodb://localhost/?appname=client-side-encryption-unencrypted");
    +   BSON_ASSERT (unencrypted_client);
    +
    +   unencrypted_coll = mongoc_client_get_collection (
    +      unencrypted_client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +   printf ("encrypted document: ");
    +   if (!print_one_document (unencrypted_coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   /* Expect a server-side error if inserting with the unencrypted collection.
    +    */
    +   ret = mongoc_collection_insert_one (
    +      unencrypted_coll, to_insert, NULL /* opts */, NULL /* reply */, &error);
    +   if (!ret) {
    +      printf ("insert with unencrypted collection failed: %s\n", error.message);
    +      memset (&error, 0, sizeof (error));
    +   }
    +
    +   exit_status = EXIT_SUCCESS;
    +fail:
    +   if (error.code) {
    +      fprintf (stderr, "error: %s\n", error.message);
    +   }
    +
    +   bson_free (local_masterkey);
    +   bson_destroy (kms_providers);
    +   mongoc_collection_destroy (keyvault_coll);
    +   mongoc_index_model_destroy (index_model);
    +   bson_destroy (index_opts);
    +   bson_destroy (index_keys);
    +   bson_json_reader_destroy (reader);
    +   mongoc_auto_encryption_opts_destroy (auto_encryption_opts);
    +   mongoc_collection_destroy (coll);
    +   mongoc_client_destroy (client);
    +   bson_destroy (to_insert);
    +   mongoc_collection_destroy (unencrypted_coll);
    +   mongoc_client_destroy (unencrypted_client);
    +   mongoc_client_destroy (keyvault_client);
    +   bson_destroy (schema);
    +   bson_destroy (create_cmd);
    +   bson_destroy (create_cmd_opts);
    +   mongoc_write_concern_destroy (wc);
    +
    +   mongoc_cleanup ();
    +   return exit_status;
    +}
    +
    +
    +
    +
    +
    +

    Explicit Encryption

    +

    Explicit encryption is a MongoDB community feature and does not use Query Analysis (mongocryptd or crypt_shared). Explicit encryption is provided by the mongoc_client_encryption_t class, for example:

    +
    +
    client-side-encryption-explicit.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +#include "client-side-encryption-helpers.h"
    +
    +/* This example demonstrates how to use explicit encryption and decryption using
    + * the community version of MongoDB */
    +int
    +main (void)
    +{
    +/* The collection used to store the encryption data keys. */
    +#define KEYVAULT_DB "encryption"
    +#define KEYVAULT_COLL "__libmongocTestKeyVault"
    +/* The collection used to store the encrypted documents in this example. */
    +#define ENCRYPTED_DB "test"
    +#define ENCRYPTED_COLL "coll"
    +
    +   int exit_status = EXIT_FAILURE;
    +   bool ret;
    +   uint8_t *local_masterkey = NULL;
    +   uint32_t local_masterkey_len;
    +   bson_t *kms_providers = NULL;
    +   bson_error_t error = {0};
    +   bson_t *index_keys = NULL;
    +   bson_t *index_opts = NULL;
    +   mongoc_index_model_t *index_model = NULL;
    +   bson_t *schema = NULL;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *coll = NULL;
    +   mongoc_collection_t *keyvault_coll = NULL;
    +   bson_t *to_insert = NULL;
    +   bson_t *create_cmd = NULL;
    +   bson_t *create_cmd_opts = NULL;
    +   mongoc_write_concern_t *wc = NULL;
    +   mongoc_client_encryption_t *client_encryption = NULL;
    +   mongoc_client_encryption_opts_t *client_encryption_opts = NULL;
    +   mongoc_client_encryption_datakey_opts_t *datakey_opts = NULL;
    +   char *keyaltnames[] = {"mongoc_encryption_example_3"};
    +   bson_value_t datakey_id = {0};
    +   bson_value_t encrypted_field = {0};
    +   bson_value_t to_encrypt = {0};
    +   mongoc_client_encryption_encrypt_opts_t *encrypt_opts = NULL;
    +   bson_value_t decrypted = {0};
    +
    +   mongoc_init ();
    +
    +   /* Configure the master key. This must be the same master key that was used
    +    * to create the encryption key. */
    +   local_masterkey =
    +      hex_to_bin (getenv ("LOCAL_MASTERKEY"), &local_masterkey_len);
    +   if (!local_masterkey || local_masterkey_len != 96) {
    +      fprintf (stderr,
    +               "Specify LOCAL_MASTERKEY environment variable as a "
    +               "secure random 96 byte hex value.\n");
    +      goto fail;
    +   }
    +
    +   kms_providers = BCON_NEW ("local",
    +                             "{",
    +                             "key",
    +                             BCON_BIN (0, local_masterkey, local_masterkey_len),
    +                             "}");
    +
    +   /* The mongoc_client_t used to read/write application data. */
    +   client =
    +      mongoc_client_new ("mongodb://localhost/?appname=client-side-encryption");
    +   coll = mongoc_client_get_collection (client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +
    +   /* Clear old data */
    +   mongoc_collection_drop (coll, NULL);
    +
    +   /* Set up the key vault for this example. */
    +   keyvault_coll =
    +      mongoc_client_get_collection (client, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_collection_drop (keyvault_coll, NULL);
    +
    +   /* Create a unique index to ensure that two data keys cannot share the same
    +    * keyAltName. This is recommended practice for the key vault. */
    +   index_keys = BCON_NEW ("keyAltNames", BCON_INT32 (1));
    +   index_opts = BCON_NEW ("unique",
    +                          BCON_BOOL (true),
    +                          "partialFilterExpression",
    +                          "{",
    +                          "keyAltNames",
    +                          "{",
    +                          "$exists",
    +                          BCON_BOOL (true),
    +                          "}",
    +                          "}");
    +   index_model = mongoc_index_model_new (index_keys, index_opts);
    +   ret = mongoc_collection_create_indexes_with_opts (keyvault_coll,
    +                                                     &index_model,
    +                                                     1,
    +                                                     NULL /* opts */,
    +                                                     NULL /* reply */,
    +                                                     &error);
    +
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   client_encryption_opts = mongoc_client_encryption_opts_new ();
    +   mongoc_client_encryption_opts_set_kms_providers (client_encryption_opts,
    +                                                    kms_providers);
    +   mongoc_client_encryption_opts_set_keyvault_namespace (
    +      client_encryption_opts, KEYVAULT_DB, KEYVAULT_COLL);
    +
    +   /* Set a mongoc_client_t to use for reading/writing to the key vault. This
    +    * can be the same mongoc_client_t used by the main application. */
    +   mongoc_client_encryption_opts_set_keyvault_client (client_encryption_opts,
    +                                                      client);
    +   client_encryption =
    +      mongoc_client_encryption_new (client_encryption_opts, &error);
    +   if (!client_encryption) {
    +      goto fail;
    +   }
    +
    +   /* Create a new data key for the encryptedField.
    +    * https://dochub.mongodb.org/core/client-side-field-level-encryption-automatic-encryption-rules
    +    */
    +   datakey_opts = mongoc_client_encryption_datakey_opts_new ();
    +   mongoc_client_encryption_datakey_opts_set_keyaltnames (
    +      datakey_opts, keyaltnames, 1);
    +   if (!mongoc_client_encryption_create_datakey (
    +          client_encryption, "local", datakey_opts, &datakey_id, &error)) {
    +      goto fail;
    +   }
    +
    +   /* Explicitly encrypt a field */
    +   encrypt_opts = mongoc_client_encryption_encrypt_opts_new ();
    +   mongoc_client_encryption_encrypt_opts_set_algorithm (
    +      encrypt_opts, MONGOC_AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC);
    +   mongoc_client_encryption_encrypt_opts_set_keyid (encrypt_opts, &datakey_id);
    +   to_encrypt.value_type = BSON_TYPE_UTF8;
    +   to_encrypt.value.v_utf8.str = "123456789";
    +   const size_t len = strlen (to_encrypt.value.v_utf8.str);
    +   BSON_ASSERT (bson_in_range_unsigned (uint32_t, len));
    +   to_encrypt.value.v_utf8.len = (uint32_t) len;
    +
    +   ret = mongoc_client_encryption_encrypt (
    +      client_encryption, &to_encrypt, encrypt_opts, &encrypted_field, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   to_insert = bson_new ();
    +   BSON_APPEND_VALUE (to_insert, "encryptedField", &encrypted_field);
    +   ret = mongoc_collection_insert_one (
    +      coll, to_insert, NULL /* opts */, NULL /* reply */, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   printf ("encrypted document: ");
    +   if (!print_one_document (coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   /* Explicitly decrypt a field */
    +   ret = mongoc_client_encryption_decrypt (
    +      client_encryption, &encrypted_field, &decrypted, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +   printf ("decrypted value: %s\n", decrypted.value.v_utf8.str);
    +
    +   exit_status = EXIT_SUCCESS;
    +fail:
    +   if (error.code) {
    +      fprintf (stderr, "error: %s\n", error.message);
    +   }
    +
    +   bson_free (local_masterkey);
    +   bson_destroy (kms_providers);
    +   mongoc_collection_destroy (keyvault_coll);
    +   mongoc_index_model_destroy (index_model);
    +   bson_destroy (index_opts);
    +   bson_destroy (index_keys);
    +   mongoc_collection_destroy (coll);
    +   mongoc_client_destroy (client);
    +   bson_destroy (to_insert);
    +   bson_destroy (schema);
    +   bson_destroy (create_cmd);
    +   bson_destroy (create_cmd_opts);
    +   mongoc_write_concern_destroy (wc);
    +   mongoc_client_encryption_destroy (client_encryption);
    +   mongoc_client_encryption_datakey_opts_destroy (datakey_opts);
    +   mongoc_client_encryption_opts_destroy (client_encryption_opts);
    +   bson_value_destroy (&encrypted_field);
    +   mongoc_client_encryption_encrypt_opts_destroy (encrypt_opts);
    +   bson_value_destroy (&decrypted);
    +   bson_value_destroy (&datakey_id);
    +
    +   mongoc_cleanup ();
    +   return exit_status;
    +}
    +
    +
    +
    +
    +
    +

    Explicit Encryption with Automatic Decryption

    +

    Although automatic encryption requires MongoDB 4.2 enterprise or a MongoDB 4.2 Atlas cluster, automatic decryption is supported for all users. To configure automatic decryption without automatic encryption set bypass_auto_encryption=True in mongoc_auto_encryption_opts_t:

    +
    +
    client-side-encryption-auto-decryption.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +#include "client-side-encryption-helpers.h"
    +
    +/* This example demonstrates how to set up automatic decryption without
    + * automatic encryption using the community version of MongoDB */
    +int
    +main (void)
    +{
    +/* The collection used to store the encryption data keys. */
    +#define KEYVAULT_DB "encryption"
    +#define KEYVAULT_COLL "__libmongocTestKeyVault"
    +/* The collection used to store the encrypted documents in this example. */
    +#define ENCRYPTED_DB "test"
    +#define ENCRYPTED_COLL "coll"
    +
    +   int exit_status = EXIT_FAILURE;
    +   bool ret;
    +   uint8_t *local_masterkey = NULL;
    +   uint32_t local_masterkey_len;
    +   bson_t *kms_providers = NULL;
    +   bson_error_t error = {0};
    +   bson_t *index_keys = NULL;
    +   bson_t *index_opts = NULL;
    +   mongoc_index_model_t *index_model = NULL;
    +   bson_t *schema = NULL;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *coll = NULL;
    +   mongoc_collection_t *keyvault_coll = NULL;
    +   bson_t *to_insert = NULL;
    +   bson_t *create_cmd = NULL;
    +   bson_t *create_cmd_opts = NULL;
    +   mongoc_write_concern_t *wc = NULL;
    +   mongoc_client_encryption_t *client_encryption = NULL;
    +   mongoc_client_encryption_opts_t *client_encryption_opts = NULL;
    +   mongoc_client_encryption_datakey_opts_t *datakey_opts = NULL;
    +   char *keyaltnames[] = {"mongoc_encryption_example_4"};
    +   bson_value_t datakey_id = {0};
    +   bson_value_t encrypted_field = {0};
    +   bson_value_t to_encrypt = {0};
    +   mongoc_client_encryption_encrypt_opts_t *encrypt_opts = NULL;
    +   bson_value_t decrypted = {0};
    +   mongoc_auto_encryption_opts_t *auto_encryption_opts = NULL;
    +   mongoc_client_t *unencrypted_client = NULL;
    +   mongoc_collection_t *unencrypted_coll = NULL;
    +
    +   mongoc_init ();
    +
    +   /* Configure the master key. This must be the same master key that was used
    +    * to create the encryption key. */
    +   local_masterkey =
    +      hex_to_bin (getenv ("LOCAL_MASTERKEY"), &local_masterkey_len);
    +   if (!local_masterkey || local_masterkey_len != 96) {
    +      fprintf (stderr,
    +               "Specify LOCAL_MASTERKEY environment variable as a "
    +               "secure random 96 byte hex value.\n");
    +      goto fail;
    +   }
    +
    +   kms_providers = BCON_NEW ("local",
    +                             "{",
    +                             "key",
    +                             BCON_BIN (0, local_masterkey, local_masterkey_len),
    +                             "}");
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost/?appname=client-side-encryption");
    +   auto_encryption_opts = mongoc_auto_encryption_opts_new ();
    +   mongoc_auto_encryption_opts_set_keyvault_namespace (
    +      auto_encryption_opts, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_auto_encryption_opts_set_kms_providers (auto_encryption_opts,
    +                                                  kms_providers);
    +
    +   /* Setting bypass_auto_encryption to true disables automatic encryption but
    +    * keeps the automatic decryption behavior. bypass_auto_encryption will also
    +    * disable spawning mongocryptd */
    +   mongoc_auto_encryption_opts_set_bypass_auto_encryption (auto_encryption_opts,
    +                                                           true);
    +
    +   /* Once bypass_auto_encryption is set, community users can enable auto
    +    * encryption on the client. This will, in fact, only perform automatic
    +    * decryption. */
    +   ret = mongoc_client_enable_auto_encryption (
    +      client, auto_encryption_opts, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   /* Now that automatic decryption is on, we can test it by inserting a
    +    * document with an explicitly encrypted value into the collection. When we
    +    * look up the document later, it should be automatically decrypted for us.
    +    */
    +   coll = mongoc_client_get_collection (client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +
    +   /* Clear old data */
    +   mongoc_collection_drop (coll, NULL);
    +
    +   /* Set up the key vault for this example. */
    +   keyvault_coll =
    +      mongoc_client_get_collection (client, KEYVAULT_DB, KEYVAULT_COLL);
    +   mongoc_collection_drop (keyvault_coll, NULL);
    +
    +   /* Create a unique index to ensure that two data keys cannot share the same
    +    * keyAltName. This is recommended practice for the key vault. */
    +   index_keys = BCON_NEW ("keyAltNames", BCON_INT32 (1));
    +   index_opts = BCON_NEW ("unique",
    +                          BCON_BOOL (true),
    +                          "partialFilterExpression",
    +                          "{",
    +                          "keyAltNames",
    +                          "{",
    +                          "$exists",
    +                          BCON_BOOL (true),
    +                          "}",
    +                          "}");
    +   index_model = mongoc_index_model_new (index_keys, index_opts);
    +   ret = mongoc_collection_create_indexes_with_opts (keyvault_coll,
    +                                                     &index_model,
    +                                                     1,
    +                                                     NULL /* opts */,
    +                                                     NULL /* reply */,
    +                                                     &error);
    +
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   client_encryption_opts = mongoc_client_encryption_opts_new ();
    +   mongoc_client_encryption_opts_set_kms_providers (client_encryption_opts,
    +                                                    kms_providers);
    +   mongoc_client_encryption_opts_set_keyvault_namespace (
    +      client_encryption_opts, KEYVAULT_DB, KEYVAULT_COLL);
    +
    +   /* The key vault client is used for reading to/from the key vault. This can
    +    * be the same mongoc_client_t used by the application. */
    +   mongoc_client_encryption_opts_set_keyvault_client (client_encryption_opts,
    +                                                      client);
    +   client_encryption =
    +      mongoc_client_encryption_new (client_encryption_opts, &error);
    +   if (!client_encryption) {
    +      goto fail;
    +   }
    +
    +   /* Create a new data key for the encryptedField.
    +    * https://dochub.mongodb.org/core/client-side-field-level-encryption-automatic-encryption-rules
    +    */
    +   datakey_opts = mongoc_client_encryption_datakey_opts_new ();
    +   mongoc_client_encryption_datakey_opts_set_keyaltnames (
    +      datakey_opts, keyaltnames, 1);
    +   ret = mongoc_client_encryption_create_datakey (
    +      client_encryption, "local", datakey_opts, &datakey_id, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   /* Explicitly encrypt a field. */
    +   encrypt_opts = mongoc_client_encryption_encrypt_opts_new ();
    +   mongoc_client_encryption_encrypt_opts_set_algorithm (
    +      encrypt_opts, MONGOC_AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC);
    +   mongoc_client_encryption_encrypt_opts_set_keyaltname (
    +      encrypt_opts, "mongoc_encryption_example_4");
    +   to_encrypt.value_type = BSON_TYPE_UTF8;
    +   to_encrypt.value.v_utf8.str = "123456789";
    +   const size_t len = strlen (to_encrypt.value.v_utf8.str);
    +   BSON_ASSERT (bson_in_range_unsigned (uint32_t, len));
    +   to_encrypt.value.v_utf8.len = (uint32_t) len;
    +
    +   ret = mongoc_client_encryption_encrypt (
    +      client_encryption, &to_encrypt, encrypt_opts, &encrypted_field, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   to_insert = bson_new ();
    +   BSON_APPEND_VALUE (to_insert, "encryptedField", &encrypted_field);
    +   ret = mongoc_collection_insert_one (
    +      coll, to_insert, NULL /* opts */, NULL /* reply */, &error);
    +   if (!ret) {
    +      goto fail;
    +   }
    +
    +   /* When we retrieve the document, any encrypted fields will get automatically
    +    * decrypted by the driver. */
    +   printf ("decrypted document: ");
    +   if (!print_one_document (coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   unencrypted_client =
    +      mongoc_client_new ("mongodb://localhost/?appname=client-side-encryption");
    +   unencrypted_coll = mongoc_client_get_collection (
    +      unencrypted_client, ENCRYPTED_DB, ENCRYPTED_COLL);
    +
    +   printf ("encrypted document: ");
    +   if (!print_one_document (unencrypted_coll, &error)) {
    +      goto fail;
    +   }
    +   printf ("\n");
    +
    +   exit_status = EXIT_SUCCESS;
    +fail:
    +   if (error.code) {
    +      fprintf (stderr, "error: %s\n", error.message);
    +   }
    +
    +   bson_free (local_masterkey);
    +   bson_destroy (kms_providers);
    +   mongoc_collection_destroy (keyvault_coll);
    +   mongoc_index_model_destroy (index_model);
    +   bson_destroy (index_opts);
    +   bson_destroy (index_keys);
    +   mongoc_collection_destroy (coll);
    +   mongoc_client_destroy (client);
    +   bson_destroy (to_insert);
    +   bson_destroy (schema);
    +   bson_destroy (create_cmd);
    +   bson_destroy (create_cmd_opts);
    +   mongoc_write_concern_destroy (wc);
    +   mongoc_client_encryption_destroy (client_encryption);
    +   mongoc_client_encryption_datakey_opts_destroy (datakey_opts);
    +   mongoc_client_encryption_opts_destroy (client_encryption_opts);
    +   bson_value_destroy (&encrypted_field);
    +   mongoc_client_encryption_encrypt_opts_destroy (encrypt_opts);
    +   bson_value_destroy (&decrypted);
    +   bson_value_destroy (&datakey_id);
    +   mongoc_collection_destroy (unencrypted_coll);
    +   mongoc_client_destroy (unencrypted_client);
    +   mongoc_auto_encryption_opts_destroy (auto_encryption_opts);
    +
    +   mongoc_cleanup ();
    +   return exit_status;
    +}
    +
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/configuring_tls.html b/libmongoc/1.24.0/configuring_tls.html new file mode 100644 index 0000000000000000000000000000000000000000..b1bd4479e1cd635406369f875b000f2447286b78 --- /dev/null +++ b/libmongoc/1.24.0/configuring_tls.html @@ -0,0 +1,250 @@ + + + + + + + + + + + + + + Configuring TLS — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +

    Configuring TLS

    +
    +

    Configuration with URI options

    +

    Enable TLS by including tls=true in the URI.

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://localhost:27017/");
    +mongoc_uri_set_option_as_bool (uri, MONGOC_URI_TLS, true);
    +
    +mongoc_client_t *client = mongoc_client_new_from_uri (uri);
    +
    +
    +

    The following URI options may be used to further configure TLS:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_TLS

    tls

    {true|false}, indicating if TLS must be used.

    MONGOC_URI_TLSCERTIFICATEKEYFILE

    tlscertificatekeyfile

    Path to PEM formatted Private Key, with its Public Certificate concatenated at the end.

    MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD

    tlscertificatekeypassword

    The password, if any, to use to unlock encrypted Private Key.

    MONGOC_URI_TLSCAFILE

    tlscafile

    One, or a bundle of, Certificate Authorities whom should be considered to be trusted.

    MONGOC_URI_TLSALLOWINVALIDCERTIFICATES

    tlsallowinvalidcertificates

    Accept and ignore certificate verification errors (e.g. untrusted issuer, expired, etc.)

    MONGOC_URI_TLSALLOWINVALIDHOSTNAMES

    tlsallowinvalidhostnames

    Ignore hostname verification of the certificate (e.g. Man In The Middle, using valid certificate, but issued for another hostname)

    MONGOC_URI_TLSINSECURE

    tlsinsecure

    {true|false}, indicating if insecure TLS options should be used. Currently this implies MONGOC_URI_TLSALLOWINVALIDCERTIFICATES and MONGOC_URI_TLSALLOWINVALIDHOSTNAMES.

    MONGOC_URI_TLSDISABLECERTIFICATEREVOCATIONCHECK

    tlsdisablecertificaterevocationcheck

    {true|false}, indicates if revocation checking (CRL / OCSP) should be disabled.

    MONGOC_URI_TLSDISABLEOCSPENDPOINTCHECK

    tlsdisableocspendpointcheck

    {true|false}, indicates if OCSP responder endpoints should not be requested when an OCSP response is not stapled.

    +
    +
    +

    Configuration with mongoc_ssl_opt_t

    +

    Alternatively, the mongoc_ssl_opt_t struct may be used to configure TLS with mongoc_client_set_ssl_opts() or mongoc_client_pool_set_ssl_opts(). Most of the configurable options can be set using the Connection String URI.

    + + + + + + + + + + + + + + + + + + + + + + + +

    mongoc_ssl_opt_t key

    URI key

    pem_file

    tlsClientCertificateKeyFile

    pem_pwd

    tlsClientCertificateKeyPassword

    ca_file

    tlsCAFile

    weak_cert_validation

    tlsAllowInvalidCertificates

    allow_invalid_hostname

    tlsAllowInvalidHostnames

    +

    The only exclusions are crl_file and ca_dir. Those may only be set with mongoc_ssl_opt_t.

    +
    +
    +

    Client Authentication

    +

    When MongoDB is started with TLS enabled, it will by default require the client to provide a client certificate issued by a certificate authority specified by --tlsCAFile, or an authority trusted by the native certificate store in use on the server.

    +

    To provide the client certificate, set the tlsCertificateKeyFile in the URI to a PEM armored certificate file.

    +
    mongoc_uri_t *uri = mongoc_uri_new ("mongodb://localhost:27017/");
    +mongoc_uri_set_option_as_bool (uri, MONGOC_URI_TLS, true);
    +mongoc_uri_set_option_as_utf8 (uri, MONGOC_URI_TLSCERTIFICATEKEYFILE, "/path/to/client-certificate.pem");
    +
    +mongoc_client_t *client = mongoc_client_new_from_uri (uri);
    +
    +
    +
    +
    +

    Server Certificate Verification

    +

    The MongoDB C Driver will automatically verify the validity of the server certificate, such as issued by configured Certificate Authority, hostname validation, and expiration.

    +

    To overwrite this behavior, it is possible to disable hostname validation, OCSP endpoint revocation checking, revocation checking entirely, and allow invalid certificates.

    +

    This behavior is controlled using the tlsAllowInvalidHostnames, tlsDisableOCSPEndpointCheck, tlsDisableCertificateRevocationCheck, and tlsAllowInvalidCertificates options respectively. By default, all are set to false.

    +

    It is not recommended to change these defaults as it exposes the client to Man In The Middle attacks (when tlsAllowInvalidHostnames is set), invalid certificates (when tlsAllowInvalidCertificates is set), or potentially revoked certificates (when tlsDisableOCSPEndpointCheck or tlsDisableCertificateRevocationCheck are set).

    +
    +
    +

    Supported Libraries

    +

    By default, libmongoc will attempt to find a supported TLS library and enable TLS support. This is controlled by the cmake flag ENABLE_SSL, which is set to AUTO by default. Valid values are:

    +
      +
    • AUTO the default behavior. Link to the system’s native TLS library, or attempt to find OpenSSL.

    • +
    • DARWIN link to Secure Transport, the native TLS library on macOS.

    • +
    • WINDOWS link to Secure Channel, the native TLS library on Windows.

    • +
    • OPENSSL link to OpenSSL (libssl). An optional install path may be specified with OPENSSL_ROOT.

    • +
    • LIBRESSL link to LibreSSL’s libtls. (LibreSSL’s compatible libssl may be linked to by setting OPENSSL).

    • +
    • OFF disable TLS support.

    • +
    +
    +

    OpenSSL

    +

    The MongoDB C Driver uses OpenSSL, if available, on Linux and Unix platforms (besides macOS). Industry best practices and some regulations require the use of TLS 1.1 or newer, which requires at least OpenSSL 1.0.1. Check your OpenSSL version like so:

    +
    $ openssl version
    +
    +
    +

    Ensure your system’s OpenSSL is a recent version (at least 1.0.1), or install a recent version in a non-system path and build against it with:

    +
    cmake -DOPENSSL_ROOT_DIR=/absolute/path/to/openssl
    +
    +
    +

    When compiled against OpenSSL, the driver will attempt to load the system default certificate store, as configured by the distribution. That can be overridden by setting the tlsCAFile URI option or with the fields ca_file and ca_dir in the mongoc_ssl_opt_t.

    +

    The Online Certificate Status Protocol (OCSP) (see RFC 6960) is fully supported when using OpenSSL 1.0.1+ with the following notes:

    +
      +
    • When a crl_file is set with mongoc_ssl_opt_t, and the crl_file revokes the server’s certificate, the certificate is considered revoked (even if the certificate has a valid stapled OCSP response)

    • +
    +
    +
    +

    LibreSSL / libtls

    +

    The MongoDB C Driver supports LibreSSL through the use of OpenSSL compatibility checks when configured to compile against openssl. It also supports the new libtls library when configured to build against libressl.

    +

    When compiled against the Windows native libraries, the crl_file option of a mongoc_ssl_opt_t is not supported, and will issue an error if used.

    +

    Setting tlsDisableOCSPEndpointCheck and tlsDisableCertificateRevocationCheck has no effect.

    +

    The Online Certificate Status Protocol (OCSP) (see RFC 6960) is partially supported with the following notes:

    +
      +
    • The Must-Staple extension (see RFC 7633) is ignored. Connection may continue if a Must-Staple certificate is presented with no stapled response (unless the client receives a revoked response from an OCSP responder).

    • +
    • Connection will continue if a Must-Staple certificate is presented without a stapled response and the OCSP responder is down.

    • +
    +
    +
    +

    Native TLS Support on Windows (Secure Channel)

    +

    The MongoDB C Driver supports the Windows native TLS library (Secure Channel, or SChannel), and its native crypto library (Cryptography API: Next Generation, or CNG).

    +

    When compiled against the Windows native libraries, the ca_dir option of a mongoc_ssl_opt_t is not supported, and will issue an error if used.

    +

    Encrypted PEM files (e.g., setting tlsCertificateKeyPassword) are also not supported, and will result in error when attempting to load them.

    +

    When tlsCAFile is set, the driver will only allow server certificates issued by the authority (or authorities) provided. When no tlsCAFile is set, the driver will look up the Certificate Authority using the System Local Machine Root certificate store to confirm the provided certificate.

    +

    When crl_file is set with mongoc_ssl_opt_t, the driver will import the revocation list to the System Local Machine Root certificate store.

    +

    Setting tlsDisableOCSPEndpointCheck has no effect.

    +

    The Online Certificate Status Protocol (OCSP) (see RFC 6960) is partially supported with the following notes:

    +
      +
    • The Must-Staple extension (see RFC 7633) is ignored. Connection may continue if a Must-Staple certificate is presented with no stapled response (unless the client receives a revoked response from an OCSP responder).

    • +
    • When a crl_file is set with mongoc_ssl_opt_t, and the crl_file revokes the server’s certificate, the OCSP response takes precedence. E.g. if the server presents a certificate with a valid stapled OCSP response, the certificate is considered valid even if the crl_file marks it as revoked.

    • +
    • Connection will continue if a Must-Staple certificate is presented without a stapled response and the OCSP responder is down.

    • +
    +
    +
    +

    Native TLS Support on macOS / Darwin (Secure Transport)

    +

    The MongoDB C Driver supports the Darwin (OS X, macOS, iOS, etc.) native TLS library (Secure Transport), and its native crypto library (Common Crypto, or CC).

    +

    When compiled against Secure Transport, the ca_dir and crl_file options of a mongoc_ssl_opt_t are not supported. An error is issued if either are used.

    +

    When tlsCAFile is set, the driver will only allow server certificates issued by the authority (or authorities) provided. When no tlsCAFile is set, the driver will use the Certificate Authorities in the currently unlocked keychains.

    +

    Setting tlsDisableOCSPEndpointCheck and tlsDisableCertificateRevocationCheck has no effect.

    +

    The Online Certificate Status Protocol (OCSP) (see RFC 6960) is partially supported with the following notes.

    +
      +
    • The Must-Staple extension (see RFC 7633) is ignored. Connection may continue if a Must-Staple certificate is presented with no stapled response (unless the client receives a revoked response from an OCSP responder).

    • +
    • Connection will continue if a Must-Staple certificate is presented without a stapled response and the OCSP responder is down.

    • +
    +
    +
    +
    + + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/connection-pooling.html b/libmongoc/1.24.0/connection-pooling.html new file mode 100644 index 0000000000000000000000000000000000000000..2b9b525c47ce52ed1f181d56b9be454cedb45a22 --- /dev/null +++ b/libmongoc/1.24.0/connection-pooling.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + Connection Pooling — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Connection Pooling

    +

    The MongoDB C driver has two connection modes: single-threaded and pooled. Single-threaded mode is optimized for embedding the driver within languages like PHP. Multi-threaded programs should use pooled mode: this mode minimizes the total connection count, and in pooled mode background threads monitor the MongoDB server topology, so the program need not block to scan it.

    +
    +

    Single Mode

    +

    In single mode, your program creates a mongoc_client_t directly:

    +
    mongoc_client_t *client = mongoc_client_new (
    +   "mongodb://hostA,hostB/?replicaSet=my_rs");
    +
    +
    +

    The client connects on demand when your program first uses it for a MongoDB operation. Using a non-blocking socket per server, it begins a check on each server concurrently, and uses the asynchronous poll or select function to receive events from the sockets, until all have responded or timed out. Put another way, in single-threaded mode the C Driver fans out to begin all checks concurrently, then fans in once all checks have completed or timed out. Once the scan completes, the client executes your program’s operation and returns.

    +

    In single mode, the client re-scans the server topology roughly once per minute. If more than a minute has elapsed since the previous scan, the next operation on the client will block while the client completes its scan. This interval is configurable with heartbeatFrequencyMS in the connection string. (See mongoc_uri_t.)

    +

    A single client opens one connection per server in your topology: these connections are used both for scanning the topology and performing normal operations.

    +
    +
    +

    Pooled Mode

    +

    To activate pooled mode, create a mongoc_client_pool_t:

    +
    mongoc_uri_t *uri = mongoc_uri_new (
    +   "mongodb://hostA,hostB/?replicaSet=my_rs");
    +
    +mongoc_client_pool_t *pool = mongoc_client_pool_new (uri);
    +
    +
    +

    When your program first calls mongoc_client_pool_pop(), the pool launches monitoring threads in the background. Monitoring threads independently connect to all servers in the connection string. As monitoring threads receive hello responses from the servers, they update the shared view of the server topology. Additional monitoring threads and connections are created as new servers are discovered. Monitoring threads are terminated when servers are removed from the shared view of the server topology.

    +

    Each thread that executes MongoDB operations must check out a client from the pool:

    +
    mongoc_client_t *client = mongoc_client_pool_pop (pool);
    +
    +/* use the client for operations ... */
    +
    +mongoc_client_pool_push (pool, client);
    +
    +
    +

    The mongoc_client_t object is not thread-safe, only the mongoc_client_pool_t is.

    +

    When the driver is in pooled mode, your program’s operations are unblocked as soon as monitoring discovers a usable server. For example, if a thread in your program is waiting to execute an “insert” on the primary, it is unblocked as soon as the primary is discovered, rather than waiting for all secondaries to be checked as well.

    +

    The pool opens one connection per server for monitoring, and each client opens its own connection to each server it uses for application operations. Background monitoring threads re-scan servers independently roughly every 10 seconds. This interval is configurable with heartbeatFrequencyMS in the connection string. (See mongoc_uri_t.)

    +

    The connection string can also specify waitQueueTimeoutMS to limit the time that mongoc_client_pool_pop() will wait for a client from the pool. (See mongoc_uri_t.) If waitQueueTimeoutMS is specified, then it is necessary to confirm that a client was actually returned:

    +
    mongoc_uri_t *uri = mongoc_uri_new (
    +   "mongodb://hostA,hostB/?replicaSet=my_rs&waitQueueTimeoutMS=1000");
    +
    +mongoc_client_pool_t *pool = mongoc_client_pool_new (uri);
    +
    +mongoc_client_t *client = mongoc_client_pool_pop (pool);
    +
    +if (client) {
    +   /* use the client for operations ... */
    +
    +   mongoc_client_pool_push (pool, client);
    +} else {
    +   /* take appropriate action for a timeout */
    +}
    +
    +
    +

    See Connection Pool Options to configure pool size and behavior, and see mongoc_client_pool_t for an extended example of a multi-threaded program that uses the driver in pooled mode.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/cursors.html b/libmongoc/1.24.0/cursors.html new file mode 100644 index 0000000000000000000000000000000000000000..0ad8bd7f2f2857cc30b7d91436f9579116513b87 --- /dev/null +++ b/libmongoc/1.24.0/cursors.html @@ -0,0 +1,342 @@ + + + + + + + + + + + + + + Cursors — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Cursors

    +
    +

    Handling Cursor Failures

    +

    Cursors exist on a MongoDB server. However, the mongoc_cursor_t structure gives the local process a handle to the cursor. It is possible for errors to occur on the server while iterating a cursor on the client. Even a network partition may occur. This means that applications should be robust in handling cursor failures.

    +

    While iterating cursors, you should check to see if an error has occurred. See the following example for how to robustly check for errors.

    +
    static void
    +print_all_documents (mongoc_collection_t *collection)
    +{
    +   mongoc_cursor_t *cursor;
    +   const bson_t *doc;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   char *str;
    +
    +   cursor = mongoc_collection_find_with_opts (collection, query, NULL, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "Failed to iterate all documents: %s\n", error.message);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +}
    +
    +
    +
    +
    +

    Destroying Server-Side Cursors

    +

    The MongoDB C driver will automatically destroy a server-side cursor when mongoc_cursor_destroy() is called. Failure to call this function when done with a cursor will leak memory client side as well as consume extra memory server side. If the cursor was configured to never timeout, it will become a memory leak on the server.

    +
    +
    +

    Tailable Cursors

    +

    Tailable cursors are cursors that remain open even after they’ve returned a final result. This way, if more documents are added to a collection (i.e., to the cursor’s result set), then you can continue to call mongoc_cursor_next() to retrieve those additional results.

    +

    Here’s a complete test case that demonstrates the use of tailable cursors.

    +
    +

    Note

    +

    Tailable cursors are for capped collections only.

    +
    +

    An example to tail the oplog from a replica set.

    +
    +
    mongoc-tail.c
    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +#ifdef _WIN32
    +#define sleep(_n) Sleep ((_n) *1000)
    +#endif
    +
    +
    +static void
    +print_bson (const bson_t *b)
    +{
    +   char *str;
    +
    +   str = bson_as_canonical_extended_json (b, NULL);
    +   fprintf (stdout, "%s\n", str);
    +   bson_free (str);
    +}
    +
    +
    +static mongoc_cursor_t *
    +query_collection (mongoc_collection_t *collection, uint32_t last_time)
    +{
    +   mongoc_cursor_t *cursor;
    +   bson_t query;
    +   bson_t gt;
    +   bson_t opts;
    +
    +   BSON_ASSERT (collection);
    +
    +   bson_init (&query);
    +   BSON_APPEND_DOCUMENT_BEGIN (&query, "ts", &gt);
    +   BSON_APPEND_TIMESTAMP (&gt, "$gt", last_time, 0);
    +   bson_append_document_end (&query, &gt);
    +
    +   bson_init (&opts);
    +   BSON_APPEND_BOOL (&opts, "tailable", true);
    +   BSON_APPEND_BOOL (&opts, "awaitData", true);
    +
    +   cursor = mongoc_collection_find_with_opts (collection, &query, &opts, NULL);
    +
    +   bson_destroy (&query);
    +   bson_destroy (&opts);
    +
    +   return cursor;
    +}
    +
    +
    +static void
    +tail_collection (mongoc_collection_t *collection)
    +{
    +   mongoc_cursor_t *cursor;
    +   uint32_t last_time;
    +   const bson_t *doc;
    +   bson_error_t error;
    +   bson_iter_t iter;
    +
    +   BSON_ASSERT (collection);
    +
    +   last_time = (uint32_t) time (NULL);
    +
    +   while (true) {
    +      cursor = query_collection (collection, last_time);
    +      while (!mongoc_cursor_error (cursor, &error) &&
    +             mongoc_cursor_more (cursor)) {
    +         if (mongoc_cursor_next (cursor, &doc)) {
    +            if (bson_iter_init_find (&iter, doc, "ts") &&
    +                BSON_ITER_HOLDS_TIMESTAMP (&iter)) {
    +               bson_iter_timestamp (&iter, &last_time, NULL);
    +            }
    +            print_bson (doc);
    +         }
    +      }
    +      if (mongoc_cursor_error (cursor, &error)) {
    +         if (error.domain == MONGOC_ERROR_SERVER) {
    +            fprintf (stderr, "%s\n", error.message);
    +            exit (1);
    +         }
    +      }
    +
    +      mongoc_cursor_destroy (cursor);
    +      sleep (1);
    +   }
    +}
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_collection_t *collection;
    +   mongoc_client_t *client;
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +
    +   if (argc != 2) {
    +      fprintf (stderr, "usage: %s MONGO_URI\n", argv[0]);
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (argv[1], &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               argv[1],
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   collection = mongoc_client_get_collection (client, "local", "oplog.rs");
    +
    +   tail_collection (collection);
    +
    +   mongoc_collection_destroy (collection);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Let’s compile and run this example against a replica set to see updates as they are made.

    +
    $ gcc -Wall -o mongoc-tail mongoc-tail.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./mongoc-tail mongodb://example.com/?replicaSet=myReplSet
    +{
    +    "h" : -8458503739429355503,
    +    "ns" : "test.test",
    +    "o" : {
    +        "_id" : {
    +            "$oid" : "5372ab0a25164be923d10d50"
    +        }
    +    },
    +    "op" : "i",
    +    "ts" : {
    +        "$timestamp" : {
    +            "i" : 1,
    +            "t" : 1400023818
    +        }
    +    },
    +    "v" : 2
    +}
    +
    +
    +

    The line of output is a sample from performing db.test.insert({}) from the mongo shell on the replica set.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/debugging.html b/libmongoc/1.24.0/debugging.html new file mode 100644 index 0000000000000000000000000000000000000000..a2cf1912cc5db62db3cea84ae09babe1ff4fccac --- /dev/null +++ b/libmongoc/1.24.0/debugging.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + Aids for Debugging — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Aids for Debugging

    +
    +

    GDB

    +

    This repository contains a .gdbinit file that contains helper functions to +aid debugging of data structures. GDB will load this file +automatically if you have added the directory which contains the .gdbinit file to GDB’s +auto-load safe-path, and you start GDB from the directory which holds the .gdbinit file.

    +

    You can see the safe-path with show auto-load safe-path on a GDB prompt. You +can configure it by setting it in ~/.gdbinit with:

    +
    add-auto-load-safe-path /path/to/mongo-c-driver
    +
    +
    +

    If you haven’t added the path to your auto-load safe-path, or start GDB in +another directory, load the file with:

    +
    source path/to/mongo-c-driver/.gdbinit
    +
    +
    +

    The .gdbinit file defines the printbson function, which shows the contents of a bson_t * variable. +If you have a local bson_t, then you must prefix the variable with a &.

    +

    An example GDB session looks like:

    +
    (gdb) printbson bson
    +ALLOC [0x555556cd7310 + 0] (len=475)
    +{
    +    'bool' : true,
    +    'int32' : NumberInt("42"),
    +    'int64' : NumberLong("3000000042"),
    +    'string' : "Stŕìñg",
    +    'objectId' : ObjectID("5A1442F3122D331C3C6757E1"),
    +    'utcDateTime' : UTCDateTime(1511277299031),
    +    'arrayOfInts' : [
    +        '0' : NumberInt("1"),
    +        '1' : NumberInt("2")
    +    ],
    +    'embeddedDocument' : {
    +        'arrayOfStrings' : [
    +            '0' : "one",
    +            '1' : "two"
    +        ],
    +        'double' : 2.718280,
    +        'notherDoc' : {
    +            'true' : NumberInt("1"),
    +            'false' : false
    +        }
    +    },
    +    'binary' : Binary("02", "3031343532333637"),
    +    'regex' : Regex("@[a-z]+@", "im"),
    +    'null' : null,
    +    'js' : JavaScript("print foo"),
    +    'jsws' : JavaScript("print foo") with scope: {
    +        'f' : NumberInt("42"),
    +        'a' : [
    +            '0' : 3.141593,
    +            '1' : 2.718282
    +        ]
    +    },
    +    'timestamp' : Timestamp(4294967295, 4294967295),
    +    'double' : 3.141593
    +}
    +
    +
    +
    +
    +

    LLDB

    +

    The mongo-c-driver repository contains a script lldb_bson.py that can be +imported into an LLDB sessions and allows rich inspection of BSON values.

    +
    +

    Note

    +

    The lldb_bson.py module requires an LLDB with Python 3.8 or newer.

    +
    +

    To activate the script, import it from the LLDB command line:

    +
    (lldb) command script import /path/to/mongo-c-driver/lldb_bson.py
    +
    +
    +

    Upon success, the message lldb_bson is ready will be printed to the LLDB +console.

    +

    The import of this script can be made automatic by adding the command to an +.lldbinit file. For example: Create a file ~/.lldbinit containing:

    +
    command script import /path/to/mongo-c-driver/lldb_bson.py
    +
    +
    +

    The docstring at the top of the lldb_bson.py file contains more information +on the capabilities of the module.

    +
    +
    +

    Debug assertions

    +

    To enable runtime debug assertions, configure with -DENABLE_DEBUG_ASSERTIONS=ON.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/distinct-mapreduce.html b/libmongoc/1.24.0/distinct-mapreduce.html new file mode 100644 index 0000000000000000000000000000000000000000..f4abd13b93e3d0a096efcb5c7b620119d79fde8b --- /dev/null +++ b/libmongoc/1.24.0/distinct-mapreduce.html @@ -0,0 +1,580 @@ + + + + + + + + + + + + + + “distinct” and “mapReduce” — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    “distinct” and “mapReduce”

    +

    This document provides some practical, simple, examples to demonstrate the distinct and mapReduce commands.

    +
    +

    Setup

    +

    First we’ll write some code to insert sample data:

    +
    +
    doc-common-insert.c
    +
    /* Don't try to compile this file on its own. It's meant to be #included
    +   by example code */
    +
    +/* Insert some sample data */
    +bool
    +insert_data (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   enum N { ndocs = 4 };
    +   bson_t *docs[ndocs];
    +   bson_error_t error;
    +   int i = 0;
    +   bool ret;
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +   docs[0] = BCON_NEW ("x", BCON_DOUBLE (1.0), "tags", "[", "dog", "cat", "]");
    +   docs[1] = BCON_NEW ("x", BCON_DOUBLE (2.0), "tags", "[", "cat", "]");
    +   docs[2] = BCON_NEW (
    +      "x", BCON_DOUBLE (2.0), "tags", "[", "mouse", "cat", "dog", "]");
    +   docs[3] = BCON_NEW ("x", BCON_DOUBLE (3.0), "tags", "[", "]");
    +
    +   for (i = 0; i < ndocs; i++) {
    +      mongoc_bulk_operation_insert (bulk, docs[i]);
    +      bson_destroy (docs[i]);
    +      docs[i] = NULL;
    +   }
    +
    +   ret = mongoc_bulk_operation_execute (bulk, NULL, &error);
    +
    +   if (!ret) {
    +      fprintf (stderr, "Error inserting data: %s\n", error.message);
    +   }
    +
    +   mongoc_bulk_operation_destroy (bulk);
    +   return ret;
    +}
    +
    +/* A helper which we'll use a lot later on */
    +void
    +print_res (const bson_t *reply)
    +{
    +   char *str;
    +   BSON_ASSERT (reply);
    +   str = bson_as_canonical_extended_json (reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +}
    +
    +
    +
    +
    +
    +

    “distinct” command

    +

    This is how to use the distinct command to get the distinct values of x which are greater than 1:

    +
    +
    distinct.c
    +
    bool
    +distinct (mongoc_database_t *database)
    +{
    +   bson_t *command;
    +   bson_t reply;
    +   bson_error_t error;
    +   bool res;
    +   bson_iter_t iter;
    +   bson_iter_t array_iter;
    +   double val;
    +
    +   command = BCON_NEW ("distinct",
    +                       BCON_UTF8 (COLLECTION_NAME),
    +                       "key",
    +                       BCON_UTF8 ("x"),
    +                       "query",
    +                       "{",
    +                       "x",
    +                       "{",
    +                       "$gt",
    +                       BCON_DOUBLE (1.0),
    +                       "}",
    +                       "}");
    +   res =
    +      mongoc_database_command_simple (database, command, NULL, &reply, &error);
    +   if (!res) {
    +      fprintf (stderr, "Error with distinct: %s\n", error.message);
    +      goto cleanup;
    +   }
    +
    +   /* Do something with reply (in this case iterate through the values) */
    +   if (!(bson_iter_init_find (&iter, &reply, "values") &&
    +         BSON_ITER_HOLDS_ARRAY (&iter) &&
    +         bson_iter_recurse (&iter, &array_iter))) {
    +      fprintf (stderr, "Couldn't extract \"values\" field from response\n");
    +      goto cleanup;
    +   }
    +
    +   while (bson_iter_next (&array_iter)) {
    +      if (BSON_ITER_HOLDS_DOUBLE (&array_iter)) {
    +         val = bson_iter_double (&array_iter);
    +         printf ("Next double: %f\n", val);
    +      }
    +   }
    +
    +cleanup:
    +   /* cleanup */
    +   bson_destroy (command);
    +   bson_destroy (&reply);
    +   return res;
    +}
    +
    +
    +
    +
    +
    +

    “mapReduce” - basic example

    +

    A simple example using the map reduce framework. It simply adds up the number of occurrences of each “tag”.

    +

    First define the map and reduce functions:

    +
    +
    constants.c
    +
    const char *const COLLECTION_NAME = "things";
    +
    +/* Our map function just emits a single (key, 1) pair for each tag
    +   in the array: */
    +const char *const MAPPER = "function () {"
    +                           "this.tags.forEach(function(z) {"
    +                           "emit(z, 1);"
    +                           "});"
    +                           "}";
    +
    +/* The reduce function sums over all of the emitted values for a
    +   given key: */
    +const char *const REDUCER = "function (key, values) {"
    +                            "var total = 0;"
    +                            "for (var i = 0; i < values.length; i++) {"
    +                            "total += values[i];"
    +                            "}"
    +                            "return total;"
    +                            "}";
    +/* Note We can't just return values.length as the reduce function
    +   might be called iteratively on the results of other reduce
    +   steps. */
    +
    +
    +
    +

    Run the mapReduce command. Use the generic command helpers (e.g. mongoc_database_command_simple()). +Do not the read command helpers (e.g. mongoc_database_read_command_with_opts()) because they are considered +retryable read operations. If retryable reads are enabled, those operations will retry once on a retryable error, +giving undesirable behavior for mapReduce.

    +
    +
    map-reduce-basic.c
    +
    bool
    +map_reduce_basic (mongoc_database_t *database)
    +{
    +   bson_t reply;
    +   bson_t *command;
    +   bool res;
    +   bson_error_t error;
    +   mongoc_cursor_t *cursor;
    +   const bson_t *doc;
    +
    +   bool query_done = false;
    +
    +   const char *out_collection_name = "outCollection";
    +   mongoc_collection_t *out_collection;
    +
    +   /* Empty find query */
    +   bson_t find_query = BSON_INITIALIZER;
    +
    +   /* Construct the mapReduce command */
    +
    +   /* Other arguments can also be specified here, like "query" or
    +      "limit" and so on */
    +   command = BCON_NEW ("mapReduce",
    +                       BCON_UTF8 (COLLECTION_NAME),
    +                       "map",
    +                       BCON_CODE (MAPPER),
    +                       "reduce",
    +                       BCON_CODE (REDUCER),
    +                       "out",
    +                       BCON_UTF8 (out_collection_name));
    +   res =
    +      mongoc_database_command_simple (database, command, NULL, &reply, &error);
    +
    +   if (!res) {
    +      fprintf (stderr, "MapReduce failed: %s\n", error.message);
    +      goto cleanup;
    +   }
    +
    +   /* Do something with the reply (it doesn't contain the mapReduce results) */
    +   print_res (&reply);
    +
    +   /* Now we'll query outCollection to see what the results are */
    +   out_collection =
    +      mongoc_database_get_collection (database, out_collection_name);
    +   cursor = mongoc_collection_find_with_opts (
    +      out_collection, &find_query, NULL, NULL);
    +   query_done = true;
    +
    +   /* Do something with the results */
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      print_res (doc);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "ERROR: %s\n", error.message);
    +      res = false;
    +      goto cleanup;
    +   }
    +
    +cleanup:
    +   /* cleanup */
    +   if (query_done) {
    +      mongoc_cursor_destroy (cursor);
    +      mongoc_collection_destroy (out_collection);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (command);
    +
    +   return res;
    +}
    +
    +
    +
    +
    +
    +

    “mapReduce” - more complicated example

    +

    You must have replica set running for this.

    +

    In this example we contact a secondary in the replica set and do an “inline” map reduce, so the results are returned immediately:

    +
    +
    map-reduce-advanced.c
    +
    bool
    +map_reduce_advanced (mongoc_database_t *database)
    +{
    +   bson_t *command;
    +   bson_error_t error;
    +   bool res = true;
    +   mongoc_cursor_t *cursor;
    +   mongoc_read_prefs_t *read_pref;
    +   const bson_t *doc;
    +
    +   /* Construct the mapReduce command */
    +   /* Other arguments can also be specified here, like "query" or "limit"
    +      and so on */
    +
    +   /* Read the results inline from a secondary replica */
    +   command = BCON_NEW ("mapReduce",
    +                       BCON_UTF8 (COLLECTION_NAME),
    +                       "map",
    +                       BCON_CODE (MAPPER),
    +                       "reduce",
    +                       BCON_CODE (REDUCER),
    +                       "out",
    +                       "{",
    +                       "inline",
    +                       "1",
    +                       "}");
    +
    +   read_pref = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +   cursor = mongoc_database_command (
    +      database, MONGOC_QUERY_NONE, 0, 0, 0, command, NULL, read_pref);
    +
    +   /* Do something with the results */
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      print_res (doc);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "ERROR: %s\n", error.message);
    +      res = false;
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_read_prefs_destroy (read_pref);
    +   bson_destroy (command);
    +
    +   return res;
    +}
    +
    +
    +
    +
    +
    +

    Running the Examples

    +

    Here’s how to run the example code

    +
    +
    basic-aggregation.c
    +
    /*
    + * Copyright 2016 MongoDB, Inc.
    + *
    + * Licensed under the Apache License, Version 2.0 (the "License");
    + * you may not use this file except in compliance with the License.
    + * You may obtain a copy of the License at
    + *
    + *   http://www.apache.org/licenses/LICENSE-2.0
    + *
    + * Unless required by applicable law or agreed to in writing, software
    + * distributed under the License is distributed on an "AS IS" BASIS,
    + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    + * See the License for the specific language governing permissions and
    + * limitations under the License.
    + */
    +
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +
    +#include "constants.c"
    +
    +#include "../doc-common-insert.c"
    +#include "distinct.c"
    +#include "map-reduce-basic.c"
    +#include "map-reduce-advanced.c"
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_database_t *database = NULL;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *collection = NULL;
    +   mongoc_uri_t *uri = NULL;
    +   bson_error_t error;
    +   char *host_and_port = NULL;
    +   int exit_code = EXIT_FAILURE;
    +
    +   if (argc != 2) {
    +      fprintf (stderr, "usage: %s CONNECTION-STRING\n", argv[0]);
    +      fprintf (stderr,
    +               "the connection string can be of the following forms:\n");
    +      fprintf (stderr, "localhost\t\t\t\tlocal machine\n");
    +      fprintf (stderr, "localhost:27018\t\t\t\tlocal machine on port 27018\n");
    +      fprintf (stderr,
    +               "mongodb://user:pass@localhost:27017\t"
    +               "local machine on port 27017, and authenticate with username "
    +               "user and password pass\n");
    +      return exit_code;
    +   }
    +
    +   mongoc_init ();
    +
    +   if (strncmp (argv[1], "mongodb://", 10) == 0) {
    +      host_and_port = bson_strdup (argv[1]);
    +   } else {
    +      host_and_port = bson_strdup_printf ("mongodb://%s", argv[1]);
    +   }
    +
    +   uri = mongoc_uri_new_with_error (host_and_port, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               host_and_port,
    +               error.message);
    +      goto cleanup;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto cleanup;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   database = mongoc_client_get_database (client, "test");
    +   collection = mongoc_database_get_collection (database, COLLECTION_NAME);
    +
    +   printf ("Inserting data\n");
    +   if (!insert_data (collection)) {
    +      goto cleanup;
    +   }
    +
    +   printf ("distinct\n");
    +   if (!distinct (database)) {
    +      goto cleanup;
    +   }
    +
    +   printf ("map reduce\n");
    +   if (!map_reduce_basic (database)) {
    +      goto cleanup;
    +   }
    +
    +   printf ("more complicated map reduce\n");
    +   if (!map_reduce_advanced (database)) {
    +      goto cleanup;
    +   }
    +   
    +   exit_code = EXIT_SUCCESS;
    +
    +cleanup:
    +   if (collection) {
    +      mongoc_collection_destroy (collection);
    +   }
    +
    +   if (database) {
    +      mongoc_database_destroy (database);
    +   }
    +
    +   if (client) {
    +      mongoc_client_destroy (client);
    +   }
    +
    +   if (uri) {
    +      mongoc_uri_destroy (uri);
    +   }
    +
    +   if (host_and_port) {
    +      bson_free (host_and_port);
    +   }
    +
    +   mongoc_cleanup ();
    +   return exit_code;
    +}
    +
    +
    +
    +

    If you want to try the advanced map reduce example with a secondary, start a replica set (instructions for how to do this can be found here).

    +

    Otherwise, just start an instance of MongoDB:

    +
    $ mongod
    +
    +
    +

    Now compile and run the example program:

    +
    $ cd examples/basic_aggregation/
    +$ gcc -Wall -o agg-example basic-aggregation.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./agg-example localhost
    +
    +Inserting data
    +distinct
    +Next double: 2.000000
    +Next double: 3.000000
    +map reduce
    +{ "result" : "outCollection", "timeMillis" : 155, "counts" : { "input" : 84, "emit" : 126, "reduce" : 3, "output" : 3 }, "ok" : 1 }
    +{ "_id" : "cat", "value" : 63 }
    +{ "_id" : "dog", "value" : 42 }
    +{ "_id" : "mouse", "value" : 21 }
    +more complicated map reduce
    +{ "results" : [ { "_id" : "cat", "value" : 63 }, { "_id" : "dog", "value" : 42 }, { "_id" : "mouse", "value" : 21 } ], "timeMillis" : 14, "counts" : { "input" : 84, "emit" : 126, "reduce" : 3, "output" : 3 }, "ok" : 1 }
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/errors.html b/libmongoc/1.24.0/errors.html new file mode 100644 index 0000000000000000000000000000000000000000..f50b6239189098cc4f36d79470338faed3016c7f --- /dev/null +++ b/libmongoc/1.24.0/errors.html @@ -0,0 +1,361 @@ + + + + + + + + + + + + + + Error Reporting — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +

    « libmongoc

    +
    +

    Error Reporting

    +
    +

    Description

    +

    Many C Driver functions report errors by returning false or -1 and filling out a bson_error_t structure with an error domain, error code, and message. Use domain to determine which subsystem generated the error, and code for the specific error. message is a human-readable error description.

    +
    +

    See also

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Code

    Description

    MONGOC_ERROR_CLIENT

    MONGOC_ERROR_CLIENT_TOO_BIG

    You tried to send a message larger than the server’s max message size.

    MONGOC_ERROR_CLIENT_AUTHENTICATE

    Wrong credentials, or failure sending or receiving authentication messages.

    MONGOC_ERROR_CLIENT_NO_ACCEPTABLE_PEER

    You tried an TLS connection but the driver was not built with TLS.

    MONGOC_ERROR_CLIENT_IN_EXHAUST

    You began iterating an exhaust cursor, then tried to begin another operation with the same mongoc_client_t.

    MONGOC_ERROR_CLIENT_SESSION_FAILURE

    Failure related to creating or using a logical session.

    MONGOC_ERROR_CLIENT_INVALID_ENCRYPTION_ARG

    Failure related to arguments passed when initializing In-Use Encryption.

    MONGOC_ERROR_CLIENT_INVALID_ENCRYPTION_STATE

    Failure related to In-Use Encryption.

    MONGOC_ERROR_CLIENT_INVALID_LOAD_BALANCER

    You attempted to connect to a MongoDB server behind a load balancer, but the server does not advertize load balanced support.

    MONGOC_ERROR_STREAM

    MONGOC_ERROR_STREAM_NAME_RESOLUTION

    DNS failure.

    MONGOC_ERROR_STREAM_SOCKET

    Timeout communicating with server, or connection closed.

    MONGOC_ERROR_STREAM_CONNECT

    Failed to connect to server.

    MONGOC_ERROR_PROTOCOL

    MONGOC_ERROR_PROTOCOL_INVALID_REPLY

    Corrupt response from server.

    MONGOC_ERROR_PROTOCOL_BAD_WIRE_VERSION

    The server version is too old or too new to communicate with the driver.

    MONGOC_ERROR_CURSOR

    MONGOC_ERROR_CURSOR_INVALID_CURSOR

    You passed bad arguments to mongoc_collection_find_with_opts(), or you called mongoc_cursor_next() on a completed or failed cursor, or the cursor timed out on the server.

    MONGOC_ERROR_CHANGE_STREAM_NO_RESUME_TOKEN

    A resume token was not returned in a document found with mongoc_change_stream_next()

    MONGOC_ERROR_QUERY

    MONGOC_ERROR_QUERY_FAILURE

    Error API Version 1: Server error from command or query. The server error message is in message.

    MONGOC_ERROR_SERVER

    MONGOC_ERROR_QUERY_FAILURE

    Error API Version 2: Server error from command or query. The server error message is in message.

    MONGOC_ERROR_SASL

    A SASL error code.

    man sasl_errors for a list of codes.

    MONGOC_ERROR_BSON

    MONGOC_ERROR_BSON_INVALID

    You passed an invalid or oversized BSON document as a parameter, or called mongoc_collection_create_index() with invalid keys, or the server reply was corrupt.

    MONGOC_ERROR_NAMESPACE

    MONGOC_ERROR_NAMESPACE_INVALID

    You tried to create a collection with an invalid name.

    MONGOC_ERROR_COMMAND

    MONGOC_ERROR_COMMAND_INVALID_ARG

    Many functions set this error code when passed bad parameters. Print the error message for details.

    MONGOC_ERROR_PROTOCOL_BAD_WIRE_VERSION

    You tried to use a command option the server does not support.

    MONGOC_ERROR_DUPLICATE_KEY

    An insert or update failed because because of a duplicate _id or other unique-index violation.

    MONGOC_ERROR_MAX_TIME_MS_EXPIRED

    The operation failed because maxTimeMS expired.

    MONGOC_ERROR_SERVER_SELECTION_INVALID_ID

    The serverId option for an operation conflicts with the pinned server for that operation’s client session (denoted by the sessionId option).

    MONGOC_ERROR_COMMAND

    Error code from server.

    Error API Version 1: Server error from a command. The server error message is in message.

    MONGOC_ERROR_SERVER

    Error code from server.

    Error API Version 2: Server error from a command. The server error message is in message.

    MONGOC_ERROR_COLLECTION

    MONGOC_ERROR_COLLECTION_INSERT_FAILED, MONGOC_ERROR_COLLECTION_UPDATE_FAILED, MONGOC_ERROR_COLLECTION_DELETE_FAILED.

    Invalid or empty input to mongoc_collection_insert_one(), mongoc_collection_insert_bulk(), mongoc_collection_update_one(), mongoc_collection_update_many(), mongoc_collection_replace_one(), mongoc_collection_delete_one(), or mongoc_collection_delete_many().

    MONGOC_ERROR_COLLECTION

    Error code from server.

    Error API Version 1: Server error from mongoc_collection_insert_one(), mongoc_collection_insert_bulk(), mongoc_collection_update_one(), mongoc_collection_update_many(), mongoc_collection_replace_one(),

    MONGOC_ERROR_SERVER

    Error code from server.

    Error API Version 2: Server error from mongoc_collection_insert_one(), mongoc_collection_insert_bulk(), mongoc_collection_update_one(), mongoc_collection_update_many(), mongoc_collection_replace_one(),

    MONGOC_ERROR_GRIDFS

    MONGOC_ERROR_GRIDFS_CHUNK_MISSING

    The GridFS file is missing a document in its chunks collection.

    MONGOC_ERROR_GRIDFS_CORRUPT

    A data inconsistency was detected in GridFS.

    MONGOC_ERROR_GRIDFS_INVALID_FILENAME

    You passed a NULL filename to mongoc_gridfs_remove_by_filename().

    MONGOC_ERROR_GRIDFS_PROTOCOL_ERROR

    You called mongoc_gridfs_file_set_id() after mongoc_gridfs_file_save(), or tried to write on a closed GridFS stream.

    MONGOC_ERROR_GRIDFS_BUCKET_FILE_NOT_FOUND

    A GridFS file is missing from files collection.

    MONGOC_ERROR_GRIDFS_BUCKET_STREAM

    An error occurred on a stream created from a GridFS operation like mongoc_gridfs_bucket_upload_from_stream().

    MONGOC_ERROR_SCRAM

    MONGOC_ERROR_SCRAM_PROTOCOL_ERROR

    Failure in SCRAM-SHA-1 authentication.

    MONGOC_ERROR_SERVER_SELECTION

    MONGOC_ERROR_SERVER_SELECTION_FAILURE

    No replica set member or mongos is available, or none matches your read preference, or you supplied an invalid mongoc_read_prefs_t.

    MONGOC_ERROR_WRITE_CONCERN

    Error code from server.

    There was a write concern error or timeout from the server.

    MONGOC_ERROR_TRANSACTION

    MONGOC_ERROR_TRANSACTION_INVALID

    You attempted to start a transaction when one is already in progress, or commit or abort when there is no transaction.

    MONGOC_ERROR_CLIENT_SIDE_ENCRYPTION

    Error code produced by libmongocrypt.

    An error occurred in the library responsible for In-Use Encryption

    MONGOC_ERROR_AZURE

    MONGOC_ERROR_KMS_SERVER_HTTP

    An Azure HTTP service responded with an error status

    MONGOC_ERROR_KMS_SERVER_BAD_JSON

    An Azure service responded with invalid JSON data

    MONGOC_ERROR_GCP

    MONGOC_ERROR_KMS_SERVER_HTTP

    A GCP HTTP service responded with an error status

    MONGOC_ERROR_KMS_SERVER_BAD_JSON

    A GCP service responded with invalid JSON data

    +
    +
    +

    Error Labels

    +

    In some cases your application must make decisions based on what category of error the driver has returned, but these categories do not correspond perfectly to an error domain or code. In such cases, error labels provide a reliable way to determine how your application should respond to an error.

    +

    Any C Driver function that has a bson_t out-parameter named reply may include error labels to the reply, in the form of a BSON field named “errorLabels” containing an array of strings:

    +
    { "errorLabels": [ "TransientTransactionError" ] }
    +
    +
    +

    Use mongoc_error_has_label() to test if a reply contains a specific label. See mongoc_client_session_start_transaction() for example code that demonstrates the use of error labels in application logic.

    +

    The following error labels are currently defined. Future versions of MongoDB may introduce new labels.

    +
    +

    TransientTransactionError

    +

    Within a multi-document transaction, certain errors can leave the transaction in an unknown or aborted state. These include write conflicts, primary stepdowns, and network errors. In response, the application should abort the transaction and try the same sequence of operations again in a new transaction.

    +
    +
    +

    UnknownTransactionCommitResult

    +

    When mongoc_client_session_commit_transaction() encounters a network error or certain server errors, it is not known whether the transaction was committed. Applications should attempt to commit the transaction again until: the commit succeeds, the commit fails with an error not labeled “UnknownTransactionCommitResult”, or the application chooses to give up.

    +
    +
    +
    +

    Setting the Error API Version

    +

    The driver’s error reporting began with a design flaw: when the error domain is MONGOC_ERROR_COLLECTION, MONGOC_ERROR_QUERY, or MONGOC_ERROR_COMMAND, the error code might originate from the server or the driver. An application cannot always know where an error originated, and therefore cannot tell what the code means.

    +

    For example, if mongoc_collection_update_one() sets the error’s domain to MONGOC_ERROR_COLLECTION and its code to 24, the application cannot know whether 24 is the generic driver error code MONGOC_ERROR_COLLECTION_UPDATE_FAILED or the specific server error code “LockTimeout”.

    +

    To fix this flaw while preserving backward compatibility, the C Driver 1.4 introduces “Error API Versions”. Version 1, the default Error API Version, maintains the flawed behavior. Version 2 adds a new error domain, MONGOC_ERROR_SERVER. In Version 2, error codes originating on the server always have error domain MONGOC_ERROR_SERVER or MONGOC_ERROR_WRITE_CONCERN. When the driver uses Version 2 the application can always determine the origin and meaning of error codes. New applications should use Version 2, and existing applications should be updated to use Version 2 as well.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Error Source

    API Version 1

    API Version 2

    mongoc_cursor_error()

    MONGOC_ERROR_QUERY

    MONGOC_ERROR_SERVER

    mongoc_client_command_with_opts(), +mongoc_database_command_with_opts(), and +other command functions

    MONGOC_ERROR_QUERY

    MONGOC_ERROR_SERVER

    mongoc_collection_count_with_opts() +mongoc_client_get_database_names_with_opts(), +and other command helper functions

    MONGOC_ERROR_QUERY

    MONGOC_ERROR_SERVER

    mongoc_collection_insert_one() +mongoc_collection_insert_bulk() +mongoc_collection_update_one() +mongoc_collection_update_many() +mongoc_collection_replace_one() +mongoc_collection_delete_one() +mongoc_collection_delete_many()

    MONGOC_ERROR_COMMAND

    MONGOC_ERROR_SERVER

    mongoc_bulk_operation_execute()

    MONGOC_ERROR_COMMAND

    MONGOC_ERROR_SERVER

    Write-concern timeout

    MONGOC_ERROR_WRITE_CONCERN

    MONGOC_ERROR_WRITE_CONCERN

    +

    The Error API Versions are defined with MONGOC_ERROR_API_VERSION_LEGACY and MONGOC_ERROR_API_VERSION_2. Set the version with mongoc_client_set_error_api() or mongoc_client_pool_set_error_api().

    +
    +

    See also

    + +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/full_index.html b/libmongoc/1.24.0/full_index.html new file mode 100644 index 0000000000000000000000000000000000000000..f15f9fc9047f387283b9f95140ff7f39ef391802 --- /dev/null +++ b/libmongoc/1.24.0/full_index.html @@ -0,0 +1,940 @@ + + + + + + + + + + + + + + Index — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Index

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/gridfs.html b/libmongoc/1.24.0/gridfs.html new file mode 100644 index 0000000000000000000000000000000000000000..052691305e392fbb72dcbe3ea4dc1fc5312ad3f7 --- /dev/null +++ b/libmongoc/1.24.0/gridfs.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + GridFS — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    GridFS

    +

    The C driver includes two APIs for GridFS.

    +

    The older API consists of mongoc_gridfs_t and its derivatives. It contains deprecated API, does not support read preferences, and is not recommended in new applications. It does not conform to the MongoDB GridFS specification.

    +

    The newer API consists of mongoc_gridfs_bucket_t and allows uploading/downloading through derived mongoc_stream_t objects. It conforms to the MongoDB GridFS specification.

    +

    There is not always a straightforward upgrade path from an application built with mongoc_gridfs_t to mongoc_gridfs_bucket_t (e.g. a mongoc_gridfs_file_t provides functions to seek but mongoc_stream_t does not). But users are encouraged to upgrade when possible.

    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/guides.html b/libmongoc/1.24.0/guides.html new file mode 100644 index 0000000000000000000000000000000000000000..57bc656059c800f21050910c840f720f6f93bab7 --- /dev/null +++ b/libmongoc/1.24.0/guides.html @@ -0,0 +1,150 @@ + + + + + + + + + + + + + + Guides — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/in-use-encryption.html b/libmongoc/1.24.0/in-use-encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..3671f0645f902cc455a80a477c538324ac436130 --- /dev/null +++ b/libmongoc/1.24.0/in-use-encryption.html @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + In-Use Encryption — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    In-Use Encryption

    +

    In-Use Encryption consists of two features:

    + +
    +

    Installation

    +

    Using In-Use Encryption in the C driver requires the dependency libmongocrypt. See the MongoDB Manual for libmongocrypt installation instructions.

    +

    Once libmongocrypt is installed, configure the C driver with -DENABLE_CLIENT_SIDE_ENCRYPTION=ON to require In-Use Encryption be enabled.

    +
    $ cd mongo-c-driver
    +$ mkdir cmake-build && cd cmake-build
    +$ cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF -DENABLE_CLIENT_SIDE_ENCRYPTION=ON ..
    +$ cmake --build . --target install
    +
    +
    +
    +
    +

    API

    +

    mongoc_client_encryption_t is used for explicit encryption and key management. +mongoc_client_enable_auto_encryption() and mongoc_client_pool_enable_auto_encryption() is used to enable automatic encryption.

    +

    The Queryable Encryption and CSFLE features share much of the same API with some exceptions.

    + +
    +
    +

    Query Analysis

    +

    To support the automatic encryption feature, one of the following dependencies are required:

    + +

    A mongoc_client_t or mongoc_client_pool_t configured with auto encryption will automatically try to load the crypt_shared library. If loading the crypt_shared library fails, the mongoc_client_t or mongoc_client_pool_t will try to spawn the mongocryptd process from the application’s PATH. To configure use of crypt_shared and mongocryptd see mongoc_auto_encryption_opts_set_extra().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/index.html b/libmongoc/1.24.0/index.html new file mode 100644 index 0000000000000000000000000000000000000000..8f15fc9303fc713dddb5f845229f6009479d794e --- /dev/null +++ b/libmongoc/1.24.0/index.html @@ -0,0 +1,287 @@ + + + + + + + + + + + + + + libmongoc — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + +
    + + + + +
    +
    +
    +
    + +
    +

    libmongoc

    +

    A Cross Platform MongoDB Client Library for C

    +
    +

    Introduction

    +

    The MongoDB C Driver, also known as “libmongoc”, is a library for using MongoDB from C applications, and for writing MongoDB drivers in higher-level languages.

    +

    It depends on libbson to generate and parse BSON documents, the native data format of MongoDB.

    + + + + + + + +
    +
    + + +
    +
    +
    + +
    +
    + + +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/init-cleanup.html b/libmongoc/1.24.0/init-cleanup.html new file mode 100644 index 0000000000000000000000000000000000000000..a043f0d803126713792d8841415e1bceeeb466cc --- /dev/null +++ b/libmongoc/1.24.0/init-cleanup.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + Initialization and cleanup — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Initialization and cleanup

    +
    +

    Synopsis

    +

    Initialize the MongoDB C Driver by calling mongoc_init() exactly once at the beginning of your program. It is responsible for initializing global state such as process counters, SSL, and threading primitives.

    +

    Exception to this is mongoc_log_set_handler(), which should be called before mongoc_init() or some log traces would not use your log handling function. See Custom Log Handlers for a detailed example.

    +

    Call mongoc_cleanup() exactly once at the end of your program to release all memory and other resources allocated by the driver. You must not call any other MongoDB C Driver functions after mongoc_cleanup(). Note that mongoc_init() does not reinitialize the driver after mongoc_cleanup().

    + +
    +
    +

    Deprecated feature: automatic initialization and cleanup

    +

    On some platforms the driver can automatically call mongoc_init() before main, and call mongoc_cleanup() as the process exits. This is problematic in situations where related libraries also execute cleanup code on shutdown, and it creates inconsistent rules across platforms. Therefore the automatic initialization and cleanup feature is deprecated, and will be dropped in version 2.0. Meanwhile, for backward compatibility, the feature is enabled by default on platforms where it is available.

    +

    For portable, future-proof code, always call mongoc_init() and mongoc_cleanup() yourself, and configure the driver like:

    +
    cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/installing.html b/libmongoc/1.24.0/installing.html new file mode 100644 index 0000000000000000000000000000000000000000..e6a2004b27d2ed282355a624c23ac2d7826e9db5 --- /dev/null +++ b/libmongoc/1.24.0/installing.html @@ -0,0 +1,370 @@ + + + + + + + + + + + + + + Installing the MongoDB C Driver (libmongoc) and BSON library (libbson) — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Installing the MongoDB C Driver (libmongoc) and BSON library (libbson)

    +

    The following guide will step you through the process of downloading, building, and installing the current release of the MongoDB C Driver (libmongoc) and BSON library (libbson).

    +
    +

    Supported Platforms

    +

    The MongoDB C Driver is continuously tested on a variety of platforms including:

    +
      +
    • Archlinux

    • +
    • Debian 9.2, 10.0, 11.0

    • +
    • macOS 10.14 (Will be dropped in an upcoming release)

    • +
    • macOS 11.0 (x86_64 and arm64)

    • +
    • Microsoft Windows Server 2008, 2016

    • +
    • RHEL 7.0, 7.1, 8.1, 8.2, 8.3

    • +
    • Ubuntu 16.04, 18.04, 20.04

    • +
    • Clang 3.4, 3.5, 3.7, 3.8, 6.0

    • +
    • GCC 4.8, 4.9, 5.4, 6.3, 7.5, 8.2, 8.3, 9.4, 10.2

    • +
    • MinGW-W64

    • +
    • Visual Studio 2013, 2015, 2017

    • +
    • x86, x86_64, ARM (aarch64), Power8 (ppc64le), zSeries (s390x)

    • +
    +
    +
    +

    Install libmongoc with a Package Manager

    +

    Several Linux distributions provide packages for libmongoc and its dependencies. One advantage of installing libmongoc with a package manager is that its dependencies (including libbson) will be installed automatically. If you choose to install libmongoc from distribution packages, use the package manager to confirm the version being installed is sufficient for your needs.

    +

    The libmongoc package is available on recent versions of Debian and Ubuntu.

    +
    $ apt-get install libmongoc-dev
    +
    +
    +

    The libmongoc-dev package includes headers required to build applications using libmongoc. To check which version is available, run apt-cache policy libmongoc-dev. To only install the libraries without headers, install the libmongoc-1.0-0 package.

    +

    On Fedora, a mongo-c-driver package is available in the default repositories and can be installed with:

    +
    $ dnf install mongo-c-driver-devel
    +
    +
    +

    The mongo-c-driver-devel package includes headers required to build applications using libmongoc. To check which version is available, see https://packages.fedoraproject.org/pkgs/mongo-c-driver/mongo-c-driver-devel. To only install the libraries without headers, install the mongo-c-driver package.

    +

    On recent Red Hat systems, such as CentOS and RHEL 7, a mongo-c-driver-devel package is available in the EPEL repository. The package can be installed with:

    +
    $ yum install mongo-c-driver-devel
    +
    +
    +

    On macOS systems with Homebrew, the mongo-c-driver package can be installed with:

    +
    $ brew install mongo-c-driver
    +
    +
    +
    +
    +

    Install libbson with a Package Manager

    +

    The libbson package is available on recent versions of Debian and Ubuntu. If you have installed libmongoc, then libbson will have already been installed as a dependency. It is also possible to install libbson without libmongoc.

    +
    $ apt-get install libbson-dev
    +
    +
    +

    The libbson-dev package includes headers required to build applications using libbson. To check which version is available, run apt-cache policy libbson-dev. To only install the libraries without headers, install the libbson-1.0-0 package.

    +

    On Fedora, a libbson package is available in the default repositories and can be installed with:

    +
    $ dnf install libbson-devel
    +
    +
    +

    The libbson-devel package includes headers required to build applications using libbson. To check +which version is available, see https://packages.fedoraproject.org/pkgs/mongo-c-driver/libbson-devel. To only install the libraries without headers, install the libbson package.

    +

    On recent Red Hat systems, such as CentOS and RHEL 7, a libbson package is available in the EPEL repository. +The package can be installed with:

    +
    $ yum install libbson-devel
    +
    +
    +
    +
    +

    Build environment

    +
    +

    Build environment on Unix

    +
    +

    Prerequisites for libmongoc

    +

    OpenSSL is required for authentication or for TLS connections to MongoDB. Kerberos or LDAP support requires Cyrus SASL.

    +

    To install all optional dependencies on RedHat / Fedora:

    +
    $ sudo yum install cmake openssl-devel cyrus-sasl-devel
    +
    +
    +

    On Debian / Ubuntu:

    +
    $ sudo apt-get install cmake libssl-dev libsasl2-dev
    +
    +
    +

    On FreeBSD:

    +
    $ su -c 'pkg install cmake openssl cyrus-sasl'
    +
    +
    +
    +
    +

    Prerequisites for libbson

    +

    The only prerequisite for building libbson is cmake. The command lines above can be adjusted to install only cmake.

    +
    +
    +
    +

    Build environment on macOS

    +

    Install the XCode Command Line Tools:

    +
    $ xcode-select --install
    +
    +
    +

    The cmake utility is also required. First install Homebrew according to its instructions, then:

    +
    $ brew install cmake
    +
    +
    +
    +
    +

    Build environment on Windows with Visual Studio

    +

    Building on Windows requires Windows Vista or newer and Visual Studio 2013 or newer. Additionally, cmake is required to generate Visual Studio project files. Installation of these components on Windows is beyond the scope of this document.

    +
    +
    +

    Build environment on Windows with MinGW-W64 and MSYS2

    +

    Install MSYS2 from msys2.github.io. Choose the x86_64 version, not i686.

    +

    Open the MingGW shell with c:\msys64\ming64.exe (not the msys2_shell). Install dependencies:

    +
    $ pacman --noconfirm -Syu
    +$ pacman --noconfirm -S mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake
    +$ pacman --noconfirm -S mingw-w64-x86_64-extra-cmake-modules make tar
    +$ pacman --noconfirm -S mingw64/mingw-w64-x86_64-cyrus-sasl
    +
    +
    +
    +
    +
    +

    Configuring the build

    +

    Before building libmongoc and/or libbson, it is necessary to configure, or prepare, the build. The steps to prepare the build depend on how you obtained the source code and the build platform.

    +
    +

    Preparing a build from a release tarball

    +

    The most recent release of libmongoc and libbson, both of which are included in mongo-c-driver, can be downloaded here. The instructions in this document utilize cmake’s out-of-source build feature to keep build artifacts separate from source files. While the $ prompt is used throughout, the instructions below will work on Linux, macOS, and Windows (assuming that CMake is in the user’s shell path in all cases). See the subsequent sections for additional platform-specific instructions.

    +

    The following snippet will download and extract the driver, and configure it:

    +
    $ wget https://github.com/mongodb/mongo-c-driver/releases/download/1.24.0/mongo-c-driver-1.24.0.tar.gz
    +$ tar xzf mongo-c-driver-1.24.0.tar.gz
    +$ cd mongo-c-driver-1.24.0
    +$ mkdir cmake-build
    +$ cd cmake-build
    +$ cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF ..
    +

    The -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF option is recommended, see Initialization and cleanup. Another useful cmake option is -DCMAKE_BUILD_TYPE=Release for a release optimized build and -DCMAKE_BUILD_TYPE=Debug for a debug build. For a list of all configure options, run cmake -L ...

    +

    If cmake completed successfully, you will see a considerable amount of output describing your build configuration. The final line of output should look something like this:

    +
    -- Build files have been written to: /home/user/mongo-c-driver-1.24.0/cmake-build
    +

    If cmake concludes with anything different, then it is likely an error occurred.

    +

    mongo-c-driver contains a copy of libbson, in case your system does not already have libbson installed. The configuration will detect if libbson is not installed and use the bundled libbson.

    +

    Additionally, it is possible to build only libbson by setting the -DENABLE_MONGOC=OFF option:

    +
    $ cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF -DENABLE_MONGOC=OFF ..
    +
    +
    +

    A build configuration description similar to the one above will be displayed, though with fewer entries. Once the configuration is complete, the selected items can be built and installed with these commands:

    +
    +
    +

    Preparing a build from a git repository clone

    +

    Clone the repository and prepare the build on the current branch or a particular release tag:

    +
    $ git clone https://github.com/mongodb/mongo-c-driver.git
    +$ cd mongo-c-driver
    +$ git checkout 1.24.0  # To build a particular release
    +$ python build/calc_release_version.py > VERSION_CURRENT
    +$ mkdir cmake-build
    +$ cd cmake-build
    +$ cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF ..
    +
    +
    +

    Preparing a build on Windows with Visual Studio

    +

    On the Windows platform with Visual Studio, it may be necessary to specify the CMake generator to use. This is especially important if multiple versions of Visual Studio are installed on the system or if alternate build tools (e.g., MinGW, MSYS2, Cygwin, etc.) are present on the system. Specifying the generator will ensure that the build configuration is known with certainty, rather than relying on the toolchain that CMake happens to find.

    +

    Start by generating Visual Studio project files. The following assumes you are compiling for 64-bit Windows using Visual Studio 2015 Express, which can be freely downloaded from Microsoft. The sample commands utilize cmake’s out-of-source build feature to keep build artifacts separate from source files.

    +
    $ cd mongo-c-driver-1.24.0
    +$ mkdir cmake-build
    +$ cd cmake-build
    +$ cmake -G "Visual Studio 14 2015 Win64" \
    +    "-DCMAKE_INSTALL_PREFIX=C:\mongo-c-driver" \
    +    "-DCMAKE_PREFIX_PATH=C:\mongo-c-driver" \
    +    ..
    +

    (Run cmake -LH .. for a list of other options.)

    +

    To see a complete list of the CMake generators available on your specific system, use a command like this:

    +
    $ cmake --help
    +
    +
    +
    +
    +
    +

    Executing a build

    +
    +

    Building on Unix, macOS, and Windows (MinGW-W64 and MSYS2)

    +
    $ cmake --build .
    +$ sudo cmake --build . --target install
    +
    +
    +

    (Note that the sudo command may not be applicable or available depending on the configuration of your system.)

    +

    In the above commands, the first relies on the default target which builds all configured components. For fine grained control over what gets built, the following command can be used (for Ninja and Makefile-based build systems) to list all available targets:

    +
    $ cmake --build . help
    +
    +
    +
    +
    +

    Building on Windows with Visual Studio

    +

    Once the project files are generated, the project can be opened directly in Visual Studio or compiled from the command line.

    +

    Build using the CMake build tool mode:

    +
    $ cmake --build . --config RelWithDebInfo
    +
    +
    +

    Visual Studio’s default build type is Debug, but we recommend a release build with debug info for production use. Now that libmongoc and libbson are compiled, install them. Components will be installed to the path specified by CMAKE_INSTALL_PREFIX.

    +
    $ cmake --build . --config RelWithDebInfo --target install
    +
    +
    +

    You should now see libmongoc and libbson installed in C:\mongo-c-driver

    +

    For Visual Studio 2019 (16.4 and newer), this command can be used to list all available targets:

    +
    $ cmake --build . -- /targets
    +
    +
    +

    Alternately, you can examine the files matching the glob *.vcxproj in the cmake-build directory.

    +

    To use the driver libraries in your program, see Using libmongoc in a Microsoft Visual Studio project.

    +
    +
    +

    Generating the documentation

    +

    Install Sphinx, then:

    +
    $ cmake -DENABLE_MAN_PAGES=ON -DENABLE_HTML_DOCS=ON ..
    +$ cmake --build . --target mongoc-doc
    +
    +
    +

    To build only the libbson documentation:

    +
    $ cmake -DENABLE_MAN_PAGES=ON -DENABLE_HTML_DOCS=ON ..
    +$ cmake --build . --target bson-doc
    +
    +
    +

    The -DENABLE_MAN_PAGES=ON and -DENABLE_HTML_DOCS=ON can also be added as options to a normal build from a release tarball or from git so that the documentation is built at the same time as other components.

    +
    +
    +

    Uninstalling the installed components

    +

    There are two ways to uninstall the components that have been installed. The first is to invoke the uninstall program directly. On Linux/Unix:

    +
    $ sudo /usr/local/share/mongo-c-driver/uninstall.sh
    +
    +
    +

    On Windows:

    +
    $ C:\mongo-c-driver\share\mongo-c-driver\uninstall.bat
    +
    +
    +

    The second way to uninstall is from within the build directory, assuming that it is in the exact same state as when the install command was invoked:

    +
    $ sudo cmake --build . --target uninstall
    +
    +
    +

    The second approach simply invokes the uninstall program referenced in the first approach.

    +
    +
    +

    Dealing with Build Failures

    +

    If your attempt to build the C driver fails, please see the README for instructions on requesting assistance.

    +
    +
    +
    +

    Additional Options for Integrators

    +

    In the event that you are building the BSON library and/or the C driver to embed with other components and you wish to avoid the potential for collision with components installed from a standard build or from a distribution package manager, you can make use of the BSON_OUTPUT_BASENAME and MONGOC_OUTPUT_BASENAME options to cmake.

    +
    $ cmake -DBSON_OUTPUT_BASENAME=custom_bson -DMONGOC_OUTPUT_BASENAME=custom_mongoc ..
    +
    +
    +

    The above command would produce libraries named libcustom_bson.so and libcustom_mongoc.so (or with the extension appropriate for the build platform). Those libraries could be placed in a standard system directory or in an alternate location and could be linked to by specifying something like -lcustom_mongoc -lcustom_bson on the linker command line (possibly adjusting the specific flags to those required by your linker).

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/lifecycle.html b/libmongoc/1.24.0/lifecycle.html new file mode 100644 index 0000000000000000000000000000000000000000..b0e18a229d2a3cd9294c1b248365a9463d1e9baa --- /dev/null +++ b/libmongoc/1.24.0/lifecycle.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + Object Lifecycle — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Object Lifecycle

    +

    This page documents the order of creation and destruction for libmongoc’s main struct types.

    +
    +

    Clients and pools

    +

    Call mongoc_init() once, before calling any other libmongoc functions, and call mongoc_cleanup() once before your program exits.

    +

    A program that uses libmongoc from multiple threads should create a mongoc_client_pool_t with mongoc_client_pool_new(). Each thread acquires a mongoc_client_t from the pool with mongoc_client_pool_pop() and returns it with mongoc_client_pool_push() when the thread is finished using it. To destroy the pool, first return all clients, then call mongoc_client_pool_destroy().

    +

    If your program uses libmongoc from only one thread, create a mongoc_client_t directly with mongoc_client_new() or mongoc_client_new_from_uri(). Destroy it with mongoc_client_destroy().

    +
    + +
    +

    GridFS objects

    +

    You can create a mongoc_gridfs_t from a mongoc_client_t, create a mongoc_gridfs_file_t or mongoc_gridfs_file_list_t from a mongoc_gridfs_t, create a mongoc_gridfs_file_t from a mongoc_gridfs_file_list_t, and create a mongoc_stream_t from a mongoc_gridfs_file_t.

    +

    Each of these objects depends on the object it was created from. Always destroy GridFS objects in the reverse of the order they were created. The sole exception is that a mongoc_gridfs_file_t need not be destroyed before the mongoc_gridfs_file_list_t it was created from.

    +
    +
    +

    GridFS bucket objects

    +

    Create mongoc_gridfs_bucket_t with a mongoc_database_t derived from a mongoc_client_t. The mongoc_database_t is independent from the mongoc_gridfs_bucket_t. But the mongoc_client_t must outlive the mongoc_gridfs_bucket_t.

    +

    A mongoc_stream_t may be created from the mongoc_gridfs_bucket_t. The mongoc_gridfs_bucket_t must outlive the mongoc_stream_t.

    +
    +
    +

    Sessions

    +

    Start a session with mongoc_client_start_session(), use the session for a sequence of operations and multi-document transactions, then free it with mongoc_client_session_destroy(). Any mongoc_cursor_t or mongoc_change_stream_t using a session must be destroyed before the session, and a session must be destroyed before the mongoc_client_t it came from.

    +

    By default, sessions are causally consistent. To disable causal consistency, before starting a session create a mongoc_session_opt_t with mongoc_session_opts_new() and call mongoc_session_opts_set_causal_consistency(), then free the struct with mongoc_session_opts_destroy().

    +

    Unacknowledged writes are prohibited with sessions.

    +

    A mongoc_client_session_t must be used by only one thread at a time. Due to session pooling, mongoc_client_start_session() may return a session that has been idle for some time and is about to be closed after its idle timeout. Use the session within one minute of acquiring it to refresh the session and avoid a timeout.

    +
    +
    +

    Client Side Encryption

    +

    When configuring a mongoc_client_t for automatic encryption via mongoc_client_enable_auto_encryption(), if a separate key vault client is set in the options (via mongoc_auto_encryption_opts_set_keyvault_client()) the key vault client must outlive the encrypted client.

    +

    When configuring a mongoc_client_pool_t for automatic encryption via mongoc_client_pool_enable_auto_encryption(), if a separate key vault client pool is set in the options (via mongoc_auto_encryption_opts_set_keyvault_client_pool()) the key vault client pool must outlive the encrypted client pool.

    +

    When creating a mongoc_client_encryption_t, the configured key vault client (set via mongoc_client_encryption_opts_set_keyvault_client()) must outlive the mongoc_client_encryption_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/logging.html b/libmongoc/1.24.0/logging.html new file mode 100644 index 0000000000000000000000000000000000000000..1469287aa335bbda828de0df4b3361f68a45f501 --- /dev/null +++ b/libmongoc/1.24.0/logging.html @@ -0,0 +1,297 @@ + + + + + + + + + + + + + + Logging — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Logging

    +

    MongoDB C driver Logging Abstraction

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_LOG_LEVEL_ERROR,
    +   MONGOC_LOG_LEVEL_CRITICAL,
    +   MONGOC_LOG_LEVEL_WARNING,
    +   MONGOC_LOG_LEVEL_MESSAGE,
    +   MONGOC_LOG_LEVEL_INFO,
    +   MONGOC_LOG_LEVEL_DEBUG,
    +   MONGOC_LOG_LEVEL_TRACE,
    +} mongoc_log_level_t;
    +
    +#define MONGOC_ERROR(...)
    +#define MONGOC_CRITICAL(...)
    +#define MONGOC_WARNING(...)
    +#define MONGOC_MESSAGE(...)
    +#define MONGOC_INFO(...)
    +#define MONGOC_DEBUG(...)
    +
    +typedef void (*mongoc_log_func_t) (mongoc_log_level_t log_level,
    +                                   const char *log_domain,
    +                                   const char *message,
    +                                   void *user_data);
    +
    +void
    +mongoc_log_set_handler (mongoc_log_func_t log_func, void *user_data);
    +void
    +mongoc_log (mongoc_log_level_t log_level,
    +            const char *log_domain,
    +            const char *format,
    +            ...) BSON_GNUC_PRINTF (3, 4);
    +const char *
    +mongoc_log_level_str (mongoc_log_level_t log_level);
    +void
    +mongoc_log_default_handler (mongoc_log_level_t log_level,
    +                            const char *log_domain,
    +                            const char *message,
    +                            void *user_data);
    +void
    +mongoc_log_trace_enable (void);
    +void
    +mongoc_log_trace_disable (void);
    +
    +
    +

    The MongoDB C driver comes with an abstraction for logging that you can use in your application, or integrate with an existing logging system.

    +
    +
    +

    Macros

    +

    To make logging a little less painful, various helper macros are provided. See the following example.

    +
    #undef MONGOC_LOG_DOMAIN
    +#define MONGOC_LOG_DOMAIN "my-custom-domain"
    +
    +MONGOC_WARNING ("An error occurred: %s", strerror (errno));
    +
    +
    +
    +
    +

    Custom Log Handlers

    +
    +
    The default log handler prints a timestamp and the log message to stdout, or to stderr for warnings, critical messages, and errors.

    You can override the handler with mongoc_log_set_handler(). +Your handler function is called in a mutex for thread safety.

    +
    +
    +

    For example, you could register a custom handler to suppress messages at INFO level and below:

    +
    void
    +my_logger (mongoc_log_level_t log_level,
    +           const char *log_domain,
    +           const char *message,
    +           void *user_data)
    +{
    +   /* smaller values are more important */
    +   if (log_level < MONGOC_LOG_LEVEL_INFO) {
    +      mongoc_log_default_handler (log_level, log_domain, message, user_data);
    +   }
    +}
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_log_set_handler (my_logger, NULL);
    +   mongoc_init ();
    +
    +   /* ... your code ...  */
    +
    +   mongoc_cleanup ();
    +   return 0;
    +}
    +
    +
    +

    Note that in the example above mongoc_log_set_handler() is called before mongoc_init(). +Otherwise, some log traces could not be processed by the log handler.

    +

    To restore the default handler:

    +
    mongoc_log_set_handler (mongoc_log_default_handler, NULL);
    +
    +
    +
    +
    +

    Disable logging

    +

    To disable all logging, including warnings, critical messages and errors, provide an empty log handler:

    +
    mongoc_log_set_handler (NULL, NULL);
    +
    +
    +
    +
    +

    Tracing

    +

    If compiling your own copy of the MongoDB C driver, consider configuring with -DENABLE_TRACING=ON to enable function tracing and hex dumps of network packets to STDERR and STDOUT during development and debugging.

    +

    This is especially useful when debugging what may be going on internally in the driver.

    +

    Trace messages can be enabled and disabled by calling mongoc_log_trace_enable() and mongoc_log_trace_disable()

    +
    +

    Note

    +

    Compiling the driver with -DENABLE_TRACING=ON will affect its performance. Disabling tracing with mongoc_log_trace_disable() significantly reduces the overhead, but cannot remove it completely.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/manage-collection-indexes.html b/libmongoc/1.24.0/manage-collection-indexes.html new file mode 100644 index 0000000000000000000000000000000000000000..db313dca9296bab3b258392b29344e878f8c94b6 --- /dev/null +++ b/libmongoc/1.24.0/manage-collection-indexes.html @@ -0,0 +1,182 @@ + + + + + + + + + + + + + + Manage Collection Indexes — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Manage Collection Indexes

    +

    To create indexes on a MongoDB collection, use mongoc_collection_create_indexes_with_opts():

    +
    // `keys` represents an ascending index on field `x`.
    +bson_t *keys = BCON_NEW ("x", BCON_INT32 (1));
    +mongoc_index_model_t *im = mongoc_index_model_new (keys, NULL /* opts */);
    +if (mongoc_collection_create_indexes_with_opts (
    +       coll, &im, 1, NULL /* opts */, NULL /* reply */, &error)) {
    +   printf ("Successfully created index\n");
    +} else {
    +   bson_destroy (keys);
    +   HANDLE_ERROR ("Failed to create index: %s", error.message);
    +}
    +bson_destroy (keys);
    +
    +
    +

    To list indexes, use mongoc_collection_find_indexes_with_opts():

    +
    mongoc_cursor_t *cursor =
    +   mongoc_collection_find_indexes_with_opts (coll, NULL /* opts */);
    +printf ("Listing indexes:\n");
    +const bson_t *got;
    +while (mongoc_cursor_next (cursor, &got)) {
    +   char *got_str = bson_as_canonical_extended_json (got, NULL);
    +   printf ("  %s\n", got_str);
    +   bson_free (got_str);
    +}
    +if (mongoc_cursor_error (cursor, &error)) {
    +   mongoc_cursor_destroy (cursor);
    +   HANDLE_ERROR ("Failed to list indexes: %s", error.message);
    +}
    +mongoc_cursor_destroy (cursor);
    +
    +
    +

    To drop an index, use mongoc_collection_drop_index_with_opts(). The index name may be obtained from the keys document with mongoc_collection_keys_to_index_string():

    +
    bson_t *keys = BCON_NEW ("x", BCON_INT32 (1));
    +char *index_name = mongoc_collection_keys_to_index_string (keys);
    +if (mongoc_collection_drop_index_with_opts (
    +       coll, index_name, NULL /* opts */, &error)) {
    +   printf ("Successfully dropped index\n");
    +} else {
    +   bson_free (index_name);
    +   bson_destroy (keys);
    +   HANDLE_ERROR ("Failed to drop index: %s", error.message);
    +}
    +bson_free (index_name);
    +bson_destroy (keys);
    +
    +
    +

    For a full example, see example-manage-collection-indexes.c.

    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc-common-task-examples.html b/libmongoc/1.24.0/mongoc-common-task-examples.html new file mode 100644 index 0000000000000000000000000000000000000000..c8c2d7e21931658e663ec6fee7178af1f499f30d --- /dev/null +++ b/libmongoc/1.24.0/mongoc-common-task-examples.html @@ -0,0 +1,431 @@ + + + + + + + + + + + + + + Common Tasks — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Common Tasks

    +

    Drivers for some other languages provide helper functions to perform certain common tasks. In the C Driver we must explicitly build commands to send to the server.

    +
    +

    Setup

    +

    First we’ll write some code to insert sample data:

    +
    +
    doc-common-insert.c
    +
    /* Don't try to compile this file on its own. It's meant to be #included
    +   by example code */
    +
    +/* Insert some sample data */
    +bool
    +insert_data (mongoc_collection_t *collection)
    +{
    +   mongoc_bulk_operation_t *bulk;
    +   enum N { ndocs = 4 };
    +   bson_t *docs[ndocs];
    +   bson_error_t error;
    +   int i = 0;
    +   bool ret;
    +
    +   bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
    +
    +   docs[0] = BCON_NEW ("x", BCON_DOUBLE (1.0), "tags", "[", "dog", "cat", "]");
    +   docs[1] = BCON_NEW ("x", BCON_DOUBLE (2.0), "tags", "[", "cat", "]");
    +   docs[2] = BCON_NEW (
    +      "x", BCON_DOUBLE (2.0), "tags", "[", "mouse", "cat", "dog", "]");
    +   docs[3] = BCON_NEW ("x", BCON_DOUBLE (3.0), "tags", "[", "]");
    +
    +   for (i = 0; i < ndocs; i++) {
    +      mongoc_bulk_operation_insert (bulk, docs[i]);
    +      bson_destroy (docs[i]);
    +      docs[i] = NULL;
    +   }
    +
    +   ret = mongoc_bulk_operation_execute (bulk, NULL, &error);
    +
    +   if (!ret) {
    +      fprintf (stderr, "Error inserting data: %s\n", error.message);
    +   }
    +
    +   mongoc_bulk_operation_destroy (bulk);
    +   return ret;
    +}
    +
    +/* A helper which we'll use a lot later on */
    +void
    +print_res (const bson_t *reply)
    +{
    +   char *str;
    +   BSON_ASSERT (reply);
    +   str = bson_as_canonical_extended_json (reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +}
    +
    +
    +
    +
    +
    +

    “explain” Command

    +

    This is how to use the explain command in MongoDB 3.2+:

    +
    +
    explain.c
    +
    bool
    +explain (mongoc_collection_t *collection)
    +{
    +   bson_t *command;
    +   bson_t reply;
    +   bson_error_t error;
    +   bool res;
    +
    +   command = BCON_NEW ("explain",
    +                       "{",
    +                       "find",
    +                       BCON_UTF8 (COLLECTION_NAME),
    +                       "filter",
    +                       "{",
    +                       "x",
    +                       BCON_INT32 (1),
    +                       "}",
    +                       "}");
    +   res = mongoc_collection_command_simple (
    +      collection, command, NULL, &reply, &error);
    +   if (!res) {
    +      fprintf (stderr, "Error with explain: %s\n", error.message);
    +      goto cleanup;
    +   }
    +
    +   /* Do something with the reply */
    +   print_res (&reply);
    +
    +cleanup:
    +   bson_destroy (&reply);
    +   bson_destroy (command);
    +   return res;
    +}
    +
    +
    +
    +
    +
    +

    Running the Examples

    +
    +
    common-operations.c
    +
    /*
    + * Copyright 2016 MongoDB, Inc.
    + *
    + * Licensed under the Apache License, Version 2.0 (the "License");
    + * you may not use this file except in compliance with the License.
    + * You may obtain a copy of the License at
    + *
    + *   http://www.apache.org/licenses/LICENSE-2.0
    + *
    + * Unless required by applicable law or agreed to in writing, software
    + * distributed under the License is distributed on an "AS IS" BASIS,
    + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    + * See the License for the specific language governing permissions and
    + * limitations under the License.
    + */
    +
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +
    +const char *COLLECTION_NAME = "things";
    +
    +#include "../doc-common-insert.c"
    +#include "explain.c"
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_database_t *database = NULL;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *collection = NULL;
    +   mongoc_uri_t *uri = NULL;
    +   bson_error_t error;
    +   char *host_and_port;
    +   int res = 0;
    +
    +   if (argc < 2 || argc > 3) {
    +      fprintf (stderr,
    +               "usage: %s MONGOD-1-CONNECTION-STRING "
    +               "[MONGOD-2-HOST-NAME:MONGOD-2-PORT]\n",
    +               argv[0]);
    +      fprintf (stderr,
    +               "MONGOD-1-CONNECTION-STRING can be "
    +               "of the following forms:\n");
    +      fprintf (stderr, "localhost\t\t\t\tlocal machine\n");
    +      fprintf (stderr, "localhost:27018\t\t\t\tlocal machine on port 27018\n");
    +      fprintf (stderr,
    +               "mongodb://user:pass@localhost:27017\t"
    +               "local machine on port 27017, and authenticate with username "
    +               "user and password pass\n");
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_init ();
    +
    +   if (strncmp (argv[1], "mongodb://", 10) == 0) {
    +      host_and_port = bson_strdup (argv[1]);
    +   } else {
    +      host_and_port = bson_strdup_printf ("mongodb://%s", argv[1]);
    +   }
    +
    +   uri = mongoc_uri_new_with_error (host_and_port, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               host_and_port,
    +               error.message);
    +      res = EXIT_FAILURE;
    +      goto cleanup;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      res = EXIT_FAILURE;
    +      goto cleanup;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   database = mongoc_client_get_database (client, "test");
    +   collection = mongoc_database_get_collection (database, COLLECTION_NAME);
    +
    +   printf ("Inserting data\n");
    +   if (!insert_data (collection)) {
    +      res = EXIT_FAILURE;
    +      goto cleanup;
    +   }
    +
    +   printf ("explain\n");
    +   if (!explain (collection)) {
    +      res = EXIT_FAILURE;
    +      goto cleanup;
    +   }
    +
    +cleanup:
    +   if (collection) {
    +      mongoc_collection_destroy (collection);
    +   }
    +
    +   if (database) {
    +      mongoc_database_destroy (database);
    +   }
    +
    +   if (client) {
    +      mongoc_client_destroy (client);
    +   }
    +
    +   if (uri) {
    +      mongoc_uri_destroy (uri);
    +   }
    +
    +   bson_free (host_and_port);
    +   mongoc_cleanup ();
    +   return res;
    +}
    +
    +
    +
    +

    First launch two separate instances of mongod (must be done from separate shells):

    +
    $ mongod
    +
    +
    +
    $ mkdir /tmp/db2
    +$ mongod --dbpath /tmp/db2 --port 27018 # second instance
    +
    +
    +

    Now compile and run the example program:

    +
    $ cd examples/common_operations/$ gcc -Wall -o example common-operations.c $(pkg-config --cflags --libs libmongoc-1.0)$ ./example localhost:27017 localhost:27018
    +Inserting data
    +explain
    +{
    +   "executionStats" : {
    +      "allPlansExecution" : [],
    +      "executionStages" : {
    +         "advanced" : 19,
    +         "direction" : "forward" ,
    +         "docsExamined" : 76,
    +         "executionTimeMillisEstimate" : 0,
    +         "filter" : {
    +            "x" : {
    +               "$eq" : 1
    +            }
    +         },
    +         "invalidates" : 0,
    +         "isEOF" : 1,
    +         "nReturned" : 19,
    +         "needTime" : 58,
    +         "needYield" : 0,
    +         "restoreState" : 0,
    +         "saveState" : 0,
    +         "stage" : "COLLSCAN" ,
    +         "works" : 78
    +      },
    +      "executionSuccess" : true,
    +      "executionTimeMillis" : 0,
    +      "nReturned" : 19,
    +      "totalDocsExamined" : 76,
    +      "totalKeysExamined" : 0
    +   },
    +   "ok" : 1,
    +   "queryPlanner" : {
    +      "indexFilterSet" : false,
    +      "namespace" : "test.things",
    +      "parsedQuery" : {
    +         "x" : {
    +            "$eq" : 1
    +         }
    +      },
    +      "plannerVersion" : 1,
    +      "rejectedPlans" : [],
    +      "winningPlan" : {
    +         "direction" : "forward" ,
    +         "filter" : {
    +            "x" : {
    +               "$eq" : 1
    +            }
    +         },
    +         "stage" : "COLLSCAN"
    +      }
    +   },
    +   "serverInfo" : {
    +      "gitVersion" : "05552b562c7a0b3143a729aaa0838e558dc49b25" ,
    +      "host" : "MacBook-Pro-57.local",
    +      "port" : 27017,
    +      "version" : "3.2.6"
    +   }
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_callbacks_destroy.html b/libmongoc/1.24.0/mongoc_apm_callbacks_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..25e426d172626f893e7e044d864e6e02942bbf81 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_callbacks_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + mongoc_apm_callbacks_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_callbacks_new.html b/libmongoc/1.24.0/mongoc_apm_callbacks_new.html new file mode 100644 index 0000000000000000000000000000000000000000..26dfcd484fb60c0524b7d4b7ce6a025a61a2acec --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_callbacks_new.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + mongoc_apm_callbacks_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_callbacks_new()

    +
    +

    Synopsis

    +
    mongoc_apm_callbacks_t *
    +mongoc_apm_callbacks_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a struct to hold event-notification callbacks.

    +
    +
    +

    Returns

    +

    A new mongoc_apm_callbacks_t you must free with mongoc_apm_callbacks_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_callbacks_t.html b/libmongoc/1.24.0/mongoc_apm_callbacks_t.html new file mode 100644 index 0000000000000000000000000000000000000000..89432eb754723d16fab9c898e1faef4212fcea9c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_callbacks_t.html @@ -0,0 +1,169 @@ + + + + + + + + + + + + + + mongoc_apm_callbacks_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_command_name.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_command_name.html new file mode 100644 index 0000000000000000000000000000000000000000..ada1301a01433ddd188a13cbd9963ca3a05c1f0a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_command_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_command_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_command_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_apm_command_failed_get_command_name (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s command name. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A string that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_context.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..8e1244c2c69d95682de4e29e53fe460a32760a9e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_duration.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..d4e62bb2587b0a86dc353ae4c1b655692b162daa --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_duration() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_duration()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_failed_get_duration (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s duration in microseconds.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s duration.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_error.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_error.html new file mode 100644 index 0000000000000000000000000000000000000000..3e57f5a4efb18728e5a49d8bd2948385cd5caa00 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_error.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_error()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_command_failed_get_error (const mongoc_apm_command_failed_t *event,
    +                                     bson_error_t *error);
    +
    +
    +

    Copies this event’s error info.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_host.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..da41cf064adca7f7f161c15e758be2d9276edc95 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_command_failed_get_host (const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_operation_id.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_operation_id.html new file mode 100644 index 0000000000000000000000000000000000000000..f834f8b8d2e2a77283461d1c16feb02608f3581a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_operation_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_operation_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_operation_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_failed_get_operation_id (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s operation id. This number correlates all the commands in a bulk operation, or all the “find” and “getMore” commands required to stream a large query result.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s operation id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_reply.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..e4d7bbeee1b9351069de7c7937c9935396a6a736 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_reply.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_reply() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_reply()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_apm_command_failed_get_reply (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns the server’s reply to a command that failed. The reply contains details about why the command failed. If no server reply was received, such as in the event of a network error, then the reply is a valid empty BSON document. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_request_id.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_request_id.html new file mode 100644 index 0000000000000000000000000000000000000000..000f17db092012e48bb319f80ffda9b19d51d0b7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_request_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_request_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_request_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_failed_get_request_id (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s wire-protocol request id. Use this number to correlate client-side events with server log messages.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s request id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_connection_id.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_connection_id.html new file mode 100644 index 0000000000000000000000000000000000000000..6a9b9c5f1d20b6a91b0a30d577d17f92590e8efc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_connection_id.html @@ -0,0 +1,175 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_server_connection_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_server_connection_id()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.24.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_apm_command_failed_get_server_connection_id_int64() in new code.

    +
    +
    +
    +

    Synopsis

    +
    int32_t
    +mongoc_apm_command_failed_get_server_connection_id (
    +  const mongoc_apm_command_failed_t *event)
    +  BSON_GNUC_DEPRECATED_FOR (
    +      "mongoc_apm_command_failed_get_server_connection_id_int64");
    +
    +
    +

    Returns this event’s context.

    +

    Returns the server connection ID for the command. The server connection ID is +distinct from the server ID (mongoc_apm_command_failed_get_server_id()) +and is returned by the hello or legacy hello response as “connectionId” from the +server on 4.2+.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The server connection ID as a positive integer or -1 if it is not available.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_connection_id_int64.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_connection_id_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..4c1e3f0314f3b93f6728628e70209c76a6999d5e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_connection_id_int64.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_server_connection_id_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_server_connection_id_int64()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_failed_get_server_connection_id_int64 (
    +  const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s context.

    +

    Returns the server connection ID for the command. The server connection ID is +distinct from the server ID (mongoc_apm_command_failed_get_server_id()) +and is returned by the hello or legacy hello response as “connectionId” from the +server on 4.2+.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The server connection ID as a positive integer or -1 if it is not available.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_id.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..45c6bf47c4024cff476db619775cf61583f53076 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_server_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_server_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_server_id()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_apm_command_failed_get_server_id (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s server id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s server id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_get_service_id.html b/libmongoc/1.24.0/mongoc_apm_command_failed_get_service_id.html new file mode 100644 index 0000000000000000000000000000000000000000..9a9b2b3d9ad5055d4506277dce868f14c24ce35a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_get_service_id.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_service_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_service_id()

    +
    +

    Synopsis

    +
    const bson_oid_t *
    +mongoc_apm_command_failed_get_service_id (
    +   const mongoc_apm_command_failed_t *event);
    +
    +
    +

    Returns this event’s service ID, which identifies the MongoDB service behind a +load balancer, or NULL if not connected to a load balanced cluster.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_oid_t that should not be modified or freed or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_failed_t.html b/libmongoc/1.24.0/mongoc_apm_command_failed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..489f9519131a273239e807e7ae883b53db7da41f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_failed_t.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_command.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_command.html new file mode 100644 index 0000000000000000000000000000000000000000..aa0c5fdf7be3ac3c067a1680445ed257274427b3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_command.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_command() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_command()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_apm_command_started_get_command (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s command. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_command_name.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_command_name.html new file mode 100644 index 0000000000000000000000000000000000000000..f461cfe4becb4745423e2182df9eb3a43a4ac5f7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_command_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_command_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_command_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_apm_command_started_get_command_name (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s command name. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A string that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_context.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..072ddc8e13fb6a5a6ea70ed2cafa511694060a82 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_database_name.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_database_name.html new file mode 100644 index 0000000000000000000000000000000000000000..2a17068a99c301ecf5cf9d239ad75057713934f5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_database_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_database_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_database_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_apm_command_started_get_database_name (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s database name. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A string that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_host.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..c8c7fa6bb755679fd0e1d969174d22f212c369f3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_command_started_get_host (const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_operation_id.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_operation_id.html new file mode 100644 index 0000000000000000000000000000000000000000..319f8319c84fe6dcaee5b910612a46234dc6dfd9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_operation_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_operation_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_operation_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_started_get_operation_id (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s operation id. This number correlates all the commands in a bulk operation, or all the “find” and “getMore” commands required to stream a large query result.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s operation id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_request_id.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_request_id.html new file mode 100644 index 0000000000000000000000000000000000000000..d5856efb4f728b65ebdc2384ceeedc732f0247b5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_request_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_request_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_request_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_started_get_request_id (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s wire-protocol request id. Use this number to correlate client-side events with server log messages.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s request id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_server_connection_id.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_server_connection_id.html new file mode 100644 index 0000000000000000000000000000000000000000..787396393b48eb14aa8f1ba836fe37e140760693 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_server_connection_id.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_server_connection_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_server_connection_id()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.24.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_apm_command_started_get_server_connection_id_int64() in new code.

    +
    +
    +
    +

    Synopsis

    +
    int32_t
    +mongoc_apm_command_started_get_server_connection_id (
    +  const mongoc_apm_command_started_t *event)
    +  BSON_GNUC_DEPRECATED_FOR (
    +      "mongoc_apm_command_started_get_server_connection_id_int64");
    +
    +
    +

    Returns the server connection ID for the command. The server connection ID is +distinct from the server ID (mongoc_apm_command_started_get_server_id()) +and is returned by the hello or legacy hello response as “connectionId” from the +server on 4.2+.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The server connection ID as a positive integer or -1 if it is not available.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_server_connection_id_int64.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_server_connection_id_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..53aec87eb53d8a230bead84934332ad4534d479e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_server_connection_id_int64.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_server_connection_id_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_server_connection_id_int64()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_started_get_server_connection_id_int64 (
    +  const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns the server connection ID for the command. The server connection ID is +distinct from the server ID (mongoc_apm_command_started_get_server_id()) +and is returned by the hello or legacy hello response as “connectionId” from the +server on 4.2+.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The server connection ID as a positive integer or -1 if it is not available.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_server_id.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..8437405656b4bd6e4e6f739bb06c7b8fd5e16456 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_server_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_server_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_server_id()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_apm_command_started_get_server_id (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s server id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s server id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_get_service_id.html b/libmongoc/1.24.0/mongoc_apm_command_started_get_service_id.html new file mode 100644 index 0000000000000000000000000000000000000000..9eaa8e05f499fadadbef358f45e5bde5d1df0676 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_get_service_id.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_service_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_service_id()

    +
    +

    Synopsis

    +
    const bson_oid_t *
    +mongoc_apm_command_started_get_service_id (
    +   const mongoc_apm_command_started_t *event);
    +
    +
    +

    Returns this event’s service ID, which identifies the MongoDB service behind a +load balancer, or NULL if not connected to a load balanced cluster.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_oid_t that should not be modified or freed or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_started_t.html b/libmongoc/1.24.0/mongoc_apm_command_started_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7f5ddded96da483e762427b6e1a6b2469604513c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_started_t.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_command_name.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_command_name.html new file mode 100644 index 0000000000000000000000000000000000000000..f57a683f278e38ea47e91eeafe0f4149bb0ae787 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_command_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_command_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_command_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_apm_command_succeeded_get_command_name (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s command name. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A string that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_context.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..20fb13e9dca17f6bc587e4b156ffb26b2cfbabaf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_duration.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..b94842ff2ad2b4b4eb1e2474349eda581f226107 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_duration() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_duration()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_succeeded_get_duration (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s duration in microseconds.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s duration.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_host.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..b7e09831c1084b19fb1fb2f712b8ae4f3cc45121 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_command_succeeded_get_host (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_operation_id.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_operation_id.html new file mode 100644 index 0000000000000000000000000000000000000000..dd6b270e4e34ccbb5a083066b378f09cd49b39a4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_operation_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_operation_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_operation_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_succeeded_get_operation_id (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s operation id. This number correlates all the commands in a bulk operation, or all the “find” and “getMore” commands required to stream a large query result.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s operation id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_reply.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..77aeb66319246f8bf241f778c257fd839ef7c918 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_reply.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_reply() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_reply()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_apm_command_succeeded_get_reply (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s reply. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_request_id.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_request_id.html new file mode 100644 index 0000000000000000000000000000000000000000..db1f4a7d3ead3cb802732ff19e08c537ec734612 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_request_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_request_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_request_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_succeeded_get_request_id (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s wire-protocol request id. Use this number to correlate client-side events with server log messages.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s request id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_connection_id.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_connection_id.html new file mode 100644 index 0000000000000000000000000000000000000000..7e1c5fb95d0cefdf942588243ff98700a6225289 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_connection_id.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_server_connection_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_server_connection_id()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.24.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_apm_command_succeeded_get_server_connection_id_int64() in new code.

    +
    +
    +
    +

    Synopsis

    +
    int32_t
    +mongoc_apm_command_succeeded_get_server_connection_id (
    +  const mongoc_apm_command_succeeded_t *event)
    +  BSON_GNUC_DEPRECATED_FOR (
    +      "mongoc_apm_command_succeeded_get_server_connection_id_int64");
    +
    +
    +

    Returns the server connection ID for the command. The server connection ID is +distinct from the server ID +(mongoc_apm_command_succeeded_get_server_id()) and is returned by the +hello or legacy hello response as “connectionId” from the server on 4.2+.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The server connection ID as a positive integer or -1 if it is not available.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_connection_id_int64.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_connection_id_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..5e63e9894f0f6c91cb43e7e1c953d14bc71d4943 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_connection_id_int64.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_server_connection_id_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_server_connection_id_int64()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_command_succeeded_get_server_connection_id_int64 (
    +  const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns the server connection ID for the command. The server connection ID is +distinct from the server ID +(mongoc_apm_command_succeeded_get_server_id()) and is returned by the +hello or legacy hello response as “connectionId” from the server on 4.2+.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The server connection ID as a positive integer or -1 if it is not available.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_id.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..be7bf0dc90a0cebbee5264109ef7961066b9d864 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_server_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_server_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_server_id()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_apm_command_succeeded_get_server_id (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s server id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s server id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_service_id.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_service_id.html new file mode 100644 index 0000000000000000000000000000000000000000..dd5eeeb020a1cffaaf7661a4c800890242be9cae --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_get_service_id.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_service_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_service_id()

    +
    +

    Synopsis

    +
    const bson_oid_t *
    +mongoc_apm_command_succeeded_get_service_id (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +
    +

    Returns this event’s service ID, which identifies the MongoDB service behind a +load balancer, or NULL if not connected to a load balanced cluster.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_oid_t that should not be modified or freed or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_command_succeeded_t.html b/libmongoc/1.24.0/mongoc_apm_command_succeeded_t.html new file mode 100644 index 0000000000000000000000000000000000000000..bb77061edc0940438522cdb956fc562685e9993c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_command_succeeded_t.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_changed_get_context.html b/libmongoc/1.24.0/mongoc_apm_server_changed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..87a4af305d1c644a99c0d235f2ea68787c5f01fd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_changed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_changed_get_host.html b/libmongoc/1.24.0/mongoc_apm_server_changed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..a173b75ddf0962a1a4e407bb1933ffdcdeba52e2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_changed_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_changed_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_server_changed_get_host (const mongoc_apm_server_changed_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_changed_get_new_description.html b/libmongoc/1.24.0/mongoc_apm_server_changed_get_new_description.html new file mode 100644 index 0000000000000000000000000000000000000000..c5fb85806ec3b922879ae37e1a3bc1e05be4bd70 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_changed_get_new_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_new_description() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_changed_get_new_description()

    +
    +

    Synopsis

    +
    const mongoc_server_description_t *
    +mongoc_apm_server_changed_get_new_description (
    +   const mongoc_apm_server_changed_t *event);
    +
    +
    +

    Returns this event’s new description. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_server_description_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_changed_get_previous_description.html b/libmongoc/1.24.0/mongoc_apm_server_changed_get_previous_description.html new file mode 100644 index 0000000000000000000000000000000000000000..70aff66e2a8d2fc047bb7bca8193eb05ec246054 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_changed_get_previous_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_previous_description() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_changed_get_previous_description()

    +
    +

    Synopsis

    +
    const mongoc_server_description_t *
    +mongoc_apm_server_changed_get_previous_description (
    +   const mongoc_apm_server_changed_t *event);
    +
    +
    +

    Returns this event’s previous description. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_server_description_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_changed_get_topology_id.html b/libmongoc/1.24.0/mongoc_apm_server_changed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..c43f139223695ed3b32d88788a814ef1a778c93b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_changed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_topology_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_changed_get_topology_id()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_server_changed_get_topology_id (
    +   const mongoc_apm_server_changed_t *event, bson_oid_t *topology_id);
    +
    +
    +

    Returns this event’s topology id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s topology id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_changed_t.html b/libmongoc/1.24.0/mongoc_apm_server_changed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..53c722646aa7eeae0503101088cffe9ef138d28e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_changed_t.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_closed_get_context.html b/libmongoc/1.24.0/mongoc_apm_server_closed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..ceaee3c76a122bb43ca182af7bcfe833013795a4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_closed_get_context.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_closed_get_host.html b/libmongoc/1.24.0/mongoc_apm_server_closed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..4652821bf45dd11e23fb579c064139cf52b8e30d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_closed_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_closed_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_server_closed_get_host (const mongoc_apm_server_closed_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_closed_get_topology_id.html b/libmongoc/1.24.0/mongoc_apm_server_closed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..20881f0adeca2b5b3b0c63931b9b9d7ee84870c6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_closed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_get_topology_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_closed_get_topology_id()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_server_closed_get_topology_id (
    +   const mongoc_apm_server_closed_t *event, bson_oid_t *topology_id);
    +
    +
    +

    Returns this event’s topology id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s topology id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_closed_t.html b/libmongoc/1.24.0/mongoc_apm_server_closed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..77aa1109bb7c81134b3856f61087eed2de7add04 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_closed_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_awaited.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_awaited.html new file mode 100644 index 0000000000000000000000000000000000000000..d87f6ca6d112286eca1cf98545aad24327427e09 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_awaited.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_awaited() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_failed_get_awaited()

    +
    +

    Synopsis

    +
    bool
    +mongoc_apm_server_heartbeat_failed_get_awaited (
    +   const mongoc_apm_server_heartbeat_failed_t *event);
    +
    +
    +

    Returns whether this event came from an awaitable hello.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bool indicating whether the heartbeat event came from an awaitable hello.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_context.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..c635e46890b521e1716cb300e9c00ab0a2622754 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_duration.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..ff4d1bf62d268da2dd9cf350e943bfc1b76b700a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_duration() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_failed_get_duration()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_server_heartbeat_failed_get_duration (
    +   const mongoc_apm_server_heartbeat_failed_t *event);
    +
    +
    +

    Returns this event’s duration in microseconds.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s duration.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_error.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_error.html new file mode 100644 index 0000000000000000000000000000000000000000..4d460a70836b8d33508b4e190e2d51b6b913d3f1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_error.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_failed_get_error()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_server_heartbeat_failed_get_error (
    +   const mongoc_apm_server_heartbeat_failed_t *event, bson_error_t *error);
    +
    +
    +

    Copies this event’s error info.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_host.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..22f3f798b3c70213a47a3f75c3239c611a8010cf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_failed_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_server_heartbeat_failed_get_host (
    +   const mongoc_apm_server_heartbeat_failed_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_t.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..641c68b78c12a66b99b91baca8e3d16f8172f569 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_failed_t.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_awaited.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_awaited.html new file mode 100644 index 0000000000000000000000000000000000000000..9ad5f77befc14e9e75e51999fb05d398fc492337 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_awaited.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_get_awaited() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_started_get_awaited()

    +
    +

    Synopsis

    +
    bool
    +mongoc_apm_server_heartbeat_started_get_awaited (
    +   const mongoc_apm_server_heartbeat_started_t *event);
    +
    +
    +

    Returns whether this event came from an awaitable hello.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bool indicating whether the heartbeat event came from an awaitable hello.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_context.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..315c37e8fa09af8074b764b6215b82b5bc9dcf4a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_host.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..c705061e242278dbad5f202f5919a5cf6700065d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_started_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_server_heartbeat_started_get_host (
    +   const mongoc_apm_server_heartbeat_started_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_t.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3d5e96b76e4bf13c248c2d76f97d53abad316e93 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_started_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_awaited.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_awaited.html new file mode 100644 index 0000000000000000000000000000000000000000..8fab5fd2c108d123e1ce5f524bc99849ae6f5e0c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_awaited.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_awaited() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_succeeded_get_awaited()

    +
    +

    Synopsis

    +
    bool
    +mongoc_apm_server_heartbeat_succeeded_get_awaited (
    +   const mongoc_apm_server_heartbeat_succeeded_t *event);
    +
    +
    +

    Returns whether this event came from an awaitable hello.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bool indicating whether the heartbeat event came from an awaitable hello.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_context.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..059be2b80c4c68429aa30e0909f1ce9d4d2d56b1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_duration.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..b655322862424e5e903d29c56f5b6c0e0d92551f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_duration() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_succeeded_get_duration()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_apm_server_heartbeat_succeeded_get_duration (
    +   const mongoc_apm_server_heartbeat_succeeded_t *event);
    +
    +
    +

    Returns this event’s duration in microseconds.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s duration.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_host.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..1803f894a5349e0620c8b5813321dfb44a111c5a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_succeeded_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_server_heartbeat_succeeded_get_host (
    +   const mongoc_apm_server_heartbeat_succeeded_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_reply.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..54904988f78445526794d699a2e10fdcdfbced40 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_get_reply.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_reply() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_succeeded_get_reply()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_apm_server_heartbeat_succeeded_get_reply (
    +   const mongoc_apm_server_heartbeat_succeeded_t *event);
    +
    +
    +

    Returns this event’s reply. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_t.html b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c81c81cfd32093e4324a38171464d8374561d4f9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_heartbeat_succeeded_t.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_opening_get_context.html b/libmongoc/1.24.0/mongoc_apm_server_opening_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..86fcecc531bf178dbe86089430bd1e4cf5029248 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_opening_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_opening_get_host.html b/libmongoc/1.24.0/mongoc_apm_server_opening_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..41633e3c2d7771b86f66d96785ee39fca9394913 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_opening_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_opening_get_host()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_apm_server_opening_get_host (const mongoc_apm_server_opening_t *event);
    +
    +
    +

    Returns this event’s host. This mongoc_host_list_t is not part of a linked list, it is solely the server for this event. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_host_list_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_opening_get_topology_id.html b/libmongoc/1.24.0/mongoc_apm_server_opening_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..9dafb58e34bae022721c54a4ac38f5a8ac2e4555 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_opening_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_get_topology_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_opening_get_topology_id()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_server_opening_get_topology_id (
    +   const mongoc_apm_server_opening_t *event, bson_oid_t *topology_id);
    +
    +
    +

    Returns this event’s topology id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s topology id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_server_opening_t.html b/libmongoc/1.24.0/mongoc_apm_server_opening_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1f5e497e356fbddeea3959442e454a3f2f0788ee --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_server_opening_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_command_failed_cb.html b/libmongoc/1.24.0/mongoc_apm_set_command_failed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..8b0bd5f8f0d67e3f99af5ee2816c423d1051b749 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_command_failed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_command_failed_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_command_failed_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_command_failed_cb_t) (
    +   const mongoc_apm_command_failed_t *event);
    +
    +void
    +mongoc_apm_set_command_failed_cb (mongoc_apm_callbacks_t *callbacks,
    +                                  mongoc_apm_command_failed_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver fails to execute a MongoDB operation.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_command_started_cb.html b/libmongoc/1.24.0/mongoc_apm_set_command_started_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..970927af893acdc25db5eb6de345fff766257c3d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_command_started_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_command_started_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_command_started_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_command_started_cb_t) (
    +   const mongoc_apm_command_started_t *event);
    +
    +void
    +mongoc_apm_set_command_started_cb (mongoc_apm_callbacks_t *callbacks,
    +                                   mongoc_apm_command_started_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver starts a MongoDB operation.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_command_succeeded_cb.html b/libmongoc/1.24.0/mongoc_apm_set_command_succeeded_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..fa683013597f288361626786bebaabcf11a8b73a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_command_succeeded_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_command_succeeded_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_command_succeeded_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_command_succeeded_cb_t) (
    +   const mongoc_apm_command_succeeded_t *event);
    +
    +void
    +mongoc_apm_set_command_succeeded_cb (mongoc_apm_callbacks_t *callbacks,
    +                                     mongoc_apm_command_succeeded_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver completes a MongoDB operation.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_server_changed_cb.html b/libmongoc/1.24.0/mongoc_apm_set_server_changed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..9da1a352f545d9833052035f6fa89b862af96094 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_server_changed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_changed_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_server_changed_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_server_changed_cb_t) (
    +   const mongoc_apm_server_changed_t *event);
    +
    +void
    +mongoc_apm_set_server_changed_cb (mongoc_apm_callbacks_t *callbacks,
    +                                  mongoc_apm_server_changed_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver observes a change in status of a server it is connected to.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_server_closed_cb.html b/libmongoc/1.24.0/mongoc_apm_set_server_closed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..02a6320bebee14f972db63648c84b7812a117ed4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_server_closed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_closed_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_server_closed_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_server_closed_cb_t) (
    +   const mongoc_apm_server_closed_t *event);
    +
    +void
    +mongoc_apm_set_server_closed_cb (mongoc_apm_callbacks_t *callbacks,
    +                                 mongoc_apm_server_closed_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver stops monitoring a server and removes its mongoc_server_description_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_failed_cb.html b/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_failed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..72f15487e33adaaafec6a1dec653ad58fcdcf6f3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_failed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_heartbeat_failed_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_server_heartbeat_failed_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_server_heartbeat_failed_cb_t) (
    +   const mongoc_apm_server_heartbeat_failed_t *event);
    +
    +void
    +mongoc_apm_set_server_heartbeat_failed_cb (mongoc_apm_callbacks_t *callbacks,
    +                                           mongoc_apm_server_heartbeat_failed_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver fails to send a “hello” command to check the status of a server.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_started_cb.html b/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_started_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..4a9b206bebe97ba334d0542ed3c6d3d1591f87ad --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_started_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_heartbeat_started_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_server_heartbeat_started_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_server_heartbeat_started_cb_t) (
    +   const mongoc_apm_server_heartbeat_started_t *event);
    +
    +void
    +mongoc_apm_set_server_heartbeat_started_cb (mongoc_apm_callbacks_t *callbacks,
    +                                            mongoc_apm_server_heartbeat_started_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver begins executing a “hello” command to check the status of a server.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_succeeded_cb.html b/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_succeeded_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..9c8cc1dee72949ba3c915e610b4664def847bf54 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_server_heartbeat_succeeded_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_heartbeat_succeeded_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_server_heartbeat_succeeded_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_server_heartbeat_succeeded_cb_t) (
    +   const mongoc_apm_server_heartbeat_succeeded_t *event);
    +
    +void
    +mongoc_apm_set_server_heartbeat_succeeded_cb (mongoc_apm_callbacks_t *callbacks,
    +                                              mongoc_apm_server_heartbeat_succeeded_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver completes a “hello” command to check the status of a server.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_server_opening_cb.html b/libmongoc/1.24.0/mongoc_apm_set_server_opening_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..573d822c963d1af6e6832e9bc6d239df6dd0f423 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_server_opening_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_opening_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_server_opening_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_server_opening_cb_t) (
    +   const mongoc_apm_server_opening_t *event);
    +
    +void
    +mongoc_apm_set_server_opening_cb (mongoc_apm_callbacks_t *callbacks,
    +                                  mongoc_apm_server_opening_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver adds a mongoc_server_description_t for a new server it was not monitoring before.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_topology_changed_cb.html b/libmongoc/1.24.0/mongoc_apm_set_topology_changed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..0a24371d7acfb39face80d94f5f91e13306d9011 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_topology_changed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_topology_changed_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_topology_changed_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_topology_changed_cb_t) (
    +   const mongoc_apm_topology_changed_t *event);
    +
    +void
    +mongoc_apm_set_topology_changed_cb (mongoc_apm_callbacks_t *callbacks,
    +                                    mongoc_apm_topology_changed_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver observes a change in any of the servers it is connected to or a change in the overall server topology.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_topology_closed_cb.html b/libmongoc/1.24.0/mongoc_apm_set_topology_closed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..a70eda78885dbd7eaae9083a450fd3b12596fd60 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_topology_closed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_topology_closed_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_topology_closed_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_topology_closed_cb_t) (
    +   const mongoc_apm_topology_closed_t *event);
    +
    +void
    +mongoc_apm_set_topology_closed_cb (mongoc_apm_callbacks_t *callbacks,
    +                                   mongoc_apm_topology_closed_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver stops monitoring a server topology and destroys its mongoc_topology_description_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_set_topology_opening_cb.html b/libmongoc/1.24.0/mongoc_apm_set_topology_opening_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..3bc659e41bfd04cdf4e36964bba42ccf44c14e2c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_set_topology_opening_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_topology_opening_cb() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_set_topology_opening_cb()

    +
    +

    Synopsis

    +
    typedef void (*mongoc_apm_topology_opening_cb_t) (
    +   const mongoc_apm_topology_opening_t *event);
    +
    +void
    +mongoc_apm_set_topology_opening_cb (mongoc_apm_callbacks_t *callbacks,
    +                                    mongoc_apm_topology_opening_cb_t cb);
    +
    +
    +

    Receive an event notification whenever the driver initializes a mongoc_topology_description_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_changed_get_context.html b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..8d5488395481db470112d758db77ffd964fe487f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_changed_get_new_description.html b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_new_description.html new file mode 100644 index 0000000000000000000000000000000000000000..25b24278615c95e4514433d32ed304052de92840 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_new_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_new_description() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_changed_get_new_description()

    +
    +

    Synopsis

    +
    const mongoc_topology_description_t *
    +mongoc_apm_topology_changed_get_new_description (
    +   const mongoc_apm_topology_changed_t *event);
    +
    +
    +

    Returns this event’s new description. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_topology_description_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_changed_get_previous_description.html b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_previous_description.html new file mode 100644 index 0000000000000000000000000000000000000000..bdd323e8ea61469dd4da915a0e739e33e466edff --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_previous_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_previous_description() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_changed_get_previous_description()

    +
    +

    Synopsis

    +
    const mongoc_topology_description_t *
    +mongoc_apm_topology_changed_get_previous_description (
    +   const mongoc_apm_topology_changed_t *event);
    +
    +
    +

    Returns this event’s previous description. The data is only valid in the scope of the callback that receives this event; copy it if it will be accessed after the callback returns.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_topology_description_t that should not be modified or freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_changed_get_topology_id.html b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..da7ed4488c84b52dc8b4c733e270e6e4861cda3d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_changed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_topology_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_changed_get_topology_id()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_topology_changed_get_topology_id (
    +   const mongoc_apm_topology_changed_t *event, bson_oid_t *topology_id);
    +
    +
    +

    Returns this event’s topology id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s topology id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_changed_t.html b/libmongoc/1.24.0/mongoc_apm_topology_changed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..0dab17cb725c51c43b1512a4f4dde3cfeaa4cbc1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_changed_t.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_closed_get_context.html b/libmongoc/1.24.0/mongoc_apm_topology_closed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..fb534ad8d39ad0539aed4c080c19676cb3985ddd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_closed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_closed_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_closed_get_topology_id.html b/libmongoc/1.24.0/mongoc_apm_topology_closed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..63438898a6d41a973ef9a15016dc76ef2933237c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_closed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_topology_closed_get_topology_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_closed_get_topology_id()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_topology_closed_get_topology_id (
    +   const mongoc_apm_topology_closed_t *event, bson_oid_t *topology_id);
    +
    +
    +

    Returns this event’s topology id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s topology id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_closed_t.html b/libmongoc/1.24.0/mongoc_apm_topology_closed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..0acae18cde5598d18efd5195e9ea8afc4680c074 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_closed_t.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + mongoc_apm_topology_closed_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_opening_get_context.html b/libmongoc/1.24.0/mongoc_apm_topology_opening_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..e7260f59a1ee4aa8990d2e607419bfbfa6d7b9da --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_opening_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_opening_get_context() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_opening_get_topology_id.html b/libmongoc/1.24.0/mongoc_apm_topology_opening_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..10508a8d9e25f527af3111a162eb9c7300e08d23 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_opening_get_topology_id.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_topology_opening_get_topology_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_opening_get_topology_id()

    +
    +

    Synopsis

    +
    void
    +mongoc_apm_topology_opening_get_topology_id (
    +   const mongoc_apm_topology_opening_t *event, bson_oid_t *topology_id);
    +
    +
    +

    Returns this event’s topology id.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The event’s topology id.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_apm_topology_opening_t.html b/libmongoc/1.24.0/mongoc_apm_topology_opening_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3130f6577a037a274b5161ce7b74221018531c3d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_apm_topology_opening_t.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + mongoc_apm_topology_opening_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_destroy.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..1a124c16d3791d0c3c0016cc625ac295fc1719d8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_destroy.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_destroy (mongoc_auto_encryption_opts_t *opts);
    +
    +
    +

    Destroy a mongoc_auto_encryption_opts_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_new.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..90a81938c94628f05acfcfba846a90fc73f45e2d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_new.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_new()

    +
    +

    Synopsis

    +
    mongoc_auto_encryption_opts_t *
    +mongoc_auto_encryption_opts_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a new mongoc_auto_encryption_opts_t.

    +

    Caller must set the required options:

    + +

    Caller may set optionally set the following:

    + +

    This options struct is used to enable auto encryption with mongoc_client_enable_auto_encryption().

    +
    +
    +

    Returns

    +

    A new mongoc_auto_encryption_opts_t, which must be destroyed with mongoc_auto_encryption_opts_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..348a8c1e44a5bac11e060b799028e10c3a86fb61 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_bypass_auto_encryption() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_bypass_auto_encryption()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_bypass_auto_encryption (
    +   mongoc_auto_encryption_opts_t *opts, bool bypass_auto_encryption);
    +
    +
    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_bypass_query_analysis.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_bypass_query_analysis.html new file mode 100644 index 0000000000000000000000000000000000000000..cca53dadce73a43295acfafe6d01cc1a5e06f632 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_bypass_query_analysis.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_bypass_query_analysis() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_bypass_query_analysis()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_bypass_query_analysis (
    +   mongoc_auto_encryption_opts_t *opts, bool bypass_query_analysis);
    +
    +
    +
    +

    New in version 1.22.0.

    +
    +
    +
    +

    Parameters

    + +

    bypass_query_analysis disables automatic analysis of outgoing commands. +bypass_query_analysis is useful for encrypting indexed fields without the +crypt_shared library or mongocryptd process. Set +bypass_query_analysis to true to use explicit encryption on indexed fields.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_encrypted_fields_map.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_encrypted_fields_map.html new file mode 100644 index 0000000000000000000000000000000000000000..0c6304aecebcd0d102c9f4758722d93005b94e21 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_encrypted_fields_map.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_encrypted_fields_map() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_encrypted_fields_map()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_encrypted_fields_map (
    +   mongoc_auto_encryption_opts_t *opts, const bson_t *encrypted_fields_map);
    +
    +
    +
    +

    New in version 1.22.0.

    +
    +
    +
    +

    Parameters

    + +

    Supplying an encrypted_fields_map provides more security than relying on an encryptedFields obtained from the server. It protects against a malicious server advertising a false encryptedFields.

    +

    The schema map does not apply to collections encrypted with: Client-Side Field Level Encryption. See mongoc_auto_encryption_opts_set_schema_map() instead.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_extra.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_extra.html new file mode 100644 index 0000000000000000000000000000000000000000..04bea31b63e3fc050d6cd6e5c661a28c39406ed2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_extra.html @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_extra() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_extra()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_extra (mongoc_auto_encryption_opts_t *opts,
    +                                       const bson_t *extra);
    +
    +
    +
    +
    +

    Parameters

    + +

    extra is a bson_t containing any of the following optional fields:

    +
      +
    • mongocryptdURI set to a URI to connect to the mongocryptd process (default is “mongodb://localhost:27020”).

    • +
    • mongocryptdBypassSpawn set to true to prevent the driver from spawning the mongocryptd process (default behavior is to spawn).

    • +
    • mongocryptdSpawnPath set to a path (with trailing slash) to search for mongocryptd (defaults to empty string and uses default system paths).

    • +
    • mongocryptdSpawnArgs set to an array of string arguments to pass to mongocryptd when spawning (defaults to [ "--idleShutdownTimeoutSecs=60" ]).

    • +
    • cryptSharedLibPath - Set a filepath string referring to a crypt_shared +library file. Unset by default.

      +
        +
      • If not set (the default), libmongocrypt will attempt to load +crypt_shared using the host system’s default dynamic-library-search +system.

      • +
      • If set, the given path should identify the crypt_shared dynamic library +file itself, not the directory that contains it.

      • +
      • If the given path is a relative path and the first path component is +$ORIGIN, the $ORIGIN component will be replaced with the absolute +path to the directory containing the libmongocrypt library in use by the +application.

        +
        +

        Note

        +

        No other RPATH/RUNPATH-style substitutions are available.

        +
        +
      • +
      • If the given path is a relative path, the path will be resolved relative to +the working directory of the operating system process.

      • +
      • If this option is set and libmongocrypt fails to load crypt_shared from the +given filepath, libmongocrypt will fail to initialize and will not +attempt to search for crypt_shared in any other locations.

      • +
      +
    • +
    • cryptSharedLibRequired - If set to true, and libmongocrypt fails +to load a crypt_shared library, initialization of auto-encryption will +fail immediately and will not attempt to spawn mongocryptd.

      +

      If set to false (the default), cryptSharedLibPath is not set, and +libmongocrypt fails to load crypt_shared, then libmongocrypt will +proceed without crypt_shared and fall back to using mongocryptd.

      +
    • +
    +
    +

    See also

    + + +
    +
    MongoDB Manual documentation for crypt_shared: Automatic Encryption Shared Library
    +
    +
    +
    MongoDB Manual documentation for mongocryptd: Install and Configure mongocryptd
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_client.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_client.html new file mode 100644 index 0000000000000000000000000000000000000000..8b8f7a0f263bd830e1eb6661278e50f622533778 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_client.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_keyvault_client() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_keyvault_client()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_keyvault_client (
    +   mongoc_auto_encryption_opts_t *opts, mongoc_client_t *client);
    +
    +
    +

    Set an optional separate mongoc_client_t to use during key lookup for automatic encryption and decryption. Only applies to automatic encryption on a single-threaded mongoc_client_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_client_pool.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_client_pool.html new file mode 100644 index 0000000000000000000000000000000000000000..c1779a35960cc959ec68bc4fb19ea446538fd9a4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_client_pool.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_keyvault_client_pool() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_keyvault_client_pool()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_keyvault_client_pool (
    +   mongoc_auto_encryption_opts_t *opts, mongoc_client_pool_t *pool);
    +
    +
    +

    Set an optional separate mongoc_client_pool_t to use during key lookup for automatic encryption and decryption. Only applies to automatic encryption on a mongoc_client_pool_t. It is invalid to set this for automatic encryption on a single-threaded mongoc_client_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_namespace.html new file mode 100644 index 0000000000000000000000000000000000000000..a10009cd632c6bc175ba082634fd6cbf03283a37 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_keyvault_namespace.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_keyvault_namespace() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_keyvault_namespace()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_keyvault_namespace (
    +   mongoc_auto_encryption_opts_t *opts, const char *db, const char *coll);
    +
    +
    +

    Set the database and collection name of the key vault. The key vault is the specially designated collection containing encrypted data keys for In-Use Encryption.

    +
    +
    +

    Parameters

    +
      +
    • opts: The mongoc_auto_encryption_opts_t

    • +
    • db: A const char * representing the database name of the key vault collection.

    • +
    • coll: A const char * representing the collection name of the key vault collection.

    • +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html new file mode 100644 index 0000000000000000000000000000000000000000..fda6d7509a0fa24d7ac0b9f8eef0583ac52f8fc0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_kms_credential_provider_callback() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_kms_credential_provider_callback()

    +
    +

    New in version 1.23.0.

    +
    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_kms_credential_provider_callback(
    +  mongoc_auto_encryption_opts_t *opts,
    +  mongoc_kms_credentials_provider_callback_fn fn,
    +  void *userdata);
    +
    +
    +

    Set the user-provided callback to provide KMS credentials on-demand when they +are needed.

    +
    +
    +

    Parameters

    +
      +
    • opts - The options object to update.

    • +
    • fn - The provider callback to set on the options object. May be NULL +to clear the callback. Refer to: +mongoc_kms_credentials_provider_callback_fn

    • +
    • userdata - An arbitrary pointer that will be passed along to the +callback function when it is called by libmongoc.

    • +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_kms_providers.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_kms_providers.html new file mode 100644 index 0000000000000000000000000000000000000000..da3a4e8ecbcd7e6fd00e20aea523f6a43324f63e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_kms_providers.html @@ -0,0 +1,245 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_kms_providers() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_kms_providers()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_kms_providers (
    +   mongoc_auto_encryption_opts_t *opts, const bson_t *kms_providers);
    +
    +
    +
    +
    +

    Parameters

    + +

    kms_providers is a BSON document containing configuration for each KMS provider. Currently aws, local, azure, gcp, and kmip are supported. At least one must be specified.

    +

    The format for “aws” is as follows:

    +
    aws: {
    +   accessKeyId: String,
    +   secretAccessKey: String
    +}
    +
    +
    +

    The format for “local” is as follows:

    +
    local: {
    +   key: <96 byte BSON binary of subtype 0> or String /* The master key used to encrypt/decrypt data keys. May be passed as a base64 encoded string. */
    +}
    +
    +
    +

    The format for “azure” is as follows:

    +
    azure: {
    +   tenantId: String,
    +   clientId: String,
    +   clientSecret: String,
    +   identityPlatformEndpoint: Optional<String> /* Defaults to login.microsoftonline.com */
    +}
    +
    +
    +

    The format for “gcp” is as follows:

    +
    gcp: {
    +   email: String,
    +   privateKey: byte[] or String, /* May be passed as a base64 encoded string. */
    +   endpoint: Optional<String> /* Defaults to oauth2.googleapis.com */
    +}
    +
    +
    +

    The format for “kmip” is as follows:

    +
    kmip: {
    +   endpoint: String
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_schema_map.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_schema_map.html new file mode 100644 index 0000000000000000000000000000000000000000..b935d138e7b9729d617a04d09b9640b6ce36c948 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_schema_map.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_schema_map() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_schema_map()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_schema_map (mongoc_auto_encryption_opts_t *opts,
    +                                            const bson_t *schema_map);
    +
    +
    +
    +
    +

    Parameters

    + +

    Supplying a schema map provides more security than relying on JSON Schemas obtained from the server. It protects against a malicious server advertising a false JSON Schema, which could trick the client into sending unencrypted data that should be encrypted.

    +

    Schemas supplied in the schema map only apply to configuring automatic encryption for Client-Side Field Level Encryption. Other validation rules in the JSON schema will not be enforced by the driver and will result in an error.

    +

    The following is an example of a schema map which configures automatic encryption for the collection db.coll:

    +
    {
    +     "db.coll": {
    +         "properties": {
    +         "encrypted_string": {
    +             "encrypt": {
    +             "keyId": [
    +                 {
    +                 "$binary": {
    +                     "base64": "AAAAAAAAAAAAAAAAAAAAAA==",
    +                     "subType": "04"
    +                 }
    +                 }
    +             ],
    +             "bsonType": "string",
    +             "algorithm": "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
    +             }
    +         }
    +         },
    +         "bsonType": "object"
    +     }
    + }
    +
    +
    +

    The schema map does not apply to collections encrypted with: Queryable Encryption. Use mongoc_auto_encryption_opts_set_encrypted_fields_map() instead.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_tls_opts.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_tls_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4757347cf63a1a5810bae469ab0d406d058019dc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_set_tls_opts.html @@ -0,0 +1,237 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_tls_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_set_tls_opts()

    +
    +

    Synopsis

    +
    void
    +mongoc_auto_encryption_opts_set_tls_opts (
    +   mongoc_auto_encryption_opts_t *opts, const bson_t *tls_opts);
    +
    +
    +
    +
    +

    Parameters

    + +

    tls_opts is a BSON document of the following form:

    +
    <KMS provider name>: {
    +   tlsCaFile: Optional<String>
    +   tlsCertificateKeyFile: Optional<String>
    +   tlsCertificateKeyFilePassword: Optional<String>
    +}
    +
    +
    +

    The KMS providers aws, azure, gcp, and kmip are supported as keys in the tls_opts document.

    +

    tls_opts maps the KMS provider name to a BSON document for TLS options.

    +

    The BSON document for TLS options may contain the following keys:

    +
      +
    • MONGOC_URI_TLSCERTIFICATEKEYFILE

    • +
    • MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD

    • +
    • MONGOC_URI_TLSCAFILE

    • +
    +
    +
    Example use
    +
    mongoc_auto_encryption_opts_t *ae_opts =
    +   mongoc_auto_encryption_opts_new ();
    +bson_t *tls_opts = bson_new ();
    +
    +BCON_APPEND (tls_opts, "kmip", "{", MONGOC_URI_TLSCAFILE, "ca1.pem", "}");
    +BCON_APPEND (tls_opts, "aws", "{", MONGOC_URI_TLSCAFILE, "ca2.pem", "}");
    +mongoc_auto_encryption_opts_set_tls_opts (ae_opts, tls_opts);
    +
    +
    +
    +

    See Configuring TLS for a description of the behavior of these options.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_auto_encryption_opts_t.html b/libmongoc/1.24.0/mongoc_auto_encryption_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b1389c76532aa15e7721148467a820d808314cca --- /dev/null +++ b/libmongoc/1.24.0/mongoc_auto_encryption_opts_t.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_delete.html b/libmongoc/1.24.0/mongoc_bulk_operation_delete.html new file mode 100644 index 0000000000000000000000000000000000000000..d873eb5aa73617b9ff3a3873d6a550f7bda8eceb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_delete.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_delete() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_delete()

    +
    +

    Warning

    +
    +

    Deprecated since version 0.96.0.

    +
    +

    This function is deprecated and should not be used in new code.

    +

    Please use mongoc_bulk_operation_remove() in new code.

    +
    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_delete (mongoc_bulk_operation_t *bulk,
    +                              const bson_t *selector)
    +  BSON_GNUC_DEPRECATED_FOR (mongoc_bulk_operation_remove);
    +
    +
    +

    Deletes documents as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_delete_one.html b/libmongoc/1.24.0/mongoc_bulk_operation_delete_one.html new file mode 100644 index 0000000000000000000000000000000000000000..73cc0a816e5b154b94f85d5501974d9a420a12a6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_delete_one.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_delete_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_delete_one()

    +
    +

    Warning

    +
    +

    Deprecated since version 0.96.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_bulk_operation_remove_one() in new code.

    +
    +
    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_delete_one (mongoc_bulk_operation_t *bulk,
    +                                  const bson_t *selector)
    +  BSON_GNUC_DEPRECATED_FOR (mongoc_bulk_operation_remove_one);
    +
    +
    +

    Delete a single document as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_destroy.html b/libmongoc/1.24.0/mongoc_bulk_operation_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..e5adb98a20f8c1bc9fdf0e6301fc0d7ca65835ef --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_destroy (mongoc_bulk_operation_t *bulk);
    +
    +
    +

    Destroys a mongoc_bulk_operation_t and frees the structure. Does nothing if bulk is NULL.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_execute.html b/libmongoc/1.24.0/mongoc_bulk_operation_execute.html new file mode 100644 index 0000000000000000000000000000000000000000..b564b25d36136c022008e4a640f6677ab7c19221 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_execute.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_execute() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_execute()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk,
    +                               bson_t *reply,
    +                               bson_error_t *error);
    +
    +
    +

    This function executes all operations queued into the bulk operation. Unless ordered: false was specified in the opts passed to mongoc_collection_create_bulk_operation_with_opts(), then forward progress will be stopped upon the first error.

    +

    It is only valid to call mongoc_bulk_operation_execute() once. The mongoc_bulk_operation_t must be destroyed afterwards.

    +
    +

    Warning

    +

    reply is always initialized, even upon failure. Callers must call bson_destroy() to release this potential allocation.

    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    On success, returns the server id used. On failure, returns 0 and sets error.

    +

    A write concern timeout or write concern error is considered a failure.

    +

    The reply document counts operations and collects error information. See Bulk Write Operations for examples.

    +
    +

    See also

    + +
    +
    mongoc_bulk_operation_get_hint(), which gets the id of the server used even if the operation failed.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_get_hint.html b/libmongoc/1.24.0/mongoc_bulk_operation_get_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..47bf313e5b423e33bb36127c849feacd05f46dee --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_get_hint.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_get_hint() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_get_hint()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_bulk_operation_get_hint (const mongoc_bulk_operation_t *bulk);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieves the opaque id of the server used for the operation.

    +

    (The function name includes the old term “hint” for the sake of backward compatibility, but we now call this number a “server id”.)

    +

    This number is zero until the driver actually uses a server in mongoc_bulk_operation_execute(). The server id is the same number as the return value of a successful mongoc_bulk_operation_execute(), so mongoc_bulk_operation_get_hint is useful mainly in case mongoc_bulk_operation_execute() fails and returns zero.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_get_write_concern.html b/libmongoc/1.24.0/mongoc_bulk_operation_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..5a0c3eba889e323e5df461bb858726ad7c1cbc7a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_get_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_get_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_get_write_concern()

    +
    +

    Synopsis

    +
    const mongoc_write_concern_t *
    +mongoc_bulk_operation_get_write_concern (const mongoc_bulk_operation_t *bulk);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the write concern to be used for bulk.

    +
    +
    +

    Returns

    +

    A mongoc_write_concern_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_insert.html b/libmongoc/1.24.0/mongoc_bulk_operation_insert.html new file mode 100644 index 0000000000000000000000000000000000000000..9dc383ec9c3b2911677a7a4856bf15f25d05fce0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_insert.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_insert() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_insert()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_insert (mongoc_bulk_operation_t *bulk,
    +                              const bson_t *document);
    +
    +
    +

    Queue an insert of a single document into a bulk operation. The insert is not performed until mongoc_bulk_operation_execute() is called.

    +

    This function is superseded by mongoc_bulk_operation_insert_with_opts().

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_insert_with_opts.html b/libmongoc/1.24.0/mongoc_bulk_operation_insert_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..afa5f37be86a3c9105451a7523a3a9c794a2ff9e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_insert_with_opts.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_insert_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_insert_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_bulk_operation_insert_with_opts (mongoc_bulk_operation_t *bulk,
    +                                        const bson_t *document,
    +                                        const bson_t *opts,
    +                                        bson_error_t *error); /* OUT */
    +
    +
    +

    Queue an insert of a single document into a bulk operation. The insert is not performed until mongoc_bulk_operation_execute() is called.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • validate: Construct a bitwise-or of all desired bson_validate_flags_t. Set to false to skip client-side validation of the provided BSON documents.

    • +
    +
    +
    +

    Errors

    +

    Operation errors are propagated via mongoc_bulk_operation_execute(), while argument validation errors are reported by the error argument.

    +
    +
    +

    Returns

    +

    Returns true on success, and false if passed invalid arguments.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_remove.html b/libmongoc/1.24.0/mongoc_bulk_operation_remove.html new file mode 100644 index 0000000000000000000000000000000000000000..36339b20c7c0a76b7750116012e5941fdde9d3db --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_remove.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_remove()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_remove (mongoc_bulk_operation_t *bulk,
    +                              const bson_t *selector);
    +
    +
    +

    Remove documents as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +

    This function is superseded by mongoc_bulk_operation_remove_one_with_opts() and mongoc_bulk_operation_remove_many_with_opts().

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_remove_many_with_opts.html b/libmongoc/1.24.0/mongoc_bulk_operation_remove_many_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..90797211b14ea4cf9873786273fb3b5d03cf85a0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_remove_many_with_opts.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove_many_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_remove_many_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_bulk_operation_remove_many_with_opts (mongoc_bulk_operation_t *bulk,
    +                                             const bson_t *selector,
    +                                             const bson_t *opts,
    +                                             bson_error_t *error); /* OUT */
    +
    +
    +

    Delete documents as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Errors

    +

    Operation errors are propagated via mongoc_bulk_operation_execute(), while argument validation errors are reported by the error argument.

    +
    +
    +

    Returns

    +

    Returns true on success, and false if passed invalid arguments.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_remove_one.html b/libmongoc/1.24.0/mongoc_bulk_operation_remove_one.html new file mode 100644 index 0000000000000000000000000000000000000000..86369075b9eba89412aa021ef8118b20a10d37c8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_remove_one.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_remove_one()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_remove_one (mongoc_bulk_operation_t *bulk,
    +                                  const bson_t *selector);
    +
    +
    +

    Remove a single document as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +

    This function is superseded by mongoc_bulk_operation_remove_one_with_opts().

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_remove_one_with_opts.html b/libmongoc/1.24.0/mongoc_bulk_operation_remove_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..81981b04d90a79ebae2abab1d324abf84e2655fc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_remove_one_with_opts.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove_one_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_remove_one_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_bulk_operation_remove_one_with_opts (mongoc_bulk_operation_t *bulk,
    +                                            const bson_t *selector,
    +                                            const bson_t *opts,
    +                                            bson_error_t *error); /* OUT */
    +
    +
    +

    Remove a single document as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Errors

    +

    Operation errors are propagated via mongoc_bulk_operation_execute(), while argument validation errors are reported by the error argument.

    +
    +
    +

    Returns

    +

    Returns true on success, and false if passed invalid arguments.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_replace_one.html b/libmongoc/1.24.0/mongoc_bulk_operation_replace_one.html new file mode 100644 index 0000000000000000000000000000000000000000..b09afe36b6405f3ff04cfa32ab01a940963d1df8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_replace_one.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_replace_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_replace_one()

    +
    +

    Synopsis

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

    Replace a single document as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +

    This function is superseded by mongoc_bulk_operation_replace_one_with_opts().

    +
    +
    +

    Parameters

    +
      +
    • bulk: A mongoc_bulk_operation_t.

    • +
    • selector: A bson_t that selects which document to remove.

    • +
    • document: A bson_t containing the replacement document.

    • +
    • upsert: true if this should be an upsert.

    • +
    +
    +

    Warning

    +

    document may not contain fields with keys containing . or $.

    +
    +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_replace_one_with_opts.html b/libmongoc/1.24.0/mongoc_bulk_operation_replace_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a7726d86f20008c8cfc8c3f955bb3e74bc2314ab --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_replace_one_with_opts.html @@ -0,0 +1,233 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_replace_one_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_replace_one_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_bulk_operation_replace_one_with_opts (mongoc_bulk_operation_t *bulk,
    +                                             const bson_t *selector,
    +                                             const bson_t *document,
    +                                             const bson_t *opts,
    +                                             bson_error_t *error); /* OUT */
    +
    +
    +

    Replace a single document as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute().

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • validate: Construct a bitwise-or of all desired bson_validate_flags_t. Set to false to skip client-side validation of the provided BSON documents.

    • +
    • collation: Configure textual comparisons. See Setting Collation Order, and the MongoDB Manual entry on Collation. Collation requires MongoDB 3.2 or later, otherwise an error is returned.

    • +
    • hint: A document or string that specifies the index to use to support the query predicate.

    • +
    • upsert: If true, insert a document if none match selector.

    • +
    +
    +

    Warning

    +

    document may not contain fields with keys containing . or $.

    +
    +
    +
    +

    Errors

    +

    Operation errors are propagated via mongoc_bulk_operation_execute(), while argument validation errors are reported by the error argument.

    +
    +
    +

    Returns

    +

    Returns true on success, and false if passed invalid arguments.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_set_bypass_document_validation.html b/libmongoc/1.24.0/mongoc_bulk_operation_set_bypass_document_validation.html new file mode 100644 index 0000000000000000000000000000000000000000..80a69670a54f7f04f899dea66e901847fe26d452 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_set_bypass_document_validation.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_bypass_document_validation() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_set_bypass_document_validation()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_set_bypass_document_validation (
    +   mongoc_bulk_operation_t *bulk, bool bypass);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Will bypass document validation for all operations part of this bulk.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_set_client_session.html b/libmongoc/1.24.0/mongoc_bulk_operation_set_client_session.html new file mode 100644 index 0000000000000000000000000000000000000000..9febd33bee6ce0d78085222d28b7699a9d178c9b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_set_client_session.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_client_session() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_set_client_session()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_set_client_session (
    +  mongoc_bulk_operation_t *bulk,
    +  mongoc_client_session_t *client_session);
    +
    +
    +

    Sets an explicit client session to use for the bulk operation.

    +

    It is an error to use a session for unacknowledged writes.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_set_comment.html b/libmongoc/1.24.0/mongoc_bulk_operation_set_comment.html new file mode 100644 index 0000000000000000000000000000000000000000..8509062314484d4c048b97755f3a4ba242de358a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_set_comment.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_comment() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_set_comment()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_set_comment (
    +   mongoc_bulk_operation_t *bulk, const bson_value_t *comment);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Assigns a comment to attach to all commands executed as part of this bulk. The comment will appear in log messages, profiler output, and currentOp output. Comments for write commands are only supported by MongoDB 4.4+.

    +

    It is prohibited to call this function after adding operations to the bulk.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_set_hint.html b/libmongoc/1.24.0/mongoc_bulk_operation_set_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..26621007022eddaac4a4108d6261c69183aed8a9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_set_hint.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_hint() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_set_hint()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_set_hint (const mongoc_bulk_operation_t *bulk,
    +                                uint32_t server_id);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Specifies which server to use for the operation. This function has an effect only if called before mongoc_bulk_operation_execute().

    +

    (The function name includes the old term “hint” for the sake of backward compatibility, but we now call this number a “server id”.)

    +

    Use mongoc_bulk_operation_set_hint only for building a language driver that wraps the C Driver. When writing applications in C, leave the server id unset and allow the driver to choose a suitable server for the bulk operation.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_set_let.html b/libmongoc/1.24.0/mongoc_bulk_operation_set_let.html new file mode 100644 index 0000000000000000000000000000000000000000..ca22218de45143248a57f32055e85fb6f848bfa4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_set_let.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_let() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_set_let()

    +
    +

    Synopsis

    +
    void
    +mongoc_bulk_operation_set_let (
    +   mongoc_bulk_operation_t *bulk, const bson_t *let);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • bulk: A mongoc_bulk_operation_t.

    • +
    • let: A BSON document consisting of any number of parameter names, each followed by definitions of constants in the MQL Aggregate Expression language.

    • +
    +
    +
    +

    Description

    +

    Defines constants that can be accessed by all update, replace, and delete operations executed as part of this bulk.

    +

    It is prohibited to call this function after adding operations to the bulk.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_t.html b/libmongoc/1.24.0/mongoc_bulk_operation_t.html new file mode 100644 index 0000000000000000000000000000000000000000..86685f58f24ee28d4626d86b47ff327878beff83 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_t.html @@ -0,0 +1,232 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_t

    +

    Bulk Write Operations

    +
    +

    Synopsis

    +
    typedef struct _mongoc_bulk_operation_t mongoc_bulk_operation_t;
    +
    +
    +

    The opaque type mongoc_bulk_operation_t provides an abstraction for submitting multiple write operations as a single batch.

    +

    After adding all of the write operations to the mongoc_bulk_operation_t, call mongoc_bulk_operation_execute() to execute the operation.

    +
    +

    Warning

    +

    It is only valid to call mongoc_bulk_operation_execute() once. The mongoc_bulk_operation_t must be destroyed afterwards.

    +
    +
    +

    See also

    + +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_update.html b/libmongoc/1.24.0/mongoc_bulk_operation_update.html new file mode 100644 index 0000000000000000000000000000000000000000..eeadc9528f9934703871c1e09ddab481dd1276b6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_update.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_update()

    +
    +

    Synopsis

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

    This function queues an update as part of a bulk operation. This does not execute the operation. To execute the entirety of the bulk operation call mongoc_bulk_operation_execute().

    +

    document MUST only contain fields whose key starts with $. See the update document specification for more details.

    +

    This function is superseded by mongoc_bulk_operation_update_one_with_opts() and mongoc_bulk_operation_update_many_with_opts().

    +
    +
    +

    Parameters

    +
      +
    • bulk: A mongoc_bulk_operation_t.

    • +
    • selector: A bson_t that selects which documents to remove.

    • +
    • document: A bson_t containing the update document.

    • +
    • upsert: true if an upsert should be performed.

    • +
    +
    +
    +

    Errors

    +

    Errors are propagated via mongoc_bulk_operation_execute().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_update_many_with_opts.html b/libmongoc/1.24.0/mongoc_bulk_operation_update_many_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..9591e0adcd79f01c866d6c1e1db23cbcad2daff4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_update_many_with_opts.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update_many_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_update_many_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_bulk_operation_update_many_with_opts (mongoc_bulk_operation_t *bulk,
    +                                             const bson_t *selector,
    +                                             const bson_t *document,
    +                                             const bson_t *opts,
    +                                             bson_error_t *error); /* OUT */
    +
    +
    +

    This function queues an update as part of a bulk operation. This does not execute the operation. To execute the entirety of the bulk operation call mongoc_bulk_operation_execute().

    +
    +

    Warning

    +

    document MUST only contain fields whose key starts with $. See the update document specification for more details.

    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • validate: Construct a bitwise-or of all desired bson_validate_flags_t. Set to false to skip client-side validation of the provided BSON documents.

    • +
    • collation: Configure textual comparisons. See Setting Collation Order, and the MongoDB Manual entry on Collation. Collation requires MongoDB 3.2 or later, otherwise an error is returned.

    • +
    • hint: A document or string that specifies the index to use to support the query predicate.

    • +
    • upsert: If true, insert a document if none match selector.

    • +
    • arrayFilters: An array of filters specifying to which array elements an update should apply.

    • +
    +
    +
    +

    Errors

    +

    Operation errors are propagated via mongoc_bulk_operation_execute(), while argument validation errors are reported by the error argument.

    +
    +
    +

    Returns

    +

    Returns true on success, and false if there is a server or network error or if passed invalid arguments.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_update_one.html b/libmongoc/1.24.0/mongoc_bulk_operation_update_one.html new file mode 100644 index 0000000000000000000000000000000000000000..c3298a0714b645e6b829dcad35ce66ac4a5e638c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_update_one.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_update_one()

    +
    +

    Synopsis

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

    This function queues an update as part of a bulk operation. It will only modify a single document on the MongoDB server. This function does not execute the operation. To execute the entirety of the bulk operation call mongoc_bulk_operation_execute().

    +

    This function is superseded by mongoc_bulk_operation_update_one_with_opts().

    +
    +
    +

    Parameters

    +
      +
    • bulk: A mongoc_bulk_operation_t.

    • +
    • selector: A bson_t that selects which document to remove.

    • +
    • document: A bson_t containing the update document.

    • +
    • upsert: true if an upsert should be performed.

    • +
    +
    +

    Warning

    +

    document must only contain fields whose key starts with $. See the update document specification for more details.

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_bulk_operation_update_one_with_opts.html b/libmongoc/1.24.0/mongoc_bulk_operation_update_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..373a7f61b4ed8c18fb25acb8f2168b29c7363200 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_bulk_operation_update_one_with_opts.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update_one_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_bulk_operation_update_one_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_bulk_operation_update_one_with_opts (mongoc_bulk_operation_t *bulk,
    +                                            const bson_t *selector,
    +                                            const bson_t *document,
    +                                            const bson_t *opts,
    +                                            bson_error_t *error); /* OUT */
    +
    +
    +

    This function queues an update as part of a bulk operation. It will only modify a single document on the MongoDB server. This function does not execute the operation. To execute the entirety of the bulk operation call mongoc_bulk_operation_execute().

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • validate: Construct a bitwise-or of all desired bson_validate_flags_t. Set to false to skip client-side validation of the provided BSON documents.

    • +
    • collation: Configure textual comparisons. See Setting Collation Order, and the MongoDB Manual entry on Collation. Collation requires MongoDB 3.2 or later, otherwise an error is returned.

    • +
    • hint: A document or string that specifies the index to use to support the query predicate.

    • +
    • upsert: If true, insert a document if none match selector.

    • +
    • arrayFilters: An array of filters specifying to which array elements an update should apply.

    • +
    +
    +

    Warning

    +

    document must only contain fields whose key starts with $. See the update document specification for more details.

    +
    +
    +
    +

    Errors

    +

    Operation errors are propagated via mongoc_bulk_operation_execute(), while argument validation errors are reported by the error argument.

    +
    +
    +

    Returns

    +

    Returns true on success, and false if there is a server or network error or if passed invalid arguments.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_change_stream_destroy.html b/libmongoc/1.24.0/mongoc_change_stream_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..4d62cedc8bd8ffedb58ebce601c9eec002721c25 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_change_stream_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_change_stream_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_change_stream_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_change_stream_destroy (mongoc_change_stream_t *stream);
    +
    +
    +

    Destroys a change stream and associated data.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_change_stream_error_document.html b/libmongoc/1.24.0/mongoc_change_stream_error_document.html new file mode 100644 index 0000000000000000000000000000000000000000..ca40f18136037655f6e3616a661bd06d37d6b5d4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_change_stream_error_document.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_change_stream_error_document() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_change_stream_error_document()

    +
    +

    Synopsis

    +
    bool
    +mongoc_change_stream_error_document (mongoc_change_stream_t *stream,
    +                                     bson_error_t *err,
    +                                     const bson_t **reply);
    +
    +
    +

    Checks if an error has occurred when creating or iterating over a change stream.

    +

    Similar to mongoc_cursor_error_document() if the error has occurred +client-side then the reply will be set to an empty BSON document. If the +error occurred server-side, reply is set to the server’s reply document.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A boolean indicating if there was an error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_change_stream_get_resume_token.html b/libmongoc/1.24.0/mongoc_change_stream_get_resume_token.html new file mode 100644 index 0000000000000000000000000000000000000000..4bc663face8636fd331178308152eff865814bc4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_change_stream_get_resume_token.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_change_stream_get_resume_token() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_change_stream_get_resume_token()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_change_stream_get_resume_token (mongoc_change_stream_t *stream);
    +
    +
    +

    This function returns the cached resume token, which may be passed as either the +resumeAfter or startAfter option of a watch function to start a new +change stream from the same point.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed.

    +

    Returns NULL if no resume token is available. This is possible if the change +stream has not been iterated and neither resumeAfter nor startAfter +options were specified in the watch function.

    +
    +
    +

    Lifecycle

    +

    The returned bson_t is valid for the lifetime of stream and +its data may be updated if mongoc_change_stream_next() is called after +this function. The value may be copied to extend its lifetime or preserve the +current resume token.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_change_stream_next.html b/libmongoc/1.24.0/mongoc_change_stream_next.html new file mode 100644 index 0000000000000000000000000000000000000000..9e3e52743fe0c5e3d1a6be98133b04a96f1b1930 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_change_stream_next.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_change_stream_next() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_change_stream_next()

    +
    +

    Synopsis

    +
    bool
    +mongoc_change_stream_next (mongoc_change_stream_t *stream,
    +                           const bson_t **bson);
    +
    +
    +

    This function iterates the underlying cursor, setting bson to the next +document. This will block for a maximum of maxAwaitTimeMS milliseconds as +specified in the options when created, or the default timeout if omitted. Data +may be returned before the timeout. If no data is returned this function returns +false.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    This function returns true if a valid bson document was read from the stream. +Otherwise, false if there was an error or no document was available.

    +

    Errors can be determined with the mongoc_change_stream_error_document() +function.

    +
    +
    +

    Lifecycle

    +

    Similar to mongoc_cursor_next() the lifetime of bson is until the +next call to mongoc_change_stream_next(), so it needs to be copied to +extend the lifetime.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_change_stream_t.html b/libmongoc/1.24.0/mongoc_change_stream_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c927343098e3970c6685d9e823616e126a16c762 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_change_stream_t.html @@ -0,0 +1,578 @@ + + + + + + + + + + + + + + mongoc_change_stream_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_change_stream_t

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_change_stream_t mongoc_change_stream_t;
    +
    +
    +

    mongoc_change_stream_t is a handle to a change stream. A collection +change stream can be obtained using mongoc_collection_watch().

    +

    It is recommended to use a mongoc_change_stream_t and its functions instead of a raw aggregation with a $changeStream stage. For more information see the MongoDB Manual Entry on Change Streams.

    +
    +
    +

    Example

    +
    +
    example-collection-watch.c
    +
    #include <mongoc/mongoc.h>
    +
    +int
    +main (void)
    +{
    +   bson_t empty = BSON_INITIALIZER;
    +   const bson_t *doc;
    +   bson_t *to_insert = BCON_NEW ("x", BCON_INT32 (1));
    +   const bson_t *err_doc;
    +   bson_error_t error;
    +   const char *uri_string;
    +   mongoc_uri_t *uri;
    +   mongoc_client_t *client;
    +   mongoc_collection_t *coll;
    +   mongoc_change_stream_t *stream;
    +   mongoc_write_concern_t *wc = mongoc_write_concern_new ();
    +   bson_t opts = BSON_INITIALIZER;
    +   bool r;
    +
    +   mongoc_init ();
    +
    +   uri_string = "mongodb://"
    +                "localhost:27017,localhost:27018,localhost:"
    +                "27019/db?replicaSet=rs0";
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   coll = mongoc_client_get_collection (client, "db", "coll");
    +   stream = mongoc_collection_watch (coll, &empty, NULL);
    +
    +   mongoc_write_concern_set_wmajority (wc, 10000);
    +   mongoc_write_concern_append (wc, &opts);
    +   r = mongoc_collection_insert_one (coll, to_insert, &opts, NULL, &error);
    +   if (!r) {
    +      fprintf (stderr, "Error: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   while (mongoc_change_stream_next (stream, &doc)) {
    +      char *as_json = bson_as_relaxed_extended_json (doc, NULL);
    +      fprintf (stderr, "Got document: %s\n", as_json);
    +      bson_free (as_json);
    +   }
    +
    +   if (mongoc_change_stream_error_document (stream, &error, &err_doc)) {
    +      if (!bson_empty (err_doc)) {
    +         fprintf (stderr,
    +                  "Server Error: %s\n",
    +                  bson_as_relaxed_extended_json (err_doc, NULL));
    +      } else {
    +         fprintf (stderr, "Client Error: %s\n", error.message);
    +      }
    +      return EXIT_FAILURE;
    +   }
    +
    +   bson_destroy (to_insert);
    +   mongoc_write_concern_destroy (wc);
    +   bson_destroy (&opts);
    +   mongoc_change_stream_destroy (stream);
    +   mongoc_collection_destroy (coll);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +

    Starting and Resuming

    +

    All watch functions accept several options to indicate where a change stream should start returning changes from: resumeAfter, startAfter, and startAtOperationTime.

    +

    All changes returned by mongoc_change_stream_next() include a resume token in the _id field. MongoDB 4.2 also includes an additional resume token in each “aggregate” and “getMore” command response, which points to the end of that response’s batch. The current token is automatically cached by libmongoc. In the event of an error, libmongoc attempts to recreate the change stream starting where it left off by passing the cached resume token. libmongoc only attempts to resume once, but client applications can access the cached resume token with mongoc_change_stream_get_resume_token() and use it for their own resume logic by passing it as either the resumeAfter or startAfter option.

    +

    Additionally, change streams can start returning changes at an operation time by using the startAtOperationTime field. This can be the timestamp returned in the operationTime field of a command reply.

    +

    resumeAfter, startAfter, and startAtOperationTime are mutually exclusive options. Setting more than one will result in a server error.

    +

    The following example implements custom resuming logic, persisting the resume token in a file.

    +
    +
    example-resume.c
    +
    #include <mongoc/mongoc.h>
    +
    +/* An example implementation of custom resume logic in a change stream.
    +* example-resume starts a client-wide change stream and persists the resume
    +* token in a file "resume-token.json". On restart, if "resume-token.json"
    +* exists, the change stream starts watching after the persisted resume token.
    +*
    +* This behavior allows a user to exit example-resume, and restart it later
    +* without missing any change events.
    +*/
    +#include <unistd.h>
    +
    +static const char *RESUME_TOKEN_PATH = "resume-token.json";
    +
    +static bool
    +_save_resume_token (const bson_t *doc)
    +{
    +   FILE *file_stream;
    +   bson_iter_t iter;
    +   bson_t resume_token_doc;
    +   char *as_json = NULL;
    +   size_t as_json_len;
    +   ssize_t r, n_written;
    +   const bson_value_t *resume_token;
    +
    +   if (!bson_iter_init_find (&iter, doc, "_id")) {
    +      fprintf (stderr, "reply does not contain operationTime.");
    +      return false;
    +   }
    +   resume_token = bson_iter_value (&iter);
    +   /* store the resume token in a document, { resumeAfter: <resume token> }
    +    * which we can later append easily. */
    +   file_stream = fopen (RESUME_TOKEN_PATH, "w+");
    +   if (!file_stream) {
    +      fprintf (stderr, "failed to open %s for writing\n", RESUME_TOKEN_PATH);
    +      return false;
    +   }
    +   bson_init (&resume_token_doc);
    +   BSON_APPEND_VALUE (&resume_token_doc, "resumeAfter", resume_token);
    +   as_json = bson_as_canonical_extended_json (&resume_token_doc, &as_json_len);
    +   bson_destroy (&resume_token_doc);
    +   n_written = 0;
    +   while (n_written < as_json_len) {
    +      r = fwrite ((void *) (as_json + n_written),
    +                  sizeof (char),
    +                  as_json_len - n_written,
    +                  file_stream);
    +      if (r == -1) {
    +         fprintf (stderr, "failed to write to %s\n", RESUME_TOKEN_PATH);
    +         bson_free (as_json);
    +         fclose (file_stream);
    +         return false;
    +      }
    +      n_written += r;
    +   }
    +
    +   bson_free (as_json);
    +   fclose (file_stream);
    +   return true;
    +}
    +
    +bool
    +_load_resume_token (bson_t *opts)
    +{
    +   bson_error_t error;
    +   bson_json_reader_t *reader;
    +   bson_t doc;
    +
    +   /* if the file does not exist, skip. */
    +   if (-1 == access (RESUME_TOKEN_PATH, R_OK)) {
    +      return true;
    +   }
    +   reader = bson_json_reader_new_from_file (RESUME_TOKEN_PATH, &error);
    +   if (!reader) {
    +      fprintf (stderr,
    +               "failed to open %s for reading: %s\n",
    +               RESUME_TOKEN_PATH,
    +               error.message);
    +      return false;
    +   }
    +
    +   bson_init (&doc);
    +   if (-1 == bson_json_reader_read (reader, &doc, &error)) {
    +      fprintf (stderr, "failed to read doc from %s\n", RESUME_TOKEN_PATH);
    +      bson_destroy (&doc);
    +      bson_json_reader_destroy (reader);
    +      return false;
    +   }
    +
    +   printf ("found cached resume token in %s, resuming change stream.\n",
    +           RESUME_TOKEN_PATH);
    +
    +   bson_concat (opts, &doc);
    +   bson_destroy (&doc);
    +   bson_json_reader_destroy (reader);
    +   return true;
    +}
    +
    +int
    +main (void)
    +{
    +   int exit_code = EXIT_FAILURE;
    +   const char *uri_string;
    +   mongoc_uri_t *uri = NULL;
    +   bson_error_t error;
    +   mongoc_client_t *client = NULL;
    +   bson_t pipeline = BSON_INITIALIZER;
    +   bson_t opts = BSON_INITIALIZER;
    +   mongoc_change_stream_t *stream = NULL;
    +   const bson_t *doc;
    +
    +   const int max_time = 30; /* max amount of time, in seconds, that
    +                               mongoc_change_stream_next can block. */
    +
    +   mongoc_init ();
    +   uri_string = "mongodb://localhost:27017/db?replicaSet=rs0";
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      goto cleanup;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto cleanup;
    +   }
    +
    +   if (!_load_resume_token (&opts)) {
    +      goto cleanup;
    +   }
    +   BSON_APPEND_INT64 (&opts, "maxAwaitTimeMS", max_time * 1000);
    +
    +   printf ("listening for changes on the client (max %d seconds).\n", max_time);
    +   stream = mongoc_client_watch (client, &pipeline, &opts);
    +
    +   while (mongoc_change_stream_next (stream, &doc)) {
    +      char *as_json;
    +
    +      as_json = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("change received: %s\n", as_json);
    +      bson_free (as_json);
    +      if (!_save_resume_token (doc)) {
    +         goto cleanup;
    +      }
    +   }
    +
    +   exit_code = EXIT_SUCCESS;
    +
    +cleanup:
    +   mongoc_uri_destroy (uri);
    +   bson_destroy (&pipeline);
    +   bson_destroy (&opts);
    +   mongoc_change_stream_destroy (stream);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +   return exit_code;
    +}
    +
    +
    +
    +

    The following example shows using startAtOperationTime to synchronize a change stream with another operation.

    +
    +
    example-start-at-optime.c
    +
    /* An example of starting a change stream with startAtOperationTime. */
    +#include <mongoc/mongoc.h>
    +
    +int
    +main (void)
    +{
    +   int exit_code = EXIT_FAILURE;
    +   const char *uri_string;
    +   mongoc_uri_t *uri = NULL;
    +   bson_error_t error;
    +   mongoc_client_t *client = NULL;
    +   mongoc_collection_t *coll = NULL;
    +   bson_t pipeline = BSON_INITIALIZER;
    +   bson_t opts = BSON_INITIALIZER;
    +   mongoc_change_stream_t *stream = NULL;
    +   bson_iter_t iter;
    +   const bson_t *doc;
    +   bson_value_t cached_operation_time = {0};
    +   int i;
    +   bool r;
    +
    +   mongoc_init ();
    +   uri_string = "mongodb://localhost:27017/db?replicaSet=rs0";
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      goto cleanup;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto cleanup;
    +   }
    +
    +   /* insert five documents. */
    +   coll = mongoc_client_get_collection (client, "db", "coll");
    +   for (i = 0; i < 5; i++) {
    +      bson_t reply;
    +      bson_t *insert_cmd = BCON_NEW ("insert",
    +                                     "coll",
    +                                     "documents",
    +                                     "[",
    +                                     "{",
    +                                     "x",
    +                                     BCON_INT64 (i),
    +                                     "}",
    +                                     "]");
    +
    +      r = mongoc_collection_write_command_with_opts (
    +         coll, insert_cmd, NULL, &reply, &error);
    +      bson_destroy (insert_cmd);
    +      if (!r) {
    +         bson_destroy (&reply);
    +         fprintf (stderr, "failed to insert: %s\n", error.message);
    +         goto cleanup;
    +      }
    +      if (i == 0) {
    +         /* cache the operation time in the first reply. */
    +         if (bson_iter_init_find (&iter, &reply, "operationTime")) {
    +            bson_value_copy (bson_iter_value (&iter), &cached_operation_time);
    +         } else {
    +            fprintf (stderr, "reply does not contain operationTime.");
    +            bson_destroy (&reply);
    +            goto cleanup;
    +         }
    +      }
    +      bson_destroy (&reply);
    +   }
    +
    +   /* start a change stream at the first returned operationTime. */
    +   BSON_APPEND_VALUE (&opts, "startAtOperationTime", &cached_operation_time);
    +   stream = mongoc_collection_watch (coll, &pipeline, &opts);
    +
    +   /* since the change stream started at the operation time of the first
    +    * insert, the five inserts are returned. */
    +   printf ("listening for changes on db.coll:\n");
    +   while (mongoc_change_stream_next (stream, &doc)) {
    +      char *as_json;
    +
    +      as_json = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("change received: %s\n", as_json);
    +      bson_free (as_json);
    +   }
    +
    +   exit_code = EXIT_SUCCESS;
    +
    +cleanup:
    +   mongoc_uri_destroy (uri);
    +   bson_destroy (&pipeline);
    +   bson_destroy (&opts);
    +   if (cached_operation_time.value_type) {
    +      bson_value_destroy (&cached_operation_time);
    +   }
    +   mongoc_change_stream_destroy (stream);
    +   mongoc_collection_destroy (coll);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +   return exit_code;
    +}
    +
    +
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_check_version.html b/libmongoc/1.24.0/mongoc_check_version.html new file mode 100644 index 0000000000000000000000000000000000000000..39c6be0e16a6651b6a8077dffc336cc076104c49 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_check_version.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_check_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_check_version()

    +
    +

    Synopsis

    +
    bool
    +mongoc_check_version (int required_major,
    +                      int required_minor,
    +                      int required_micro);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • required_major: The minimum major version required.

    • +
    • required_minor: The minimum minor version required.

    • +
    • required_micro: The minimum micro version required.

    • +
    +
    +
    +

    Returns

    +

    True if libmongoc’s version is greater than or equal to the required version.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cleanup.html b/libmongoc/1.24.0/mongoc_cleanup.html new file mode 100644 index 0000000000000000000000000000000000000000..cb7519a8c0cbffc20b5acd9d66a2173fb04d76bf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cleanup.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_cleanup() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cleanup()

    +
    +

    Synopsis

    +
    void
    +mongoc_cleanup (void);
    +
    +
    +
    +
    +

    Description

    +

    Initialize the MongoDB C Driver by calling mongoc_init() exactly once at the beginning of your program. It is responsible for initializing global state such as process counters, SSL, and threading primitives.

    +

    Exception to this is mongoc_log_set_handler(), which should be called before mongoc_init() or some log traces would not use your log handling function. See Custom Log Handlers for a detailed example.

    +

    Call mongoc_cleanup() exactly once at the end of your program to release all memory and other resources allocated by the driver. You must not call any other MongoDB C Driver functions after mongoc_cleanup(). Note that mongoc_init() does not reinitialize the driver after mongoc_cleanup().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_command.html b/libmongoc/1.24.0/mongoc_client_command.html new file mode 100644 index 0000000000000000000000000000000000000000..af51038544383bca5e03d441317f74414935a4b7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_command.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_client_command() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_command()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_client_command (mongoc_client_t *client,
    +                       const char *db_name,
    +                       mongoc_query_flags_t flags,
    +                       uint32_t skip,
    +                       uint32_t limit,
    +                       uint32_t batch_size,
    +                       const bson_t *query,
    +                       const bson_t *fields,
    +                       const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function is superseded by mongoc_client_command_with_opts(), mongoc_client_read_command_with_opts(), mongoc_client_write_command_with_opts(), and mongoc_client_read_write_command_with_opts().

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Description

    +

    This function creates a cursor which will execute the command when mongoc_cursor_next() is called on it. The client’s read preference, read concern, and write concern are not applied to the command, and mongoc_cursor_next() will not check the server response for a write concern error or write concern timeout.

    +

    If mongoc_cursor_next() returns false, then retrieve error details with mongoc_cursor_error() or mongoc_cursor_error_document().

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • flags: Unused.

    • +
    • skip: Unused.

    • +
    • limit: Unused.

    • +
    • batch_size: Unused.

    • +
    • query: A bson_t containing the command specification.

    • +
    • fields: Unused.

    • +
    • read_prefs: An optional mongoc_read_prefs_t. Otherwise, the command uses mode MONGOC_READ_PRIMARY.

    • +
    +
    +
    +

    Returns

    +

    A mongoc_cursor_t.

    +

    The cursor should be freed with mongoc_cursor_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_command_simple.html b/libmongoc/1.24.0/mongoc_client_command_simple.html new file mode 100644 index 0000000000000000000000000000000000000000..2d5b3534a49d663b03cded25a5bc83a1e97a3199 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_command_simple.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_client_command_simple() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_command_simple()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_command_simple (mongoc_client_t *client,
    +                              const char *db_name,
    +                              const bson_t *command,
    +                              const mongoc_read_prefs_t *read_prefs,
    +                              bson_t *reply,
    +                              bson_error_t *error);
    +
    +
    +

    This is a simplified interface to mongoc_client_command(). It returns the first document from the result cursor into reply. The client’s read preference, read concern, and write concern are not applied to the command.

    +
    +

    Warning

    +

    reply is always set, and should be released with bson_destroy().

    +
    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • command: A bson_t containing the command specification.

    • +
    • read_prefs: An optional mongoc_read_prefs_t. Otherwise, the command uses mode MONGOC_READ_PRIMARY.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    This function does not check the server response for a write concern error or write concern timeout.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_command_simple_with_server_id.html b/libmongoc/1.24.0/mongoc_client_command_simple_with_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..8e0c9735971c0b6330efd5d742605f8a8c131cea --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_command_simple_with_server_id.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_command_simple_with_server_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_command_simple_with_server_id()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_command_simple_with_server_id (
    +   mongoc_client_t *client,
    +   const char *db_name,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs,
    +   uint32_t server_id,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    This function executes a command on a specific server, using the database and command specification provided.

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • read_prefs: An optional mongoc_read_prefs_t.

    • +
    • server_id: An opaque id specifying which server to use.

    • +
    • reply: An optional location for a bson_t which will store the server’s reply.

    • +
    • error: An optional location for a bson_error_t or a NULL.

    • +
    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    This function does not check the server response for a write concern error or write concern timeout.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_command_with_opts.html b/libmongoc/1.24.0/mongoc_client_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4e12ec75e3434b687258b0a129802a0806e8c71a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_command_with_opts.html @@ -0,0 +1,259 @@ + + + + + + + + + + + + + + mongoc_client_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_command_with_opts (
    +   mongoc_client_t *client,
    +   const char *db_name,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs,
    +   const bson_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Execute a command on the server, interpreting opts according to the MongoDB server version. To send a raw command to the server without any of this logic, use mongoc_client_command_simple().

    +

    Read preferences, read and write concern, and collation can be overridden by various sources. The highest-priority sources for these options are listed first:

    + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Write Concern

    Collation

    read_prefs

    opts

    opts

    opts

    Transaction

    Transaction

    Transaction

    +

    In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. +See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • command: A bson_t containing the command specification.

    • +
    • read_prefs: An optional mongoc_read_prefs_t.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    The reply is not parsed for a write concern timeout or write concern error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_destroy.html b/libmongoc/1.24.0/mongoc_client_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..0167f0b58496014b0549a5bb36b1a28c8dd4b099 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_destroy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_client_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_destroy (mongoc_client_t *client);
    +
    +
    +

    Release all resources associated with client and free the structure. Does nothing if client is NULL.

    +

    Only call mongoc_client_destroy() on a single-threaded client. Do not call on a mongoc_client_t obtained from a mongoc_client_pool_t, which should instead be pushed back with mongoc_client_pool_push().

    +
    +
    +

    Parameters

    + +
    +

    See also

    +
    +
    mongoc_client_pool_push() to push a multi-threaded client back onto a pool.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_enable_auto_encryption.html b/libmongoc/1.24.0/mongoc_client_enable_auto_encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..741b98274f5ceb46ff1889942a862fa915a90d54 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_enable_auto_encryption.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_client_enable_auto_encryption() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_enable_auto_encryption()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_enable_auto_encryption (mongoc_client_t *client,
    +                                      mongoc_auto_encryption_opts_t* opts,
    +                                      bson_error_t* error);
    +
    +
    +

    Enable automatic In-Use Encryption on a mongoc_client_t. Requires libmongoc to be built with support for In-Use Encryption. See In-Use Encryption for instructions to enable In-Use Encryption in libmongoc.

    +

    Automatic encryption is an enterprise only feature that only applies to operations on a collection. Automatic encryption is not supported for operations on a database or view, and operations that are not bypassed will result in error. To bypass automatic encryption for all operations, bypass automatic encryption with mongoc_auto_encryption_opts_set_bypass_auto_encryption() in opts.

    +

    Automatic encryption requires the authenticated user to have the listCollections privilege action.

    +

    Enabling automatic encryption reduces the maximum message size and may have a negative performance impact.

    +

    Only applies to a single-threaded mongoc_client_t. To use with client pools, see mongoc_client_pool_enable_auto_encryption().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True on success. False on error. On error, error is set.

    +
    +

    See also

    + + +
    +
    In-Use Encryption for libmongoc
    +
    +
    +
    The MongoDB Manual for Client-Side Field Level Encryption
    +
    +
    +
    The MongoDB Manual for Queryable Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_add_key_alt_name.html b/libmongoc/1.24.0/mongoc_client_encryption_add_key_alt_name.html new file mode 100644 index 0000000000000000000000000000000000000000..e62fe39ada4f11d2d1df5056db2bfb67a3e5ac35 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_add_key_alt_name.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_client_encryption_add_key_alt_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_add_key_alt_name()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_add_key_alt_name (
    +   mongoc_client_encryption_t *client_encryption,
    +   const bson_value_t *keyid,
    +   const char *keyaltname,
    +   bson_t *key_doc,
    +   bson_error_t *error);
    +
    +
    +

    Add keyaltname to the set of alternate names in the key document with UUID keyid.

    +
    +
    +

    Parameters

    +
      +
    • client_encryption: A mongoc_client_encryption_t.

    • +
    • keyid: A UUID (BSON binary subtype 0x04) key ID of the key to add the key alternate name to.

    • +
    • keyaltname: The key alternate name to add.

    • +
    • key_doc: Optional. An uninitialized bson_t set to the value of the key document before addition of the alternate name, or an empty document if the key does not exist. Must be freed by bson_destroy().

    • +
    • error: Optional. bson_error_t.

    • +
    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_create_datakey.html b/libmongoc/1.24.0/mongoc_client_encryption_create_datakey.html new file mode 100644 index 0000000000000000000000000000000000000000..2e9821f4897233fd4280e66055fafc3c2c4c2bf7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_create_datakey.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_client_encryption_create_datakey() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_create_datakey()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_create_datakey (
    +   mongoc_client_encryption_t *client_encryption,
    +   const char *kms_provider,
    +   const mongoc_client_encryption_datakey_opts_t *opts,
    +   bson_value_t *keyid,
    +   bson_error_t *error);
    +
    +
    +

    Creates a new key document in the key vault collection and sets keyid to the UUID of the newly created key if keyid is not NULL. The new key can be used to configure automatic encryption (see mongoc_client_enable_auto_encryption() and mongoc_client_pool_enable_auto_encryption()) or for explicit encryption (see mongoc_client_encryption_encrypt()).

    +

    The created key document is inserted into the key vault collection (identified via mongoc_client_encryption_opts_set_keyvault_namespace()) with majority write concern.

    +

    keyid is always initialized (even on error). Caller must call bson_value_destroy() on keyid to free.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_create_encrypted_collection.html b/libmongoc/1.24.0/mongoc_client_encryption_create_encrypted_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..2e9d540443e855477e8d70ebf57af610afa63f71 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_create_encrypted_collection.html @@ -0,0 +1,270 @@ + + + + + + + + + + + + + + mongoc_client_encryption_create_encrypted_collection() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_create_encrypted_collection()

    +
    +

    Synopsis

    +
    mongoc_collection_t*
    +mongoc_client_encryption_create_encrypted_collection (
    +      mongoc_client_encryption_t *enc,
    +      mongoc_database_t *database,
    +      const char *name,
    +      const bson_t *in_options,
    +      bson_t *out_options,
    +      const char *kms_provider,
    +      const bson_t *opt_masterKey,
    +      bson_error_t *error)
    +  BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a new collection with Queryable Encryption +enabled. Requires a valid mongoc_client_encryption_t object to +operate.

    +
    +

    New in version 1.24.0.

    +
    +
    +

    See also

    +

    This function is a convenience API wrapping +mongoc_database_create_collection().

    +
    +
    +
    +

    Parameters

    +
      +
    • enc: The mongoc_client_encryption_t to be used to configure +encryption for the new collection.

    • +
    • database: The mongoc_database_t in which the new collection will +be created.

    • +
    • name: The name of the new collection.

    • +
    • in_options: The options for the new collection. (See below).

    • +
    • out_options: An optional output option for the final create-collection +options. Should point to storage for a bson_t. The pointed-to object +must be destroyed by the caller. If NULL, has no effect.

    • +
    • kms_provider: The name of the KMS provider to use for generating new data +encryption keys for encrypted fields within the collection.

    • +
    • opt_masterKey: If provided, used as the masterkey option when data +encryption keys need to be created. (See: +mongoc_client_encryption_datakey_opts_set_masterkey())

    • +
    • error: Optional output parameter pointing to storage for a +bson_error_t. If an error occurs, will be initialized with error +information.

    • +
    +
    +
    +

    Returns

    +

    If successful, this function returns a new mongoc_collection_t object. +Upon failure, returns NULL and initializes *error with an error +indicating the reason for failure. The returned collection object must be freed +by the caller.

    +
    +
    +

    Creation Options

    +

    The in_options parameter behaves similarly to the opts parameter for +mongoc_database_create_collection(), which accepts the options for the +create MongoDB command +(Documented here). +The in_options document accepted here is different in one important way:

    +

    The $.encryptedFields.fields array is required by this function, and, +unlike the schema documented for the create command, accepts a value of +null for the keyId parameter on each array element.

    +

    This function has the following as-if effect:

    +
      +
    1. A new set of options \(O\) will be created based on in_options.

    2. +
    3. For each element \(F\) in the $.encryptedFields.fields array of \(O\):

      +
        +
      1. If \(F\) contains a "keyId": null element, a new data encryption key +\(K_f\) will be created as-if by calling the +mongoc_client_encryption_create_datakey(), using the relevant +arguments that were given to +mongoc_client_encryption_create_encrypted_collection.

      2. +
      3. The ID of \(K_f\) will be used to replace the "keyId": null element +within \(F\).

      4. +
      +
    4. +
    5. A collection will be created using the options \(O\).

    6. +
    7. If out_options is not NULL, \(O\) will be written to +out_options.

    8. +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_destroy.html b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..95709ac8400c373b59016b566554a57fd64303e0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_datakey_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_datakey_opts_destroy (mongoc_client_encryption_datakey_opts_t *opts);
    +
    +
    +

    Frees resources of a mongoc_client_encryption_datakey_opts_t created with mongoc_client_encryption_datakey_opts_new(). Does nothing if NULL is passed.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_new.html b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..559f4456660cc3c5e3acd0aa7a6814f363a376d3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_datakey_opts_new()

    +
    +

    Synopsis

    +
    mongoc_client_encryption_datakey_opts_t *
    +mongoc_client_encryption_datakey_opts_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    A new mongoc_client_encryption_datakey_opts_t that must be freed with mongoc_client_encryption_datakey_opts_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_keyaltnames.html b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_keyaltnames.html new file mode 100644 index 0000000000000000000000000000000000000000..33ac1f7eacdc3e71a1d6c71c26cd0a16dc37fbc4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_keyaltnames.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_set_keyaltnames() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_datakey_opts_set_keyaltnames()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_datakey_opts_set_keyaltnames (
    +   mongoc_client_encryption_datakey_opts_t *opts,
    +   char **keyaltnames,
    +   uint32_t keyaltnames_count);
    +
    +
    +

    Sets a list of alternate name strings that can be used to identify a data key. Key alternate names must be unique.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_keymaterial.html b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_keymaterial.html new file mode 100644 index 0000000000000000000000000000000000000000..c69f011b37bce712690a83df68b9c68a88bf677c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_keymaterial.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_set_keymaterial() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_datakey_opts_set_keymaterial()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_datakey_opts_set_keymaterial (
    +   mongoc_client_encryption_datakey_opts_t *opts,
    +   const uint8_t *data,
    +   uint32_t len);
    +
    +
    +

    Sets the custom key material to be used by the data key for encryption and decryption.

    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Key material is used to encrypt and decrypt data. If custom key material is not provided, the key material for the new data key is generated from a cryptographically secure random device.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_masterkey.html b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_masterkey.html new file mode 100644 index 0000000000000000000000000000000000000000..2f70462d3b8a4ac25a53e28994c5ee460d55fe8a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_set_masterkey.html @@ -0,0 +1,239 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_set_masterkey() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_datakey_opts_set_masterkey()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_datakey_opts_set_masterkey (
    +   mongoc_client_encryption_datakey_opts_t *opts, const bson_t *masterkey);
    +
    +
    +

    Identifies the masterkey for the Key Management Service (KMS) provider used to encrypt a new data key.

    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Setting the masterkey is required when creating a data key with the KMS providers: aws, azure, gcp, and kmip.

    +

    Setting the masterkey is prohibited with the KMS provider local.

    +

    The format of masterkey for “aws” is as follows:

    +
    {
    +   region: String,
    +   key: String, /* The Amazon Resource Name (ARN) to the AWS customer master key (CMK). */
    +   endpoint: Optional<String> /* An alternate host identifier to send KMS requests to. May include port number. Defaults to "kms.<region>.amazonaws.com" */
    +}
    +
    +
    +

    The format of masterkey for “azure” is as follows:

    +
    {
    +   keyVaultEndpoint: String, /* Host with optional port. Example: "example.vault.azure.net". */
    +   keyName: String,
    +   keyVersion: Optional<String> /* A specific version of the named key, defaults to using the key's primary version. */
    +}
    +
    +
    +

    The format of masterkey for “gcp” is as follows:

    +
    {
    +   projectId: String,
    +   location: String,
    +   keyRing: String,
    +   keyName: String,
    +   keyVersion: Optional<String>, /* A specific version of the named key, defaults to using the key's primary version. */
    +   endpoint: Optional<String> /* Host with optional port. Defaults to "cloudkms.googleapis.com". */
    +}
    +
    +
    +

    The format of masterkey for “kmip” is as follows:

    +
    {
    +   keyId: Optional<String>,
    +   endpoint: Optional<String> /* Host with optional port. */
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_t.html b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..49a366ee5eaaf9dfc2d90ea50f7329b5a11d4f0b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_datakey_opts_t.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_datakey_opts_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_encryption_datakey_opts_t mongoc_client_encryption_datakey_opts_t;
    +
    +
    +

    Used to set options for mongoc_client_encryption_create_datakey().

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_decrypt.html b/libmongoc/1.24.0/mongoc_client_encryption_decrypt.html new file mode 100644 index 0000000000000000000000000000000000000000..89dd9696560a66d968ff06a7aa8fbd2d27852d95 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_decrypt.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_decryption_decrypt() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_decryption_decrypt()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_decrypt (mongoc_client_encryption_t *client_encryption,
    +                                  const bson_value_t *ciphertext,
    +                                  bson_value_t *value,
    +                                  bson_error_t *error);
    +
    +
    +

    Performs explicit decryption.

    +

    value is always initialized (even on failure). Caller must call bson_value_destroy() to free.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_delete_key.html b/libmongoc/1.24.0/mongoc_client_encryption_delete_key.html new file mode 100644 index 0000000000000000000000000000000000000000..864c70ddea0388308333d94730a2c1158fa4df03 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_delete_key.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_encryption_delete_key() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_delete_key()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_delete_key (
    +   mongoc_client_encryption_t *client_encryption,
    +   const bson_value_t *keyid,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Delete a key document in the key vault collection that has the given keyid.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_destroy.html b/libmongoc/1.24.0/mongoc_client_encryption_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5b31f16483a4d1691db7b50b5a9bb9245eabdb3a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_destroy.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_client_encryption_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_destroy (
    +   mongoc_client_encryption_t *client_encryption);
    +
    +
    +

    Release all resources associated with client_encryption and free the structure. Does nothing if client_encryption is NULL.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt.html new file mode 100644 index 0000000000000000000000000000000000000000..05d48f55be24bd17aaf9af2af5b7972040ef3e44 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_encrypt (
    +   mongoc_client_encryption_t *client_encryption,
    +   const bson_value_t *value,
    +   mongoc_client_encryption_encrypt_opts_t *opts,
    +   bson_value_t *ciphertext,
    +   bson_error_t *error);
    +
    +
    +

    Performs explicit encryption.

    +

    ciphertext is always initialized (even on failure). Caller must call bson_value_destroy() to free.

    +

    To insert or query with an “Indexed” or “RangePreview” encrypted payload, use a +mongoc_client_t configured with +mongoc_auto_encryption_opts_t. The +mongoc_auto_encryption_opts_t may be configured to bypass query +analysis with mongoc_auto_encryption_opts_set_bypass_query_analysis(). +The mongoc_auto_encryption_opts_t must not be configured to bypass +automatic encryption with +mongoc_auto_encryption_opts_set_bypass_auto_encryption(). Note that +the "RangePreview" payload type is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.. The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes.

    +

    To insert with a RangePreview payload +mongoc_client_encryption_encrypt_range_opts_t must be set in opts.

    +

    To query with a RangePreview payload, use mongoc_client_encryption_encrypt_expression()

    +

    NOTE that the Range algorithm is experimental only and not intended for public use. It is subject to breaking changes.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_expression.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_expression.html new file mode 100644 index 0000000000000000000000000000000000000000..a7c80cf1680f8f2d444c37c58499c41f14e82423 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_expression.html @@ -0,0 +1,257 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_expression() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_expression()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_encrypt_expression (
    +   mongoc_client_encryption_t *client_encryption,
    +   const bson_t *expr,
    +   mongoc_client_encryption_encrypt_opts_t *opts,
    +   bson_t *expr_out,
    +   bson_error_t *error);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Encrypts a Match Expression or Aggregate Expression to query a range index.

    +

    To query with a RangePreview encrypted payload, use a +mongoc_client_t configured with +mongoc_auto_encryption_opts_t. The +mongoc_auto_encryption_opts_t may be configured to bypass query +analysis with mongoc_auto_encryption_opts_set_bypass_query_analysis(). +The mongoc_auto_encryption_opts_t must not be configured to bypass +automatic encryption with +mongoc_auto_encryption_opts_set_bypass_auto_encryption().

    +

    To query with a RangePreview payload, expr must be one of the following forms:

    +
      +
    1. A Match Expression of the following form:

      +
      // $gt may also be $gte. $lt may also be $lte.
      +// Can include one of $gt/$gte/$lt/$lte. It is not required to include both.
      +{"$and": [{"<field>": {"$gt": "<value1>"}}, {"<field>": {"$lt": "<value2>" }}]}
      +
      +
      +
    2. +
    3. An Aggregation Expression of this form:

      +
      // $gt may also be $gte. $lt may also be $lte
      +// Can include one of $gt/$gte/$lt/$lte. It is not required to include both.
      +{"$and": [{"$gt": ["<fieldpath>", "<value1>"]}, {"$lt": ["<fieldpath>", "<value2>"]}]
      +
      +
      +
    4. +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_destroy.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5fc6ba71c3847180922564b3f842abfd869e5f8c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_opts_destroy (mongoc_client_encryption_encrypt_opts_t *opts);
    +
    +
    +

    Frees resources of a mongoc_client_encryption_encrypt_opts_t created with mongoc_client_encryption_encrypt_opts_new(). Does nothing if NULL is passed.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_new.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..80988a2a515408dc5616556f3a56648c1cada04b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_new()

    +
    +

    Synopsis

    +
    mongoc_client_encryption_encrypt_opts_t *
    +mongoc_client_encryption_encrypt_opts_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    A new mongoc_client_encryption_encrypt_opts_t that must be freed with mongoc_client_encryption_encrypt_opts_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_algorithm.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_algorithm.html new file mode 100644 index 0000000000000000000000000000000000000000..cadabf6379e55e74121d6cb20c7bccec8b6dcbf0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_algorithm.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_algorithm() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_set_algorithm()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_opts_set_algorithm (
    +   mongoc_client_encryption_encrypt_opts_t *opts, const char *algorithm);
    +
    +#define MONGOC_AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
    +#define MONGOC_AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"
    +// (Experimental: See below)
    +#define MONGOC_ENCRYPT_ALGORITHM_INDEXED "Indexed"
    +// (Experimental: See below)
    +#define MONGOC_ENCRYPT_ALGORITHM_UNINDEXED "Unindexed"
    +// (Experimental: See below)
    +#define MONGOC_ENCRYPT_ALGORITHM_RANGEPREVIEW "RangePreview"
    +
    +
    +

    Identifies the algorithm to use for encryption. Valid values of algorithm are:

    +

    "AEAD_AES_256_CBC_HMAC_SHA_512-Random"

    +
    +

    for randomized encryption. Specific to the Client-Side Field Level Encryption feature.

    +
    +

    "AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic"

    +
    +

    for deterministic (queryable) encryption. Specific to the Client-Side Field Level Encryption feature.

    +
    +

    "Indexed"

    +
    +

    for indexed encryption. Specific to the Queryable Encryption feature.

    +
    +

    "Unindexed"

    +
    +

    for unindexed encryption. Specific to the Queryable Encryption feature.

    +
    +

    "RangePreview"

    +
    +

    for range encryption. Specific to the Queryable Encryption feature.

    +
    +

    Note

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This option is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_contention_factor.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_contention_factor.html new file mode 100644 index 0000000000000000000000000000000000000000..91d78319a7d9fff6e7c1608203b544f340eff632 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_contention_factor.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_contention_factor() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_set_contention_factor()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_opts_set_contention_factor (
    +    mongoc_client_encryption_encrypt_opts_t *opts, int64_t contention_factor);
    +
    +
    +
    +

    New in version 1.22.0.

    +
    +

    Sets a contention factor for explicit encryption. +Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “Indexed” or “RangePreview”. +It is an error to set the contention factor when algorithm is not “Indexed” or “RangePreview”. Note that the Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. +If contention factor is not supplied, it defaults to a value of 0.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_keyaltname.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_keyaltname.html new file mode 100644 index 0000000000000000000000000000000000000000..337757586b6f894cfbc31dcb880d8fe7d206237c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_keyaltname.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_keyaltname() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_set_keyaltname()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_opts_set_keyaltname (
    +   mongoc_client_encryption_encrypt_opts_t *opts, const char *keyaltname);
    +
    +
    +

    Identifies the data key to use for encryption. This option is mutually exclusive with mongoc_client_encryption_encrypt_opts_set_keyid().

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_keyid.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_keyid.html new file mode 100644 index 0000000000000000000000000000000000000000..32ae66e16771b69645ab2841edda39047fc286f0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_keyid.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_keyid() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_set_keyid()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_opts_set_keyid (
    +   mongoc_client_encryption_encrypt_opts_t *opts, const bson_value_t *keyid);
    +
    +
    +

    Identifies the data key to use for encryption. This option is mutually exclusive with mongoc_client_encryption_encrypt_opts_set_keyaltname().

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_query_type.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_query_type.html new file mode 100644 index 0000000000000000000000000000000000000000..0d5a1213cacd606d4d9e82ad155826146a3b8752 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_query_type.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_query_type() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_set_query_type()

    +
    +

    Synopsis

    +
    #define MONGOC_ENCRYPT_QUERY_TYPE_EQUALITY "equality"
    +#define MONGOC_ENCRYPT_QUERY_TYPE_RANGEPREVIEW "rangePreview"
    +
    +MONGOC_EXPORT (void)
    + mongoc_client_encryption_encrypt_opts_set_query_type (
    +     mongoc_client_encryption_encrypt_opts_t *opts, const char* query_type);
    +
    +
    +
    +

    New in version 1.22.0.

    +
    +

    Sets a query type for explicit encryption. Currently, the supported values +for query_type are "equality" and "rangePreview". NOTE that the Range algorithm is experimental only and not intended for public use. It is subject to breaking changes.

    +

    Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “Indexed” or “RangePreview”. +It is an error to set the query type when algorithm is not “Indexed” or “RangePreview”.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_range_opts.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_range_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..b3e5d3eac26df6172c9435683faff3fe1dc805f7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_set_range_opts.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_range_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_set_range_opts()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_opts_set_range_opts (
    +      mongoc_client_encryption_encrypt_opts_t *opts,
    +      const mongoc_client_encryption_encrypt_range_opts_t *range_opts);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Sets the range_opts for explicit encryption. +Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “RangePreview”. +It is an error to set range_opts when algorithm is not “RangePreview”.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_t.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a07335d62456db134ab6b936f0b84024ced653e1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_opts_t.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_destroy.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..72f3aca64d3e9f6eb0220a879848cef47e91c52d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_destroy.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_range_opts_destroy (mongoc_client_encryption_encrypt_range_opts_t *range_opts);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Frees resources of a mongoc_client_encryption_encrypt_range_opts_t created with mongoc_client_encryption_encrypt_range_opts_new(). Does nothing if NULL is passed.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_new.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..95c7d0e9bebcb4f723c0df3cd8c1057be0b1e84e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_new.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_new()

    +
    +

    Synopsis

    +
    mongoc_client_encryption_encrypt_range_opts_t *
    +mongoc_client_encryption_encrypt_range_opts_new (void);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +
    +
    +

    Returns

    +

    A new mongoc_client_encryption_encrypt_range_opts_t that must be freed with mongoc_client_encryption_encrypt_range_opts_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_max.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_max.html new file mode 100644 index 0000000000000000000000000000000000000000..8a2e7355fcb5c5adf64273ea509f63b07fd28686 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_max.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_max() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_set_max()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_range_opts_set_max (
    +     mongoc_client_encryption_encrypt_range_opts_t *range_opts,
    +     const bson_value_t *max);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Sets the maximum value of the range for explicit encryption. +Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “RangePreview”. +It is an error to set maximum when algorithm is not “RangePreview”.

    +

    The maximum must match the value set in the encryptedFields of the destination collection. +It is an error to set a different value.

    +

    For double and decimal128 fields, max/max/precision must all be set, or all be unset.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_min.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_min.html new file mode 100644 index 0000000000000000000000000000000000000000..66b9f2db99b12dd3c56d0447758f39f623d6f0ce --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_min.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_min() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_set_min()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_range_opts_set_min (
    +     mongoc_client_encryption_encrypt_range_opts_t *range_opts,
    +     const bson_value_t *min);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Sets the minimum value of the range for explicit encryption. +Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “RangePreview”. +It is an error to set minimum when algorithm is not “RangePreview”.

    +

    The minimum must match the value set in the encryptedFields of the destination collection. +It is an error to set a different value.

    +

    For double and decimal128 fields, min/max/precision must all be set, or all be unset.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_precision.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_precision.html new file mode 100644 index 0000000000000000000000000000000000000000..c56a92b89d0ae63d4ff26ee442490ce372c4503b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_precision.html @@ -0,0 +1,224 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_precision() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_set_precision()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_range_opts_set_precision (
    +     mongoc_client_encryption_encrypt_range_opts_t *range_opts, int32_t precision);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Sets precision for explicit encryption. +Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “RangePreview”. +It is an error to set precision when algorithm is not “RangePreview”.

    +

    Precision can only be set with double or decimal128 fields. +It is an error to set precision if the type of the encryptedFields in the destination collection is not double or decimal128.

    +

    For double and decimal128 fields, min/max/precision must all be set, or all be unset.

    +

    Precision must match the value set in the encryptedFields of the destination collection. +It is an error to set a different value.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html new file mode 100644 index 0000000000000000000000000000000000000000..dc3e6455fdb34ee14621c40e624d588ef7d0958d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_sparsity() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_set_sparsity()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_encrypt_range_opts_set_sparsity (
    +     mongoc_client_encryption_encrypt_range_opts_t *range_opts, int64_t sparsity);
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    Sets sparsity for explicit encryption. Sparsity is required for explicit encryption of range indexes. +Only applies when the algorithm set by mongoc_client_encryption_encrypt_opts_set_algorithm() is “RangePreview”. +It is an error to set sparsity when algorithm is not “RangePreview”.

    +

    Sparsity must match the value set in the encryptedFields of the destination collection. +It is an error to set a different value.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_t.html b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b8c28b8f01650e76875fd9df6f0e86bd0ae8085d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_encrypt_range_opts_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_range_opts_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_encryption_encrypt_range_opts_t mongoc_client_encryption_encrypt_range_opts_t;
    +
    +
    +
    +

    Important

    +

    The Range algorithm is experimental only and not intended for public use. It is subject to breaking changes. This API is part of the experimental +Queryable Encryption API and may be subject +to breaking changes in future releases.

    +
    +
    +

    New in version 1.24.0.

    +
    +

    RangeOpts specifies index options for a Queryable Encryption field supporting “rangePreview” queries. Used to set options for mongoc_client_encryption_encrypt().

    +

    The options min, max, sparsity, and range must match the values set in the encryptedFields of the destination collection.

    +

    For double and decimal128 fields, min/max/precision must all be set, or all be unset.

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_get_crypt_shared_version.html b/libmongoc/1.24.0/mongoc_client_encryption_get_crypt_shared_version.html new file mode 100644 index 0000000000000000000000000000000000000000..86e01d5c92b4fa420305a0de9a0964482ec3101f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_get_crypt_shared_version.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_crypt_shared_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_get_crypt_shared_version()

    +
    +

    Synopsis

    +
    const char*
    +mongoc_client_encryption_get_crypt_shared_version (mongoc_client_encryption_t const *enc)
    +    BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Obtain the version string of the crypt_shared that is loaded for the given +explicit encryption object. If no crypt_shared library is loaded, the returned +pointer will be NULL.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A pointer to a null-terminated character array string designating the version of +crypt_shared that was loaded for enc. If no crypt_shared library is +loaded, the returned pointer will be NULL. The pointed-to array must not be +modified or freed. The returned pointer is only valid for the lifetime of +enc.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_get_key.html b/libmongoc/1.24.0/mongoc_client_encryption_get_key.html new file mode 100644 index 0000000000000000000000000000000000000000..596278be386b05eadc227ea09d53dbcca66a1d96 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_get_key.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_key() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_get_key()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_get_key (mongoc_client_encryption_t *client_encryption,
    +                                  const bson_value_t *keyid,
    +                                  bson_t *key_doc,
    +                                  bson_error_t *error);
    +
    +
    +

    Get a key document in the key vault collection that has the given keyid.

    +
    +
    +

    Parameters

    +
      +
    • client_encryption: A mongoc_client_encryption_t.

    • +
    • keyid: The UUID (BSON binary subtype 0x04) of the key to get.

    • +
    • key_doc: Optional. An uninitialized bson_t set to the resulting key document, or an empty document value if the key does not exist. Must be freed by bson_destroy().

    • +
    • error: Optional. bson_error_t.

    • +
    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_get_key_by_alt_name.html b/libmongoc/1.24.0/mongoc_client_encryption_get_key_by_alt_name.html new file mode 100644 index 0000000000000000000000000000000000000000..a39c9ac96810c9a363aae98e6901b97f3d012ae7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_get_key_by_alt_name.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_key_by_alt_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_get_key_by_alt_name()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_get_key_by_alt_name (
    +   mongoc_client_encryption_t *client_encryption,
    +   const char *keyaltname,
    +   bson_value_t *key_doc,
    +   bson_error_t *error);
    +
    +
    +

    Get a key document in the key vault collection that has the given keyaltname.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_get_keys.html b/libmongoc/1.24.0/mongoc_client_encryption_get_keys.html new file mode 100644 index 0000000000000000000000000000000000000000..a82fd0facaecbf71f8844cb2232bad87ac84e8eb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_get_keys.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_keys() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_get_keys()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_client_encryption_get_keys (mongoc_client_encryption_t *client_encryption,
    +                                   bson_error_t *error);
    +
    +
    +

    Get all the key documents in the key vault collection.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns the result of the internal find command if successful. Returns NULL and sets error otherwise.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_new.html b/libmongoc/1.24.0/mongoc_client_encryption_new.html new file mode 100644 index 0000000000000000000000000000000000000000..aa4e954f71a8ec5c94a2a47c5cbd6f9efc9c831b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_new.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_encryption_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_new()

    +
    +

    Synopsis

    +
    mongoc_client_encryption_t *
    +mongoc_client_encryption_new (mongoc_client_encryption_opts_t *opts,
    +                              bson_error_t *error) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a new mongoc_client_encryption_t.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A new mongoc_client_encryption_t that must be freed with mongoc_client_encryption_destroy() if successful. Returns NULL and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_destroy.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..7781ee0325a564daf4d944f69c2bc9e731e29158 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_opts_destroy (mongoc_client_encryption_opts_t *opts);
    +
    +
    +

    Frees resources of a mongoc_client_encryption_opts_t created with mongoc_client_encryption_opts_new(). Does nothing if NULL is passed.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_new.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..0fed4b6a11114ca49a0cce1fe2936f350a4c220d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_new()

    +
    +

    Synopsis

    +
    mongoc_client_encryption_opts_t *
    +mongoc_client_encryption_opts_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    A new mongoc_client_encryption_opts_t that must be freed with mongoc_client_encryption_opts_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_set_keyvault_client.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_keyvault_client.html new file mode 100644 index 0000000000000000000000000000000000000000..77413de18b3def72a95fd1a191e68bfe9c3cb5b0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_keyvault_client.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_keyvault_client() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_set_keyvault_client()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_opts_set_keyvault_client (
    +   mongoc_client_encryption_opts_t *opts,
    +   mongoc_client_t *keyvault_client);
    +
    +
    +

    Set the mongoc_client_t to use during key creation and key lookup for encryption and decryption. This may be either a single-threaded or multi-threaded client (i.e. a client obtained from a mongoc_client_pool_t).

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_keyvault_namespace.html new file mode 100644 index 0000000000000000000000000000000000000000..ed35aa319c02b691d2efd3b8db26845a82d6d919 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_keyvault_namespace.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_keyvault_namespace() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_set_keyvault_namespace()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_opts_set_keyvault_namespace (
    +   mongoc_client_encryption_opts_t *opts, const char *db, const char *coll);
    +
    +
    +

    Set the database and collection name of the key vault. The key vault is the specially designated collection containing encrypted data keys for In-Use Encryption.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html new file mode 100644 index 0000000000000000000000000000000000000000..27d45890711c9ba44f576e03c51c857e14527f3b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html @@ -0,0 +1,246 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_kms_credential_provider_callback () — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_set_kms_credential_provider_callback ()

    +
    +

    New in version 1.23.0.

    +
    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_opts_set_kms_credential_provider_callback (
    +  mongoc_client_encryption_opts_t *opts,
    +  mongoc_kms_credentials_provider_callback_fn fn,
    +  void *userdata);
    +
    +
    +

    Set the user-provided callback to provide KMS credentials on-demand when they +are needed.

    +
    +
    +

    Parameters

    +
      +
    • opts - The options object to update.

    • +
    • fn - The provider callback to set on the options object. May be NULL +to clear the callback. Refer to: +mongoc_kms_credentials_provider_callback_fn

    • +
    • userdata - An arbitrary pointer that will be passed along to the +callback function when it is called by libmongoc.

    • +
    + +

    Related:

    +
    +
    +type mongoc_kms_credentials_provider_callback_fn
    +
    typedef
    +bool (*mongoc_kms_credentials_provider_callback_fn) (void *userdata,
    +                                                     const bson_t *params,
    +                                                     bson_t *out,
    +                                                     bson_error_t *error);
    +
    +
    +

    The type of a callback function for providing KMS providers data on-demand.

    +
    +
    Parameters:
    +
      +
    • userdata - The same userdata pointer provided to the userdata +parameter when the callback was set.

    • +
    • params - Parameters for the requested KMS credentials. Currently +empty.

    • +
    • out - The output bson_t in which to write the new +KMS providers. When passed to the callback, this already points to an +empty BSON document which must be populated.

    • +
    • error - An output parameter for indicating any errors that might +occur while generating the KMS credentials.

    • +
    +
    +
    Return value:
    +

    Must return true on success, false on failure.

    +
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_set_kms_providers.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_kms_providers.html new file mode 100644 index 0000000000000000000000000000000000000000..70a0a71a7ed33ccc27e07bc6591312b5783a51e5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_kms_providers.html @@ -0,0 +1,245 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_kms_providers() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_set_kms_providers()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_opts_set_kms_providers (
    +   mongoc_client_encryption_opts_t *opts, const bson_t *kms_providers);
    +
    +
    +
    +
    +

    Parameters

    + +

    kms_providers is a BSON document containing configuration for each KMS provider. Currently aws, local, azure, gcp, and kmip are supported. At least one must be specified.

    +

    The format for “aws” is as follows:

    +
    aws: {
    +   accessKeyId: String,
    +   secretAccessKey: String
    +}
    +
    +
    +

    The format for “local” is as follows:

    +
    local: {
    +   key: <96 byte BSON binary of subtype 0> or String /* The master key used to encrypt/decrypt data keys. May be passed as a base64 encoded string. */
    +}
    +
    +
    +

    The format for “azure” is as follows:

    +
    azure: {
    +   tenantId: String,
    +   clientId: String,
    +   clientSecret: String,
    +   identityPlatformEndpoint: Optional<String> /* Defaults to login.microsoftonline.com */
    +}
    +
    +
    +

    The format for “gcp” is as follows:

    +
    gcp: {
    +   email: String,
    +   privateKey: byte[] or String, /* May be passed as a base64 encoded string. */
    +   endpoint: Optional<String> /* Defaults to oauth2.googleapis.com */
    +}
    +
    +
    +

    The format for “kmip” is as follows:

    +
    kmip: {
    +   endpoint: String
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_set_tls_opts.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_tls_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..6bb0212205cce480330dbc05559cbeb6981d3cbc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_set_tls_opts.html @@ -0,0 +1,234 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_tls_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_set_tls_opts()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_opts_set_tls_opts (
    +   mongoc_client_encryption_opts_t *opts, const bson_t *tls_opts);
    +
    +
    +
    +
    +

    Parameters

    + +

    tls_opts is a BSON document of the following form:

    +
    <KMS provider name>: {
    +   tlsCaFile: Optional<String>
    +   tlsCertificateKeyFile: Optional<String>
    +   tlsCertificateKeyFilePassword: Optional<String>
    +}
    +
    +
    +

    The KMS providers aws, azure, gcp, and kmip are supported as keys in the tls_opts document.

    +

    tls_opts maps the KMS provider name to a BSON document for TLS options.

    +

    The BSON document for TLS options may contain the following keys:

    +
      +
    • MONGOC_URI_TLSCERTIFICATEKEYFILE

    • +
    • MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD

    • +
    • MONGOC_URI_TLSCAFILE

    • +
    +
    +
    Example use
    +
    mongoc_client_encryption_opts_t *ce_opts =
    +   mongoc_client_encryption_opts_new ();
    +bson_t *tls_opts = bson_new ();
    +
    +BCON_APPEND (tls_opts, "kmip", "{", MONGOC_URI_TLSCAFILE, "ca1.pem", "}");
    +BCON_APPEND (tls_opts, "aws", "{", MONGOC_URI_TLSCAFILE, "ca2.pem", "}");
    +mongoc_client_encryption_opts_set_tls_opts (ce_opts, tls_opts);
    +
    +
    +
    +

    See Configuring TLS for a description of the behavior of these options.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_opts_t.html b/libmongoc/1.24.0/mongoc_client_encryption_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..14b1b68bdb292e92764e9a4c869796f7447250af --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_opts_t.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    + + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_remove_key_alt_name.html b/libmongoc/1.24.0/mongoc_client_encryption_remove_key_alt_name.html new file mode 100644 index 0000000000000000000000000000000000000000..789da02390b7980ccbd55a581fd04c587328fc74 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_remove_key_alt_name.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_encryption_remove_key_alt_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_remove_key_alt_name()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_remove_key_alt_name (
    +   mongoc_client_encryption_t *client_encryption,
    +   const bson_value_t *keyid,
    +   const char *keyaltname,
    +   bson_t *key_doc,
    +   bson_error_t *error);
    +
    +
    +

    Remove keyaltname from the set of keyAltNames in the key document with UUID keyid.

    +

    Also removes the keyAltNames field from the key document if it would otherwise be empty.

    +
    +
    +

    Parameters

    +
      +
    • client_encryption: A mongoc_client_encryption_t.

    • +
    • keyid: The UUID (BSON binary subtype 0x04) of the key to remove the key alternate name from.

    • +
    • keyaltname: The key alternate name to remove.

    • +
    • key_doc: Optional. An uninitialized bson_t set to the value of the key document before removal of the key alternate name, or an empty document the key does not exist. Must be freed by bson_value_destroy().

    • +
    • error: Optional. bson_error_t.

    • +
    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey.html b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey.html new file mode 100644 index 0000000000000000000000000000000000000000..7bcadeb49118aae4d9309d79b08ac90be1495623 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_rewrap_many_datakey()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_encryption_rewrap_many_datakey (
    +   mongoc_client_encryption_t *client_encryption,
    +   const bson_t *filter,
    +   const char *provider,
    +   const bson_t *master_key,
    +   mongoc_client_encryption_rewrap_many_datakey_result_t *result,
    +   bson_error_t *error);
    +
    +
    +

    Rewraps zero or more data keys in the key vault collection that match the +provided filter.

    +

    A NULL argument for filter is equivalent to being given an empty +document (match all).

    +

    If provider is NULL, rewraps matching data keys with their current KMS +provider and master key.

    +

    If provider is not NULL, rewraps matching data keys with the new KMS +provider as described by master_key. The master_key document must +conform to the Client Side Encryption specification.

    +
    +
    +

    Parameters

    +
      +
    • client_encryption: A mongoc_client_encryption_t.

    • +
    • filter: The filter to use when finding data keys to rewrap in the key vault collection.

    • +
    • provider: The new KMS provider to use to encrypt the data keys, or NULL to use the current KMS provider(s).

    • +
    • master_key: The master key fields corresponding to the new KMS provider when provider is not NULL.

    • +
    • result: An optional mongoc_client_encryption_rewrap_many_datakey_result_t.

    • +
    • error: A bson_error_t set on failure.

    • +
    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..cbc066f6e72ed2d84a80564b1bdfa9c697fadcb2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_rewrap_many_datakey_result_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_encryption_rewrap_many_datakey_result_destroy (
    +   mongoc_client_encryption_rewrap_many_datakey_result_t *result);
    +
    +
    +

    Frees resources of a mongoc_client_encryption_rewrap_many_datakey_result_t created with mongoc_client_encryption_rewrap_many_datakey_result_new(). Does nothing if NULL is passed.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html new file mode 100644 index 0000000000000000000000000000000000000000..6aaee004abb0387890d744ab840d2e6772107d0b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result (
    +   mongoc_client_encryption_rewrap_many_datakey_result_t *result)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Get the bulk write result set by a successful call to mongoc_client_encryption_rewrap_many_datakey().

    +

    Returns NULL if no bulk write operation was executed or if the bulk write operation was unacknowledged.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that must not be modified or freed if result is not NULL. Otherwise, returns NULL.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_new.html b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_new.html new file mode 100644 index 0000000000000000000000000000000000000000..52abba364feb17476276fcbaf18ce569e3ca8e34 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_new.html @@ -0,0 +1,196 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_rewrap_many_datakey_result_new()

    +
    +

    Synopsis

    +
    mongoc_client_encryption_rewrap_many_datakey_result_t *
    +mongoc_client_encryption_rewrap_many_datakey_result_new (void)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    A new mongoc_client_encryption_rewrap_many_datakey_result_t that must be freed with mongoc_client_encryption_rewrap_many_datakey_result_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_t.html b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_t.html new file mode 100644 index 0000000000000000000000000000000000000000..e5745aefd4a32e72bb65b9bc2112ac0c1cb32733 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_rewrap_many_datakey_result_t.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_rewrap_many_datakey_result_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_encryption_rewrap_many_datakey_result_t
    +   mongoc_client_encryption_rewrap_many_datakey_result_t;
    +
    +
    +

    Used to access the result of mongoc_client_encryption_rewrap_many_datakey().

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_encryption_t.html b/libmongoc/1.24.0/mongoc_client_encryption_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f3159e7cdc1d6162a347fb1b8cda95273a2f68b7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_encryption_t.html @@ -0,0 +1,238 @@ + + + + + + + + + + + + + + mongoc_client_encryption_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_find_databases_with_opts.html b/libmongoc/1.24.0/mongoc_client_find_databases_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..ce7a43944eb49bdb8b9856c01a70f138efcb8e5e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_find_databases_with_opts.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_find_databases_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_find_databases_with_opts()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_client_find_databases_with_opts (
    +   mongoc_client_t *client, const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Fetches a cursor containing documents, each corresponding to a database on this MongoDB server.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the listDatabases command.

    +
    +
    +

    Errors

    +

    Use mongoc_cursor_error() on the returned cursor to check for errors.

    +
    +
    +

    Returns

    +

    A cursor where each result corresponds to the server’s representation of a database.

    +

    The cursor functions mongoc_cursor_set_limit(), mongoc_cursor_set_batch_size(), and mongoc_cursor_set_max_await_time_ms() have no use on the returned cursor.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_collection.html b/libmongoc/1.24.0/mongoc_client_get_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..af02f81ef92aab8fd20c1c559cbdca7d331d1bc2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_collection.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_get_collection() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_collection()

    +
    +

    Synopsis

    +
    mongoc_collection_t *
    +mongoc_client_get_collection (mongoc_client_t *client,
    +                              const char *db,
    +                              const char *collection)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Get a newly allocated mongoc_collection_t for the collection named collection in the database named db.

    +
    +

    Tip

    +

    Collections are automatically created on the MongoDB server upon insertion of the first document. There is no need to create a collection manually.

    +
    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db: The name of the database containing the collection.

    • +
    • collection: The name of the collection.

    • +
    +
    +
    +

    Returns

    +

    A newly allocated mongoc_collection_t that should be freed with mongoc_collection_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_crypt_shared_version.html b/libmongoc/1.24.0/mongoc_client_get_crypt_shared_version.html new file mode 100644 index 0000000000000000000000000000000000000000..0da37f00f935549fa415745f49436cba1cad5f1d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_crypt_shared_version.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_get_crypt_shared_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_crypt_shared_version()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_client_get_crypt_shared_version (const mongoc_client_t *client)
    +  BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Obtain the version string of the crypt_shared that is loaded for +auto-encryption on the given client. If no crypt_shared library is loaded, +the returned pointer will be NULL.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A pointer to a null-terminated character array string designating the version of +crypt_shared that was loaded for auto-encryption with client. If no +crypt_shared library is loaded, or auto-encryption is not loaded for the given +client, the returned pointer will be NULL. The pointed-to array must not +be modified or freed. The returned pointer is only valid for the lifetime of +client.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_database.html b/libmongoc/1.24.0/mongoc_client_get_database.html new file mode 100644 index 0000000000000000000000000000000000000000..6ee09949593c5886c75bcb8cd0d289dc15fc91ff --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_database.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_get_database() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_database()

    +
    +

    Synopsis

    +
    mongoc_database_t *
    +mongoc_client_get_database (mongoc_client_t *client,
    +                            const char *name) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Get a newly allocated mongoc_database_t for the database named name.

    +
    +

    Tip

    +

    Databases are automatically created on the MongoDB server upon insertion of the first document into a collection. There is no need to create a database manually.

    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated mongoc_database_t that should be freed with mongoc_database_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_database_names.html b/libmongoc/1.24.0/mongoc_client_get_database_names.html new file mode 100644 index 0000000000000000000000000000000000000000..dd5e0cfad1f73a6a800120a4fc04d2504794d842 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_database_names.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_client_get_database_names() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_database_names()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_client_get_database_names_with_opts() in new code.

    +
    +
    +
    +

    Synopsis

    +
    char **
    +mongoc_client_get_database_names (mongoc_client_t *client, bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_client_get_database_names_with_opts);
    +
    +
    +
    +
    +

    Description

    +

    This function queries the MongoDB server for a list of known databases.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A NULL terminated vector of NULL-byte terminated strings. The result should be freed with bson_strfreev().

    +

    NULL is returned upon failure and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_database_names_with_opts.html b/libmongoc/1.24.0/mongoc_client_get_database_names_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4374f39ca14016fd4fcceeea17659e839615dffe --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_database_names_with_opts.html @@ -0,0 +1,239 @@ + + + + + + + + + + + + + + mongoc_client_get_database_names_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_database_names_with_opts()

    +
    +

    Synopsis

    +
    char **
    +mongoc_client_get_database_names_with_opts (mongoc_client_t *client,
    +                                            const bson_t *opts,
    +                                            bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function queries the MongoDB server for a list of known databases.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the listDatabases command.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A NULL terminated vector of NULL-byte terminated strings. The result should be freed with bson_strfreev().

    +

    NULL is returned upon failure and error is set.

    +
    +
    +

    Examples

    +
    {
    +   bson_error_t error;
    +   char **strv;
    +   unsigned i;
    +
    +   if ((strv = mongoc_client_get_database_names_with_opts (client, NULL, &error))) {
    +      for (i = 0; strv[i]; i++)
    +         printf ("%s\n", strv[i]);
    +      bson_strfreev (strv);
    +   } else {
    +      fprintf (stderr, "Command failed: %s\n", error.message);
    +   }
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_default_database.html b/libmongoc/1.24.0/mongoc_client_get_default_database.html new file mode 100644 index 0000000000000000000000000000000000000000..1edee939ba7bab8c6408832f3e48f65bff0a1ee5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_default_database.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_client_get_default_database() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_default_database()

    +
    +

    Synopsis

    +
    mongoc_database_t *
    +mongoc_client_get_default_database (mongoc_client_t *client)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Get the database named in the MongoDB connection URI, or NULL if the URI specifies none.

    +

    Useful when you want to choose which database to use based only on the URI in a configuration file.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated mongoc_database_t that should be freed with mongoc_database_destroy().

    +
    +
    +

    Example

    +
    +
    Default Database Example
    +
    /* default database is "db_name" */
    +mongoc_client_t *client = mongoc_client_new ("mongodb://host/db_name");
    +mongoc_database_t *db = mongoc_client_get_default_database (client);
    +
    +assert (!strcmp ("db_name", mongoc_database_get_name (db)));
    +
    +mongoc_database_destroy (db);
    +mongoc_client_destroy (client);
    +
    +/* no default database */
    +client = mongoc_client_new ("mongodb://host/");
    +db = mongoc_client_get_default_database (client);
    +
    +assert (!db);
    +
    +mongoc_client_destroy (client);
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_gridfs.html b/libmongoc/1.24.0/mongoc_client_get_gridfs.html new file mode 100644 index 0000000000000000000000000000000000000000..b0b7533f3b426bfb06ece4dacd75a73569337c08 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_gridfs.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_client_get_gridfs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_gridfs()

    +
    +

    Synopsis

    +
    mongoc_gridfs_t *
    +mongoc_client_get_gridfs (mongoc_client_t *client,
    +                          const char *db,
    +                          const char *prefix,
    +                          bson_error_t *error) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    The mongoc_client_get_gridfs() function shall create a new mongoc_gridfs_t. The db parameter is the name of the database which the gridfs instance should exist in. The prefix parameter corresponds to the gridfs collection namespacing; its default is “fs”, thus the default GridFS collection names are “fs.files” and “fs.chunks”.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db: The database name.

    • +
    • prefix: Optional prefix for gridfs collection names or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    On success, returns a mongoc_gridfs_t you must free with mongoc_gridfs_destroy(). Returns NULL upon failure and sets error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_handshake_description.html b/libmongoc/1.24.0/mongoc_client_get_handshake_description.html new file mode 100644 index 0000000000000000000000000000000000000000..5c0dcee75d36691e4fea59b4915bcd79b54dd377 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_handshake_description.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_client_get_handshake_description() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_handshake_description()

    +
    +

    Synopsis

    +
    mongoc_server_description_t *
    +mongoc_client_get_handshake_description (mongoc_client_t *client,
    +                                         uint32_t server_id,
    +                                         bson_t *opts,
    +                                         bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Returns a description constructed from the initial handshake response to a server.

    +
    +
    +

    Description

    +

    mongoc_client_get_handshake_description() is distinct from mongoc_client_get_server_description(). mongoc_client_get_server_description() returns a server description constructed from monitoring, which may differ from the server description constructed from the connection handshake.

    +

    mongoc_client_get_handshake_description() will attempt to establish a connection to the server if a connection was not already established. It will perform the MongoDB handshake and authentication if required.

    +

    Use this function only for building a language driver that wraps the C Driver. When writing applications in C, higher-level functions automatically select a suitable server.

    +
    +

    Single-threaded client behavior

    +

    Single-threaded clients only have one active connection to each server. The one connection is used for both monitoring and application operations. However, the server description returned by mongoc_client_get_handshake_description() may still differ from the server description returned by mongoc_client_get_server_description(). Notably, if connected to a load balanced cluster, the server description returned by mongoc_client_get_server_description() will describe the load balancer server (mongoc_server_description_type() will return “LoadBalancer”). And the server description returned by mongoc_client_get_handshake_description() will describe the backing server.

    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_server_description_t that must be freed with mongoc_server_description_destroy(). If a connection has not been successfully established to a server, returns NULL and error is filled out.

    +
    +
    +

    See Also

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_read_concern.html b/libmongoc/1.24.0/mongoc_client_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..350acca7cc9fa79626bb3688c05a424fbc97beb1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_read_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_read_concern()

    +
    +

    Synopsis

    +
    const mongoc_read_concern_t *
    +mongoc_client_get_read_concern (const mongoc_client_t *client);
    +
    +
    +

    Retrieve the default read concern configured for the client instance. The result should not be modified or freed.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_read_concern_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_read_prefs.html b/libmongoc/1.24.0/mongoc_client_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..767d47ad3a4fb9288d3c250e1451f5a417b09520 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_read_prefs.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_read_prefs()

    +
    +

    Synopsis

    +
    const mongoc_read_prefs_t *
    +mongoc_client_get_read_prefs (const mongoc_client_t *client);
    +
    +
    +

    Retrieves the default read preferences configured for the client instance. The result should not be modified or freed.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_read_prefs_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_server_description.html b/libmongoc/1.24.0/mongoc_client_get_server_description.html new file mode 100644 index 0000000000000000000000000000000000000000..e88ac8b8749436aec3e00c0afd79d4342fb71513 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_server_description.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_client_get_server_description() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_server_description()

    +
    +

    Synopsis

    +
    mongoc_server_description_t *
    +mongoc_client_get_server_description (
    +   mongoc_client_t *client, uint32_t server_id) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Get information about the server specified by server_id.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • server_id: An opaque id specifying the server.

    • +
    +
    +
    +

    Returns

    +

    A mongoc_server_description_t that must be freed with mongoc_server_description_destroy(). If the server is no longer in the topology, returns NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_server_descriptions.html b/libmongoc/1.24.0/mongoc_client_get_server_descriptions.html new file mode 100644 index 0000000000000000000000000000000000000000..4ab7bc451b0f6334a577f9e511656f2d34fbd998 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_server_descriptions.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_client_get_server_descriptions() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_server_descriptions()

    +
    +

    Synopsis

    +
    mongoc_server_description_t **
    +mongoc_client_get_server_descriptions (const mongoc_client_t *client,
    +                                       size_t *n) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Fetches an array of mongoc_server_description_t structs for all known servers in the topology. Returns no servers until the client connects. Returns a single server if the client is directly connected, or all members of a replica set if the client’s MongoDB URI includes a “replicaSet” option, or all known mongos servers if the MongoDB URI includes a list of them.

    +
    void
    +show_servers (const mongoc_client_t *client)
    +{
    +   bson_t *b = BCON_NEW ("ping", BCON_INT32 (1));
    +   bson_error_t error;
    +   bool r;
    +   mongoc_server_description_t **sds;
    +   size_t i, n;
    +
    +   /* ensure client has connected */
    +   r = mongoc_client_command_simple (client, "db", b, NULL, NULL, &error);
    +   if (!r) {
    +      MONGOC_ERROR ("could not connect: %s\n", error.message);
    +      return;
    +   }
    +
    +   sds = mongoc_client_get_server_descriptions (client, &n);
    +
    +   for (i = 0; i < n; ++i) {
    +      printf ("%s\n", mongoc_server_description_host (sds[i])->host_and_port);
    +   }
    +
    +   mongoc_server_descriptions_destroy_all (sds, n);
    +   bson_destroy (&b);
    +}
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • n: Receives the length of the descriptions array.

    • +
    +
    +
    +

    Returns

    +

    A newly allocated array that must be freed with mongoc_server_descriptions_destroy_all().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_server_status.html b/libmongoc/1.24.0/mongoc_client_get_server_status.html new file mode 100644 index 0000000000000000000000000000000000000000..14a5e752e25cc41f0050a8b5d2e14198d05fe96d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_server_status.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_client_get_server_status() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_server_status()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.10.0: This function is deprecated and should not be used in new code.

    +

    Run the serverStatus command directly with mongoc_client_read_command_with_opts() instead.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_client_get_server_status (mongoc_client_t *client,
    +                                 mongoc_read_prefs_t *read_prefs,
    +                                 bson_t *reply,
    +                                 bson_error_t *error) BSON_GNUC_DEPRECATED;
    +
    +
    +

    Queries the server for the current server status. The result is stored in reply.

    +

    reply is always initialized, even in the case of failure. Always call bson_destroy() to release it.

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_uri.html b/libmongoc/1.24.0/mongoc_client_get_uri.html new file mode 100644 index 0000000000000000000000000000000000000000..3dd51bb5541dba85c0fa0dd3d03ba494d9f02fc0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_uri.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_uri() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_uri()

    +
    +

    Synopsis

    +
    const mongoc_uri_t *
    +mongoc_client_get_uri (const mongoc_client_t *client);
    +
    +
    +

    Fetches the mongoc_uri_t used to create the client.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_uri_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_get_write_concern.html b/libmongoc/1.24.0/mongoc_client_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..5ffdb0b7d3c7ec920bd05e1cac3eb2cced3aba30 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_get_write_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_get_write_concern()

    +
    +

    Synopsis

    +
    const mongoc_write_concern_t *
    +mongoc_client_get_write_concern (const mongoc_client_t *client);
    +
    +
    +

    Retrieve the default write concern configured for the client instance. The result should not be modified or freed.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_write_concern_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_new.html b/libmongoc/1.24.0/mongoc_client_new.html new file mode 100644 index 0000000000000000000000000000000000000000..1e3f79b93326e206d5156fff05ec10d6b656d1b0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_new.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_new()

    +
    +

    Synopsis

    +
    mongoc_client_t *
    +mongoc_client_new (const char *uri_string) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Creates a new mongoc_client_t using the URI string provided.

    +
    +
    +

    Parameters

    +
      +
    • uri_string: A string containing the MongoDB connection URI.

    • +
    +
    +
    +

    Returns

    +

    A newly allocated mongoc_client_t that should be freed with mongoc_client_destroy() when no longer in use. On error, NULL is returned and an error or warning will be logged.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_new_from_uri.html b/libmongoc/1.24.0/mongoc_client_new_from_uri.html new file mode 100644 index 0000000000000000000000000000000000000000..df5e327fd4211df2cd36e491e53c5656e9bf63d2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_new_from_uri.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_new_from_uri() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_new_from_uri()

    +
    +

    Synopsis

    +
    mongoc_client_t *
    +mongoc_client_new_from_uri (const mongoc_uri_t *uri)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Creates a new mongoc_client_t using the mongoc_uri_t provided.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated mongoc_client_t that should be freed with mongoc_client_destroy() when no longer in use. On error, NULL is returned and an error will be logged.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_new_from_uri_with_error.html b/libmongoc/1.24.0/mongoc_client_new_from_uri_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..258b450cb65940f18609d93db3ad71fe5b7d424f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_new_from_uri_with_error.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_client_new_from_uri_with_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_new_from_uri_with_error()

    +
    +

    Synopsis

    +
    mongoc_client_t *
    +mongoc_client_new_from_uri_with_error (const mongoc_uri_t *uri,
    +                                       bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Creates a new mongoc_client_t using the mongoc_uri_t provided.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated mongoc_client_t that should be freed with mongoc_client_destroy() when no longer in use. On error, NULL is returned and error will be populated with the error description.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_destroy.html b/libmongoc/1.24.0/mongoc_client_pool_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..b684c7069fb32aabf2ee8e2357c8b9d23bb873f7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_destroy.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_client_pool_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_pool_destroy (mongoc_client_pool_t *pool);
    +
    +
    +

    Release all resources associated with pool, including freeing the structure.

    +

    All mongoc_client_t objects obtained from mongoc_client_pool_pop() from pool must be pushed back onto the pool with mongoc_client_pool_push() prior to calling mongoc_client_pool_destroy().

    +

    This method is NOT thread safe, and must only be called by one thread. It should be called once the application is shutting down, and after all other threads that use clients have been joined.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_enable_auto_encryption.html b/libmongoc/1.24.0/mongoc_client_pool_enable_auto_encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..0521c4a90647242e1c96d4b00d6a8caebde6d62e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_enable_auto_encryption.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_client_pool_enable_auto_encryption() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_enable_auto_encryption()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_pool_enable_auto_encryption (mongoc_client_pool_t *pool,
    +                                           mongoc_auto_encryption_opts_t* opts,
    +                                           bson_error_t* error);
    +
    +
    +

    Enable automatic client side encryption on a mongoc_client_pool_t. Requires libmongoc to be built with support for In-Use Encryption. See In-Use Encryption for instructions to enable In-Use Encryption in libmongoc.

    +

    Automatic encryption is an enterprise-only feature that only applies to operations on a collection. Automatic encryption is not supported for operations on a database or view, and operations that are not bypassed will result in error. To bypass automatic encryption for all operations, bypass automatic encryption with mongoc_auto_encryption_opts_set_bypass_auto_encryption() in opts.

    +

    Automatic encryption requires the authenticated user to have the listCollections privilege action.

    +

    Enabling automatic encryption reduces the maximum message size and may have a negative performance impact.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    +
    +

    See also

    + + +
    +
    In-Use Encryption for libmongoc
    +
    +
    +
    The MongoDB Manual for Client-Side Field Level Encryption
    +
    +
    +
    The MongoDB Manual for Queryable Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_max_size.html b/libmongoc/1.24.0/mongoc_client_pool_max_size.html new file mode 100644 index 0000000000000000000000000000000000000000..bcaea15d99d1af892b20f240db8cf6f6b4797624 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_max_size.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_client_pool_max_size() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_max_size()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_pool_max_size (mongoc_client_pool_t *pool,
    +                             uint32_t max_pool_size);
    +
    +
    +

    This function sets the maximum number of pooled connections available from a mongoc_client_pool_t.

    +
    +
    +

    Parameters

    +
      +
    • pool: A mongoc_client_pool_t.

    • +
    • max_pool_size: The maximum number of connections which shall be available from the pool.

    • +
    +
    +
    +

    Thread Safety

    +

    This function is safe to call from multiple threads.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_min_size.html b/libmongoc/1.24.0/mongoc_client_pool_min_size.html new file mode 100644 index 0000000000000000000000000000000000000000..cec714525d65e4260fc7854815ab3793d1827d5a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_min_size.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_pool_min_size() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_min_size()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated because its behavior does not match what developers expect from a “minimum pool size”, and its actual behavior is likely to hurt performance.

    +

    Applications should not call this function, they should instead accept the default behavior, which is to keep all idle clients that are pushed into the pool.

    +
    +
    +
    +

    Synopsis

    +
    void
    +mongoc_client_pool_min_size (mongoc_client_pool_t *pool,
    +                             uint32_t min_pool_size)
    +   BSON_GNUC_DEPRECATED;
    +
    +
    +

    This function sets the maximum number of idle clients to be kept in the pool. Any idle clients in excess of the maximum are destroyed.

    +
    +
    +

    Parameters

    + +
    +
    +

    Thread Safety

    +

    This function is safe to call from multiple threads.

    +

    Subsequent calls to mongoc_client_pool_push() respect the new minimum size, and close the least recently used mongoc_client_t if the minimum size is exceeded.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_new.html b/libmongoc/1.24.0/mongoc_client_pool_new.html new file mode 100644 index 0000000000000000000000000000000000000000..3085eb36f56b54fd77568382757a7a9cd298eb15 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_new.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_new()

    +
    +

    Synopsis

    +
    mongoc_client_pool_t *
    +mongoc_client_pool_new (const mongoc_uri_t *uri) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function creates a new mongoc_client_pool_t using the mongoc_uri_t provided.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated mongoc_client_pool_t that should be freed with mongoc_client_pool_destroy() when no longer in use. On error, NULL is returned and an error may be logged.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_new_with_error.html b/libmongoc/1.24.0/mongoc_client_pool_new_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..364980230a159f913740aef7ad7f35df3e310f5f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_new_with_error.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_client_pool_new_with_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_new_with_error()

    +
    +

    Synopsis

    +
    mongoc_client_pool_t *
    +mongoc_client_pool_new_with_error (const mongoc_uri_t *uri,
    +                                   bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function creates a new mongoc_client_pool_t using the mongoc_uri_t provided.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated mongoc_client_pool_t that should be freed with mongoc_client_pool_destroy() when no longer in use. On error, NULL is returned and error will be populated with the error description.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_pop.html b/libmongoc/1.24.0/mongoc_client_pool_pop.html new file mode 100644 index 0000000000000000000000000000000000000000..3c53f88b6426ad03a5389e96e70151064af7b327 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_pop.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_pop() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_pop()

    +
    +

    Synopsis

    +
    mongoc_client_t *
    +mongoc_client_pool_pop (mongoc_client_pool_t *pool)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Retrieve a mongoc_client_t from the client pool, or create one. The total number of clients that can be created from this pool is limited by the URI option “maxPoolSize”, default 100. If this number of clients has been created and all are in use, mongoc_client_pool_pop blocks until another thread returns a client with mongoc_client_pool_push(). If the “waitQueueTimeoutMS” URI option was specified with a positive value, then mongoc_client_pool_pop will return NULL when the timeout expires.

    +

    The returned mongoc_client_t must be returned to the pool with mongoc_client_pool_push().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_client_t.

    +
    +
    +

    Thread Safety

    +

    This function is safe to call from multiple threads.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_push.html b/libmongoc/1.24.0/mongoc_client_pool_push.html new file mode 100644 index 0000000000000000000000000000000000000000..51a2a9be06937e42e437dcf83d987946a314dea0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_push.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_pool_push() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_push()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_pool_push (mongoc_client_pool_t *pool, mongoc_client_t *client);
    +
    +
    +

    This function returns a mongoc_client_t back to the client pool.

    +
    +
    +

    Parameters

    + +
    +
    +

    Thread Safety

    +

    This function is safe to call from multiple threads.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_set_apm_callbacks.html b/libmongoc/1.24.0/mongoc_client_pool_set_apm_callbacks.html new file mode 100644 index 0000000000000000000000000000000000000000..045394b92ebd16d7804d6525d7a2f9800070c3c4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_set_apm_callbacks.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_apm_callbacks() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_set_apm_callbacks()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_pool_set_apm_callbacks (mongoc_client_pool_t *pool,
    +                                      mongoc_apm_callbacks_t *callbacks,
    +                                      void *context);
    +
    +
    +

    Register a set of callbacks to receive Application Performance Monitoring events.

    +

    The callbacks are copied by the pool and may be destroyed at any time after. If a context is passed, it is the application’s responsibility to ensure context remains valid for the lifetime of the pool.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    +

    Thread Safety

    +

    This function can only be called once on a pool, and must be called before the first call to mongoc_client_pool_pop().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_set_appname.html b/libmongoc/1.24.0/mongoc_client_pool_set_appname.html new file mode 100644 index 0000000000000000000000000000000000000000..be768826069c5dbcfe1da9424404d429667edf8a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_set_appname.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_appname() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_set_appname()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_pool_set_appname (mongoc_client_pool_t *pool, const char *appname)
    +
    +
    +

    This function is identical to mongoc_client_set_appname() except for client pools.

    +

    Also note that mongoc_client_set_appname() cannot be called on a client retrieved from a client pool.

    +
    +
    +

    Parameters

    +
      +
    • pool: A mongoc_client_pool_t.

    • +
    • appname: The application name, of length at most MONGOC_HANDSHAKE_APPNAME_MAX.

    • +
    +
    +
    +

    Returns

    +

    Returns true if appname was set. If appname is too long, returns false and logs an error.

    +
    +
    +

    Thread Safety

    +

    This function can only be called once on a pool, and must be called before the first call to mongoc_client_pool_pop().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_set_error_api.html b/libmongoc/1.24.0/mongoc_client_pool_set_error_api.html new file mode 100644 index 0000000000000000000000000000000000000000..43f32c6bb01e5d7e56de0f89fb652d52b98ac68f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_set_error_api.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_error_api() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_set_error_api()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_pool_set_error_api (mongoc_client_pool_t *client,
    +                                  int32_t version);
    +
    +
    +

    Configure how the C Driver reports errors. See Setting the Error API Version.

    +
    +
    +

    Parameters

    +
      +
    • pool: A mongoc_client_pool_t.

    • +
    • version: The version of the error API, either MONGOC_ERROR_API_VERSION_LEGACY or MONGOC_ERROR_API_VERSION_2.

    • +
    +
    +
    +

    Returns

    +

    Returns true if the error API version was set, or logs an error message and returns false if version is invalid.

    +
    +
    +

    Thread Safety

    +

    This function can only be called once on a pool, and must be called before the first call to mongoc_client_pool_pop().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_set_server_api.html b/libmongoc/1.24.0/mongoc_client_pool_set_server_api.html new file mode 100644 index 0000000000000000000000000000000000000000..f91c64bb8187c63e955e47de8167c3d76c21e945 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_set_server_api.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_server_api() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_set_server_api()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_pool_set_server_api (mongoc_client_pool_t *pool,
    +                                   const mongoc_server_api_t *api,
    +                                   bson_error_t *error);
    +
    +
    +

    Set the API version to use for clients created through pool. Once the API version is set on a pool, it may not be changed to a new value. Attempting to do so will cause this method to fail and set error.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True if the version was successfully set, false if not. On failure, error will be set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_set_ssl_opts.html b/libmongoc/1.24.0/mongoc_client_pool_set_ssl_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..1f1fe3c912ef9b278214bfa6d05f37e3fe0f0f92 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_set_ssl_opts.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_ssl_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_set_ssl_opts()

    +
    +

    Synopsis

    +
    #ifdef MONGOC_ENABLE_SSL
    +void
    +mongoc_client_pool_set_ssl_opts (mongoc_client_pool_t *pool,
    +                                 const mongoc_ssl_opt_t *opts);
    +#endif
    +
    +
    +

    This function is identical to mongoc_client_set_ssl_opts() except for +client pools. It ensures that all clients retrieved from +mongoc_client_pool_pop() or mongoc_client_pool_try_pop() +are configured with the same SSL settings.

    +

    The mongoc_ssl_opt_t struct is copied by the pool along with the strings +it points to (pem_file, pem_pwd, ca_file, ca_dir, and +crl_file) so they don’t have to remain valid after the call to +mongoc_client_pool_set_ssl_opts.

    +

    A call to mongoc_client_pool_set_ssl_opts overrides all TLS options set +through the connection string with which the mongoc_client_pool_t was +constructed.

    +
    +
    +

    Parameters

    + +
    +
    +

    Thread Safety

    +

    This function can only be called once on a pool, and must be called before the first call to mongoc_client_pool_pop().

    +
    +
    +

    Availability

    +

    This feature requires that the MongoDB C driver was compiled with -DENABLE_SSL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_t.html b/libmongoc/1.24.0/mongoc_client_pool_t.html new file mode 100644 index 0000000000000000000000000000000000000000..6c051930be2fdea4161da8cfaa86d2684b9f765c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_t.html @@ -0,0 +1,322 @@ + + + + + + + + + + + + + + mongoc_client_pool_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_t

    +

    A connection pool for multi-threaded programs. See Connection Pooling.

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_pool_t mongoc_client_pool_t
    +
    +
    +

    mongoc_client_pool_t is the basis for multi-threading in the MongoDB C driver. Since mongoc_client_t structures are not thread-safe, this structure is used to retrieve a new mongoc_client_t for a given thread. This structure is thread-safe, except for its destructor method, mongoc_client_pool_destroy(), which is not thread-safe and must only be called from one thread.

    +
    +
    +

    Example

    +
    +
    example-pool.c
    +
    /* gcc example-pool.c -o example-pool $(pkg-config --cflags --libs
    + * libmongoc-1.0) */
    +
    +/* ./example-pool [CONNECTION_STRING] */
    +
    +#include <mongoc/mongoc.h>
    +#include <pthread.h>
    +#include <stdio.h>
    +
    +static pthread_mutex_t mutex;
    +static bool in_shutdown = false;
    +
    +static void *
    +worker (void *data)
    +{
    +   mongoc_client_pool_t *pool = data;
    +   mongoc_client_t *client;
    +   bson_t ping = BSON_INITIALIZER;
    +   bson_error_t error;
    +   bool r;
    +
    +   BSON_APPEND_INT32 (&ping, "ping", 1);
    +
    +   while (true) {
    +      client = mongoc_client_pool_pop (pool);
    +      /* Do something with client. If you are writing an HTTP server, you
    +       * probably only want to hold onto the client for the portion of the
    +       * request performing database queries.
    +       */
    +      r = mongoc_client_command_simple (
    +         client, "admin", &ping, NULL, NULL, &error);
    +
    +      if (!r) {
    +         fprintf (stderr, "%s\n", error.message);
    +      }
    +
    +      mongoc_client_pool_push (pool, client);
    +
    +      pthread_mutex_lock (&mutex);
    +      if (in_shutdown || !r) {
    +         pthread_mutex_unlock (&mutex);
    +         break;
    +      }
    +
    +      pthread_mutex_unlock (&mutex);
    +   }
    +
    +   bson_destroy (&ping);
    +   return NULL;
    +}
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=pool-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +   mongoc_client_pool_t *pool;
    +   pthread_t threads[10];
    +   unsigned i;
    +   void *ret;
    +
    +   pthread_mutex_init (&mutex, NULL);
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   pool = mongoc_client_pool_new (uri);
    +   mongoc_client_pool_set_error_api (pool, 2);
    +
    +   for (i = 0; i < 10; i++) {
    +      pthread_create (&threads[i], NULL, worker, pool);
    +   }
    +
    +   sleep (10);
    +   pthread_mutex_lock (&mutex);
    +   in_shutdown = true;
    +   pthread_mutex_unlock (&mutex);
    +
    +   for (i = 0; i < 10; i++) {
    +      pthread_join (threads[i], &ret);
    +   }
    +
    +   mongoc_client_pool_destroy (pool);
    +   mongoc_uri_destroy (uri);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_pool_try_pop.html b/libmongoc/1.24.0/mongoc_client_pool_try_pop.html new file mode 100644 index 0000000000000000000000000000000000000000..68f00734b9fc23145d2e9c2722bebeecf35e0caf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_pool_try_pop.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_client_pool_try_pop() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_pool_try_pop()

    +
    +

    Synopsis

    +
    mongoc_client_t *
    +mongoc_client_pool_try_pop (mongoc_client_pool_t *pool)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function is identical to mongoc_client_pool_pop() except it will return NULL instead of blocking for a client to become available.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_client_t if one is immediately available, otherwise NULL.

    +
    +
    +

    Thread Safety

    +

    This function is safe to call from multiple threads.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_read_command_with_opts.html b/libmongoc/1.24.0/mongoc_client_read_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..d8c9d66a97978fd79030f6f073e70761f6e2a0df --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_read_command_with_opts.html @@ -0,0 +1,412 @@ + + + + + + + + + + + + + + mongoc_client_read_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_read_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_read_command_with_opts (mongoc_client_t *client,
    +                                      const char *db_name,
    +                                      const bson_t *command,
    +                                      const mongoc_read_prefs_t *read_prefs,
    +                                      const bson_t *opts,
    +                                      bson_t *reply,
    +                                      bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic that is specific to commands that read, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_client_command_simple().

    +

    Use this function for commands that read such as “count” or “distinct”.

    +

    Read preferences, read concern, and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. The highest-priority sources for these options are listed first in the following table. No write concern is applied.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Collation

    read_prefs

    opts

    opts

    Transaction

    Transaction

    client

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +

    Retry logic occurs regardless of the underlying command. Retrying mapReduce has the potential for degraded performance. +Retrying a getMore command has the potential to miss results. For those commands, use generic command helpers (like mongoc_client_command_with_opts()) instead.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • command: A bson_t containing the command specification.

    • +
    • read_prefs: An optional mongoc_read_prefs_t.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    +

    Example

    +
    +
    example-command-with-opts.c
    +
    /*
    +
    +Demonstrates how to prepare options for mongoc_client_read_command_with_opts and
    +mongoc_client_write_command_with_opts. First it calls "cloneCollectionAsCapped"
    +command with "writeConcern" option, then "distinct" command with "collation" and
    +"readConcern" options,
    +
    +Start a MongoDB 3.4 replica set with --enableMajorityReadConcern and insert two
    +documents:
    +
    +$ mongo
    +MongoDB Enterprise replset:PRIMARY> db.my_collection.insert({x: 1, y: "One"})
    +WriteResult({ "nInserted" : 1 })
    +MongoDB Enterprise replset:PRIMARY> db.my_collection.insert({x: 2, y: "Two"})
    +WriteResult({ "nInserted" : 1 })
    +
    +Build and run the example:
    +
    +gcc example-command-with-opts.c -o example-command-with-opts $(pkg-config
    +--cflags --libs libmongoc-1.0)
    +./example-command-with-opts [CONNECTION_STRING]
    +cloneCollectionAsCapped: { "ok" : 1 }
    +distinct: { "values" : [ 1, 2 ], "ok" : 1 }
    +
    +*/
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=client-example";
    +   mongoc_uri_t *uri;
    +   bson_t *cmd;
    +   bson_t *opts;
    +   mongoc_write_concern_t *write_concern;
    +   mongoc_read_prefs_t *read_prefs;
    +   mongoc_read_concern_t *read_concern;
    +   bson_t reply;
    +   bson_error_t error;
    +   char *json;
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   cmd = BCON_NEW ("cloneCollectionAsCapped",
    +                   BCON_UTF8 ("my_collection"),
    +                   "toCollection",
    +                   BCON_UTF8 ("my_capped_collection"),
    +                   "size",
    +                   BCON_INT64 (1024 * 1024));
    +
    +   /* include write concern "majority" in command options */
    +   write_concern = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_wmajority (write_concern, 10000 /* wtimeoutMS */);
    +   opts = bson_new ();
    +   mongoc_write_concern_append (write_concern, opts);
    +
    +   if (mongoc_client_write_command_with_opts (
    +          client, "test", cmd, opts, &reply, &error)) {
    +      json = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("cloneCollectionAsCapped: %s\n", json);
    +      bson_free (json);
    +   } else {
    +      fprintf (stderr, "cloneCollectionAsCapped: %s\n", error.message);
    +   }
    +
    +   bson_free (cmd);
    +   bson_free (opts);
    +
    +   /* distinct values of "x" in "my_collection" where "y" sorts after "one" */
    +   cmd = BCON_NEW ("distinct",
    +                   BCON_UTF8 ("my_collection"),
    +                   "key",
    +                   BCON_UTF8 ("x"),
    +                   "query",
    +                   "{",
    +                   "y",
    +                   "{",
    +                   "$gt",
    +                   BCON_UTF8 ("one"),
    +                   "}",
    +                   "}");
    +
    +   read_prefs = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +
    +   /* "One" normally sorts before "one"; make "One" sort after "one" */
    +   opts = BCON_NEW ("collation",
    +                    "{",
    +                    "locale",
    +                    BCON_UTF8 ("en_US"),
    +                    "caseFirst",
    +                    BCON_UTF8 ("lower"),
    +                    "}");
    +
    +   /* add a read concern to "opts" */
    +   read_concern = mongoc_read_concern_new ();
    +   mongoc_read_concern_set_level (read_concern,
    +                                  MONGOC_READ_CONCERN_LEVEL_MAJORITY);
    +
    +   mongoc_read_concern_append (read_concern, opts);
    +
    +   if (mongoc_client_read_command_with_opts (
    +          client, "test", cmd, read_prefs, opts, &reply, &error)) {
    +      json = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("distinct: %s\n", json);
    +      bson_free (json);
    +   } else {
    +      fprintf (stderr, "distinct: %s\n", error.message);
    +   }
    +
    +   bson_destroy (cmd);
    +   bson_destroy (opts);
    +   bson_destroy (&reply);
    +   mongoc_read_prefs_destroy (read_prefs);
    +   mongoc_read_concern_destroy (read_concern);
    +   mongoc_write_concern_destroy (write_concern);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_read_write_command_with_opts.html b/libmongoc/1.24.0/mongoc_client_read_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..f61a9da1e65ea35a0f95d3db0c730991a7f1f79f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_read_write_command_with_opts.html @@ -0,0 +1,260 @@ + + + + + + + + + + + + + + mongoc_client_read_write_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_read_write_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_read_write_command_with_opts (
    +   mongoc_client_t *client,
    +   const char *db_name,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs /* UNUSED */,
    +   const bson_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic for commands that both read and write, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_client_command_simple().

    +

    Use this function for commands that both read and write, such as “mapReduce” with an output collection.

    +

    Read and write concern and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts. The highest-priority sources for these options are listed first in the following table. Read preferences are not applied. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Concern

    Write Concern

    Collation

    opts

    opts

    opts

    Transaction

    Transaction

    client

    client

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    (The mongoc_read_prefs_t parameter was included by mistake when this function was introduced in libmongoc 1.5. A command that writes must not obey a read preference.)

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • command: A bson_t containing the command specification.

    • +
    • read_prefs: Ignored.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_reset.html b/libmongoc/1.24.0/mongoc_client_reset.html new file mode 100644 index 0000000000000000000000000000000000000000..8d0181b69ad6207ee72a976c0462f394eba51cda --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_reset.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_reset() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_reset()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_reset (mongoc_client_t *client);
    +
    +
    +

    Call this method in the child after forking to invalidate the mongoc_client_t.

    +
    +
    +

    Description

    +

    Calling mongoc_client_reset() prevents resource cleanup in the child process from interfering with the parent process.

    +

    This method causes the client to clear its session pool without sending endSessions. It also increments an internal generation counter on the given client. After this method is called, cursors from previous generations will not issue a killCursors command when they are destroyed. Client sessions from previous generations cannot be used and should be destroyed.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_select_server.html b/libmongoc/1.24.0/mongoc_client_select_server.html new file mode 100644 index 0000000000000000000000000000000000000000..9e6fcc906593bb84c726ff1c1344f470325f6eaf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_select_server.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_select_server() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_select_server()

    +
    +

    Synopsis

    +
    mongoc_server_description_t *
    +mongoc_client_select_server (mongoc_client_t *client,
    +                             bool for_writes,
    +                             const mongoc_read_prefs_t *prefs,
    +                             bson_error_t *error) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Choose a server for an operation, according to the logic described in the Server Selection Spec.

    +

    Use this function only for building a language driver that wraps the C Driver. When writing applications in C, higher-level functions automatically select a suitable server.

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • for_writes: Whether to choose a server suitable for writes or reads.

    • +
    • prefs: An optional mongoc_read_prefs_t. If for_writes is true, prefs must be NULL. Otherwise, use prefs to customize server selection, or pass NULL to use read preference PRIMARY.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Returns

    +

    A mongoc_server_description_t that must be freed with mongoc_server_description_destroy(). If no suitable server is found, returns NULL and error is filled out.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_abort_transaction.html b/libmongoc/1.24.0/mongoc_client_session_abort_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..a47879370146b51bd06091c34b0fd4ab41d3f66f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_abort_transaction.html @@ -0,0 +1,306 @@ + + + + + + + + + + + + + + mongoc_client_session_abort_transaction() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_abort_transaction()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_abort_transaction (mongoc_client_session_t *session,
    +                                         bson_error_t *error);
    +
    +
    +

    Abort a multi-document transaction.

    +
    +
    +

    Parameters

    + +
    +
    +

    Return

    +

    Returns true if the transaction was aborted. Returns false and sets error if there are invalid arguments, such as a session with no transaction in progress. Network or server errors are ignored.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_advance_cluster_time.html b/libmongoc/1.24.0/mongoc_client_session_advance_cluster_time.html new file mode 100644 index 0000000000000000000000000000000000000000..fb548785bd73b4d8b9b82d5e92f76950fcbd7a48 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_advance_cluster_time.html @@ -0,0 +1,303 @@ + + + + + + + + + + + + + + mongoc_client_session_advance_cluster_time() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_advance_cluster_time()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_session_advance_cluster_time (mongoc_client_session_t *session,
    +                                            const bson_t *cluster_time);
    +
    +
    +

    Advance the cluster time for a session. Has an effect only if the new cluster time is greater than the session’s current cluster time.

    +

    Use mongoc_client_session_advance_operation_time() and mongoc_client_session_advance_cluster_time() to copy the operationTime and clusterTime from another session, ensuring subsequent operations in this session are causally consistent with the last operation in the other session

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_advance_operation_time.html b/libmongoc/1.24.0/mongoc_client_session_advance_operation_time.html new file mode 100644 index 0000000000000000000000000000000000000000..e596cc3a4d12c1f9f7710ca877d190320557399a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_advance_operation_time.html @@ -0,0 +1,305 @@ + + + + + + + + + + + + + + mongoc_client_session_advance_operation_time() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_advance_operation_time()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_session_advance_operation_time (mongoc_client_session_t *session,
    +                                              uint32_t timestamp,
    +                                              uint32_t increment);
    +
    +
    +

    Advance the session’s operation time, expressed as a BSON Timestamp with timestamp and increment components. Has an effect only if the new operation time is greater than the session’s current operation time.

    +

    Use mongoc_client_session_advance_operation_time() and mongoc_client_session_advance_cluster_time() to copy the operationTime and clusterTime from another session, ensuring subsequent operations in this session are causally consistent with the last operation in the other session

    +
    +
    +

    Parameters

    +
      +
    • session: A mongoc_client_session_t.

    • +
    • timestamp: The new operationTime’s timestamp component.

    • +
    • increment: The new operationTime’s increment component.

    • +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_append.html b/libmongoc/1.24.0/mongoc_client_session_append.html new file mode 100644 index 0000000000000000000000000000000000000000..2b210df13244d1e544e5498a06519a8c423a99be --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_append.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_client_session_append() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_append()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_append (const mongoc_client_session_t *client_session,
    +                              bson_t *opts,
    +                              bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function appends a logical session id to command options. Use it to configure a session for any function that takes an options document, such as mongoc_client_write_command_with_opts().

    +

    It is an error to use a session for unacknowledged writes.

    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and fills out error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_session_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_commit_transaction.html b/libmongoc/1.24.0/mongoc_client_session_commit_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..c6400130d34576f6dbbb540ef96c87c1f0e52ed3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_commit_transaction.html @@ -0,0 +1,309 @@ + + + + + + + + + + + + + + mongoc_client_session_commit_transaction() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_commit_transaction()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_commit_transaction (mongoc_client_session_t *session,
    +                                          bson_t *reply,
    +                                          bson_error_t *error);
    +
    +
    +

    Commit a multi-document transaction.

    +
    +
    +

    Parameters

    + +
    +
    +

    Return

    +

    Returns true if the transaction was committed. Returns false and sets error if there are invalid arguments, such as a session with no transaction in progress, or if there is a server or network error.

    +

    If a reply is supplied, it is always initialized and must be freed with bson_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_destroy.html b/libmongoc/1.24.0/mongoc_client_session_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..2611eed3b92899d4337f45f0ad6092ab4ecbd5ce --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_destroy.html @@ -0,0 +1,301 @@ + + + + + + + + + + + + + + mongoc_client_session_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_session_destroy (mongoc_client_session_t *session);
    +
    +
    +

    End a session, returning its session id to the pool, and free all client resources associated with the session. If a multi-document transaction is in progress, abort it. Does nothing if session is NULL.

    +

    See the example code for mongoc_client_session_t.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_client.html b/libmongoc/1.24.0/mongoc_client_session_get_client.html new file mode 100644 index 0000000000000000000000000000000000000000..8fc4f0bbb94219b04596d96d9e4a70ea4655ff36 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_client.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_client() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_client()

    +
    +

    Synopsis

    +
    mongoc_client_t *
    +mongoc_client_session_get_client (const mongoc_client_session_t *session);
    +
    +
    +

    Returns the mongoc_client_t from which this session was created. See mongoc_client_start_session().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_client_t that should not be freed.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_cluster_time.html b/libmongoc/1.24.0/mongoc_client_session_get_cluster_time.html new file mode 100644 index 0000000000000000000000000000000000000000..61286322e145a810430f4b2c6199b524f69a4ad3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_cluster_time.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_cluster_time() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_cluster_time()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_client_session_get_cluster_time (const mongoc_client_session_t *session);
    +
    +
    +

    Get the session’s clusterTime as a BSON document.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    If the session has not been used for any operation and mongoc_client_session_advance_cluster_time() has not been called, a bson_t that is valid only for the lifetime of session. Otherwise, NULL.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_dirty.html b/libmongoc/1.24.0/mongoc_client_session_get_dirty.html new file mode 100644 index 0000000000000000000000000000000000000000..8185785cb52d22f49f148f2ff74346e99ec773ba --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_dirty.html @@ -0,0 +1,308 @@ + + + + + + + + + + + + + + mongoc_client_session_get_dirty() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_dirty()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_get_dirty (const mongoc_client_session_t *session);
    +
    +
    +

    Indicates whether session has been marked “dirty” as defined in the driver sessions specification.

    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function is intended for use by drivers that wrap libmongoc. It is not useful in client applications.

    +
    +
    +

    Returns

    +

    A boolean indicating whether the session has been marked “dirty”.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_lsid.html b/libmongoc/1.24.0/mongoc_client_session_get_lsid.html new file mode 100644 index 0000000000000000000000000000000000000000..bd6e34dc92ae7723873115c1ebd526f3a4a889e8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_lsid.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_lsid() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_lsid()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_client_session_get_lsid (mongoc_client_session_t *session);
    +
    +
    +

    Get the server-side “logical session ID” associated with this mongoc_client_session_t as a BSON document.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A bson_t that is valid only for the lifetime of session.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_operation_time.html b/libmongoc/1.24.0/mongoc_client_session_get_operation_time.html new file mode 100644 index 0000000000000000000000000000000000000000..3f5497d97e322e8e87e11984e39dcc7a9e0b77f1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_operation_time.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_operation_time() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_operation_time()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_session_get_operation_time (const mongoc_client_session_t *session,
    +                                          uint32_t *timestamp,
    +                                          uint32_t *increment);
    +
    +
    +

    Get the session’s operationTime, expressed as a BSON Timestamp with timestamp and increment components. If the session has not been used for any operations, the timestamp and increment are 0.

    +
    +
    +

    Parameters

    +
      +
    • session: A mongoc_client_session_t.

    • +
    • timestamp: A pointer to a uint32_t to receive the timestamp component.

    • +
    • increment: A pointer to a uint32_t to receive the increment component.

    • +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_opts.html b/libmongoc/1.24.0/mongoc_client_session_get_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..128d6fabd93c2881607541a3da34b938b53bcfa8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_opts.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_opts()

    +
    +

    Synopsis

    +
    const mongoc_session_opt_t *
    +mongoc_client_session_get_opts (const mongoc_client_session_t *session);
    +
    +
    +

    Get a reference to the mongoc_session_opt_t with which this session was configured.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_session_opt_t that is valid only for the lifetime of session.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_server_id.html b/libmongoc/1.24.0/mongoc_client_session_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..73589c6608c44361ae91777bb74c03db97c96d6c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_server_id.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_server_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_server_id()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_client_session_get_server_id (const mongoc_client_session_t *session);
    +
    +
    +

    Get the “server ID” of the mongos this mongoc_client_session_t is pinned to.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A server ID or 0 if this mongoc_client_session_t is not pinned.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_get_transaction_state.html b/libmongoc/1.24.0/mongoc_client_session_get_transaction_state.html new file mode 100644 index 0000000000000000000000000000000000000000..a32c3f5ad7c8a46247d35d0bd7e977c6c01e45cb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_get_transaction_state.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_session_get_transaction_state() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_get_transaction_state()

    +
    +

    Synopsis

    +
    mongoc_transaction_state_t
    +mongoc_client_session_get_transaction_state (const mongoc_client_session_t *session);
    +
    +
    +

    Returns the current transaction state for this session.

    +
    +
    +

    Parameters

    + +
    +
    +

    Return

    +

    Returns a mongoc_transaction_state_t that represents the current transaction state.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_in_transaction.html b/libmongoc/1.24.0/mongoc_client_session_in_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..4671de43dab7ce83bd3457d12bf9d6c5ce2133c5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_in_transaction.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_session_in_transaction() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_in_transaction()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_in_transaction (const mongoc_client_session_t *session);
    +
    +
    +

    Check whether a multi-document transaction is in progress for this session.

    +
    +
    +

    Parameters

    + +
    +
    +

    Return

    +

    Returns true if a transaction was started and has not been committed or aborted, otherwise false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_start_transaction.html b/libmongoc/1.24.0/mongoc_client_session_start_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..c6126932174e6802a81ce615dba5423b32c1cf45 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_start_transaction.html @@ -0,0 +1,498 @@ + + + + + + + + + + + + + + mongoc_client_session_start_transaction() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_start_transaction()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_start_transaction (mongoc_client_session_t *session,
    +                                         const mongoc_transaction_opt_t *opts,
    +                                         bson_error_t *error);
    +
    +
    +

    Start a multi-document transaction for all following operations in this session. Any options provided in opts override options passed to mongoc_session_opts_set_default_transaction_opts(), and options inherited from the mongoc_client_t. The opts argument is copied and can be freed after calling this function.

    +

    The transaction must be completed with mongoc_client_session_commit_transaction() or mongoc_client_session_abort_transaction(). An in-progress transaction is automatically aborted by mongoc_client_session_destroy().

    +
    +
    +

    Parameters

    + +
    +
    +

    Return

    +

    Returns true if the transaction was started. Returns false and sets error if there are invalid arguments, such as a session with a transaction already in progress.

    +
    +
    +

    Example

    +

    The following example demonstrates how to use error labels to reliably execute a multi-document transaction despite network errors and other transient failures.

    +
    +
    example-transaction.c
    +
    /* gcc example-transaction.c -o example-transaction \
    + *     $(pkg-config --cflags --libs libmongoc-1.0) */
    +
    +/* ./example-transaction [CONNECTION_STRING] */
    +
    +#include <stdio.h>
    +#include <mongoc/mongoc.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   int exit_code = EXIT_FAILURE;
    +
    +   mongoc_client_t *client = NULL;
    +   mongoc_database_t *database = NULL;
    +   mongoc_collection_t *collection = NULL;
    +   mongoc_client_session_t *session = NULL;
    +   mongoc_session_opt_t *session_opts = NULL;
    +   mongoc_transaction_opt_t *default_txn_opts = NULL;
    +   mongoc_transaction_opt_t *txn_opts = NULL;
    +   mongoc_read_concern_t *read_concern = NULL;
    +   mongoc_write_concern_t *write_concern = NULL;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=transaction-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +   bson_t *doc = NULL;
    +   bson_t *insert_opts = NULL;
    +   int32_t i;
    +   int64_t start;
    +   bson_t reply = BSON_INITIALIZER;
    +   char *reply_json;
    +   bool r;
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      MONGOC_ERROR ("failed to parse URI: %s\n"
    +                    "error message:       %s\n",
    +                    uri_string,
    +                    error.message);
    +      goto done;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto done;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   database = mongoc_client_get_database (client, "example-transaction");
    +
    +   /* inserting into a nonexistent collection normally creates it, but a
    +    * collection can't be created in a transaction; create it now */
    +   collection =
    +      mongoc_database_create_collection (database, "collection", NULL, &error);
    +
    +   if (!collection) {
    +      /* code 48 is NamespaceExists, see error_codes.err in mongodb source */
    +      if (error.code == 48) {
    +         collection = mongoc_database_get_collection (database, "collection");
    +      } else {
    +         MONGOC_ERROR ("Failed to create collection: %s", error.message);
    +         goto done;
    +      }
    +   }
    +
    +   /* a transaction's read preferences, read concern, and write concern can be
    +    * set on the client, on the default transaction options, or when starting
    +    * the transaction. for the sake of this example, set read concern on the
    +    * default transaction options. */
    +   default_txn_opts = mongoc_transaction_opts_new ();
    +   read_concern = mongoc_read_concern_new ();
    +   mongoc_read_concern_set_level (read_concern, "snapshot");
    +   mongoc_transaction_opts_set_read_concern (default_txn_opts, read_concern);
    +   session_opts = mongoc_session_opts_new ();
    +   mongoc_session_opts_set_default_transaction_opts (session_opts,
    +                                                     default_txn_opts);
    +
    +   session = mongoc_client_start_session (client, session_opts, &error);
    +   if (!session) {
    +      MONGOC_ERROR ("Failed to start session: %s", error.message);
    +      goto done;
    +   }
    +
    +   /* in this example, set write concern when starting the transaction */
    +   txn_opts = mongoc_transaction_opts_new ();
    +   write_concern = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_wmajority (write_concern, 1000 /* wtimeout */);
    +   mongoc_transaction_opts_set_write_concern (txn_opts, write_concern);
    +
    +   insert_opts = bson_new ();
    +   if (!mongoc_client_session_append (session, insert_opts, &error)) {
    +      MONGOC_ERROR ("Could not add session to opts: %s", error.message);
    +      goto done;
    +   }
    +
    +retry_transaction:
    +   r = mongoc_client_session_start_transaction (session, txn_opts, &error);
    +   if (!r) {
    +      MONGOC_ERROR ("Failed to start transaction: %s", error.message);
    +      goto done;
    +   }
    +
    +   /* insert two documents - on error, retry the whole transaction */
    +   for (i = 0; i < 2; i++) {
    +      doc = BCON_NEW ("_id", BCON_INT32 (i));
    +      bson_destroy (&reply);
    +      r = mongoc_collection_insert_one (
    +         collection, doc, insert_opts, &reply, &error);
    +
    +      bson_destroy (doc);
    +
    +      if (!r) {
    +         MONGOC_ERROR ("Insert failed: %s", error.message);
    +         mongoc_client_session_abort_transaction (session, NULL);
    +
    +         /* a network error, primary failover, or other temporary error in a
    +          * transaction includes {"errorLabels": ["TransientTransactionError"]},
    +          * meaning that trying the entire transaction again may succeed
    +          */
    +         if (mongoc_error_has_label (&reply, "TransientTransactionError")) {
    +            goto retry_transaction;
    +         }
    +
    +         goto done;
    +      }
    +
    +      reply_json = bson_as_json (&reply, NULL);
    +      printf ("%s\n", reply_json);
    +      bson_free (reply_json);
    +   }
    +
    +   /* in case of transient errors, retry for 5 seconds to commit transaction */
    +   start = bson_get_monotonic_time ();
    +   while (bson_get_monotonic_time () - start < 5 * 1000 * 1000) {
    +      bson_destroy (&reply);
    +      r = mongoc_client_session_commit_transaction (session, &reply, &error);
    +      if (r) {
    +         /* success */
    +         break;
    +      } else {
    +         MONGOC_ERROR ("Warning: commit failed: %s", error.message);
    +         if (mongoc_error_has_label (&reply, "TransientTransactionError")) {
    +            goto retry_transaction;
    +         } else if (mongoc_error_has_label (&reply,
    +                                            "UnknownTransactionCommitResult")) {
    +            /* try again to commit */
    +            continue;
    +         }
    +
    +         /* unrecoverable error trying to commit */
    +         break;
    +      }
    +   }
    +
    +   exit_code = EXIT_SUCCESS;
    +
    +done:
    +   bson_destroy (&reply);
    +   bson_destroy (insert_opts);
    +   mongoc_write_concern_destroy (write_concern);
    +   mongoc_read_concern_destroy (read_concern);
    +   mongoc_transaction_opts_destroy (txn_opts);
    +   mongoc_transaction_opts_destroy (default_txn_opts);
    +   mongoc_client_session_destroy (session);
    +   mongoc_collection_destroy (collection);
    +   mongoc_database_destroy (database);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return exit_code;
    +}
    +
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_t.html b/libmongoc/1.24.0/mongoc_client_session_t.html new file mode 100644 index 0000000000000000000000000000000000000000..696c38083a1a6dbe45b18d84ed62b0cb12083f9d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_t.html @@ -0,0 +1,368 @@ + + + + + + + + + + + + + + mongoc_client_session_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_t

    +

    Use a session for a sequence of operations, optionally with causal consistency. See the MongoDB Manual Entry for Causal Consistency.

    +
    +

    Synopsis

    +

    Start a session with mongoc_client_start_session(), use the session for a sequence of operations and multi-document transactions, then free it with mongoc_client_session_destroy(). Any mongoc_cursor_t or mongoc_change_stream_t using a session must be destroyed before the session, and a session must be destroyed before the mongoc_client_t it came from.

    +

    By default, sessions are causally consistent. To disable causal consistency, before starting a session create a mongoc_session_opt_t with mongoc_session_opts_new() and call mongoc_session_opts_set_causal_consistency(), then free the struct with mongoc_session_opts_destroy().

    +

    Unacknowledged writes are prohibited with sessions.

    +

    A mongoc_client_session_t must be used by only one thread at a time. Due to session pooling, mongoc_client_start_session() may return a session that has been idle for some time and is about to be closed after its idle timeout. Use the session within one minute of acquiring it to refresh the session and avoid a timeout.

    +
    +
    +

    Example

    +
    +
    example-session.c
    +
    /* gcc example-session.c -o example-session \
    + *     $(pkg-config --cflags --libs libmongoc-1.0) */
    +
    +/* ./example-session [CONNECTION_STRING] */
    +
    +#include <stdio.h>
    +#include <mongoc/mongoc.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   int exit_code = EXIT_FAILURE;
    +
    +   mongoc_client_t *client = NULL;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=session-example";
    +   mongoc_uri_t *uri = NULL;
    +   mongoc_client_session_t *client_session = NULL;
    +   mongoc_collection_t *collection = NULL;
    +   bson_error_t error;
    +   bson_t *selector = NULL;
    +   bson_t *update = NULL;
    +   bson_t *update_opts = NULL;
    +   bson_t *find_opts = NULL;
    +   mongoc_read_prefs_t *secondary = NULL;
    +   mongoc_cursor_t *cursor = NULL;
    +   const bson_t *doc;
    +   char *str;
    +   bool r;
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      goto done;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto done;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   /* pass NULL for options - by default the session is causally consistent */
    +   client_session = mongoc_client_start_session (client, NULL, &error);
    +   if (!client_session) {
    +      fprintf (stderr, "Failed to start session: %s\n", error.message);
    +      goto done;
    +   }
    +
    +   collection = mongoc_client_get_collection (client, "test", "collection");
    +   selector = BCON_NEW ("_id", BCON_INT32 (1));
    +   update = BCON_NEW ("$inc", "{", "x", BCON_INT32 (1), "}");
    +   update_opts = bson_new ();
    +   if (!mongoc_client_session_append (client_session, update_opts, &error)) {
    +      fprintf (stderr, "Could not add session to opts: %s\n", error.message);
    +      goto done;
    +   }
    +
    +   r = mongoc_collection_update_one (
    +      collection, selector, update, update_opts, NULL /* reply */, &error);
    +
    +   if (!r) {
    +      fprintf (stderr, "Update failed: %s\n", error.message);
    +      goto done;
    +   }
    +
    +   bson_destroy (selector);
    +   selector = BCON_NEW ("_id", BCON_INT32 (1));
    +   secondary = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +
    +   find_opts = BCON_NEW ("maxTimeMS", BCON_INT32 (2000));
    +   if (!mongoc_client_session_append (client_session, find_opts, &error)) {
    +      fprintf (stderr, "Could not add session to opts: %s\n", error.message);
    +      goto done;
    +   };
    +
    +   /* read from secondary. since we're in a causally consistent session, the
    +    * data is guaranteed to reflect the update we did on the primary. the query
    +    * blocks waiting for the secondary to catch up, if necessary, or times out
    +    * and fails after 2000 ms.
    +    */
    +   cursor = mongoc_collection_find_with_opts (
    +      collection, selector, find_opts, secondary);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_json (doc, NULL);
    +      fprintf (stdout, "%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "Cursor Failure: %s\n", error.message);
    +      goto done;
    +   }
    +
    +   exit_code = EXIT_SUCCESS;
    +
    +done:
    +   if (find_opts) {
    +      bson_destroy (find_opts);
    +   }
    +   if (update) {
    +      bson_destroy (update);
    +   }
    +   if (selector) {
    +      bson_destroy (selector);
    +   }
    +   if (update_opts) {
    +      bson_destroy (update_opts);
    +   }
    +   if (secondary) {
    +      mongoc_read_prefs_destroy (secondary);
    +   }
    +   /* destroy cursor, collection, session before the client they came from */
    +   if (cursor) {
    +      mongoc_cursor_destroy (cursor);
    +   }
    +   if (collection) {
    +      mongoc_collection_destroy (collection);
    +   }
    +   if (client_session) {
    +      mongoc_client_session_destroy (client_session);
    +   }
    +   if (uri) {
    +      mongoc_uri_destroy (uri);
    +   }
    +   if (client) {
    +      mongoc_client_destroy (client);
    +   }
    +
    +   mongoc_cleanup ();
    +
    +   return exit_code;
    +}
    +
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_with_transaction.html b/libmongoc/1.24.0/mongoc_client_session_with_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..ec2b6de9feb11b8398b929aac8b6732265b1d12c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_with_transaction.html @@ -0,0 +1,408 @@ + + + + + + + + + + + + + + mongoc_client_session_with_transaction() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_with_transaction()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_session_with_transaction (mongoc_client_session_t *session,
    +                                        mongoc_client_session_with_transaction_cb_t cb,
    +                                        const mongoc_transaction_opt_t *opts,
    +                                        void *ctx,
    +                                        bson_t *reply,
    +                                        bson_error_t *error);
    +
    +
    +

    This method will start a new transaction on session, run cb, and then commit the transaction. If it cannot commit the transaction, the entire sequence may be retried, and cb may be run multiple times. ctx will be passed to cb each time it is called.

    +

    This method has an internal time limit of 120 seconds, and will retry until that time limit is reached. This timeout is not configurable.

    +

    cb should not attempt to start new transactions, but should simply run operations meant to be contained within a transaction. The cb does not need to commit transactions; this is handled by the mongoc_client_session_with_transaction(). If cb does commit or abort a transaction, however, this method will return without taking further action.

    +

    The parameter reply is initialized even upon failure to simplify memory management.

    +
    +
    +

    Parameters

    + +
    +
    +

    Return

    +

    Returns true if the transaction was completed successfully. Otherwise, returns false in case of failure. In cases of failure error will also be set, except if the passed-in cb fails without setting error. If a non-NULL reply is passed in, reply will be set to the value of the last server response, except if the passed-in cb fails without setting a reply.

    +
    +
    +

    Example

    +
    +
    Use with_transaction() to run a callback within a transaction
    +
    /* gcc example-with-transaction-cb.c -o example-with-transaction-cb $(pkg-config
    + * --cflags --libs libmongoc-1.0) */
    +
    +/* ./example-with-transaction-cb [CONNECTION_STRING] */
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +/*
    + * We pass this context object to mongoc_client_session_with_transaction() along
    + * with our callback function. The context object will be passed to our callback
    + * function when it runs, so we can access it.
    + */
    +typedef struct {
    +   mongoc_collection_t *collection;
    +   bson_t *insert_opts;
    +} ctx_t;
    +
    +/*
    + * We pass this method as the callback to
    + * mongoc_client_session_with_transaction(). The insert that this method
    + * performs will happen inside of a new transaction.
    + */
    +bool
    +create_and_insert_doc (mongoc_client_session_t *session,
    +                       void *ctx,
    +                       bson_t **reply, /* out param for our server reply */
    +                       bson_error_t *error)
    +{
    +   /*
    +    * mongoc_collection_insert_one requires an uninitialized, stack-allocated
    +    * bson_t to receive the update result
    +    */
    +   bson_t local_reply;
    +   bson_t *doc = NULL;
    +   ctx_t *data = NULL;
    +   bool retval;
    +
    +   /*
    +    * Create a new bson document - { id: 1 }
    +    */
    +   doc = BCON_NEW ("_id", BCON_INT32 (1));
    +
    +   printf (
    +      "Running the user-defined callback in a newly created transaction...\n");
    +   data = (ctx_t *) ctx;
    +   retval = mongoc_collection_insert_one (
    +      data->collection, doc, data->insert_opts, &local_reply, error);
    +
    +   /*
    +    * To return to the mongoc_client_session_with_transaction() method, set
    +    * *reply to a new copy of our local_reply before destroying it.
    +    */
    +   *reply = bson_copy (&local_reply);
    +   bson_destroy (&local_reply);
    +
    +   bson_destroy (doc);
    +   return retval;
    +}
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   int exit_code = EXIT_FAILURE;
    +
    +   mongoc_uri_t *uri = NULL;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=with-txn-cb-example";
    +   mongoc_client_t *client = NULL;
    +   mongoc_database_t *database = NULL;
    +   mongoc_collection_t *collection = NULL;
    +   mongoc_client_session_t *session = NULL;
    +   bson_t *insert_opts = NULL;
    +   bson_t reply;
    +   ctx_t ctx;
    +   char *str;
    +   bson_error_t error;
    +
    +   /*
    +    * Required to initialize libmongoc's internals
    +    */
    +   mongoc_init ();
    +
    +   /*
    +    * Optionally get MongoDB URI from command line
    +    */
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   /*
    +    * Safely create a MongoDB URI object from the given string
    +    */
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      MONGOC_ERROR ("failed to parse URI: %s\n"
    +                    "error message:       %s\n",
    +                    uri_string,
    +                    error.message);
    +      goto done;
    +   }
    +
    +   /*
    +    * Create a new client instance
    +    */
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto done;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   /*
    +    * Get a handle on the database "example-with-txn-cb"
    +    */
    +   database = mongoc_client_get_database (client, "example-with-txn-cb");
    +
    +   /*
    +    * Inserting into a nonexistent collection normally creates it, but a
    +    * collection can't be created in a transaction; create it now
    +    */
    +   collection =
    +      mongoc_database_create_collection (database, "collection", NULL, &error);
    +   if (!collection) {
    +      /* code 48 is NamespaceExists, see error_codes.err in mongodb source */
    +      if (error.code == 48) {
    +         collection = mongoc_database_get_collection (database, "collection");
    +      } else {
    +         MONGOC_ERROR ("Failed to create collection: %s", error.message);
    +         goto done;
    +      }
    +   }
    +
    +   /*
    +    * Pass NULL for options - by default the session is causally consistent
    +    */
    +   session = mongoc_client_start_session (client, NULL, &error);
    +   if (!session) {
    +      MONGOC_ERROR ("Failed to start session: %s", error.message);
    +      goto done;
    +   }
    +
    +   /*
    +    * Append a logical session id to command options
    +    */
    +   insert_opts = bson_new ();
    +   if (!mongoc_client_session_append (session, insert_opts, &error)) {
    +      MONGOC_ERROR ("Could not add session to opts: %s", error.message);
    +      goto done;
    +   }
    +
    +   ctx.collection = collection;
    +   ctx.insert_opts = insert_opts;
    +
    +   /*
    +    * This method will start a new transaction on session, run our callback
    +    * function, i.e., &create_and_insert_doc, passing &ctx as an argument and
    +    * commit the transaction.
    +    */
    +   if (!mongoc_client_session_with_transaction (
    +          session, &create_and_insert_doc, NULL, &ctx, &reply, &error)) {
    +      MONGOC_ERROR ("Insert failed: %s", error.message);
    +      goto done;
    +   }
    +
    +   str = bson_as_json (&reply, NULL);
    +   printf ("%s\n", str);
    +
    +   exit_code = EXIT_SUCCESS;
    +
    +done:
    +   bson_free (str);
    +   bson_destroy (&reply);
    +   bson_destroy (insert_opts);
    +   mongoc_client_session_destroy (session);
    +   mongoc_collection_destroy (collection);
    +   mongoc_database_destroy (database);
    +   mongoc_client_destroy (client);
    +   mongoc_uri_destroy (uri);
    +
    +   mongoc_cleanup ();
    +
    +   return exit_code;
    +}
    +
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_session_with_transaction_cb_t.html b/libmongoc/1.24.0/mongoc_client_session_with_transaction_cb_t.html new file mode 100644 index 0000000000000000000000000000000000000000..18de1291a9772cb7fd73e647c2146145d932af84 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_session_with_transaction_cb_t.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_session_with_transaction_cb_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_session_with_transaction_cb_t

    +
    +

    Synopsis

    +
    typedef bool (*mongoc_client_session_with_transaction_cb_t) (
    +   mongoc_client_session_t *session,
    +   void *ctx,
    +   bson_t **reply,
    +   bson_error_t *error);
    +
    +
    +

    Provide this callback to mongoc_client_session_with_transaction(). The callback should run a sequence of operations meant to be contained within a transaction. The callback should not attempt to start or commit transactions.

    +
    +
    +

    Parameters

    +
      +
    • session: A mongoc_client_session_t.

    • +
    • ctx: A void* set to the the user-provided ctx passed to mongoc_client_session_with_transaction().

    • +
    • reply: An optional location for a bson_t or NULL. The callback should set this if it runs any operations against the server and receives replies.

    • +
    • error: A bson_error_t. The callback should set this if it receives any errors while running operations against the server.

    • +
    +
    +
    +

    Return

    +

    Returns true for success and false on failure. If cb returns false then it should also set error.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_apm_callbacks.html b/libmongoc/1.24.0/mongoc_client_set_apm_callbacks.html new file mode 100644 index 0000000000000000000000000000000000000000..5f2f14f3894e709d20e2713387e9293bc0007104 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_apm_callbacks.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_set_apm_callbacks() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_apm_callbacks()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_set_apm_callbacks (mongoc_client_t *client,
    +                                 mongoc_apm_callbacks_t *callbacks,
    +                                 void *context);
    +
    +
    +

    Register a set of callbacks to receive Application Performance Monitoring events.

    +

    The callbacks are copied by the client and may be destroyed at any time after. If a context is passed, it is the application’s responsibility to ensure context remains valid for the lifetime of the client.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_appname.html b/libmongoc/1.24.0/mongoc_client_set_appname.html new file mode 100644 index 0000000000000000000000000000000000000000..b447a00af946f70644366b8244918905bd933d10 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_appname.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_set_appname() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_appname()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_set_appname (mongoc_client_t *client, const char *appname)
    +
    +
    +

    Sets the application name for this client. This string, along with other internal driver details, is sent to the server as part of the initial connection handshake (“hello”).

    +

    appname is copied, and doesn’t have to remain valid after the call to mongoc_client_set_appname().

    +

    This function will log an error and return false in the following cases:

    +
      +
    • appname is longer than MONGOC_HANDSHAKE_APPNAME_MAX

    • +
    • client has already initiated a handshake

    • +
    • client is from a mongoc_client_pool_t

    • +
    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • appname: The application name, of length at most MONGOC_HANDSHAKE_APPNAME_MAX.

    • +
    +
    +
    +

    Returns

    +

    true if the appname is set successfully. Otherwise, false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_error_api.html b/libmongoc/1.24.0/mongoc_client_set_error_api.html new file mode 100644 index 0000000000000000000000000000000000000000..c5fbb875c816be13acda7df92298e2b9d0e4c3da --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_error_api.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_client_set_error_api() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_error_api()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_set_error_api (mongoc_client_t *client, int32_t version);
    +
    +
    +

    Configure how the C Driver reports errors. See Setting the Error API Version.

    +

    Do not use this function with pooled clients, see mongoc_client_pool_set_error_api().

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • version: The version of the error API, either MONGOC_ERROR_API_VERSION_LEGACY or MONGOC_ERROR_API_VERSION_2.

    • +
    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_read_concern.html b/libmongoc/1.24.0/mongoc_client_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..746a0d972a11c65ce25c2c08f7759dc6b2b7e98a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_read_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_set_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_read_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_set_read_concern (mongoc_client_t *client,
    +                                const mongoc_read_concern_t *read_concern);
    +
    +
    +

    Sets the read concern for the client. This only affects future operations, collections, and databases inheriting from client.

    +

    The default read concern is MONGOC_READ_CONCERN_LEVEL_LOCAL. This is the correct read concern for the great majority of applications.

    +

    It is a programming error to call this function on a client from a mongoc_client_pool_t. For pooled clients, set the read concern with the MongoDB URI instead.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_read_prefs.html b/libmongoc/1.24.0/mongoc_client_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..5095ca12d96f73e4ddb451647ba83a22b5e613d0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_read_prefs.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_set_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_read_prefs()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_set_read_prefs (mongoc_client_t *client,
    +                              const mongoc_read_prefs_t *read_prefs);
    +
    +
    +

    Sets the default read preferences to use with future operations upon client.

    +

    The global default is to read from the replica set primary.

    +

    It is a programming error to call this function on a client from a mongoc_client_pool_t. For pooled clients, set the read preferences with the MongoDB URI instead.

    +

    Please see the MongoDB website for a description of Read Preferences.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_server_api.html b/libmongoc/1.24.0/mongoc_client_set_server_api.html new file mode 100644 index 0000000000000000000000000000000000000000..a96d50911b8086638c2be148a657a9c6c4d4bc70 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_server_api.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_set_server_api() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_server_api()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_set_server_api (mongoc_client_t *client,
    +                              const mongoc_server_api_t *api,
    +                              bson_error_t *error);
    +
    +
    +

    Set the API version to use for client. Once the API version is set on a client, it may not be changed to a new value. Attempting to do so will cause this method to fail and set error.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True if the version was successfully set, false if not. On failure, error will be set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_ssl_opts.html b/libmongoc/1.24.0/mongoc_client_set_ssl_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..98a695b68f685a16a321f050036b309ad7bd35ea --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_ssl_opts.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_set_ssl_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_ssl_opts()

    +
    +

    Synopsis

    +
    #ifdef MONGOC_ENABLE_SSL
    +void
    +mongoc_client_set_ssl_opts (mongoc_client_t *client,
    +                            const mongoc_ssl_opt_t *opts);
    +#endif
    +
    +
    +

    Sets the TLS (SSL) options to use when connecting to TLS enabled MongoDB servers.

    +

    The mongoc_ssl_opt_t struct is copied by the client along with the strings +it points to (pem_file, pem_pwd, ca_file, ca_dir, and +crl_file) so they don’t have to remain valid after the call to +mongoc_client_set_ssl_opts.

    +

    A call to mongoc_client_set_ssl_opts overrides all TLS options set through +the connection string with which the mongoc_client_t was constructed.

    +

    It is a programming error to call this function on a client from a +mongoc_client_pool_t. Instead, call +mongoc_client_pool_set_ssl_opts() on the pool before popping any +clients.

    +
    +
    +

    Parameters

    + +
    +
    +

    Availability

    +

    This feature requires that the MongoDB C driver was compiled with -DENABLE_SSL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_stream_initiator.html b/libmongoc/1.24.0/mongoc_client_set_stream_initiator.html new file mode 100644 index 0000000000000000000000000000000000000000..687aefdc594c8fe68588eed5143cd893583d4847 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_stream_initiator.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_set_stream_initiator() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_stream_initiator()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_set_stream_initiator (mongoc_client_t *client,
    +                                    mongoc_stream_initiator_t initiator,
    +                                    void *user_data);
    +
    +
    +

    The mongoc_client_set_stream_initiator() function shall associate a given mongoc_client_t with a new stream initiator. This will completely replace the default transport (buffered TCP, possibly with TLS). The initiator should fulfill the mongoc_stream_t contract. user_data is passed through to the initiator callback and may be used for whatever run time customization is necessary.

    +

    If user_data is passed, it is the application’s responsibility to ensure user_data remains valid for the lifetime of the client.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_set_write_concern.html b/libmongoc/1.24.0/mongoc_client_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..add0b0ca731b9d7f370a9393e12e2b6dc6dad373 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_set_write_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_set_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_set_write_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_client_set_write_concern (mongoc_client_t *client,
    +                                 const mongoc_write_concern_t *write_concern);
    +
    +
    +

    Sets the write concern for the client. This only affects future operations, collections, and databases inheriting from client.

    +

    The default write concern is MONGOC_WRITE_CONCERN_W_DEFAULT: the driver blocks awaiting basic acknowledgement of write operations from MongoDB. This is the correct write concern for the great majority of applications.

    +

    It is a programming error to call this function on a client from a mongoc_client_pool_t. For pooled clients, set the write concern with the MongoDB URI instead.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_start_session.html b/libmongoc/1.24.0/mongoc_client_start_session.html new file mode 100644 index 0000000000000000000000000000000000000000..091f59ec3636faf22721e5eee850a55d9eca192c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_start_session.html @@ -0,0 +1,316 @@ + + + + + + + + + + + + + + mongoc_client_start_session() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_start_session()

    +
    +

    Synopsis

    +
    mongoc_client_session_t *
    +mongoc_client_start_session (mongoc_client_t *client,
    +                             mongoc_session_opt_t *opts,
    +                             bson_error_t *error)
    +
    +
    +

    Create a session for a sequence of operations.

    +

    Start a session with mongoc_client_start_session(), use the session for a sequence of operations and multi-document transactions, then free it with mongoc_client_session_destroy(). Any mongoc_cursor_t or mongoc_change_stream_t using a session must be destroyed before the session, and a session must be destroyed before the mongoc_client_t it came from.

    +

    By default, sessions are causally consistent. To disable causal consistency, before starting a session create a mongoc_session_opt_t with mongoc_session_opts_new() and call mongoc_session_opts_set_causal_consistency(), then free the struct with mongoc_session_opts_destroy().

    +

    Unacknowledged writes are prohibited with sessions.

    +

    A mongoc_client_session_t must be used by only one thread at a time. Due to session pooling, mongoc_client_start_session() may return a session that has been idle for some time and is about to be closed after its idle timeout. Use the session within one minute of acquiring it to refresh the session and avoid a timeout.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    If successful, this function returns a newly allocated mongoc_client_session_t that should be freed with mongoc_client_session_destroy() when no longer in use. On error, returns NULL and sets error.

    +
    +
    +

    Errors

    +

    This function can fail if the driver is not built with crypto support, if opts is misconfigured, or if the session is configured with options that the server does not support.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_t.html b/libmongoc/1.24.0/mongoc_client_t.html new file mode 100644 index 0000000000000000000000000000000000000000..855b0ff905a9bafcb983523479d4f9e16f835797 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_t.html @@ -0,0 +1,341 @@ + + + + + + + + + + + + + + mongoc_client_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_t

    +

    A single-threaded MongoDB connection. See Connection Pooling.

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_t mongoc_client_t;
    +
    +typedef mongoc_stream_t *(*mongoc_stream_initiator_t) (
    +   const mongoc_uri_t *uri,
    +   const mongoc_host_list_t *host,
    +   void *user_data,
    +   bson_error_t *error);
    +
    +
    +

    mongoc_client_t is an opaque type that provides access to a MongoDB server, +replica set, or sharded cluster. It maintains management of underlying sockets +and routing to individual nodes based on mongoc_read_prefs_t or mongoc_write_concern_t.

    +
    +
    +

    Streams

    +

    The underlying transport for a given client can be customized, wrapped or replaced by any implementation that fulfills mongoc_stream_t. A custom transport can be set with mongoc_client_set_stream_initiator().

    +
    +
    +

    Thread Safety

    +

    mongoc_client_t is NOT thread-safe and should only be used from one thread at a time. When used in multi-threaded scenarios, it is recommended that you use the thread-safe mongoc_client_pool_t to retrieve a mongoc_client_t for your thread.

    +
    +
    +

    Example

    +
    +
    example-client.c
    +
    /* gcc example-client.c -o example-client $(pkg-config --cflags --libs
    + * libmongoc-1.0) */
    +
    +/* ./example-client [CONNECTION_STRING [COLLECTION_NAME]] */
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   mongoc_cursor_t *cursor;
    +   bson_error_t error;
    +   const bson_t *doc;
    +   const char *collection_name = "test";
    +   bson_t query;
    +   char *str;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=client-example";
    +   mongoc_uri_t *uri;
    +
    +   mongoc_init ();
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   if (argc > 2) {
    +      collection_name = argv[2];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   bson_init (&query);
    +   collection = mongoc_client_get_collection (client, "test", collection_name);
    +   cursor = mongoc_collection_find_with_opts (
    +      collection,
    +      &query,
    +      NULL,  /* additional options */
    +      NULL); /* read prefs, NULL for default */
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      fprintf (stdout, "%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "Cursor Failure: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   bson_destroy (&query);
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_collection_destroy (collection);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_watch.html b/libmongoc/1.24.0/mongoc_client_watch.html new file mode 100644 index 0000000000000000000000000000000000000000..8fdf0aa77c89d13fcabf5250054e21f65a803147 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_watch.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_client_watch() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_watch()

    +
    +

    Synopsis

    +
    mongoc_change_stream_t*
    +mongoc_client_watch (mongoc_client_t *client,
    +                     const bson_t *pipeline,
    +                     const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    A helper function to create a change stream. It is preferred to call this +function over using a raw aggregation to create a change stream.

    +

    This function uses the read preference and read concern of the client. If +the change stream needs to re-establish connection, the same read preference +will be used. This may happen if the change stream encounters a resumable error.

    +
    +

    Warning

    +

    A change stream is only supported with majority read concern.

    +
    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    +
      +
    • db: A mongoc_client_t specifying the client which the change stream listens to.

    • +
    • pipeline: A bson_t representing an aggregation pipeline appended to the change stream. This may be an empty document.

    • +
    • opts: A bson_t containing change stream options.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • batchSize: An int32 representing number of documents requested to be returned on each call to mongoc_change_stream_next()

    • +
    • resumeAfter: A Document representing the logical starting point of the change stream. The result of mongoc_change_stream_get_resume_token() or the _id field of any change received from a change stream can be used here. This option is mutually exclusive with startAfter and startAtOperationTime.

    • +
    • startAfter: A Document representing the logical starting point of the change stream. Unlike resumeAfter, this can resume notifications after an “invalidate” event. The result of mongoc_change_stream_get_resume_token() or the _id field of any change received from a change stream can be used here. This option is mutually exclusive with resumeAfter and startAtOperationTime.

    • +
    • startAtOperationTime: A Timestamp. The change stream only provides changes that occurred at or after the specified timestamp. Any command run against the server will return an operation time that can be used here. This option is mutually exclusive with resumeAfter and startAfter.

    • +
    • maxAwaitTimeMS: An int64 representing the maximum amount of time a call to mongoc_change_stream_next() will block waiting for data

    • +
    • fullDocument: An optional UTF-8 string. Set this option to “default”, “updateLookup”, “whenAvailable”, or “required”, If unset, The string “default” is assumed. Set this option to “updateLookup” to direct the change stream cursor to lookup the most current majority-committed version of the document associated to an update change stream event.

    • +
    • fullDocumentBeforeChange: An optional UTF-8 string. Set this option to “whenAvailable”, “required”, or “off”. When unset, the default value is “off”. Similar to “fullDocument”, but returns the value of the document before the associated change.

    • +
    • showExpandedEvents: Set to true to return an expanded list of change stream events. Avaiable only on MongoDB versions >=6.0

    • +
    • comment: A bson_value_t specifying the comment to attach to this command. The comment will appear in log messages, profiler output, and currentOp output. Only string values are supported prior to MongoDB 4.4.

    • +
    +
    +
    +

    Returns

    +

    A newly allocated mongoc_change_stream_t which must be freed with +mongoc_change_stream_destroy() when no longer in use. The returned +mongoc_change_stream_t is never NULL. If there is an error, it can +be retrieved with mongoc_change_stream_error_document(), and subsequent +calls to mongoc_change_stream_next() will return false.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_client_write_command_with_opts.html b/libmongoc/1.24.0/mongoc_client_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..3dce0b91e168b64e3e8a2a47cefc66cd1303b0e7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_client_write_command_with_opts.html @@ -0,0 +1,405 @@ + + + + + + + + + + + + + + mongoc_client_write_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_write_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_client_write_command_with_opts (mongoc_client_t *client,
    +                                       const char *db_name,
    +                                       const bson_t *command,
    +                                       const bson_t *opts,
    +                                       bson_t *reply,
    +                                       bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic that is specific to commands that write, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_client_command_simple().

    +

    Use this function for commands that write such as “drop” or “createRole” (but not for “insert”, “update”, or “delete”, see Basic Write Operations). Write concern and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts. The highest-priority sources for these options are listed first in the following table. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + +

    Write Concern

    Collation

    opts

    opts

    Transaction

    client

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • command: A bson_t containing the command specification.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Basic Write Operations

    +

    Do not use this function to call the basic write commands “insert”, “update”, and “delete”. Those commands require special logic not implemented in mongoc_client_write_command_with_opts. For basic write operations use CRUD functions such as mongoc_collection_insert_one() and the others described in the CRUD tutorial, or use the Bulk API.

    +
    +
    +

    Example

    +
    +
    example-command-with-opts.c
    +
    /*
    +
    +Demonstrates how to prepare options for mongoc_client_read_command_with_opts and
    +mongoc_client_write_command_with_opts. First it calls "cloneCollectionAsCapped"
    +command with "writeConcern" option, then "distinct" command with "collation" and
    +"readConcern" options,
    +
    +Start a MongoDB 3.4 replica set with --enableMajorityReadConcern and insert two
    +documents:
    +
    +$ mongo
    +MongoDB Enterprise replset:PRIMARY> db.my_collection.insert({x: 1, y: "One"})
    +WriteResult({ "nInserted" : 1 })
    +MongoDB Enterprise replset:PRIMARY> db.my_collection.insert({x: 2, y: "Two"})
    +WriteResult({ "nInserted" : 1 })
    +
    +Build and run the example:
    +
    +gcc example-command-with-opts.c -o example-command-with-opts $(pkg-config
    +--cflags --libs libmongoc-1.0)
    +./example-command-with-opts [CONNECTION_STRING]
    +cloneCollectionAsCapped: { "ok" : 1 }
    +distinct: { "values" : [ 1, 2 ], "ok" : 1 }
    +
    +*/
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=client-example";
    +   mongoc_uri_t *uri;
    +   bson_t *cmd;
    +   bson_t *opts;
    +   mongoc_write_concern_t *write_concern;
    +   mongoc_read_prefs_t *read_prefs;
    +   mongoc_read_concern_t *read_concern;
    +   bson_t reply;
    +   bson_error_t error;
    +   char *json;
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   cmd = BCON_NEW ("cloneCollectionAsCapped",
    +                   BCON_UTF8 ("my_collection"),
    +                   "toCollection",
    +                   BCON_UTF8 ("my_capped_collection"),
    +                   "size",
    +                   BCON_INT64 (1024 * 1024));
    +
    +   /* include write concern "majority" in command options */
    +   write_concern = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_wmajority (write_concern, 10000 /* wtimeoutMS */);
    +   opts = bson_new ();
    +   mongoc_write_concern_append (write_concern, opts);
    +
    +   if (mongoc_client_write_command_with_opts (
    +          client, "test", cmd, opts, &reply, &error)) {
    +      json = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("cloneCollectionAsCapped: %s\n", json);
    +      bson_free (json);
    +   } else {
    +      fprintf (stderr, "cloneCollectionAsCapped: %s\n", error.message);
    +   }
    +
    +   bson_free (cmd);
    +   bson_free (opts);
    +
    +   /* distinct values of "x" in "my_collection" where "y" sorts after "one" */
    +   cmd = BCON_NEW ("distinct",
    +                   BCON_UTF8 ("my_collection"),
    +                   "key",
    +                   BCON_UTF8 ("x"),
    +                   "query",
    +                   "{",
    +                   "y",
    +                   "{",
    +                   "$gt",
    +                   BCON_UTF8 ("one"),
    +                   "}",
    +                   "}");
    +
    +   read_prefs = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +
    +   /* "One" normally sorts before "one"; make "One" sort after "one" */
    +   opts = BCON_NEW ("collation",
    +                    "{",
    +                    "locale",
    +                    BCON_UTF8 ("en_US"),
    +                    "caseFirst",
    +                    BCON_UTF8 ("lower"),
    +                    "}");
    +
    +   /* add a read concern to "opts" */
    +   read_concern = mongoc_read_concern_new ();
    +   mongoc_read_concern_set_level (read_concern,
    +                                  MONGOC_READ_CONCERN_LEVEL_MAJORITY);
    +
    +   mongoc_read_concern_append (read_concern, opts);
    +
    +   if (mongoc_client_read_command_with_opts (
    +          client, "test", cmd, read_prefs, opts, &reply, &error)) {
    +      json = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("distinct: %s\n", json);
    +      bson_free (json);
    +   } else {
    +      fprintf (stderr, "distinct: %s\n", error.message);
    +   }
    +
    +   bson_destroy (cmd);
    +   bson_destroy (opts);
    +   bson_destroy (&reply);
    +   mongoc_read_prefs_destroy (read_prefs);
    +   mongoc_read_concern_destroy (read_concern);
    +   mongoc_write_concern_destroy (write_concern);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_aggregate.html b/libmongoc/1.24.0/mongoc_collection_aggregate.html new file mode 100644 index 0000000000000000000000000000000000000000..b1393032f9da136ca3fb13098457e54f1553c6ef --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_aggregate.html @@ -0,0 +1,320 @@ + + + + + + + + + + + + + + mongoc_collection_aggregate() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_aggregate()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_collection_aggregate (mongoc_collection_t *collection,
    +                             mongoc_query_flags_t flags,
    +                             const bson_t *pipeline,
    +                             const bson_t *opts,
    +                             const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • flags: A mongoc_query_flags_t. Not all flag values apply. In particular, setting MONGOC_QUERY_EXHAUST results in an error.

    • +
    • pipeline: A bson_t, either a BSON array or a BSON document containing an array field named “pipeline”.

    • +
    • opts: A bson_t containing options for the command, or NULL.

    • +
    • read_prefs: A mongoc_read_prefs_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the aggregate command.

    +

    This function is considered a retryable read operation unless the pipeline contains a write stage like $out or $merge. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Description

    +

    This function creates a cursor which sends the aggregate command on the underlying collection upon the first call to mongoc_cursor_next(). For more information on building aggregation pipelines, see the MongoDB Manual entry on the aggregate command.

    +

    Read preferences, read and write concern, and collation can be overridden by various sources. The highest-priority sources for these options are listed first in the following table. In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. Write concern is applied from opts, or if opts has no write concern and the aggregation pipeline includes “$out”, the write concern is applied from collection. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Write Concern

    Collation

    read_prefs

    opts

    opts

    opts

    Transaction

    Transaction

    Transaction

    collection

    collection

    collection

    +

    See the example for transactions and for the “distinct” command with opts.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +
    +static mongoc_cursor_t *
    +pipeline_query (mongoc_collection_t *collection)
    +{
    +   mongoc_cursor_t *cursor;
    +   bson_t *pipeline;
    +
    +   pipeline = BCON_NEW ("pipeline",
    +                        "[",
    +                        "{",
    +                        "$match",
    +                        "{",
    +                        "foo",
    +                        BCON_UTF8 ("A"),
    +                        "}",
    +                        "}",
    +                        "{",
    +                        "$match",
    +                        "{",
    +                        "bar",
    +                        BCON_BOOL (false),
    +                        "}",
    +                        "}",
    +                        "]");
    +
    +   cursor = mongoc_collection_aggregate (
    +      collection, MONGOC_QUERY_NONE, pipeline, NULL, NULL);
    +
    +   bson_destroy (pipeline);
    +
    +   return cursor;
    +}
    +
    +
    +
    +
    +

    Other Parameters

    +

    When using $out, the pipeline stage that writes, the write_concern field of the mongoc_cursor_t will be set to the mongoc_write_concern_t parameter, if it is valid, and applied to the write command when mongoc_cursor_next() is called. Pass any other parameters to the aggregate command, besides pipeline, as fields in opts:

    +
    mongoc_write_concern_t *write_concern = mongoc_write_concern_new ();
    +mongoc_write_concern_set_w (write_concern, 3);
    +
    +pipeline =
    +   BCON_NEW ("pipeline", "[", "{", "$out", BCON_UTF8 ("collection2"), "}", "]");
    +
    +opts = BCON_NEW ("bypassDocumentValidation", BCON_BOOL (true));
    +mongoc_write_concern_append (write_concern, opts);
    +
    +cursor = mongoc_collection_aggregate (
    +   collection1, MONGOC_QUERY_NONE, pipeline, opts, NULL);
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_command.html b/libmongoc/1.24.0/mongoc_collection_command.html new file mode 100644 index 0000000000000000000000000000000000000000..84556b2f7ef3aa2b93fc044f80ffe6f533b94cf3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_command.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_collection_command() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_command()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_collection_command (mongoc_collection_t *collection,
    +                           mongoc_query_flags_t flags,
    +                           uint32_t skip,
    +                           uint32_t limit,
    +                           uint32_t batch_size,
    +                           const bson_t *command,
    +                           const bson_t *fields,
    +                           const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function is superseded by mongoc_collection_command_with_opts(), mongoc_collection_read_command_with_opts(), mongoc_collection_write_command_with_opts(), and mongoc_collection_read_write_command_with_opts().

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • flags: A mongoc_query_flags_t.

    • +
    • skip: A uint32_t with the number of documents to skip or zero.

    • +
    • limit: A uint32_t with the max number of documents to return or zero.

    • +
    • batch_size: A uint32_t with the number of documents in each batch or zero. Default is 100.

    • +
    • command: A bson_t containing the command to execute.

    • +
    • fields: A bson_t containing the fields to return or NULL. Not all commands support this option.

    • +
    • read_prefs: An optional mongoc_read_prefs_t. Otherwise, the command uses mode MONGOC_READ_PRIMARY.

    • +
    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_command_simple.html b/libmongoc/1.24.0/mongoc_collection_command_simple.html new file mode 100644 index 0000000000000000000000000000000000000000..edac1a0965e81ab734e512726437b752b9714dbc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_command_simple.html @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + mongoc_collection_command_simple() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_command_simple()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_command_simple (mongoc_collection_t *collection,
    +                                  const bson_t *command,
    +                                  const mongoc_read_prefs_t *read_prefs,
    +                                  bson_t *reply,
    +                                  bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • command: A bson_t containing the command to execute.

    • +
    • read_prefs: An optional mongoc_read_prefs_t. Otherwise, the command uses mode MONGOC_READ_PRIMARY.

    • +
    • reply: A location to initialize a bson_t. This should be on the stack.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    This is a simplified version of mongoc_collection_command() that returns the first result document in reply. The collection’s read preference, read concern, and write concern are not applied to the command. The parameter reply is initialized even upon failure to simplify memory management.

    +

    This function tries to unwrap an embedded error in the command when possible. The unwrapped error will be propagated via the error parameter. Additionally, the result document is set in reply.

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    This function does not check the server response for a write concern error or write concern timeout.

    +
    +
    +

    Example

    +

    The following is an example of executing the ping command.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +do_ping (mongoc_collection_t *collection)
    +{
    +   bson_error_t error;
    +   bson_t *cmd;
    +   bson_t reply;
    +   char *str;
    +
    +   cmd = BCON_NEW ("ping", BCON_INT32 (1));
    +
    +   if (mongoc_collection_command_simple (
    +          collection, cmd, NULL, &reply, &error)) {
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("Got reply: %s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (stderr, "Got error: %s\n", error.message);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (cmd);
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_command_with_opts.html b/libmongoc/1.24.0/mongoc_collection_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..7b5874017354385381ebdd0cac23700c0e28031f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_command_with_opts.html @@ -0,0 +1,257 @@ + + + + + + + + + + + + + + mongoc_collection_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_command_with_opts (
    +   mongoc_collection_t *collection,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs,
    +   const bson_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Execute a command on the server, interpreting opts according to the MongoDB server version. To send a raw command to the server without any of this logic, use mongoc_client_command_simple().

    +

    Read preferences, read and write concern, and collation can be overridden by various sources. The highest-priority sources for these options are listed first:

    + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Write Concern

    Collation

    read_prefs

    opts

    opts

    opts

    Transaction

    Transaction

    Transaction

    +

    In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. +See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    The reply is not parsed for a write concern timeout or write concern error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_copy.html b/libmongoc/1.24.0/mongoc_collection_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..4c91ac7d4c7df44cc45caa6d21fcb1c00223d6b3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_copy.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_collection_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_copy()

    +
    +

    Synopsis

    +
    mongoc_collection_t *
    +mongoc_collection_copy (mongoc_collection_t *collection)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a deep copy of the collection struct and its configuration. Useful if you intend to call mongoc_collection_set_write_concern(), mongoc_collection_set_read_prefs(), or mongoc_collection_set_read_concern(), and want to preserve an unaltered copy of the struct.

    +

    This function does not copy the contents of the collection on the MongoDB server.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_collection_t that should be freed with mongoc_collection_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_count.html b/libmongoc/1.24.0/mongoc_collection_count.html new file mode 100644 index 0000000000000000000000000000000000000000..86f29d4df206fb9602dd74b8994b3d89fe1a758d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_count.html @@ -0,0 +1,261 @@ + + + + + + + + + + + + + + mongoc_collection_count() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_count()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.11.0: This function is deprecated and should not be used in new code. +Use mongoc_collection_count_documents() or mongoc_collection_estimated_document_count() instead.

    +

    mongoc_collection_count_documents() has similar performance to calling mongoc_collection_count() with a non-NULL query, and is guaranteed to retrieve an accurate collection count. See migrating from deprecated count functions for details.

    +

    mongoc_collection_estimated_document_count() has the same performance as calling mongoc_collection_count() with a NULL query, but is not guaranteed to retrieve an accurate collection count.

    +
    +
    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_collection_count (mongoc_collection_t *collection,
    +                         mongoc_query_flags_t flags,
    +                         const bson_t *query,
    +                         int64_t skip,
    +                         int64_t limit,
    +                         const mongoc_read_prefs_t *read_prefs,
    +                         bson_error_t *error)
    + BSON_GNUC_DEPRECATED_FOR (mongoc_collection_count_documents or
    +                           mongoc_collection_estimated_document_count);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall execute a count query on the underlying ‘collection’. The bson ‘query’ is not validated, simply passed along as appropriate to the server. As such, compatibility and errors should be validated in the appropriate server documentation.

    +

    For more information, see the query reference at the MongoDB website.

    +

    The mongoc_read_concern_t specified on the mongoc_collection_t will be used, if any. If read_prefs is NULL, the collection’s read preferences are used.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    -1 on failure, otherwise the number of documents counted.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_query_count (mongoc_collection_t *collection, bson_t *query)
    +{
    +   bson_error_t error;
    +   int64_t count;
    +
    +   count = mongoc_collection_count (
    +      collection, MONGOC_QUERY_NONE, query, 0, 0, NULL, &error);
    +
    +   if (count < 0) {
    +      fprintf (stderr, "Count failed: %s\n", error.message);
    +   } else {
    +      printf ("%" PRId64 " documents counted.\n", count);
    +   }
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_count_documents.html b/libmongoc/1.24.0/mongoc_collection_count_documents.html new file mode 100644 index 0000000000000000000000000000000000000000..ca30e9567a556be2787428bb9e617f7d01225f4c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_count_documents.html @@ -0,0 +1,289 @@ + + + + + + + + + + + + + + mongoc_collection_count_documents() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_count_documents()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_collection_count_documents (mongoc_collection_t *collection,
    +                                   const bson_t *filter,
    +                                   const bson_t *opts,
    +                                   const mongoc_read_prefs_t *read_prefs,
    +                                   bson_t *reply,
    +                                   bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • filter: A bson_t containing the filter.

    • +
    • opts: A bson_t, NULL to ignore.

    • +
    • read_prefs: A mongoc_read_prefs_t or NULL.

    • +
    • reply: A location for an uninitialized bson_t to store the command reply, NULL to ignore. If not NULL, reply will be initialized.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Other options are included in the sent aggregate command. For a list of all options, see the MongoDB Manual entry on the aggregate command.

    +
    +
    +

    Description

    +

    This functions executes a count query on collection. In contrast with mongoc_collection_estimated_document_count(), the count returned is guaranteed to be accurate.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    -1 on failure, otherwise the number of documents counted.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_count (mongoc_collection_t *collection, bson_t *filter)
    +{
    +   bson_error_t error;
    +   int64_t count;
    +   bson_t* opts = BCON_NEW ("skip", BCON_INT64(5));
    +
    +   count = mongoc_collection_count_documents (
    +      collection, filter, opts, NULL, NULL, &error);
    +   bson_destroy (opts);
    +
    +   if (count < 0) {
    +      fprintf (stderr, "Count failed: %s\n", error.message);
    +   } else {
    +      printf ("%" PRId64 " documents counted.\n", count);
    +   }
    +}
    +
    +
    +
    +
    +

    Migrating from deprecated count functions

    +

    When migrating to mongoc_collection_count_documents() from the deprecated mongoc_collection_count() or mongoc_collection_count_with_opts(), the following query operators in the filter must be replaced:

    + + + + + + + + + + + + + + + + + +

    Operator

    Replacement

    $where

    $expr

    $near

    $geoWithin with $center

    $nearSphere

    $geoWithin with $centerSphere

    +

    $expr requires MongoDB 3.6+

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_count_with_opts.html b/libmongoc/1.24.0/mongoc_collection_count_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..30f57628b15f7d550901be7fbf2592cf8f22983a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_count_with_opts.html @@ -0,0 +1,320 @@ + + + + + + + + + + + + + + mongoc_collection_count_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_count_with_opts()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.11.0: This function is deprecated and should not be used in new code. +Use mongoc_collection_count_documents() or mongoc_collection_estimated_document_count() instead.

    +

    mongoc_collection_count_documents() has similar performance to calling mongoc_collection_count() with a non-NULL query, and is guaranteed to retrieve an accurate collection count. See migrating from deprecated count functions for details.

    +

    mongoc_collection_estimated_document_count() has the same performance as calling mongoc_collection_count() with a NULL query, but is not guaranteed to retrieve an accurate collection count.

    +
    +
    +
    +

    Synopsis

    +
    int64_t
    +mongoc_collection_count_with_opts (mongoc_collection_t *collection,
    +                                   mongoc_query_flags_t flags,
    +                                   const bson_t *query,
    +                                   int64_t skip,
    +                                   int64_t limit,
    +                                   const bson_t *opts,
    +                                   const mongoc_read_prefs_t *read_prefs,
    +                                   bson_error_t *error)
    + BSON_GNUC_DEPRECATED_FOR (mongoc_collection_count_documents or
    +                           mongoc_collection_estimated_document_count);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function shall execute a count query on the underlying ‘collection’. The bson ‘query’ is not validated, simply passed along as appropriate to the server. As such, compatibility and errors should be validated in the appropriate server documentation.

    +

    The mongoc_read_concern_t specified on the mongoc_collection_t will be used, if any. If read_prefs is NULL, the collection’s read preferences are used.

    +

    In addition to the standard functionality available from mongoc_collection_count, this function allows the user to add arbitrary extra keys to the count. This pass through enables features such as hinting for counts.

    +

    For more information, see the query reference at the MongoDB website.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    -1 on failure, otherwise the number of documents counted.

    +
    +
    +

    Examples

    +
    +
    Basic Counting
    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_query_count (mongoc_collection_t *collection, bson_t *query)
    +{
    +   bson_error_t error;
    +   int64_t count;
    +   bson_t opts;
    +
    +   bson_init (&opts);
    +   BSON_APPEND_UTF8 (&opts, "hint", "_id_");
    +
    +   count = mongoc_collection_count_with_opts (
    +      collection, MONGOC_QUERY_NONE, query, 0, 0, &opts, NULL, &error);
    +
    +   bson_destroy (&opts);
    +
    +   if (count < 0) {
    +      fprintf (stderr, "Count failed: %s\n", error.message);
    +   } else {
    +      printf ("%" PRId64 " documents counted.\n", count);
    +   }
    +}
    +
    +
    +
    +
    +
    Counting with Collation
    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_query_count (mongoc_collection_t *collection, bson_t *query)
    +{
    +   bson_t *selector;
    +   bson_t *opts;
    +   bson_error_t error;
    +   int64_t count;
    +
    +   selector = BCON_NEW ("_id", "{", "$gt", BCON_UTF8 ("one"), "}");
    +
    +   /* "One" normally sorts before "one"; make "one" come first */
    +   opts = BCON_NEW ("collation",
    +                    "{",
    +                    "locale",
    +                    BCON_UTF8 ("en_US"),
    +                    "caseFirst",
    +                    BCON_UTF8 ("lower"),
    +                    "}");
    +
    +   count = mongoc_collection_count_with_opts (
    +      collection, MONGOC_QUERY_NONE, query, 0, 0, opts, NULL, &error);
    +
    +   bson_destroy (selector);
    +   bson_destroy (opts);
    +
    +   if (count < 0) {
    +      fprintf (stderr, "Count failed: %s\n", error.message);
    +   } else {
    +      printf ("%" PRId64 " documents counted.\n", count);
    +   }
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_create_bulk_operation.html b/libmongoc/1.24.0/mongoc_collection_create_bulk_operation.html new file mode 100644 index 0000000000000000000000000000000000000000..82256e63cb2a83d723027fb17344224b35cbb2ea --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_create_bulk_operation.html @@ -0,0 +1,237 @@ + + + + + + + + + + + + + + mongoc_collection_create_bulk_operation() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_create_bulk_operation()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_collection_create_bulk_operation_with_opts() in new code.

    +
    +
    +
    +

    Synopsis

    +
    mongoc_bulk_operation_t *
    +mongoc_collection_create_bulk_operation (
    +   mongoc_collection_t *collection,
    +   bool ordered,
    +   const mongoc_write_concern_t *write_concern) BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_create_bulk_operation_with_opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall begin a new bulk operation. After creating this you may call various functions such as mongoc_bulk_operation_update(), mongoc_bulk_operation_insert() and others.

    +

    After calling mongoc_bulk_operation_execute() the commands will be executed in as large as batches as reasonable by the client.

    +

    If ordered is true, then processing will stop at the first error.

    +

    If ordered is not true, then the bulk operation will attempt to continue processing even after the first failure.

    +

    write_concern contains the write concern for all operations in the bulk operation. If NULL, the collection’s write concern is used. The global default is acknowledged writes: MONGOC_WRITE_CONCERN_W_DEFAULT.

    +
    +
    +

    Errors

    +

    Errors are propagated when executing the bulk operation.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_bulk_operation_t that should be freed with mongoc_bulk_operation_destroy() when no longer in use.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_create_bulk_operation_with_opts.html b/libmongoc/1.24.0/mongoc_collection_create_bulk_operation_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..e2769476547da63912f5c169833be6d968da0097 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_create_bulk_operation_with_opts.html @@ -0,0 +1,233 @@ + + + + + + + + + + + + + + mongoc_collection_create_bulk_operation_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_create_bulk_operation_with_opts()

    +
    +

    Synopsis

    +
    mongoc_bulk_operation_t *
    +mongoc_collection_create_bulk_operation_with_opts (
    +   mongoc_collection_t *collection,
    +   const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function shall begin a new bulk operation. After creating this you may call various functions such as mongoc_bulk_operation_update(), mongoc_bulk_operation_insert() and others.

    +

    After calling mongoc_bulk_operation_execute() the commands will be executed in as large as batches as reasonable by the client.

    +
    +
    +

    Errors

    +

    Errors are propagated when executing the bulk operation.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_bulk_operation_t that should be freed with mongoc_bulk_operation_destroy() when no longer in use.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_create_index.html b/libmongoc/1.24.0/mongoc_collection_create_index.html new file mode 100644 index 0000000000000000000000000000000000000000..7e6ec093333b73686a54c19727f81420e28ada16 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_create_index.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_collection_create_index() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_create_index()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.8.0: This function is deprecated and should not be used in new code. See Manage Collection Indexes.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_create_index (mongoc_collection_t *collection,
    +                                const bson_t *keys,
    +                                const mongoc_index_opt_t *opt,
    +                                bson_error_t *error) BSON_GNUC_DEPRECATED;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_create_index_with_opts.html b/libmongoc/1.24.0/mongoc_collection_create_index_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..bda89600e66d94ace8b04fee39415eb9bbe9e1b5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_create_index_with_opts.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_collection_create_index_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_create_index_with_opts()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.8.0: This function is deprecated and should not be used in new code. See Manage Collection Indexes.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_create_index_with_opts (mongoc_collection_t *collection,
    +                                          const bson_t *keys,
    +                                          const mongoc_index_opt_t *index_opts,
    +                                          const bson_t *command_opts,
    +                                          bson_t *reply,
    +                                          bson_error_t *error)
    +   BSON_GNUC_DEPRECATED;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • keys: A bson_t.

    • +
    • index_opts: A mongoc_index_opt_t.

    • +
    • reply: An optional location for a bson_t which will store the server’s reply.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    command_opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function will request the creation of a new index.

    +

    This function will use the createIndexes command. +The server’s reply is stored in reply.

    +

    If no write concern is provided in command_opts, the collection’s write concern is used.

    +

    See mongoc_index_opt_t for options on creating indexes.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    reply is always initialized and must be destroyed with bson_destroy(). If the server is running an obsolete version of MongoDB then reply may be empty, though it will still be initialized.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_create_indexes_with_opts.html b/libmongoc/1.24.0/mongoc_collection_create_indexes_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..275620b3ac554ca723570af3714a9fe42c538f92 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_create_indexes_with_opts.html @@ -0,0 +1,249 @@ + + + + + + + + + + + + + + mongoc_collection_create_indexes_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_create_indexes_with_opts()

    +
    +

    Synopsis

    +
    typedef struct _mongoc_index_model_t mongoc_index_model_t;
    +
    +mongoc_index_model_t *
    +mongoc_index_model_new (const bson_t *keys, const bson_t *opts);
    +
    +void mongoc_index_model_destroy (mongoc_index_model_t *model);
    +
    +bool
    +mongoc_collection_create_indexes_with_opts (mongoc_collection_t *collection,
    +                                            mongoc_index_model_t **models,
    +                                            size_t n_models,
    +                                            const bson_t *opts,
    +                                            bson_t *reply,
    +                                            bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • models: An array of mongoc_index_model_t *.

    • +
    • n_models: The number of models.

    • +
    • opts: Optional options.

    • +
    • reply: An optional location for the server reply to the createIndexes command.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Additional options passed in opts are appended to the createIndexes command. See the MongoDB Manual for createIndexes for all supported options.

    +

    If no write concern is provided in opts, the collection’s write concern is used.

    +
    +

    mongoc_index_model_t

    +

    Each mongoc_index_model_t represents an index to create. mongoc_index_model_new includes:

    +
      +
    • keys Expected to match the form of the key field in the createIndexes command.

    • +
    • opts Optional index options appended as a sibling to the key field in the createIndexes command.

    • +
    +
    +
    +
    +

    Description

    +

    This function wraps around the createIndexes command.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_delete.html b/libmongoc/1.24.0/mongoc_collection_delete.html new file mode 100644 index 0000000000000000000000000000000000000000..0b064e9c201800c57ee4c0f7afef0be71f14a30c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_delete.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_delete() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_delete()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_collection_delete_one() or mongoc_collection_delete_many() in new code.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_delete (mongoc_collection_t *collection,
    +                          mongoc_delete_flags_t flags,
    +                          const bson_t *selector,
    +                          const mongoc_write_concern_t *write_concern,
    +                          bson_error_t *error)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_delete_one or
    +                             mongoc_collection_delete_many);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall delete documents in the given collection that match selector. The bson selector is not validated, simply passed along as appropriate to the server. As such, compatibility and errors should be validated in the appropriate server documentation.

    +

    If you want to limit deletes to a single document, provide MONGOC_DELETE_SINGLE_REMOVE in flags.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_delete_many.html b/libmongoc/1.24.0/mongoc_collection_delete_many.html new file mode 100644 index 0000000000000000000000000000000000000000..947d8df9e988eb68b850f0a3a3967fcb3321f4cd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_delete_many.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_delete_many() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_delete_many()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_delete_many (mongoc_collection_t *collection,
    +                               const bson_t *selector,
    +                               const bson_t *opts,
    +                               bson_t *reply,
    +                               bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • selector: A bson_t containing the query to match documents.

    • +
    • reply: Optional. An uninitialized bson_t populated with the delete result, or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function removes all documents in the given collection that match selector.

    +

    To delete at most one matching document, use mongoc_collection_delete_one().

    +

    If you pass a non-NULL reply, it is filled out with the field “deletedCount”. If there is a server error then reply contains either a “writeErrors” array with one subdocument or a “writeConcernErrors” array. The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_delete_one.html b/libmongoc/1.24.0/mongoc_collection_delete_one.html new file mode 100644 index 0000000000000000000000000000000000000000..932e0982b9ecccc57169337d21dd109fc9737767 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_delete_one.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_delete_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_delete_one()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_delete_one (mongoc_collection_t *collection,
    +                              const bson_t *selector,
    +                              const bson_t *opts,
    +                              bson_t *reply,
    +                              bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • selector: A bson_t containing the query to match documents.

    • +
    • reply: Optional. An uninitialized bson_t populated with the delete result, or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function removes at most one document in the given collection that matches selector.

    +

    To delete all matching documents, use mongoc_collection_delete_many().

    +

    If you pass a non-NULL reply, it is filled out with the field “deletedCount”. If there is a server error then reply contains either a “writeErrors” array with one subdocument or a “writeConcernErrors” array. The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_destroy.html b/libmongoc/1.24.0/mongoc_collection_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..f0313538b8ef6073b939583491662bce6bda0190 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_destroy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_collection_destroy (mongoc_collection_t *collection);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall destroy a mongoc_collection_t and its associated resources. Does nothing if collection is NULL.

    +
    +

    Warning

    +

    Always destroy a mongoc_cursor_t created from a collection before destroying the collection.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_drop.html b/libmongoc/1.24.0/mongoc_collection_drop.html new file mode 100644 index 0000000000000000000000000000000000000000..4aa9e918be6410708bc15dfdc1d29ee8bb8462f5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_drop.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_collection_drop() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_drop()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_drop (mongoc_collection_t *collection, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    For more information, see mongoc_collection_drop_with_opts(). This function is a thin wrapper, passing NULL in as bson_t parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_drop_index.html b/libmongoc/1.24.0/mongoc_collection_drop_index.html new file mode 100644 index 0000000000000000000000000000000000000000..ac38936bd1b8027ee40b165ec278849c31ef8a3a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_drop_index.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_drop_index() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_drop_index()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_drop_index (mongoc_collection_t *collection,
    +                              const char *index_name,
    +                              bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    For more information, see mongoc_collection_drop_with_opts(). This function is a thin wrapper, passing NULL in as bson_t parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_drop_index_with_opts.html b/libmongoc/1.24.0/mongoc_collection_drop_index_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..7f09ebfa2be9ac5d66a4e3eb7c2cf681100c3ed0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_drop_index_with_opts.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_drop_index_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_drop_index_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_drop_index_with_opts (mongoc_collection_t *collection,
    +                                        const char *index_name,
    +                                        const bson_t *opts,
    +                                        bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function requests than an index on collection be dropped.

    +

    If no write concern is provided in opts, the collection’s write concern is used.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_drop_with_opts.html b/libmongoc/1.24.0/mongoc_collection_drop_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..3435f714375e6e2c66a9771baf3a7c04a288256a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_drop_with_opts.html @@ -0,0 +1,247 @@ + + + + + + + + + + + + + + mongoc_collection_drop_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_drop_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_drop_with_opts (mongoc_collection_t *collection,
    +                                  bson_t *opts,
    +                                  bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function requests that a collection be dropped, including all indexes associated with the collection.

    +

    If no write concern is provided in opts, the collection’s write concern is used.

    +

    If the collection does not exist, the server responds with an “ns not found” error. It is safe to ignore this error; set the Error API Version to 2 and ignore server error code 26:

    +
    mongoc_client_t *client;
    +mongoc_collection_t *collection;
    +bson_error_t error;
    +bool r;
    +
    +client = mongoc_client_new (NULL);
    +mongoc_client_set_error_api (client, 2);
    +collection = mongoc_client_get_collection (client, "db", "collection");
    +r = mongoc_collection_drop_with_opts (collection, NULL /* opts */, &error);
    +if (r) {
    +   printf ("Dropped.\n");
    +} else {
    +   printf ("Error message: %s\n", error.message);
    +   if (error.domain == MONGOC_ERROR_SERVER && error.code == 26) {
    +      printf ("Ignoring 'ns not found' error\n");
    +   } else {
    +      fprintf (stderr, "Unrecognized error!\n");
    +   }
    +}
    +
    +mongoc_collection_destroy (collection);
    +mongoc_client_destroy (client);
    +
    +
    +

    In MongoDB 3.0 and older, the “ns not found” error code is the generic MONGOC_ERROR_QUERY_FAILURE; in this case check whether the error message is equal to the string “ns not found”.

    +

    The encryptedFields document in opts may be used to drop a collection for Queryable Encryption. If encryptedFields is specified, the “ns not found” error is not returned.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if the collection was successfully dropped. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_ensure_index.html b/libmongoc/1.24.0/mongoc_collection_ensure_index.html new file mode 100644 index 0000000000000000000000000000000000000000..48f3cdd680874aea068e83d4ec171e2f54195461 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_ensure_index.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_collection_ensure_index() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_ensure_index()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.8.0: This function is deprecated and should not be used in new code. See Manage Collection Indexes.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_ensure_index (mongoc_collection_t *collection,
    +                                const bson_t *keys,
    +                                const mongoc_index_opt_t *opt,
    +                                bson_error_t *error)
    +   BSON_GNUC_DEPRECATED;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_estimated_document_count.html b/libmongoc/1.24.0/mongoc_collection_estimated_document_count.html new file mode 100644 index 0000000000000000000000000000000000000000..58a0d27cf28eb99fde9dcb6b728f7e9225e20e6b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_estimated_document_count.html @@ -0,0 +1,270 @@ + + + + + + + + + + + + + + mongoc_collection_estimated_document_count() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_estimated_document_count()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_collection_estimated_document_count (mongoc_collection_t *collection,
    +                                            const bson_t *opts,
    +                                            const mongoc_read_prefs_t *read_prefs,
    +                                            bson_t *reply,
    +                                            bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
      +
    • skip: An int specifying how many documents matching the query should be skipped before counting.

    • +
    • limit: An int specifying the maximum number of documents to count.

    • +
    • comment: A bson_value_t specifying the comment to attach to this command. The comment will appear in log messages, profiler output, and currentOp output. Requires MongoDB 4.4 or later.

    • +
    +

    For a list of all options, see the MongoDB Manual entry on the count command.

    +
    +
    +

    Description

    +

    This functions executes a count query on collection. In contrast with mongoc_collection_count_documents(), the count returned is not guaranteed to be accurate.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +

    Behavior

    +

    This method is implemented using the count command. Due to an oversight in versions 5.0.0-5.0.8 of MongoDB, the count command was not included in version “1” of the Stable API. Applications using this method with the Stable API are recommended to upgrade their server version to 5.0.9+ or disable strict mode (via :symbol:`mongoc_server_api_strict()) to avoid encountering errors.

    +
    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    -1 on failure, otherwise the number of documents counted.

    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_count (mongoc_collection_t *collection, bson_t *query)
    +{
    +   bson_error_t error;
    +   int64_t count;
    +   bson_t* opts = BCON_NEW ("skip", BCON_INT64(5));
    +
    +   count = mongoc_collection_estimated_document_count (
    +      collection, opts, NULL, NULL, &error);
    +   bson_destroy (opts);
    +
    +   if (count < 0) {
    +      fprintf (stderr, "Count failed: %s\n", error.message);
    +   } else {
    +      printf ("%" PRId64 " documents counted.\n", count);
    +   }
    +}
    +
    +
    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_find.html b/libmongoc/1.24.0/mongoc_collection_find.html new file mode 100644 index 0000000000000000000000000000000000000000..8628aa069e8f9107f678fd577b7d91c9aa4bab15 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_find.html @@ -0,0 +1,356 @@ + + + + + + + + + + + + + + mongoc_collection_find() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_find()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.5.0: This function is deprecated and should not be used in new code.

    +
    +
    +

    Use the more convenient mongoc_collection_find_with_opts() instead.

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_collection_find (mongoc_collection_t *collection,
    +                        mongoc_query_flags_t flags,
    +                        uint32_t skip,
    +                        uint32_t limit,
    +                        uint32_t batch_size,
    +                        const bson_t *query,
    +                        const bson_t *fields,
    +                        const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_find_with_opts)
    +      BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • flags: A mongoc_query_flags_t.

    • +
    • skip: A uint32_t of number of documents to skip or 0.

    • +
    • limit: A uint32_t of max number of documents to return or 0.

    • +
    • batch_size: A uint32_t containing batch size of document result sets or 0 for default. Default is 100.

    • +
    • query: A bson_t containing the query and options to execute.

    • +
    • fields: A bson_t containing fields to return or NULL.

    • +
    • read_prefs: A mongoc_read_prefs_t or NULL for default read preferences.

    • +
    +
    +
    +

    Description

    +

    This function shall execute a query on the underlying collection.

    +

    If no options are necessary, query can simply contain a query such as {a:1}. If you would like to specify options such as a sort order, the query must be placed inside of {"$query": {}}. See the example below for how to properly specify additional options to query.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    +

    Example

    +
    +
    Print All Documents in a Collection
    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_all_documents (mongoc_collection_t *collection)
    +{
    +   mongoc_cursor_t *cursor;
    +   bson_error_t error;
    +   const bson_t *doc;
    +   char *str;
    +   bson_t *query;
    +
    +   query = BCON_NEW ("$query",
    +                     "{",
    +                     "foo",
    +                     BCON_INT32 (1),
    +                     "}",
    +                     "$orderby",
    +                     "{",
    +                     "bar",
    +                     BCON_INT32 (-1),
    +                     "}");
    +   cursor = mongoc_collection_find (
    +      collection, MONGOC_QUERY_NONE, 0, 0, 0, query, NULL, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "An error occurred: %s\n", error.message);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   bson_destroy (query);
    +}
    +
    +
    +
    +
    +
    +

    The “find” command

    +

    Queries have historically been sent as OP_QUERY wire protocol messages, but beginning in MongoDB 3.2 queries use the “find” command instead.

    +

    The driver automatically converts queries to the new “find” command syntax if needed, so this change is typically invisible to C Driver users. However, an application written exclusively for MongoDB 3.2 and later can choose to use the new syntax directly instead of relying on the driver to convert from the old syntax:

    +
    /* MongoDB 3.2+ "find" command syntax */
    +query = BCON_NEW ("filter",
    +                  "{",
    +                  "foo",
    +                  BCON_INT32 (1),
    +                  "}",
    +                  "sort",
    +                  "{",
    +                  "bar",
    +                  BCON_INT32 (-1),
    +                  "}");
    +cursor = mongoc_collection_find (
    +   collection, MONGOC_QUERY_NONE, 0, 0, 0, query, NULL, NULL);
    +
    +
    +

    The “find” command takes different options from the traditional OP_QUERY message.

    + + + + + + + + + + + + + + + + + + + +

    Query

    $query

    filter

    Sort

    $orderby

    sort

    Show record location

    $showDiskLoc

    showRecordId

    Other $-options

    $<option name>

    <option name>

    +

    Most applications should use the OP_QUERY syntax, with “$query”, “$orderby”, and so on, and rely on the driver to convert to the new syntax if needed.

    +
    +

    See also

    +
    +
    The “find” command in the MongoDB Manual.
    +
    +
    +
    +
    +

    The “explain” command

    +

    With MongoDB before 3.2, a query with option $explain: true returns information about the query plan, instead of the query results. Beginning in MongoDB 3.2, there is a separate “explain” command. The driver will not convert “$explain” queries to “explain” commands, you must call the “explain” command explicitly:

    +
    /* MongoDB 3.2+, "explain" command syntax */
    +command = BCON_NEW ("explain",
    +                    "{",
    +                    "find",
    +                    BCON_UTF8 ("collection_name"),
    +                    "filter",
    +                    "{",
    +                    "foo",
    +                    BCON_INT32 (1),
    +                    "}",
    +                    "}");
    +mongoc_collection_command_simple (collection, command, NULL, &reply, &error);
    +
    +
    +
    +

    See also

    +
    +
    The “explain” command in the MongoDB Manual.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_find_and_modify.html b/libmongoc/1.24.0/mongoc_collection_find_and_modify.html new file mode 100644 index 0000000000000000000000000000000000000000..07957a2858493c345a9c8a9dcc47aec3d9596204 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_find_and_modify.html @@ -0,0 +1,332 @@ + + + + + + + + + + + + + + mongoc_collection_find_and_modify() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_find_and_modify()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_find_and_modify (mongoc_collection_t *collection,
    +                                   const bson_t *query,
    +                                   const bson_t *sort,
    +                                   const bson_t *update,
    +                                   const bson_t *fields,
    +                                   bool _remove,
    +                                   bool upsert,
    +                                   bool _new,
    +                                   bson_t *reply,
    +                                   bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • query: A bson_t containing the query to locate target document(s).

    • +
    • sort: A bson_t containing the sort order for query.

    • +
    • update: A bson_t containing an update spec.

    • +
    • fields: An optional bson_t containing the fields to return or NULL.

    • +
    • _remove: If the matching documents should be removed.

    • +
    • upsert: If an upsert should be performed.

    • +
    • _new: If the new version of the document should be returned.

    • +
    • reply: Optional pointer to an uninitialized bson_t that will be initialized with the result.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    Update and return an object.

    +

    This is a thin wrapper around the findAndModify command. Either update or _remove arguments are required.

    +

    As of MongoDB 3.2, the mongoc_write_concern_t specified on the mongoc_collection_t will be used, if any.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    On success, the output reply contains the full server reply to the findAndModify command. See the MongoDB Manual page for findAndModify for the expected server reply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    If given invalid arguments or a server/network error occurs, returns false and sets error. Otherwise, succeeds and returns true. +A write concern timeout or write concern error is considered a failure.

    + +
    +
    +

    Example

    +
    +
    find-and-modify.c
    +
    #include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +
    +int
    +main (void)
    +{
    +   mongoc_collection_t *collection;
    +   mongoc_client_t *client;
    +   const char *uri_string =
    +      "mongodb://127.0.0.1:27017/?appname=find-and-modify-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +   bson_t *query;
    +   bson_t *update;
    +   bson_t reply;
    +   char *str;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   /*
    +    * Build our query, {"cmpxchg": 1}
    +    */
    +   query = BCON_NEW ("cmpxchg", BCON_INT32 (1));
    +
    +   /*
    +    * Build our update. {"$set": {"cmpxchg": 2}}
    +    */
    +   update = BCON_NEW ("$set", "{", "cmpxchg", BCON_INT32 (2), "}");
    +
    +   /*
    +    * Submit the findAndModify.
    +    */
    +   if (!mongoc_collection_find_and_modify (collection,
    +                                           query,
    +                                           NULL,
    +                                           update,
    +                                           NULL,
    +                                           false,
    +                                           false,
    +                                           true,
    +                                           &reply,
    +                                           &error)) {
    +      fprintf (stderr, "find_and_modify() failure: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   /*
    +    * Print the result as JSON.
    +    */
    +   str = bson_as_canonical_extended_json (&reply, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   /*
    +    * Cleanup.
    +    */
    +   bson_destroy (query);
    +   bson_destroy (update);
    +   bson_destroy (&reply);
    +   mongoc_collection_destroy (collection);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_find_and_modify_with_opts.html b/libmongoc/1.24.0/mongoc_collection_find_and_modify_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..416b93f4b058f0898db9868ffbebed1f21ccd97a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_find_and_modify_with_opts.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_collection_find_and_modify_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_find_and_modify_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_find_and_modify_with_opts (
    +   mongoc_collection_t *collection,
    +   const bson_t *query,
    +   const mongoc_find_and_modify_opts_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Update and return an object.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    If an unacknowledged write concern is set (through mongoc_find_and_modify_opts_append()), the output reply is always an empty document.

    +

    On success, the output reply contains the full server reply to the findAndModify command. See the MongoDB Manual page for findAndModify for the expected server reply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Example

    +

    See the example code for mongoc_find_and_modify_opts_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_find_indexes.html b/libmongoc/1.24.0/mongoc_collection_find_indexes.html new file mode 100644 index 0000000000000000000000000000000000000000..572df6a25c6ce98e59b45d19892cbf9a3cb14207 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_find_indexes.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_collection_find_indexes() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_find_indexes()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_collection_find_indexes_with_opts() in new code.

    +
    +
    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_collection_find_indexes (mongoc_collection_t *collection,
    +                                bson_error_t *error);
    +   BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_find_indexes_with_opts);
    +
    +
    +

    Fetches a cursor containing documents, each corresponding to an index on this collection.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +

    In the returned cursor each result corresponds to the server’s representation of an index on this collection. If the collection does not exist on the server, the cursor will be empty.

    +

    The cursor functions mongoc_cursor_set_limit(), mongoc_cursor_set_batch_size(), and mongoc_cursor_set_max_await_time_ms() have no use on the returned cursor.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_find_indexes_with_opts.html b/libmongoc/1.24.0/mongoc_collection_find_indexes_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..7c1d89cd9be65ae7dbd9e96ae896870a3a37f094 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_find_indexes_with_opts.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_collection_find_indexes_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_find_indexes_with_opts()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_collection_find_indexes_with_opts (mongoc_collection_t *collection,
    +                                          const bson_t *opts)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Fetches a cursor containing documents, each corresponding to an index on this collection.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the listIndexes command.

    +
    +
    +

    Errors

    +

    Use mongoc_cursor_error() on the returned cursor to check for errors.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +

    In the returned cursor each result corresponds to the server’s representation of an index on this collection. If the collection does not exist on the server, the cursor will be empty.

    +

    The cursor functions mongoc_cursor_set_limit(), mongoc_cursor_set_batch_size(), and mongoc_cursor_set_max_await_time_ms() have no use on the returned cursor.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_find_with_opts.html b/libmongoc/1.24.0/mongoc_collection_find_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a11ac30bd3419cd558c28655054ae8d19d277275 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_find_with_opts.html @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + mongoc_collection_find_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_find_with_opts()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_collection_find_with_opts (mongoc_collection_t *collection,
    +                                  const bson_t *filter,
    +                                  const bson_t *opts,
    +                                  const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Query on collection, passing arbitrary query options to the server in opts.

    +

    To target a specific server, include an integer “serverId” field in opts with an id obtained first by calling mongoc_client_select_server(), then mongoc_server_description_id() on its return value.

    +

    Read preferences, read concern, and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. The highest-priority sources for these options are listed first in the following table. No write concern is applied.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Collation

    read_prefs

    opts

    opts

    Transaction

    Transaction

    collection

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    +

    Examples

    +
    +
    Print First Ten Documents in a Collection
    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +static void
    +print_ten_documents (mongoc_collection_t *collection)
    +{
    +   bson_t *filter;
    +   bson_t *opts;
    +   mongoc_cursor_t *cursor;
    +   bson_error_t error;
    +   const bson_t *doc;
    +   char *str;
    +
    +   /* filter by "foo": 1, order by "bar" descending */
    +   filter = BCON_NEW ("foo", BCON_INT32 (1));
    +   opts = BCON_NEW (
    +      "limit", BCON_INT64 (10), "sort", "{", "bar", BCON_INT32 (-1), "}");
    +
    +   cursor = mongoc_collection_find_with_opts (collection, filter, opts, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "An error occurred: %s\n", error.message);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   bson_destroy (filter);
    +   bson_destroy (opts);
    +}
    +
    +
    +
    +
    +
    More examples of modifying the query with opts:
    +
    bson_t *filter;
    +bson_t *opts;
    +mongoc_read_prefs_t *read_prefs;
    +
    +filter = BCON_NEW ("foo", BCON_INT32 (1));
    +
    +/* Include "field_name_one" and "field_name_two" in "projection", omit
    + * others. "_id" must be specifically removed or it is included by default.
    + */
    +opts = BCON_NEW ("projection", "{",
    +                    "field_name_one", BCON_BOOL (true),
    +                    "field_name_two", BCON_BOOL (true),
    +                    "_id", BCON_BOOL (false),
    +                 "}",
    +                 "tailable", BCON_BOOL (true),
    +                 "awaitData", BCON_BOOL (true),
    +                 "sort", "{", "bar", BCON_INT32 (-1), "}",
    +                 "collation", "{",
    +                    "locale", BCON_UTF8("en_US"),
    +                    "caseFirst", BCON_UTF8 ("lower"),
    +                 "}");
    +
    +read_prefs = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +
    +cursor =
    +   mongoc_collection_find_with_opts (collection, filter, opts, read_prefs);
    +
    +
    +
    +

    The following options are supported.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Option

    BSON type

    Option

    BSON type

    projection

    document

    max

    document

    sort

    document

    maxTimeMS

    non-negative int64

    skip

    non-negative int64

    maxAwaitTimeMS

    non-negative int64

    limit

    non-negative int64

    min

    document

    batchSize

    non-negative int64

    noCursorTimeout

    bool

    exhaust

    bool

    oplogReplay

    bool

    hint

    string or document

    readConcern

    document

    allowPartialResults

    bool

    returnKey

    bool

    awaitData

    bool

    sessionId

    (none)

    collation

    document

    showRecordId

    bool

    comment

    any

    singleBatch

    bool

    allowDiskUse

    bool

    let

    document

    +

    All options are documented in the reference page for the “find” command in the MongoDB server manual, except for “maxAwaitTimeMS”, “sessionId”, and “exhaust”.

    +

    “maxAwaitTimeMS” is the maximum amount of time for the server to wait on new documents to satisfy a query, if “tailable” and “awaitData” are both true. +If no new documents are found, the tailable cursor receives an empty batch. The “maxAwaitTimeMS” option is ignored for MongoDB older than 3.4.

    +

    To add a “sessionId”, construct a mongoc_client_session_t with mongoc_client_start_session(). You can begin a transaction with mongoc_client_session_start_transaction(), optionally with a mongoc_transaction_opt_t that overrides the options inherited from collection. Then use mongoc_client_session_append() to add the session to opts. See the example code for mongoc_client_session_t.

    +

    To add a “readConcern”, construct a mongoc_read_concern_t with mongoc_read_concern_new() and configure it with mongoc_read_concern_set_level(). Then use mongoc_read_concern_append() to add the read concern to opts.

    +

    “exhaust” requests the construction of an exhaust cursor. For MongoDB servers before 5.1, this option converts the command into a legacy OP_QUERY message. For MongoDB servers 5.1 and newer, this option is ignored and a normal cursor is constructed instead.

    +

    For some options like “collation”, the driver returns an error if the server version is too old to support the feature. +Any fields in opts that are not listed here are passed to the server unmodified.

    +

    allowDiskUse is only supported in MongoDB 4.4+.

    +

    comment only supports string values prior to MongoDB 4.4.

    +
    +
    +

    Deprecated Options

    +

    The snapshot boolean option is removed in MongoDB 4.0. The maxScan option, a non-negative int64, is deprecated in MongoDB 4.0 and will be removed in a future MongoDB version. The oplogReplay boolean option is deprecated in MongoDB 4.4. All of these options are supported by the C Driver with older MongoDB versions.

    +
    +

    See also

    +
    +
    The “find” command in the MongoDB Manual. All options listed there are supported by the C Driver. For MongoDB servers before 3.2, the driver transparently converts the query to a legacy OP_QUERY message.
    +
    +
    +
    +
    +

    The “explain” command

    +

    With MongoDB before 3.2, a query with option $explain: true returns information about the query plan, instead of the query results. Beginning in MongoDB 3.2, there is a separate “explain” command. The driver will not convert “$explain” queries to “explain” commands, you must call the “explain” command explicitly:

    +
    /* MongoDB 3.2+, "explain" command syntax */
    +command = BCON_NEW ("explain", "{",
    +                    "find", BCON_UTF8 ("collection_name"),
    +                    "filter", "{", "foo", BCON_INT32 (1), "}",
    +                    "}");
    +
    +mongoc_collection_command_simple (collection, command, NULL, &reply, &error);
    +
    +
    +
    +

    See also

    +
    +
    The “explain” command in the MongoDB Manual.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_get_last_error.html b/libmongoc/1.24.0/mongoc_collection_get_last_error.html new file mode 100644 index 0000000000000000000000000000000000000000..358997a4111060ced608f8da33bc027002eec6d8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_get_last_error.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_collection_get_last_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_get_last_error()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_collection_get_last_error (const mongoc_collection_t *collection);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The mongoc_collection_get_last_error() function returns a bulk result. See Bulk Write Operations for examples of bulk results.

    +

    A write_concern must be at least MONGOC_WRITE_CONCERN_W_DEFAULT in last command execution for this to be available.

    +
    +
    +

    Returns

    +

    A bson_t that should not be modified or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_get_name.html b/libmongoc/1.24.0/mongoc_collection_get_name.html new file mode 100644 index 0000000000000000000000000000000000000000..149443d4c2db2a078f1d736b44a99248c9f915dd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_get_name.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_get_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_collection_get_name (mongoc_collection_t *collection);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the name of collection.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_get_read_concern.html b/libmongoc/1.24.0/mongoc_collection_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..36b0718825e30e51bb289f16dc19a25af50a0828 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_get_read_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_get_read_concern()

    +
    +

    Synopsis

    +
    const mongoc_read_concern_t *
    +mongoc_collection_get_read_concern (const mongoc_collection_t *collection);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the default read concern to be used on read operations originating from collection.

    +
    +
    +

    Returns

    +

    A mongoc_read_concern_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_get_read_prefs.html b/libmongoc/1.24.0/mongoc_collection_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..7bcd7c44e242153ddb40e7a05250feb075f8aa4a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_get_read_prefs.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_get_read_prefs()

    +
    +

    Synopsis

    +
    const mongoc_read_prefs_t *
    +mongoc_collection_get_read_prefs (const mongoc_collection_t *collection);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the default read preferences to use for collection. Operations without specified read-preferences will default to this.

    +
    +
    +

    Returns

    +

    A mongoc_read_prefs_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_get_write_concern.html b/libmongoc/1.24.0/mongoc_collection_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..ddd31ce1050bd60ffca236e40570471a8be6655f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_get_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_get_write_concern()

    +
    +

    Synopsis

    +
    const mongoc_write_concern_t *
    +mongoc_collection_get_write_concern (const mongoc_collection_t *collection);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the default write concern to be used on write operations originating from collection and not specifying a write concern.

    +
    +
    +

    Returns

    +

    A mongoc_write_concern_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_insert.html b/libmongoc/1.24.0/mongoc_collection_insert.html new file mode 100644 index 0000000000000000000000000000000000000000..11a848765cfc4af18d9ff417cf55a9501a4c2e8f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_insert.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_collection_insert() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_insert()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_insert (mongoc_collection_t *collection,
    +                          mongoc_insert_flags_t flags,
    +                          const bson_t *document,
    +                          const mongoc_write_concern_t *write_concern,
    +                          bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Superseded by mongoc_collection_insert_one() and mongoc_collection_insert_many().

    +

    This function shall insert document into collection.

    +

    If no _id element is found in document, then a bson_oid_t will be generated locally and added to the document. If you must know the inserted document’s _id, generate it in your code and include it in the document. The _id you generate can be a bson_oid_t or any other non-array BSON type.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_insert_bulk.html b/libmongoc/1.24.0/mongoc_collection_insert_bulk.html new file mode 100644 index 0000000000000000000000000000000000000000..e0bacb1384bf0904b43b9bfd0567c38884c77130 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_insert_bulk.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_insert_bulk() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_insert_bulk()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_collection_insert_many() in new code.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_insert_bulk (mongoc_collection_t *collection,
    +                               mongoc_insert_flags_t flags,
    +                               const bson_t **documents,
    +                               uint32_t n_documents,
    +                               const mongoc_write_concern_t *write_concern,
    +                               bson_error_t *error)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_insert_many);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function performs a bulk insert of all of the documents in documents. This function is deprecated as it cannot accurately return which documents may have failed during the bulk insert.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_insert_many.html b/libmongoc/1.24.0/mongoc_collection_insert_many.html new file mode 100644 index 0000000000000000000000000000000000000000..f3236a3485bd673ae0eca40c5a89aed6f1562f88 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_insert_many.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_collection_insert_many() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_insert_many()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_insert_many (mongoc_collection_t *collection,
    +                               const bson_t **documents,
    +                               size_t n_documents,
    +                               const bson_t *opts,
    +                               bson_t *reply,
    +                               bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • documents: An array of pointers to bson_t.

    • +
    • n_documents: The length of documents.

    • +
    • reply: Optional. An uninitialized bson_t populated with the insert result, or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    Insert documents into collection.

    +

    To insert a single document, see mongoc_collection_insert_one().

    +

    For any document that does not have an “_id” field, a bson_oid_t will be generated locally and added to the document. If you must know the inserted document’s _id, generate it in your code and include it in the document. The _id you generate can be a bson_oid_t or any other non-array BSON type.

    +

    If you pass a non-NULL reply, it is filled out with an “insertedCount” field. If there is a server error then reply may contain a “writeErrors” array and/or a “writeConcernErrors” array (see Bulk Write Operations for examples). The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_insert_one.html b/libmongoc/1.24.0/mongoc_collection_insert_one.html new file mode 100644 index 0000000000000000000000000000000000000000..678e39d43d8278074b8fdc69176d11f4c77d8b8b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_insert_one.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_insert_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_insert_one()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_insert_one (mongoc_collection_t *collection,
    +                              const bson_t *document,
    +                              const bson_t *opts,
    +                              bson_t *reply,
    +                              bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function shall insert document into collection.

    +

    To insert an array of documents, see mongoc_collection_insert_many().

    +

    If no _id element is found in document, then a bson_oid_t will be generated locally and added to the document. If you must know the inserted document’s _id, generate it in your code and include it in the document. The _id you generate can be a bson_oid_t or any other non-array BSON type.

    +

    If you pass a non-NULL reply, it is filled out with an “insertedCount” field. If there is a server error then reply contains either a “writeErrors” array with one subdocument or a “writeConcernErrors” array. The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_keys_to_index_string.html b/libmongoc/1.24.0/mongoc_collection_keys_to_index_string.html new file mode 100644 index 0000000000000000000000000000000000000000..1c29ae9a05a725dfe7ca38faf7ea450c88e87f40 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_keys_to_index_string.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_collection_keys_to_index_string() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_keys_to_index_string()

    +
    +

    Synopsis

    +
    char *
    +mongoc_collection_keys_to_index_string (const bson_t *keys)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • keys: A bson_t. This is expected to match the form of the key field in the createIndexes command.

    • +
    +
    +
    +

    Description

    +

    This function returns the canonical stringification of a given key specification. See Manage Collection Indexes for example usage.

    +

    It is a programming error to call this function on a non-standard index, such one other than a straight index with ascending and descending.

    +
    +
    +

    Returns

    +

    A string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_read_command_with_opts.html b/libmongoc/1.24.0/mongoc_collection_read_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..0650f0b78128c4db246956fd73f151c1b32d1314 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_read_command_with_opts.html @@ -0,0 +1,259 @@ + + + + + + + + + + + + + + mongoc_collection_read_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_read_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_read_command_with_opts (mongoc_collection_t *collection,
    +                                          const bson_t *command,
    +                                          const mongoc_read_prefs_t *read_prefs,
    +                                          const bson_t *opts,
    +                                          bson_t *reply,
    +                                          bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic that is specific to commands that read, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_collection_command_simple().

    +

    Use this function for commands that read such as “count” or “distinct”.

    +

    Read preferences, read concern, and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. The highest-priority sources for these options are listed first in the following table. No write concern is applied.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Collation

    read_prefs

    opts

    opts

    Transaction

    Transaction

    collection

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +

    Retry logic occurs regardless of the underlying command. Retrying mapReduce has the potential for degraded performance. +Retrying a getMore command has the potential to miss results. For those commands, use generic command helpers (like mongoc_collection_command_with_opts()) instead.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_read_write_command_with_opts.html b/libmongoc/1.24.0/mongoc_collection_read_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..d2cf815b1fadb59c91da9157660bea31c072a666 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_read_write_command_with_opts.html @@ -0,0 +1,258 @@ + + + + + + + + + + + + + + mongoc_collection_read_write_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_read_write_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_read_write_command_with_opts (
    +   mongoc_collection_t *collection,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs /* UNUSED */,
    +   const bson_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic for commands that both read and write, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_collection_command_simple().

    +

    Use this function for commands that both read and write, such as “mapReduce” with an output collection.

    +

    Read and write concern and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts. The highest-priority sources for these options are listed first in the following table. Read preferences are not applied. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Concern

    Write Concern

    Collation

    opts

    opts

    opts

    Transaction

    Transaction

    collection

    collection

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    (The mongoc_read_prefs_t parameter was included by mistake when this function was introduced in libmongoc 1.5. A command that writes must not obey a read preference.)

    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • command: A bson_t containing the command specification.

    • +
    • read_prefs: Ignored.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_remove.html b/libmongoc/1.24.0/mongoc_collection_remove.html new file mode 100644 index 0000000000000000000000000000000000000000..6260b1dd2c405bcd56690b828dcfc5a9b860dc20 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_remove.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_collection_remove() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_remove()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_remove (mongoc_collection_t *collection,
    +                          mongoc_remove_flags_t flags,
    +                          const bson_t *selector,
    +                          const mongoc_write_concern_t *write_concern,
    +                          bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Superseded by mongoc_collection_delete_one() and mongoc_collection_delete_many().

    +

    This function shall remove documents in the given collection that match selector. The bson selector is not validated, simply passed along as appropriate to the server. As such, compatibility and errors should be validated in the appropriate server documentation.

    +

    If you want to limit deletes to a single document, provide MONGOC_REMOVE_SINGLE_REMOVE in flags.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_rename.html b/libmongoc/1.24.0/mongoc_collection_rename.html new file mode 100644 index 0000000000000000000000000000000000000000..693a0348c70ce000c8eb18e113265cc7ca6bb2e9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_rename.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_collection_rename() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_rename()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_rename (mongoc_collection_t *collection,
    +                          const char *new_db,
    +                          const char *new_name,
    +                          bool drop_target_before_rename,
    +                          bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • new_db: The name of the new database.

    • +
    • new_name: The new name for the collection.

    • +
    • drop_target_before_rename: If an existing collection matches the new name, drop it before the rename.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    For more information, see mongoc_collection_rename_with_opts(). This function is a thin wrapper, passing NULL in as bson_t parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_rename_with_opts.html b/libmongoc/1.24.0/mongoc_collection_rename_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..1d65d7204e14ed0d83bd1f5aae34c92ad46de5f8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_rename_with_opts.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_collection_rename_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_rename_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_rename_with_opts (mongoc_collection_t *collection,
    +                                    const char *new_db,
    +                                    const char *new_name,
    +                                    bool drop_target_before_rename,
    +                                    const bson_t *opts,
    +                                    bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • new_db: The name of the new database.

    • +
    • new_name: The new name for the collection.

    • +
    • drop_target_before_rename: If an existing collection matches the new name, drop it before the rename.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function is a helper to rename an existing collection on a MongoDB server. The name of the collection will also be updated internally so it is safe to continue using this collection after the rename. Additional operations will occur on renamed collection.

    +

    If no write concern is provided in opts, the collection’s write concern is used.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_replace_one.html b/libmongoc/1.24.0/mongoc_collection_replace_one.html new file mode 100644 index 0000000000000000000000000000000000000000..4f04b1ec208f040420b8463b825a21093049e8d9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_replace_one.html @@ -0,0 +1,244 @@ + + + + + + + + + + + + + + mongoc_collection_replace_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_replace_one()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_replace_one (mongoc_collection_t *collection,
    +                               const bson_t *selector,
    +                               const bson_t *replacement,
    +                               const bson_t *opts,
    +                               bson_t *reply,
    +                               bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • selector: A bson_t containing the query to match the document for updating.

    • +
    • replacement: A bson_t containing the replacement document.

    • +
    • reply: Optional. An uninitialized bson_t populated with the update result, or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function shall replace documents in collection that match selector with replacement.

    +

    If provided, reply will be initialized and populated with the fields matchedCount, modifiedCount, upsertedCount, and optionally upsertedId if applicable. If there is a server error then reply contains either a writeErrors array with one subdocument or a writeConcernErrors array. The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +

    See also

    +
    +
    MongoDB update command documentation for more information on the update options.
    +
    + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_save.html b/libmongoc/1.24.0/mongoc_collection_save.html new file mode 100644 index 0000000000000000000000000000000000000000..40f007c98cc1a6fb25b8a38e8a6fa82924f44d50 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_save.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_collection_save() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_save()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_collection_insert_one() or +mongoc_collection_replace_one() with “upsert” instead.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_save (mongoc_collection_t *collection,
    +                        const bson_t *document,
    +                        const mongoc_write_concern_t *write_concern,
    +                        bson_error_t *error)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_insert_one or
    +                             mongoc_collection_replace_one);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall save a document into collection. If the document has an _id field it will be updated. Otherwise it will be inserted.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_set_read_concern.html b/libmongoc/1.24.0/mongoc_collection_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..9b910f6f29d803a4290a557d8c4c5e71067e6adb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_set_read_concern.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_collection_set_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_set_read_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_collection_set_read_concern (mongoc_collection_t *collection,
    +                                    const mongoc_read_concern_t *read_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the read concern to use for operations on collection.

    +

    The default read concern is empty: No readConcern is sent to the server unless explicitly configured.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_set_read_prefs.html b/libmongoc/1.24.0/mongoc_collection_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..b6b348aafa2f9101ed65312e952cfc44af991f7b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_set_read_prefs.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_set_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_set_read_prefs()

    +
    +

    Synopsis

    +
    void
    +mongoc_collection_set_read_prefs (mongoc_collection_t *collection,
    +                                  const mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the default read preferences to use for operations on collection not specifying a read preference.

    +

    The global default is MONGOC_READ_PRIMARY: if the client is connected to a replica set it reads from the primary, otherwise it reads from the current MongoDB server.

    +

    Please see the MongoDB website for a description of Read Preferences.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_set_write_concern.html b/libmongoc/1.24.0/mongoc_collection_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..29170af835fe421f5a921b9f94768d45fa013755 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_set_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_set_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_set_write_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_collection_set_write_concern (
    +   mongoc_collection_t *collection,
    +   const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the write concern to use for operations on collection.

    +

    The default write concern is MONGOC_WRITE_CONCERN_W_DEFAULT: the driver blocks awaiting basic acknowledgement of write operations from MongoDB. This is the correct write concern for the great majority of applications.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_stats.html b/libmongoc/1.24.0/mongoc_collection_stats.html new file mode 100644 index 0000000000000000000000000000000000000000..17abbb465f023c7e56fed52870bff319de500447 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_stats.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_collection_stats() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_stats()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.10.0: This helper function is deprecated and should not be used in new code. Use the $collStats aggregation pipeline stage with mongoc_collection_aggregate() instead.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_stats (mongoc_collection_t *collection,
    +                         const bson_t *options,
    +                         bson_t *reply,
    +                         bson_error_t *error) BSON_GNUC_DEPRECATED;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • options: An optional bson_t containing extra options to pass to the collStats command.

    • +
    • reply: An uninitialized bson_t to store the result.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    Run the collStats command to retrieve statistics about the collection.

    +

    The command uses the mongoc_read_prefs_t set on collection.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    reply is always initialized and must be freed with bson_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_t.html b/libmongoc/1.24.0/mongoc_collection_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a43ab8a0cc4cd52650906cbf7b95c5b1643b6c07 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_t.html @@ -0,0 +1,256 @@ + + + + + + + + + + + + + + mongoc_collection_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_collection_t mongoc_collection_t;
    +
    +
    +

    mongoc_collection_t provides access to a MongoDB collection. This handle is useful for actions for most CRUD operations, I.e. insert, update, delete, find, etc.

    +
    +
    +

    Read Preferences and Write Concerns

    +

    Read preferences and write concerns are inherited from the parent client. They can be overridden by set_* commands if so desired.

    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_update.html b/libmongoc/1.24.0/mongoc_collection_update.html new file mode 100644 index 0000000000000000000000000000000000000000..3c9d2fa4deed752f94b482c55f75a79d2b6a9cee --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_update.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_collection_update() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_update()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_update (mongoc_collection_t *collection,
    +                          mongoc_update_flags_t flags,
    +                          const bson_t *selector,
    +                          const bson_t *update,
    +                          const mongoc_write_concern_t *write_concern,
    +                          bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Superseded by mongoc_collection_update_one(), mongoc_collection_update_many(), and mongoc_collection_replace_one().

    +

    This function shall update documents in collection that match selector.

    +

    By default, updates only a single document. Set flags to MONGOC_UPDATE_MULTI_UPDATE to update multiple documents.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_update_many.html b/libmongoc/1.24.0/mongoc_collection_update_many.html new file mode 100644 index 0000000000000000000000000000000000000000..2a17ffd5ec2879b2ea357a9a0220c234e0ced21f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_update_many.html @@ -0,0 +1,243 @@ + + + + + + + + + + + + + + mongoc_collection_update_many() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_update_many()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_update_many (mongoc_collection_t *collection,
    +                               const bson_t *selector,
    +                               const bson_t *update,
    +                               const bson_t *opts,
    +                               bson_t *reply,
    +                               bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • selector: A bson_t containing the query to match documents for updating.

    • +
    • update: A bson_t containing the update to perform. If updating with a pipeline, a bson_t array.

    • +
    • reply: Optional. An uninitialized bson_t populated with the update result, or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function updates all documents in collection that match selector.

    +

    To update at most one document see mongoc_collection_update_one().

    +

    If you pass a non-NULL reply, it is filled out with fields matchedCount, modifiedCount, and optionally upsertedId if applicable. If there is a server error then reply contains either a “writeErrors” array with one subdocument or a “writeConcernErrors” array. The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +

    See also

    +
    +
    MongoDB update command documentation for more information on the update options.
    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_update_one.html b/libmongoc/1.24.0/mongoc_collection_update_one.html new file mode 100644 index 0000000000000000000000000000000000000000..6129f79b8142e18fbc8502ce41cfcc29031f905c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_update_one.html @@ -0,0 +1,323 @@ + + + + + + + + + + + + + + mongoc_collection_update_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_update_one()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_update_one (mongoc_collection_t *collection,
    +                              const bson_t *selector,
    +                              const bson_t *update,
    +                              const bson_t *opts,
    +                              bson_t *reply,
    +                              bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • selector: A bson_t containing the query to match the document for updating.

    • +
    • update: A bson_t containing the update to perform. If updating with a pipeline, a bson_t array.

    • +
    • reply: Optional. An uninitialized bson_t populated with the update result, or NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function updates at most one document in collection that matches selector.

    +

    To update multiple documents see mongoc_collection_update_many().

    +

    If you pass a non-NULL reply, it is filled out with fields matchedCount, modifiedCount, and optionally upsertedId if applicable. If there is a server error then reply contains either a “writeErrors” array with one subdocument or a “writeConcernErrors” array. The reply must be freed with bson_destroy().

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Example

    +
    +
    example-update.c
    +
    #include "mongoc/mongoc.h"
    +
    +int
    +main (void)
    +{
    +   bson_t *to_insert = BCON_NEW ("_id", BCON_INT32 (1));
    +   bson_t *selector = BCON_NEW ("_id", "{", "$gt", BCON_INT32 (0), "}");
    +   bson_t *update = BCON_NEW ("$set", "{", "x", BCON_INT32 (1), "}");
    +   const bson_t *next_doc;
    +   char *to_str;
    +   bson_error_t error = {0};
    +   mongoc_cursor_t *cursor;
    +   mongoc_client_t *client;
    +   mongoc_collection_t *coll;
    +   const char *uri_string = "mongodb://localhost:27017/?appname=example-update";
    +   mongoc_uri_t *uri = mongoc_uri_new_with_error (uri_string, &error);
    +
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   coll = mongoc_client_get_collection (client, "db", "example_coll");
    +
    +   mongoc_client_set_error_api (client, 2);
    +   /* insert a document */
    +   if (!mongoc_collection_insert_one (coll, to_insert, NULL, NULL, &error)) {
    +      fprintf (stderr, "insert failed: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   if (!mongoc_collection_update_one (
    +          coll, selector, update, NULL, NULL, &error)) {
    +      fprintf (stderr, "update failed: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   to_str = bson_as_relaxed_extended_json (to_insert, NULL);
    +   printf ("inserted: %s\n", to_str);
    +   bson_free (to_str);
    +
    +   cursor = mongoc_collection_find_with_opts (coll, selector, NULL, NULL);
    +   BSON_ASSERT (mongoc_cursor_next (cursor, &next_doc));
    +   printf ("after update, collection has the following document:\n");
    +
    +   to_str = bson_as_relaxed_extended_json (next_doc, NULL);
    +   printf ("%s\n", to_str);
    +   bson_free (to_str);
    +
    +   BSON_ASSERT (mongoc_collection_drop (coll, NULL));
    +
    +   bson_destroy (to_insert);
    +   bson_destroy (update);
    +   bson_destroy (selector);
    +   mongoc_collection_destroy (coll);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +

    See also

    +
    +
    MongoDB update command documentation for more information on the update options.
    +
    + + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_validate.html b/libmongoc/1.24.0/mongoc_collection_validate.html new file mode 100644 index 0000000000000000000000000000000000000000..5c41a4cd6b04de303a57fdb226bc3b5dfb42e321 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_validate.html @@ -0,0 +1,224 @@ + + + + + + + + + + + + + + mongoc_collection_validate() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_validate()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.10.0: This helper function is deprecated and should not be used in new code. Run the validate command directly with mongoc_client_read_command_with_opts() instead.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_validate (mongoc_collection_t *collection,
    +                            const bson_t *options,
    +                            bson_t *reply,
    +                            bson_error_t *error) BSON_GNUC_DEPRECATED;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function is a helper function to execute the validate MongoDB command.

    +

    Currently, the only supported options are full, which is a boolean and scandata, also a boolean.

    +

    See the MongoDB documentation for more information on this command.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    reply is always initialized if it’s not NULL and must be destroyed with bson_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_watch.html b/libmongoc/1.24.0/mongoc_collection_watch.html new file mode 100644 index 0000000000000000000000000000000000000000..adc3fe10da4ccafc16886153afc9c17d70194a7d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_watch.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_collection_watch() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_watch()

    +
    +

    Synopsis

    +
    mongoc_change_stream_t*
    +mongoc_collection_watch (const mongoc_collection_t *coll,
    +                         const bson_t *pipeline,
    +                         const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    A helper function to create a change stream. It is preferred to call this +function over using a raw aggregation to create a change stream.

    +

    This function uses the read preference and read concern of the collection. If +the change stream needs to re-establish connection, the same read preference +will be used. This may happen if the change stream encounters a resumable error.

    +
    +

    Warning

    +

    A change stream is only supported with majority read concern.

    +
    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    +
      +
    • coll: A mongoc_collection_t specifying the collection which the change stream listens to.

    • +
    • pipeline: A bson_t representing an aggregation pipeline appended to the change stream. This may be an empty document.

    • +
    • opts: A bson_t containing change stream options.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • batchSize: An int32 representing number of documents requested to be returned on each call to mongoc_change_stream_next()

    • +
    • resumeAfter: A Document representing the logical starting point of the change stream. The result of mongoc_change_stream_get_resume_token() or the _id field of any change received from a change stream can be used here. This option is mutually exclusive with startAfter and startAtOperationTime.

    • +
    • startAfter: A Document representing the logical starting point of the change stream. Unlike resumeAfter, this can resume notifications after an “invalidate” event. The result of mongoc_change_stream_get_resume_token() or the _id field of any change received from a change stream can be used here. This option is mutually exclusive with resumeAfter and startAtOperationTime.

    • +
    • startAtOperationTime: A Timestamp. The change stream only provides changes that occurred at or after the specified timestamp. Any command run against the server will return an operation time that can be used here. This option is mutually exclusive with resumeAfter and startAfter.

    • +
    • maxAwaitTimeMS: An int64 representing the maximum amount of time a call to mongoc_change_stream_next() will block waiting for data

    • +
    • fullDocument: An optional UTF-8 string. Set this option to “default”, “updateLookup”, “whenAvailable”, or “required”, If unset, The string “default” is assumed. Set this option to “updateLookup” to direct the change stream cursor to lookup the most current majority-committed version of the document associated to an update change stream event.

    • +
    • fullDocumentBeforeChange: An optional UTF-8 string. Set this option to “whenAvailable”, “required”, or “off”. When unset, the default value is “off”. Similar to “fullDocument”, but returns the value of the document before the associated change.

    • +
    • showExpandedEvents: Set to true to return an expanded list of change stream events. Avaiable only on MongoDB versions >=6.0

    • +
    • comment: A bson_value_t specifying the comment to attach to this command. The comment will appear in log messages, profiler output, and currentOp output. Only string values are supported prior to MongoDB 4.4.

    • +
    +
    +
    +

    Returns

    +

    A newly allocated mongoc_change_stream_t which must be freed with +mongoc_change_stream_destroy() when no longer in use. The returned +mongoc_change_stream_t is never NULL. If there is an error, it can +be retrieved with mongoc_change_stream_error_document(), and subsequent +calls to mongoc_change_stream_next() will return false.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_collection_write_command_with_opts.html b/libmongoc/1.24.0/mongoc_collection_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..7ec053091bd755dfd167f823ac8cdaf65a3df801 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_collection_write_command_with_opts.html @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + mongoc_collection_write_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_collection_write_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_collection_write_command_with_opts (mongoc_collection_t *collection,
    +                                           const bson_t *command,
    +                                           const bson_t *opts,
    +                                           bson_t *reply,
    +                                           bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic that is specific to commands that write, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_collection_command_simple().

    +

    Use this function for commands that write such as “drop” or “createRole” (but not for “insert”, “update”, or “delete”, see Basic Write Operations). Write concern and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts. The highest-priority sources for these options are listed first in the following table. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + +

    Write Concern

    Collation

    opts

    opts

    Transaction

    collection

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +
    +
    +

    Parameters

    +
      +
    • collection: A mongoc_collection_t.

    • +
    • command: A bson_t containing the command specification.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Basic Write Operations

    +

    Do not use this function to call the basic write commands “insert”, “update”, and “delete”. Those commands require special logic not implemented in mongoc_collection_write_command_with_opts. For basic write operations use CRUD functions such as mongoc_collection_insert_one() and the others described in the CRUD tutorial, or use the Bulk API.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_clone.html b/libmongoc/1.24.0/mongoc_cursor_clone.html new file mode 100644 index 0000000000000000000000000000000000000000..18fd3bcb4253bff072d45eb6bea74c46a599907b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_clone.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_cursor_clone() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_clone()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_cursor_clone (const mongoc_cursor_t *cursor)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall create a copy of a mongoc_cursor_t. The cloned cursor will be reset to the beginning of the query, and therefore the query will be re-executed on the MongoDB server when mongoc_cursor_next() is called.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_current.html b/libmongoc/1.24.0/mongoc_cursor_current.html new file mode 100644 index 0000000000000000000000000000000000000000..6835cec686484c0d475a9ac1dc5bf4672e7ec1d5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_current.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_cursor_current() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_current()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_cursor_current (const mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the cursors current document or NULL if there has been an error.

    +
    +
    +

    Returns

    +

    A bson_t that should not be modified or freed or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_destroy.html b/libmongoc/1.24.0/mongoc_cursor_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..b56f991c27ae609539f441853f59a0fe6eb629f6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_cursor_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_cursor_destroy (mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees a mongoc_cursor_t and releases all associated resources. If a server-side cursor has been allocated, it will be released as well. Does nothing if cursor is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_error.html b/libmongoc/1.24.0/mongoc_cursor_error.html new file mode 100644 index 0000000000000000000000000000000000000000..582baf1843b78f89de287b063c6908a667a6f33d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_error.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_cursor_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_error()

    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_error (mongoc_cursor_t *cursor, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function checks to see if an error has occurred while iterating the cursor.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    false if no error has occurred, otherwise true and error is set.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_error_document.html b/libmongoc/1.24.0/mongoc_cursor_error_document.html new file mode 100644 index 0000000000000000000000000000000000000000..c94e18679325159e9314d74b4b6653f5e8e9e37a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_error_document.html @@ -0,0 +1,313 @@ + + + + + + + + + + + + + + mongoc_cursor_error_document() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_error_document()

    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_error_document (mongoc_cursor_t *cursor,
    +                              bson_error_t *error,
    +                              const bson_t **reply);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function checks to see if an error has occurred while iterating the cursor.

    +

    If an error occurred client-side, for example if there was a network error or timeout, or the cursor was created with invalid parameters, then reply is set to an empty BSON document. If an error occurred server-side, reply is set to the server’s reply document with information about the error.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error and reply parameters.

    +
    +
    +

    Returns

    +

    False if no error has occurred, otherwise true and error is set.

    +

    If the function returns true and reply is not NULL, then reply is set to a pointer to a BSON document, which is either empty or the server’s error response. The document is invalid after the cursor is freed with mongoc_cursor_destroy().

    +
    +
    +

    Example

    +

    This example shows the difference between a client-side and server-side error. If the client cannot connect to the server, for example, the error message includes “No suitable servers found” and reply is set to an empty BSON document.

    +

    On the other hand, if the client connects to the server successfully and attempts to execute an invalid query, the error message comes from the server and reply is set to the server’s reply document, with fields errmsg and code.

    +
    void
    +run_query (const char *uri_str, const bson_t *query)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   mongoc_cursor_t *cursor;
    +   const bson_t *doc;
    +   bson_error_t error;
    +   const bson_t *reply;
    +   char *str;
    +
    +   client = mongoc_client_new (uri_str);
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   collection = mongoc_client_get_collection (client, "db", "collection");
    +   cursor = mongoc_collection_find_with_opts (
    +      collection,
    +      query,
    +      NULL,  /* additional options */
    +      NULL); /* read prefs, NULL for default */
    +
    +   /* this loop is never run: mongoc_cursor_next immediately returns false */
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +   }
    +
    +   if (mongoc_cursor_error_document (cursor, &error, &reply)) {
    +      str = bson_as_json (reply, NULL);
    +      fprintf (stderr, "Cursor Failure: %s\nReply: %s\n", error.message, str);
    +      bson_free (str);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +}
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   bson_t *good_query;
    +   bson_t *bad_query;
    +
    +   mongoc_init ();
    +
    +   /* find documents matching the query {"x": 1} */
    +   good_query = BCON_NEW ("x", BCON_INT64 (1));
    +
    +   /* Cause a network error. This will print an error and empty reply document:
    +    *
    +    * Cursor Failure: No suitable servers found (`serverSelectionTryOnce` set):
    +    *     [Failed to resolve 'fake-domain']
    +    *
    +    * Reply: { }
    +    *
    +    */
    +   run_query ("mongodb://fake-domain/?appname=cursor-example", good_query);
    +
    +   /* invalid: {"x": {"$badOperator": 1}} */
    +   bad_query = BCON_NEW ("x", "{", "$badOperator", BCON_INT64 (1), "}");
    +
    +   /* Cause a server error. This will print an error and server reply document:
    +    *
    +    * Cursor Failure: unknown operator: $badOperator
    +    *
    +    * Reply:
    +    * {"ok": 0.0,
    +    *  "errmsg":"unknown operator: $badOperator",
    +    *  "code": 2,
    +    *  "codeName":"BadValue"
    +    * }
    +    *
    +    */
    +   run_query ("mongodb://localhost/?appname=cursor-example", bad_query);
    +
    +   bson_destroy (good_query);
    +   bson_destroy (bad_query);
    +
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_get_batch_size.html b/libmongoc/1.24.0/mongoc_cursor_get_batch_size.html new file mode 100644 index 0000000000000000000000000000000000000000..7cf6e07948e0b518683beb6d039d1c744547d7af --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_get_batch_size.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_cursor_get_batch_size() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_get_batch_size()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_cursor_get_batch_size (const mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieve the cursor’s batch size, the maximum number of documents returned per round trip to the server. A batch size of zero means the cursor accepts the server’s maximum batch size.

    +

    See Cursor Batches in the MongoDB Manual.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_get_hint.html b/libmongoc/1.24.0/mongoc_cursor_get_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..eb47e82696a69b83aeb6708e4bba43585668e561 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_get_hint.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_cursor_get_hint() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_get_hint()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_cursor_get_hint (const mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieves the opaque id of the server used for the operation.

    +

    (The function name includes the old term “hint” for the sake of backward compatibility, but we now call this number a “server id”.)

    +

    This number is zero until the driver actually uses a server when executing the find operation or mongoc_cursor_set_hint() is called.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_get_host.html b/libmongoc/1.24.0/mongoc_cursor_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..5c6467c4d0bc566cc234118692ff8c6efb72a847 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_get_host.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_cursor_get_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_get_host()

    +
    +

    Synopsis

    +
    void
    +mongoc_cursor_get_host (mongoc_cursor_t *cursor, mongoc_host_list_t *host);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the MongoDB host that the cursor is communicating with in the host out parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_get_id.html b/libmongoc/1.24.0/mongoc_cursor_get_id.html new file mode 100644 index 0000000000000000000000000000000000000000..4d158df07cdae001bdafae7454dc67791512e495 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_get_id.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_cursor_get_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_get_id()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_cursor_get_id (const mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieves the cursor id used by the server to track the cursor.

    +

    This number is zero until the driver actually uses a server when executing the query, and after it has fetched all results from the server.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_get_limit.html b/libmongoc/1.24.0/mongoc_cursor_get_limit.html new file mode 100644 index 0000000000000000000000000000000000000000..71becdba73ac7c897b5a481aef74414a4ff3eb43 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_get_limit.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_cursor_get_limit() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_get_limit()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_cursor_get_limit (mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Return the value set with mongoc_cursor_set_limit() or mongoc_collection_find().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_get_max_await_time_ms.html b/libmongoc/1.24.0/mongoc_cursor_get_max_await_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..7c1a4188fdd094c2a3ff504555a8adfba60ad803 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_get_max_await_time_ms.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_cursor_get_max_await_time_ms() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_get_max_await_time_ms()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_cursor_get_max_await_time_ms (mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieve the value set with mongoc_cursor_set_max_await_time_ms().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_is_alive.html b/libmongoc/1.24.0/mongoc_cursor_is_alive.html new file mode 100644 index 0000000000000000000000000000000000000000..3b6fc144a121928105be9d696237c2ca13b9dfb3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_is_alive.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_cursor_is_alive() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_is_alive()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.10.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_cursor_more() in new code.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_is_alive (const mongoc_cursor_t *cursor)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_cursor_more);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    See mongoc_cursor_more().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_more.html b/libmongoc/1.24.0/mongoc_cursor_more.html new file mode 100644 index 0000000000000000000000000000000000000000..3d2cdd88cbd38f85074232f1f931f0563b19ea4a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_more.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_cursor_more() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_more()

    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_more (mongoc_cursor_t *cursor);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall indicate if there is potentially more data to be read from the cursor. This is only useful with tailable cursors. Use mongoc_cursor_next() for regular cursors.

    +

    Details: mongoc_cursor_more is unreliable because it does not contact the server to see if there are actually more documents in the result set. It simply returns true if the cursor has not begun, or if it has begun and there are buffered documents in the client-side cursor, or if it has begun and the server has not yet told the cursor it is completely iterated.

    +

    This is unreliable with regular queries because it returns true for a new cursor before iteration, even if the cursor will match no documents. It is also true if the collection has been dropped on the server since the previous fetch, or if the cursor has finished its final batch and the next batch will be empty.

    +
    +
    +

    Returns

    +

    true if the cursor has locally-buffered documents, or if a round-trip to the server might fetch additional documents.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_new_from_command_reply.html b/libmongoc/1.24.0/mongoc_cursor_new_from_command_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..c977183a2de67c327eed768c779c90d08244c4a1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_new_from_command_reply.html @@ -0,0 +1,236 @@ + + + + + + + + + + + + + + mongoc_cursor_new_from_command_reply() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_new_from_command_reply()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.11.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_cursor_new_from_command_reply_with_opts() in new code.

    +

    When migrating from the deprecated mongoc_cursor_new_from_command_reply() to mongoc_cursor_new_from_command_reply_with_opts(), +note that options previously passed to the reply argument (e.g. “batchSize”) must instead be provided in the opts argument.

    +
    +
    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_cursor_new_from_command_reply (mongoc_client_t *client,
    +                                      bson_t *reply,
    +                                      uint32_t server_id);
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_cursor_new_from_command_reply_with_opts);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • reply: The reply to a command, such as “aggregate”, “find”, or “listCollections”, that returns a cursor document. The reply is destroyed by mongoc_cursor_new_from_command_reply and must not be accessed afterward.

    • +
    • server_id: The opaque id of the server used to execute the command.

    • +
    +
    +
    +

    Description

    +

    Some MongoDB commands return a “cursor” document. For example, given an “aggregate” command:

    +
    { "aggregate" : "collection", "pipeline" : [], "cursor" : {}}
    +
    +
    +

    The server replies:

    +
    {
    +   "cursor" : {
    +      "id" : 1234,
    +      "ns" : "db.collection",
    +      "firstBatch" : [ ]
    +   },
    +   "ok" : 1
    +}
    +
    +
    +

    mongoc_cursor_new_from_command_reply is a low-level function that initializes a mongoc_cursor_t from such a reply. Additional options such as “tailable” or “awaitData” can be included in the reply.

    +

    When synthesizing a completed cursor response that has no more batches (i.e. with cursor id 0), set server_id to 0 as well.

    +

    Use this function only for building a language driver that wraps the C Driver. When writing applications in C, higher-level functions such as mongoc_collection_aggregate() are more appropriate, and ensure compatibility with a range of MongoDB versions.

    +
    +
    +

    Returns

    +

    A mongoc_cursor_t. On failure, the cursor’s error is set. Check for failure with mongoc_cursor_error().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_new_from_command_reply_with_opts.html b/libmongoc/1.24.0/mongoc_cursor_new_from_command_reply_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..b26de09cae4e883864aed3421d2c7cfcca686be9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_new_from_command_reply_with_opts.html @@ -0,0 +1,236 @@ + + + + + + + + + + + + + + mongoc_cursor_new_from_command_reply_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_new_from_command_reply_with_opts()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_cursor_new_from_command_reply_with_opts (mongoc_client_t *client,
    +                                                bson_t *reply,
    +                                                const bson_t *opts);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • client: A mongoc_client_t.

    • +
    • reply: The reply to a command, such as “aggregate”, “find”, or “listCollections”, that returns a cursor document. The reply is destroyed by mongoc_cursor_new_from_command_reply_with_opts and must not be accessed afterward.

    • +
    • opts: A bson_t.

    • +
    +

    opts may be NULL or a BSON document with additional options, which have the same meaning for this function as for mongoc_collection_find_with_opts():

    +
      +
    • awaitData

    • +
    • batchSize

    • +
    • limit

    • +
    • maxAwaitTimeMS

    • +
    • serverId

    • +
    • sessionId

    • +
    • skip

    • +
    • tailable

    • +
    +
    +
    +

    Description

    +

    Some MongoDB commands return a “cursor” document. For example, given an “aggregate” command:

    +
    { "aggregate" : "collection", "pipeline" : [], "cursor" : {}}
    +
    +
    +

    The server replies:

    +
    {
    +   "cursor" : {
    +      "id" : 1234,
    +      "ns" : "db.collection",
    +      "firstBatch" : [ ]
    +   },
    +   "ok" : 1
    +}
    +
    +
    +

    mongoc_cursor_new_from_command_reply_with_opts is a low-level function that initializes a mongoc_cursor_t from such a reply.

    +

    Use this function only for building a language driver that wraps the C Driver. When writing applications in C, higher-level functions such as mongoc_collection_aggregate() are more appropriate, and ensure compatibility with a range of MongoDB versions.

    +
    +
    +

    Returns

    +

    A mongoc_cursor_t. On failure, the cursor’s error is set. Check for failure with mongoc_cursor_error().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_next.html b/libmongoc/1.24.0/mongoc_cursor_next.html new file mode 100644 index 0000000000000000000000000000000000000000..78788909f819dbf83cb56ce4c9a57aa056364255 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_next.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_cursor_next() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_next()

    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_next (mongoc_cursor_t *cursor, const bson_t **bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall iterate the underlying cursor, setting bson to the next document.

    +

    This function is a blocking function.

    +
    +
    +

    Returns

    +

    This function returns true if a valid bson document was read from the cursor. Otherwise, false if there was an error or the cursor was exhausted.

    +

    Errors can be determined with the mongoc_cursor_error() function.

    +
    +
    +

    Lifecycle

    +

    The bson objects set in this function are ephemeral and good until the next call. This means that you must copy the returned bson if you wish to retain it beyond the lifetime of a single call to mongoc_cursor_next().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_set_batch_size.html b/libmongoc/1.24.0/mongoc_cursor_set_batch_size.html new file mode 100644 index 0000000000000000000000000000000000000000..74606376b42fbe463bf8aeeba055781ef388e770 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_set_batch_size.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_cursor_set_batch_size() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_set_batch_size()

    +
    +

    Synopsis

    +
    void
    +mongoc_cursor_set_batch_size (mongoc_cursor_t *cursor, uint32_t batch_size);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • cursor: A mongoc_cursor_t.

    • +
    • batch_size: The requested number of documents per batch.

    • +
    +
    +
    +

    Description

    +

    Limits the number of documents returned in one batch. Each batch requires a round trip to the server. If the batch size is zero, the cursor uses the server-defined maximum batch size.

    +

    See Cursor Batches in the MongoDB Manual.

    +

    This is not applicable to all cursors. Calling mongoc_cursor_set_batch_size() on a cursor returned by mongoc_client_find_databases_with_opts(), mongoc_database_find_collections_with_opts(), or mongoc_collection_find_indexes_with_opts() will not change the results.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_set_hint.html b/libmongoc/1.24.0/mongoc_cursor_set_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..54d5353e4b542814802f5bcbeff50b7fb4699b67 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_set_hint.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_cursor_set_hint() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_set_hint()

    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_set_hint (mongoc_cursor_t *cursor, uint32_t server_id);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • cursor: A mongoc_cursor_t.

    • +
    • server_id: An opaque id identifying the server to use.

    • +
    +
    +
    +

    Description

    +

    Specifies which server to use for the operation. This function has an effect only if called before the find operation is executed.

    +

    (The function name includes the old term “hint” for the sake of backward compatibility, but we now call this number a “server id”.)

    +

    Use mongoc_cursor_set_hint only for building a language driver that wraps the C Driver. When writing applications in C, leave the server id unset and allow the driver to choose a suitable server from the find operation’s read preference.

    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_set_limit.html b/libmongoc/1.24.0/mongoc_cursor_set_limit.html new file mode 100644 index 0000000000000000000000000000000000000000..31db762c32adb0d880001cf25d013c0f14e54a40 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_set_limit.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_cursor_set_limit() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_set_limit()

    +
    +

    Synopsis

    +
    bool
    +mongoc_cursor_set_limit (mongoc_cursor_t *cursor, int64_t limit);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • cursor: A mongoc_cursor_t.

    • +
    • limit: The maximum number of documents to retrieve for this query.

    • +
    +
    +
    +

    Description

    +

    Limits the number of documents in the result set.

    +

    This function is useful for setting the limit on a cursor after the cursor is created, but before any calls to mongoc_cursor_next(). It can also be used to pass a negative limit: The limit parameter to mongoc_cursor_set_limit is signed, although for backward-compatibility reasons the limit parameter to mongoc_collection_find() is not.

    +

    Calling this function after mongoc_cursor_next() has no effect.

    +

    This is not applicable to all cursors. Calling mongoc_cursor_set_limit() on a cursor returned by mongoc_client_find_databases_with_opts(), mongoc_database_find_collections_with_opts(), or mongoc_collection_find_indexes_with_opts() will not change the results.

    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and leaves the limit unchanged.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_set_max_await_time_ms.html b/libmongoc/1.24.0/mongoc_cursor_set_max_await_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..285198540d641682afc10346f319668634f98ce5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_set_max_await_time_ms.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_cursor_set_max_await_time_ms() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_set_max_await_time_ms()

    +
    +

    Synopsis

    +
    void
    +mongoc_cursor_set_max_await_time_ms (mongoc_cursor_t *cursor,
    +                                     uint32_t max_await_time_ms);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • cursor: A mongoc_cursor_t.

    • +
    • max_await_time_ms: A timeout in milliseconds.

    • +
    +
    +
    +

    Description

    +

    The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query. Only applies if the cursor is created from mongoc_collection_find_with_opts() with “tailable” and “awaitData” options, and the server is MongoDB 3.2 or later. See the documentation for maxTimeMS and the “getMore” command.

    +

    The max_await_time_ms cannot be changed after the first call to mongoc_cursor_next().

    +

    This is not applicable to all cursors. Calling mongoc_cursor_set_batch_size() on a cursor returned by mongoc_client_find_databases_with_opts(), mongoc_database_find_collections_with_opts(), or mongoc_collection_find_indexes_with_opts() will not change the results.

    +

    Note: although max_await_time_ms is a uint32_t, it is possible to set it as a uint64_t through the options arguments in some cursor returning functions like mongoc_collection_find_with_opts().

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_cursor_t.html b/libmongoc/1.24.0/mongoc_cursor_t.html new file mode 100644 index 0000000000000000000000000000000000000000..5eceee76ffff68327fd336931f09e82f051dfe15 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_cursor_t.html @@ -0,0 +1,316 @@ + + + + + + + + + + + + + + mongoc_cursor_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_cursor_t

    +

    Client-side cursor abstraction

    +
    +

    Synopsis

    +
    typedef struct _mongoc_cursor_t mongoc_cursor_t;
    +
    +
    +

    mongoc_cursor_t provides access to a MongoDB query cursor. +It wraps up the wire protocol negotiation required to initiate a query and retrieve an unknown number of documents.

    +

    Common cursor operations include:

    + +

    Cursors are lazy, meaning that no connection is established and no network traffic occurs until the first call to mongoc_cursor_next().

    +
    +
    +

    Thread Safety

    +

    mongoc_cursor_t is NOT thread safe. It may only be used from within the thread in which it was created.

    +
    +
    +

    Example

    +
    +
    Query MongoDB and iterate results
    +
    /* gcc example-client.c -o example-client $(pkg-config --cflags --libs
    + * libmongoc-1.0) */
    +
    +/* ./example-client [CONNECTION_STRING [COLLECTION_NAME]] */
    +
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   mongoc_cursor_t *cursor;
    +   bson_error_t error;
    +   const bson_t *doc;
    +   const char *collection_name = "test";
    +   bson_t query;
    +   char *str;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=client-example";
    +   mongoc_uri_t *uri;
    +
    +   mongoc_init ();
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   if (argc > 2) {
    +      collection_name = argv[2];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +
    +   bson_init (&query);
    +   collection = mongoc_client_get_collection (client, "test", collection_name);
    +   cursor = mongoc_collection_find_with_opts (
    +      collection,
    +      &query,
    +      NULL,  /* additional options */
    +      NULL); /* read prefs, NULL for default */
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      fprintf (stdout, "%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "Cursor Failure: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   bson_destroy (&query);
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_collection_destroy (collection);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_add_user.html b/libmongoc/1.24.0/mongoc_database_add_user.html new file mode 100644 index 0000000000000000000000000000000000000000..ea2149e1fc7228496fdd2714e16a7b97a4652cdd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_add_user.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_database_add_user() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_add_user()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_add_user (mongoc_database_t *database,
    +                          const char *username,
    +                          const char *password,
    +                          const bson_t *roles,
    +                          const bson_t *custom_data,
    +                          bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • username: The name of the user.

    • +
    • password: The cleartext password for the user.

    • +
    • roles: An optional bson_t for roles.

    • +
    • custom_data: A optional bson_t for extra data.

    • +
    • error: A location for a bson_error_t or NULL.

    • +
    +

    This function shall create a new user with access to database.

    +
    +

    Warning

    +

    Do not call this function without TLS.

    +
    +
    +
    +

    Errors

    +

    Errors are returned through the error parameter and can include socket or other server side failures.

    +
    +
    +

    Returns

    +

    Returns true if the user was successfully added. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_aggregate.html b/libmongoc/1.24.0/mongoc_database_aggregate.html new file mode 100644 index 0000000000000000000000000000000000000000..aea7230b4fdf91b808488e3f8a3350326d609d8b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_aggregate.html @@ -0,0 +1,297 @@ + + + + + + + + + + + + + + mongoc_database_aggregate() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_aggregate()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_database_aggregate (mongoc_database_t *database,
    +                           const bson_t *pipeline,
    +                           const bson_t *opts,
    +                           const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • pipeline: A bson_t, either a BSON array or a BSON document containing an array field named “pipeline”.

    • +
    • opts: A bson_t containing options for the command, or NULL.

    • +
    • read_prefs: A mongoc_read_prefs_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the aggregate command.

    +
    +
    +

    Description

    +

    This function creates a cursor which sends the aggregate command on the underlying database upon the first call to mongoc_cursor_next(). For more information on building aggregation pipelines, see the MongoDB Manual entry on the aggregate command. Note that the pipeline must start with a compatible stage that does not require an underlying collection (e.g. “$currentOp”, “$listLocalSessions”).

    +

    Read preferences, read and write concern, and collation can be overridden by various sources. The highest-priority sources for these options are listed first in the following table. In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. Write concern is applied from opts, or if opts has no write concern and the aggregation pipeline includes “$out”, the write concern is applied from database.

    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Write Concern

    Collation

    read_prefs

    opts

    opts

    opts

    Transaction

    Transaction

    Transaction

    database

    database

    database

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    This function is considered a retryable read operation unless the pipeline contains a write stage like $out or $merge. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    +

    Example

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +
    +static mongoc_cursor_t *
    +current_op_query (mongoc_client_t *client)
    +{
    +   mongoc_cursor_t *cursor;
    +   mongoc_database_t *database;
    +   bson_t *pipeline;
    +
    +   pipeline = BCON_NEW ("pipeline",
    +                        "[",
    +                        "{",
    +                        "$currentOp",
    +                        "{",
    +                        "}",
    +                        "}",
    +                        "]");
    +
    +   /* $currentOp must be run on the admin database */
    +   database = mongoc_client_get_database (client, "admin");
    +
    +   cursor = mongoc_database_aggregate (
    +      database, pipeline, NULL, NULL);
    +
    +   bson_destroy (pipeline);
    +   mongoc_database_destroy (database);
    +
    +   return cursor;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_command.html b/libmongoc/1.24.0/mongoc_database_command.html new file mode 100644 index 0000000000000000000000000000000000000000..1b8126ca15f2af835632f4ee1b5953e7d16d4c3f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_command.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_database_command() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_command()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_database_command (mongoc_database_t *database,
    +                         mongoc_query_flags_t flags,
    +                         uint32_t skip,
    +                         uint32_t limit,
    +                         uint32_t batch_size,
    +                         const bson_t *command,
    +                         const bson_t *fields,
    +                         const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    This function is superseded by mongoc_database_command_with_opts(), mongoc_database_read_command_with_opts(), mongoc_database_write_command_with_opts(), and mongoc_database_read_write_command_with_opts().

    +
    +
    +

    Description

    +

    This function creates a cursor which will execute the command when mongoc_cursor_next() is called on it. The database’s read preference, read concern, and write concern are not applied to the command, and mongoc_cursor_next() will not check the server response for a write concern error or write concern timeout.

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • flags: A mongoc_query_flags_t.

    • +
    • skip: The number of documents to skip on the server.

    • +
    • limit: The maximum number of documents to return from the cursor.

    • +
    • batch_size: Attempt to batch results from the server in groups of batch_size documents.

    • +
    • command: A bson_t containing the command.

    • +
    • fields: An optional bson_t containing the fields to return. NULL for all fields.

    • +
    • read_prefs: An optional mongoc_read_prefs_t. Otherwise, the command uses mode MONGOC_READ_PRIMARY.

    • +
    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_command_simple.html b/libmongoc/1.24.0/mongoc_database_command_simple.html new file mode 100644 index 0000000000000000000000000000000000000000..7d49aa4c2e3e436ed63199fba8b9213b06feef3d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_command_simple.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_database_command_simple() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_command_simple()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_command_simple (mongoc_database_t *database,
    +                                const bson_t *command,
    +                                const mongoc_read_prefs_t *read_prefs,
    +                                bson_t *reply,
    +                                bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • command: A bson_t containing the command.

    • +
    • read_prefs: An optional mongoc_read_prefs_t. Otherwise, the command uses mode MONGOC_READ_PRIMARY.

    • +
    • reply: A location to store the commands first result document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    This is a simplified interface to mongoc_database_command() that returns the first result document. The database’s read preference, read concern, and write concern are not applied to the command. The parameter reply is initialized even upon failure to simplify memory management.

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Errors

    +

    Errors are propagated through the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    This function does not check the server response for a write concern error or write concern timeout.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_command_with_opts.html b/libmongoc/1.24.0/mongoc_database_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..c1a3b7baa5d3335e78fb39bf92a620e4ac259356 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_command_with_opts.html @@ -0,0 +1,257 @@ + + + + + + + + + + + + + + mongoc_database_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_command_with_opts (
    +   mongoc_database_t *database,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs,
    +   const bson_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Execute a command on the server, interpreting opts according to the MongoDB server version. To send a raw command to the server without any of this logic, use mongoc_client_command_simple().

    +

    Read preferences, read and write concern, and collation can be overridden by various sources. The highest-priority sources for these options are listed first:

    + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Write Concern

    Collation

    read_prefs

    opts

    opts

    opts

    Transaction

    Transaction

    Transaction

    +

    In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. +See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    This function is not considered a retryable read operation.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    The reply is not parsed for a write concern timeout or write concern error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_copy.html b/libmongoc/1.24.0/mongoc_database_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..bab9b1a7d29c8a0ea6085942c6bfc6fd86aa89a7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_copy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_database_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_copy()

    +
    +

    Synopsis

    +
    mongoc_database_t *
    +mongoc_database_copy (mongoc_database_t *database) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a deep copy of the database struct and its configuration. Useful if you intend to call mongoc_database_set_write_concern(), mongoc_database_set_read_prefs(), or mongoc_database_set_read_concern(), and want to preserve an unaltered copy of the struct.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_database_t that should be freed with mongoc_database_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_create_collection.html b/libmongoc/1.24.0/mongoc_database_create_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..7c4e8666655cc33a6cf9483c61f555c6fa0a7f0b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_create_collection.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_database_create_collection() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_create_collection()

    +
    +

    Synopsis

    +
    mongoc_collection_t *
    +mongoc_database_create_collection (mongoc_database_t *database,
    +                                   const char *name,
    +                                   const bson_t *opts,
    +                                   bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • name: The name of the new collection.

    • +
    • opts: An optional bson_t for opts to the create command.

    • +
    • error: A location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    This function creates a mongoc_collection_t from the given mongoc_database_t.

    +

    If no write concern is provided in opts, the database’s write concern is used.

    +

    The encryptedFields document in opts may be used to create a collection used for Queryable Encryption.

    +

    For a list of all options, see the MongoDB Manual entry on the create command.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_collection_t upon success, NULL upon failure and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_destroy.html b/libmongoc/1.24.0/mongoc_database_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..f3087c9a1f027e5e34cc166030672f316a10362f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_database_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_database_destroy (mongoc_database_t *database);
    +
    +
    +

    Releases all resources associated with database, including freeing the structure. Does nothing if database is NULL.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_drop.html b/libmongoc/1.24.0/mongoc_database_drop.html new file mode 100644 index 0000000000000000000000000000000000000000..d8e8c67f24f3e3f4e0c09c81d9df646608342b83 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_drop.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_drop() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_drop()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_drop (mongoc_database_t *database, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    For more information, see mongoc_database_drop_with_opts(). This function is a thin wrapper, passing NULL in as bson_t parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_drop_with_opts.html b/libmongoc/1.24.0/mongoc_database_drop_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a470a4c8b6cfc862a47541c05ebcf0ed0c3700cd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_drop_with_opts.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_database_drop_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_drop_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_drop_with_opts (mongoc_database_t *database,
    +                                const bson_t *opts,
    +                                bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    This function attempts to drop a database on the MongoDB server.

    +

    If no write concern is provided in opts, the database’s write concern is used.

    +

    The encryptedFields document in opts may be used to drop a collection used for Queryable Encryption.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_find_collections.html b/libmongoc/1.24.0/mongoc_database_find_collections.html new file mode 100644 index 0000000000000000000000000000000000000000..2275eb28bffd4b37169797c22edd6b47337bb349 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_find_collections.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_database_find_collections() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_find_collections()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_database_find_collections_with_opts() in new code.

    +
    +
    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_database_find_collections (mongoc_database_t *database,
    +                                  const bson_t *filter,
    +                                  bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_database_find_collections_with_opts);
    +
    +
    +
    +
    +

    Description

    +

    Fetches a cursor containing documents, each corresponding to a collection on this database.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • filter: A matcher used by the server to filter the returned collections. May be NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use, or NULL in case of error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    In the returned cursor each result corresponds to the server’s representation of a collection in this database.

    +

    The cursor functions mongoc_cursor_set_limit(), mongoc_cursor_set_batch_size(), and mongoc_cursor_set_max_await_time_ms() have no use on the returned cursor.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_find_collections_with_opts.html b/libmongoc/1.24.0/mongoc_database_find_collections_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..2641b672fd644871c591935dba6241a52958bffc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_find_collections_with_opts.html @@ -0,0 +1,263 @@ + + + + + + + + + + + + + + mongoc_database_find_collections_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_find_collections_with_opts()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_database_find_collections_with_opts (mongoc_database_t *database,
    +                                            const bson_t *opts)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Fetches a cursor containing documents, each corresponding to a collection on this database.

    +

    To get collection names only, use mongoc_database_get_collection_names_with_opts().

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the listCollections command.

    +
    +
    +

    Errors

    +

    Use mongoc_cursor_error() on the returned cursor to check for errors.

    +
    +
    +

    Returns

    +

    This function returns a newly allocated mongoc_cursor_t that should be freed with mongoc_cursor_destroy() when no longer in use. The returned mongoc_cursor_t is never NULL, even on error. The user must call mongoc_cursor_next() on the returned mongoc_cursor_t to execute the initial command.

    +

    Cursor errors can be checked with mongoc_cursor_error_document(). It always fills out the bson_error_t if an error occurred, and optionally includes a server reply document if the error occurred server-side.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +

    In the returned cursor each result corresponds to the server’s representation of a collection in this database.

    +

    The cursor functions mongoc_cursor_set_limit(), mongoc_cursor_set_batch_size(), and mongoc_cursor_set_max_await_time_ms() have no use on the returned cursor.

    +
    +
    +

    Examples

    +
    {
    +   bson_t opts = BSON_INITIALIZER;
    +   bson_t name_filter;
    +   const bson_t *doc;
    +   bson_iter_t iter;
    +   bson_error_t error;
    +   mongoc_cursor_t *cursor;
    +
    +   BSON_APPEND_DOCUMENT_BEGIN (&opts, "filter", &name_filter);
    +   /* find collections with names like "abbbbc" */
    +   BSON_APPEND_REGEX (&name_filter, "name", "ab+c", NULL);
    +   bson_append_document_end (&opts, &name_filter);
    +
    +   cursor = mongoc_database_find_collections_with_opts (database, &opts);
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      bson_iter_init_find (&iter, doc, "name");
    +      printf ("found collection: %s\n", bson_iter_utf8 (&iter, NULL));
    +   }
    +
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "%s\n", error.message);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   bson_destroy (&opts);
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_collection.html b/libmongoc/1.24.0/mongoc_database_get_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..c63992014e1c63d36da01c8253527a3109ad8c99 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_collection.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_database_get_collection() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_collection()

    +
    +

    Synopsis

    +
    mongoc_collection_t *
    +mongoc_database_get_collection (mongoc_database_t *database,
    +                                const char *name) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Allocates a new mongoc_collection_t structure for the collection named name in database.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_collection_t that should be freed with mongoc_collection_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_collection_names.html b/libmongoc/1.24.0/mongoc_database_get_collection_names.html new file mode 100644 index 0000000000000000000000000000000000000000..92b20c033d3bbe84323c3d33e786485d3a9f70d4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_collection_names.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_database_get_collection_names() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_collection_names()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_database_get_collection_names_with_opts() in new code.

    +
    +
    +
    +

    Synopsis

    +
    char **
    +mongoc_database_get_collection_names (mongoc_database_t *database,
    +                                      bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_database_get_collection_names_with_opts);
    +
    +
    +
    +
    +

    Description

    +

    Fetches a NULL terminated array of NULL-byte terminated char* strings containing the names of all of the collections in database.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A NULL terminated array of NULL terminated char* strings that should be freed with bson_strfreev(). Upon failure, NULL is returned and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_collection_names_with_opts.html b/libmongoc/1.24.0/mongoc_database_get_collection_names_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a90484ce1bd6a0c66a3776b79d6499f776959068 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_collection_names_with_opts.html @@ -0,0 +1,249 @@ + + + + + + + + + + + + + + mongoc_database_get_collection_names_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_collection_names_with_opts()

    +
    +

    Synopsis

    +
    char **
    +mongoc_database_get_collection_names_with_opts (mongoc_database_t *database,
    +                                                const bson_t *opts,
    +                                                bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Fetches a NULL terminated array of NULL-byte terminated char* strings containing the names of all of the collections in database.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    For a list of all options, see the MongoDB Manual entry on the listCollections command.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A NULL terminated array of NULL terminated char* strings that should be freed with bson_strfreev(). Upon failure, NULL is returned and error is set.

    +
    +
    +

    Examples

    +
    {
    +   bson_t opts = BSON_INITIALIZER;
    +   mongoc_read_concern_t *rc;
    +   bson_error_t error;
    +   char **strv;
    +   unsigned i;
    +
    +   rc = mongoc_read_concern_new ();
    +   mongoc_read_concern_set_level (rc, MONGOC_READ_CONCERN_LEVEL_MAJORITY);
    +   mongoc_read_concern_append (rc, &opts);
    +   if ((strv = mongoc_database_get_collection_names_with_opts (
    +          database, &opts, &error))) {
    +
    +      for (i = 0; strv[i]; i++)
    +         printf ("%s\n", strv[i]);
    +
    +      bson_strfreev (strv);
    +   } else {
    +      fprintf (stderr, "Command failed: %s\n", error.message);
    +   }
    +
    +   mongoc_read_concern_destroy (rc);
    +   bson_destroy (&opts);
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_name.html b/libmongoc/1.24.0/mongoc_database_get_name.html new file mode 100644 index 0000000000000000000000000000000000000000..d4ceab00cbd0219a95ac2c1e833e73f6a3fd4679 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_name.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_database_get_name (mongoc_database_t *database);
    +
    +
    +

    Fetches the name of the database.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A string which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_read_concern.html b/libmongoc/1.24.0/mongoc_database_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..3c83af77aa245e0bcbd0cf2a094f9276d58820ea --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_read_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_read_concern()

    +
    +

    Synopsis

    +
    const mongoc_read_concern_t *
    +mongoc_database_get_read_concern (const mongoc_database_t *database);
    +
    +
    +

    This function retrieves the default mongoc_read_concern_t to use with database as configured by the client.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_read_concern_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_read_prefs.html b/libmongoc/1.24.0/mongoc_database_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..9d758e3b838308df51bd79b08aa78b11b27629ee --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_read_prefs.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_read_prefs()

    +
    +

    Synopsis

    +
    const mongoc_read_prefs_t *
    +mongoc_database_get_read_prefs (const mongoc_database_t *database);
    +
    +
    +

    Fetches the default read preferences to use with database.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_write_concern_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_get_write_concern.html b/libmongoc/1.24.0/mongoc_database_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..88a3ade3aff06648039bc1fe9b3d5e7876a894e5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_get_write_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_get_write_concern()

    +
    +

    Synopsis

    +
    const mongoc_write_concern_t *
    +mongoc_database_get_write_concern (const mongoc_database_t *database);
    +
    +
    +

    This function retrieves the default mongoc_write_concern_t to use with database as configured by the client.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_write_concern_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_has_collection.html b/libmongoc/1.24.0/mongoc_database_has_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..6d1a1a33d74adaf51f094ed950e128b10c320d3c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_has_collection.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_database_has_collection() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_has_collection()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_has_collection (mongoc_database_t *database,
    +                                const char *name,
    +                                bson_error_t *error);
    +
    +
    +

    This function checks to see if a collection exists on the MongoDB server within database.

    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • name: A string containing the name of the collection.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    If the function succeeds, it returns true if the collection exists and false if not, and in either case the fields of error are cleared, if error is not NULL.

    +

    Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_read_command_with_opts.html b/libmongoc/1.24.0/mongoc_database_read_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..d232ddb93d0c5b9a1c6808102a7e4a185bb04e7e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_read_command_with_opts.html @@ -0,0 +1,259 @@ + + + + + + + + + + + + + + mongoc_database_read_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_read_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_read_command_with_opts (mongoc_database_t *database,
    +                                        const bson_t *command,
    +                                        const mongoc_read_prefs_t *read_prefs,
    +                                        const bson_t *opts,
    +                                        bson_t *reply,
    +                                        bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic that is specific to commands that read, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_database_command_simple().

    +

    Use this function for commands that read such as “count” or “distinct”.

    +

    Read preferences, read concern, and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts and the read preference must be primary or NULL. The highest-priority sources for these options are listed first in the following table. No write concern is applied.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Preferences

    Read Concern

    Collation

    read_prefs

    opts

    opts

    Transaction

    Transaction

    database

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +

    Retry logic occurs regardless of the underlying command. Retrying mapReduce has the potential for degraded performance. +Retrying a getMore command has the potential to miss results. For those commands, use generic command helpers (like mongoc_database_command_with_opts()) instead.

    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_read_write_command_with_opts.html b/libmongoc/1.24.0/mongoc_database_read_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..9a93d02124f63cb7a662017d39724ade63e950f1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_read_write_command_with_opts.html @@ -0,0 +1,258 @@ + + + + + + + + + + + + + + mongoc_database_read_write_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_read_write_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_read_write_command_with_opts (
    +   mongoc_database_t *database,
    +   const bson_t *command,
    +   const mongoc_read_prefs_t *read_prefs /* UNUSED */,
    +   const bson_t *opts,
    +   bson_t *reply,
    +   bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic for commands that both read and write, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_database_command_simple().

    +

    Use this function for commands that both read and write, such as “mapReduce” with an output collection.

    +

    Read and write concern and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts. The highest-priority sources for these options are listed first in the following table. Read preferences are not applied. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + + + + + +

    Read Concern

    Write Concern

    Collation

    opts

    opts

    opts

    Transaction

    Transaction

    database

    database

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +

    (The mongoc_read_prefs_t parameter was included by mistake when this function was introduced in libmongoc 1.5. A command that writes must not obey a read preference.)

    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • command: A bson_t containing the command specification.

    • +
    • read_prefs: Ignored.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_remove_all_users.html b/libmongoc/1.24.0/mongoc_database_remove_all_users.html new file mode 100644 index 0000000000000000000000000000000000000000..e8c19c68b40f1069d01f66ce62edcc4335e52de6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_remove_all_users.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_database_remove_all_users() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_remove_all_users()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_remove_all_users (mongoc_database_t *database,
    +                                  bson_error_t *error);
    +
    +
    +

    This function will remove all users configured to access database.

    +
    +
    +

    Parameters

    + +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter. This may fail if there are socket errors or the current user is not authorized to perform the given command.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_remove_user.html b/libmongoc/1.24.0/mongoc_database_remove_user.html new file mode 100644 index 0000000000000000000000000000000000000000..eeff19fc22aea4b32895cad4f6c74da48b7d9021 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_remove_user.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_database_remove_user() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_remove_user()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_remove_user (mongoc_database_t *database,
    +                             const char *username,
    +                             bson_error_t *error);
    +
    +
    +

    This function removes the user named username from database.

    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • username: A string containing the username of the user to remove.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter. This could include socket errors or others if the current user is not authorized to perform the command.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_set_read_concern.html b/libmongoc/1.24.0/mongoc_database_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..e3da5a094067579bf471a176f21920f45b5a4240 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_set_read_concern.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_database_set_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_set_read_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_database_set_read_concern (mongoc_database_t *database,
    +                                  const mongoc_read_concern_t *read_concern);
    +
    +
    +

    This function sets the read concern to use on operations performed with database. Collections created with mongoc_database_get_collection() after this call will inherit this read concern.

    +

    The default read concern is empty: No readConcern is sent to the server unless explicitly configured.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_set_read_prefs.html b/libmongoc/1.24.0/mongoc_database_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..c4998f11da3ef2e0b1267d9dfcdec9637813c716 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_set_read_prefs.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_set_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_set_read_prefs()

    +
    +

    Synopsis

    +
    void
    +mongoc_database_set_read_prefs (mongoc_database_t *database,
    +                                const mongoc_read_prefs_t *read_prefs);
    +
    +
    +

    This function sets the default read preferences to use on operations performed with database. Collections created with mongoc_database_get_collection() after this call will inherit these read preferences.

    +

    The global default is MONGOC_READ_PRIMARY: if the client is connected to a replica set it reads from the primary, otherwise it reads from the current MongoDB server.

    +

    Please see the MongoDB website for a description of Read Preferences.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_set_write_concern.html b/libmongoc/1.24.0/mongoc_database_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..c659ea360662bb3f397b37a6038fff4af68a79b6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_set_write_concern.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_database_set_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_set_write_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_database_set_write_concern (mongoc_database_t *database,
    +                                   const mongoc_write_concern_t *write_concern);
    +
    +
    +

    This function sets the write concern to use on operations performed with database. Collections created with mongoc_database_get_collection() after this call will inherit this write concern.

    +

    The default write concern is MONGOC_WRITE_CONCERN_W_DEFAULT: the driver blocks awaiting basic acknowledgement of write operations from MongoDB. This is the correct write concern for the great majority of applications.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_t.html b/libmongoc/1.24.0/mongoc_database_t.html new file mode 100644 index 0000000000000000000000000000000000000000..498d7bffe8081613e5df8a67878a756ba497ac67 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_t.html @@ -0,0 +1,253 @@ + + + + + + + + + + + + + + mongoc_database_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_t

    +

    MongoDB Database Abstraction

    +
    +

    Synopsis

    +
    typedef struct _mongoc_database_t mongoc_database_t;
    +
    +
    +

    mongoc_database_t provides access to a MongoDB database. This handle is useful for actions a particular database object. It is not a container for mongoc_collection_t structures.

    +

    Read preferences and write concerns are inherited from the parent client. They can be overridden with mongoc_database_set_read_prefs() and mongoc_database_set_write_concern().

    +
    +
    +

    Functions

    + +
    +
    +

    Examples

    +
    #include <mongoc/mongoc.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_database_t *database;
    +   mongoc_client_t *client;
    +
    +   mongoc_init ();
    +
    +   client = mongoc_client_new ("mongodb://localhost/");
    +   database = mongoc_client_get_database (client, "test");
    +
    +   mongoc_database_destroy (database);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_watch.html b/libmongoc/1.24.0/mongoc_database_watch.html new file mode 100644 index 0000000000000000000000000000000000000000..31ac400717d5edb074549a5ea48adaf0441eaf17 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_watch.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_database_watch() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_watch()

    +
    +

    Synopsis

    +
    mongoc_change_stream_t*
    +mongoc_database_watch (const mongoc_database_t *db,
    +                       const bson_t *pipeline,
    +                       const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    A helper function to create a change stream. It is preferred to call this +function over using a raw aggregation to create a change stream.

    +

    This function uses the read preference and read concern of the database. If +the change stream needs to re-establish connection, the same read preference +will be used. This may happen if the change stream encounters a resumable error.

    +
    +

    Warning

    +

    A change stream is only supported with majority read concern.

    +
    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Parameters

    +
      +
    • db: A mongoc_database_t specifying the database which the change stream listens to.

    • +
    • pipeline: A bson_t representing an aggregation pipeline appended to the change stream. This may be an empty document.

    • +
    • opts: A bson_t containing change stream options.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • batchSize: An int32 representing number of documents requested to be returned on each call to mongoc_change_stream_next()

    • +
    • resumeAfter: A Document representing the logical starting point of the change stream. The result of mongoc_change_stream_get_resume_token() or the _id field of any change received from a change stream can be used here. This option is mutually exclusive with startAfter and startAtOperationTime.

    • +
    • startAfter: A Document representing the logical starting point of the change stream. Unlike resumeAfter, this can resume notifications after an “invalidate” event. The result of mongoc_change_stream_get_resume_token() or the _id field of any change received from a change stream can be used here. This option is mutually exclusive with resumeAfter and startAtOperationTime.

    • +
    • startAtOperationTime: A Timestamp. The change stream only provides changes that occurred at or after the specified timestamp. Any command run against the server will return an operation time that can be used here. This option is mutually exclusive with resumeAfter and startAfter.

    • +
    • maxAwaitTimeMS: An int64 representing the maximum amount of time a call to mongoc_change_stream_next() will block waiting for data

    • +
    • fullDocument: An optional UTF-8 string. Set this option to “default”, “updateLookup”, “whenAvailable”, or “required”, If unset, The string “default” is assumed. Set this option to “updateLookup” to direct the change stream cursor to lookup the most current majority-committed version of the document associated to an update change stream event.

    • +
    • fullDocumentBeforeChange: An optional UTF-8 string. Set this option to “whenAvailable”, “required”, or “off”. When unset, the default value is “off”. Similar to “fullDocument”, but returns the value of the document before the associated change.

    • +
    • showExpandedEvents: Set to true to return an expanded list of change stream events. Avaiable only on MongoDB versions >=6.0

    • +
    • comment: A bson_value_t specifying the comment to attach to this command. The comment will appear in log messages, profiler output, and currentOp output. Only string values are supported prior to MongoDB 4.4.

    • +
    +
    +
    +

    Returns

    +

    A newly allocated mongoc_change_stream_t which must be freed with +mongoc_change_stream_destroy() when no longer in use. The returned +mongoc_change_stream_t is never NULL. If there is an error, it can +be retrieved with mongoc_change_stream_error_document(), and subsequent +calls to mongoc_change_stream_next() will return false.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_database_write_command_with_opts.html b/libmongoc/1.24.0/mongoc_database_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..bf56cd6c829836cdc150096079bb48d58f0822cc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_database_write_command_with_opts.html @@ -0,0 +1,253 @@ + + + + + + + + + + + + + + mongoc_database_write_command_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_database_write_command_with_opts()

    +
    +

    Synopsis

    +
    bool
    +mongoc_database_write_command_with_opts (mongoc_database_t *database,
    +                                         const bson_t *command,
    +                                         const bson_t *opts,
    +                                         bson_t *reply,
    +                                         bson_error_t *error);
    +
    +
    +

    Execute a command on the server, applying logic that is specific to commands that write, and taking the MongoDB server version into account. To send a raw command to the server without any of this logic, use mongoc_database_command_simple().

    +

    Use this function for commands that write such as “drop” or “createRole” (but not for “insert”, “update”, or “delete”, see Basic Write Operations). Write concern and collation can be overridden by various sources. In a transaction, read concern and write concern are prohibited in opts. The highest-priority sources for these options are listed first in the following table. The write concern is omitted for MongoDB before 3.4.

    + + + + + + + + + + + + + + + + + +

    Write Concern

    Collation

    opts

    opts

    Transaction

    database

    +

    See the example for transactions and for the “distinct” command with opts.

    +

    reply is always initialized, and must be freed with bson_destroy().

    +
    +
    +

    Parameters

    +
      +
    • database: A mongoc_database_t.

    • +
    • db_name: The name of the database to run the command on.

    • +
    • command: A bson_t containing the command specification.

    • +
    • opts: A bson_t containing additional options.

    • +
    • reply: A location for the resulting document.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +

    opts may be NULL or a BSON document with additional command options:

    + +

    Consult the MongoDB Manual entry on Database Commands for each command’s arguments.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +

    A write concern timeout or write concern error is considered a failure.

    +
    +
    +

    Basic Write Operations

    +

    Do not use this function to call the basic write commands “insert”, “update”, and “delete”. Those commands require special logic not implemented in mongoc_database_write_command_with_opts. For basic write operations use CRUD functions such as mongoc_collection_insert_one() and the others described in the CRUD tutorial, or use the Bulk API.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_delete_flags_t.html b/libmongoc/1.24.0/mongoc_delete_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..350217ef0a55d5b9c905ca531446ddd279588ff3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_delete_flags_t.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_delete_flags_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_delete_flags_t

    +
    +

    Warning

    +
    +

    Deprecated since version 1.9.0: These flags are deprecated and should not be used in new code.

    +

    Please use mongoc_collection_delete_one() or mongoc_collection_delete_many() in new code.

    +
    +
    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_DELETE_NONE = 0,
    +   MONGOC_DELETE_SINGLE_REMOVE = 1 << 0,
    +} mongoc_delete_flags_t;
    +
    +
    +

    Flags for deletion operations

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_error_has_label.html b/libmongoc/1.24.0/mongoc_error_has_label.html new file mode 100644 index 0000000000000000000000000000000000000000..7c915c56165a2489adadefd4a33c6414a81b5b2d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_error_has_label.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_error_has_label() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_error_has_label()

    +
    +

    Synopsis

    +
    bool
    +mongoc_error_has_label (const bson_t *reply, const char *label);
    +
    +
    +

    Test whether a reply from a failed operation includes a specific error label. See Error Labels for details, and see mongoc_client_session_start_transaction() for example code that demonstrates their use.

    +
    +
    +

    Parameters

    +
      +
    • reply: A bson_t, the reply to a failed operation.

    • +
    • label: The label to test for, such as “TransientTransactionError” or “UnknownTransactionCommitResult”.

    • +
    +
    +
    +

    Returns

    +

    Returns true if reply contains the error label.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_append.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_append.html new file mode 100644 index 0000000000000000000000000000000000000000..2357e265eb04012b1019655c6092cb3c0dd63e88 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_append.html @@ -0,0 +1,282 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_append() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_append()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_append (mongoc_find_and_modify_opts_t *opts,
    +                                    const bson_t *extra);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Adds arbitrary options to the findAndModify command.

    +

    extra does not have to remain valid after calling this function.

    +

    extra may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    +

    Appending options to findAndModify

    +
    +
    opts.c
    +
    void
    +fam_opts (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_t *update;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   mongoc_write_concern_t *wc;
    +   bson_t extra = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +
    +   /* Bump his age */
    +   update = BCON_NEW ("$inc", "{", "age", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   /* Abort if the operation takes too long. */
    +   mongoc_find_and_modify_opts_set_max_time_ms (opts, 100);
    +
    +   /* Set write concern w: 2 */
    +   wc = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_w (wc, 2);
    +   mongoc_write_concern_append (wc, &extra);
    +
    +   /* Some future findAndModify option the driver doesn't support conveniently
    +    */
    +   BSON_APPEND_INT32 (&extra, "futureOption", 42);
    +   mongoc_find_and_modify_opts_append (opts, &extra);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (&extra);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_write_concern_destroy (wc);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_destroy.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..c8a2db3f9c04fb2645c2712ed63836090e3485ef --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_destroy.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_find_and_modify_opts_destroy (
    +   mongoc_find_and_modify_opts_t *find_and_modify_opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees all resources associated with the find and modify builder structure. Does nothing if find_and_modify_opts is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_bypass_document_validation.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_bypass_document_validation.html new file mode 100644 index 0000000000000000000000000000000000000000..957b2e71a315bc606f91b29d058f42e8fb97ec27 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_bypass_document_validation.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_bypass_document_validation() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_get_bypass_document_validation()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_get_bypass_document_validation (
    +   const mongoc_find_and_modify_opts_t *opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if mongoc_find_and_modify_opts_set_bypass_document_validation() was called previously on opts.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_fields.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_fields.html new file mode 100644 index 0000000000000000000000000000000000000000..2d03923f3d740e2823432bc148926baef2a94144 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_fields.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_fields() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_get_fields()

    +
    +

    Synopsis

    +
    void
    +mongoc_find_and_modify_opts_get_fields (
    +   const mongoc_find_and_modify_opts_t *opts, bson_t *fields);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Copy to fields the BSON document that was set with mongoc_find_and_modify_opts_set_fields(), or initializes fields with an empty BSON document.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_flags.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_flags.html new file mode 100644 index 0000000000000000000000000000000000000000..77cbd48f74f585c6150cf271bd31eae77ae56885 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_flags.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_flags() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_get_flags()

    +
    +

    Synopsis

    +
    mongoc_find_and_modify_flags_t
    +mongoc_find_and_modify_opts_get_flags (
    +   const mongoc_find_and_modify_opts_t *opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns the flags set with mongoc_find_and_modify_opts_set_flags().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_max_time_ms.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_max_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..27a708f1e81c722ee4a13a5c184e7840a492ae43 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_max_time_ms.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_max_time_ms() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_get_max_time_ms()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_find_and_modify_opts_get_max_time_ms (
    +   const mongoc_find_and_modify_opts_t *opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns the “maxTimeMS” value set with mongoc_find_and_modify_opts_set_max_time_ms().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_sort.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_sort.html new file mode 100644 index 0000000000000000000000000000000000000000..6d77ffcb0e01e3627fd726b8af09b1e70cd0fd16 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_sort.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_sort() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_get_sort()

    +
    +

    Synopsis

    +
    void
    +mongoc_find_and_modify_opts_get_sort (const mongoc_find_and_modify_opts_t *opts,
    +                                      bson_t *sort);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Copies the sort document set with mongoc_find_and_modify_opts_set_sort(), or initializes sort with an empty BSON document.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_update.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_update.html new file mode 100644 index 0000000000000000000000000000000000000000..05b29bcfc6b08a348ec537a980414793c3dc25e5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_get_update.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_update() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_get_update()

    +
    +

    Synopsis

    +
    void
    +mongoc_find_and_modify_opts_get_update (
    +   const mongoc_find_and_modify_opts_t *opts, bson_t *update);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Copies the update document set with mongoc_find_and_modify_opts_set_update(), or initializes update with an empty BSON document.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_new.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..a63e66dd76dfecb54a90c1199191d2856ca4d1dc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_new()

    +
    +

    Synopsis

    +
    mongoc_find_and_modify_opts_t *
    +mongoc_find_and_modify_opts_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    Creates a newly allocated find and modify builder structure that is used to create a findAndModify command. This should be freed with mongoc_find_and_modify_opts_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_bypass_document_validation.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_bypass_document_validation.html new file mode 100644 index 0000000000000000000000000000000000000000..f1f1afe9f64e4681a7915099a73de8c355b05634 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_bypass_document_validation.html @@ -0,0 +1,276 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_bypass_document_validation() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_set_bypass_document_validation()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_set_bypass_document_validation (
    +   mongoc_find_and_modify_opts_t *opts, bool bypass);
    +
    +
    +

    This option is only available when talking to MongoDB 3.2 and later.

    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Adds bypassDocumentValidation argument to the builder.

    +

    When authentication is enabled, the authenticated user must have either the “dbadmin” or “restore” roles to bypass document validation.

    +
    +
    +

    Returns

    +

    Returns true if it successfully added the option to the builder, otherwise false and logs an error.

    +
    +
    +

    Setting bypassDocumentValidation

    +
    +
    bypass.c
    +
    void
    +fam_bypass (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_t *update;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +
    +   /* Bump his age */
    +   update = BCON_NEW ("$inc", "{", "age", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +   /* He can still play, even though he is pretty old. */
    +   mongoc_find_and_modify_opts_set_bypass_document_validation (opts, true);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +

    Outputs:

    +
    {
    +   "lastErrorObject" : {"updatedExisting" : true, "n" : 1},
    +                       "value" : {
    +                          "_id" : {"$oid" : "56562a99d13e6d86239c7b00"},
    +                          "age" : 34,
    +                          "firstname" : "Zlatan",
    +                          "goals" : 342,
    +                          "lastname" : "Ibrahimovic",
    +                          "profession" : "Football player",
    +                          "position" : "striker"
    +                       },
    +                                 "ok" : 1
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_fields.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_fields.html new file mode 100644 index 0000000000000000000000000000000000000000..89c0132f5a782c328723983b8c0f401c07b9497b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_fields.html @@ -0,0 +1,275 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_fields() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_set_fields()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_set_fields (mongoc_find_and_modify_opts_t *opts,
    +                                        const bson_t *fields);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • opts: A mongoc_find_and_modify_opts_t.

    • +
    • fields: A subset of fields to return. Choose which fields to include by appending {fieldname: 1} for each fieldname, or excluding it with {fieldname: 0}.

    • +
    +
    +
    +

    Description

    +

    Adds fields argument to the builder.

    +

    fields does not have to remain valid after calling this function.

    +
    +
    +

    Returns

    +

    Returns true if it successfully added the option to the builder, otherwise false.

    +
    +
    +

    Setting fields

    +
    +
    fields.c
    +
    void
    +fam_fields (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t fields = BSON_INITIALIZER;
    +   bson_t *update;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic */
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +
    +   /* Return his goal tally */
    +   BSON_APPEND_INT32 (&fields, "goals", 1);
    +
    +   /* Bump his goal tally */
    +   update = BCON_NEW ("$inc", "{", "goals", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +   mongoc_find_and_modify_opts_set_fields (opts, &fields);
    +   /* Return the new tally */
    +   mongoc_find_and_modify_opts_set_flags (opts,
    +                                          MONGOC_FIND_AND_MODIFY_RETURN_NEW);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&fields);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +

    Outputs:

    +
    {
    +   "lastErrorObject"
    +      : {"updatedExisting" : true, "n" : 1},
    +        "value"
    +        : {"_id" : {"$oid" : "56562a99d13e6d86239c7b00"}, "goals" : 343},
    +          "ok" : 1
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_flags.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_flags.html new file mode 100644 index 0000000000000000000000000000000000000000..3c39d3edb06eb4228baeb511567325e13c3ddb4a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_flags.html @@ -0,0 +1,301 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_flags() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_set_flags()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_set_flags (
    +   mongoc_find_and_modify_opts_t *opts,
    +   const mongoc_find_and_modify_flags_t flags);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Adds one or more flags to the builder.

    + + + + + + + + + + + + + + + +

    MONGOC_FIND_AND_MODIFY_NONE

    Default. Doesn’t add anything to the builder.

    MONGOC_FIND_AND_MODIFY_REMOVE

    Will instruct find_and_modify to remove the matching document.

    MONGOC_FIND_AND_MODIFY_UPSERT

    Update the matching document or, if no document matches, insert the document.

    MONGOC_FIND_AND_MODIFY_RETURN_NEW

    Return the resulting document.

    +
    +
    +

    Returns

    +

    Returns Returns true if it successfully added the option to the builder, otherwise false and logs an error.

    +
    +
    +

    Setting flags

    +
    +
    flags.c
    +
    void
    +fam_flags (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bson_t *update;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +   BSON_APPEND_INT32 (&query, "age", 34);
    +   BSON_APPEND_INT32 (
    +      &query, "goals", (16 + 35 + 23 + 57 + 16 + 14 + 28 + 84) + (1 + 6 + 62));
    +
    +   /* Add his football position */
    +   update = BCON_NEW ("$set", "{", "position", BCON_UTF8 ("striker"), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   /* Create the document if it didn't exist, and return the updated document */
    +   mongoc_find_and_modify_opts_set_flags (
    +      opts, MONGOC_FIND_AND_MODIFY_UPSERT | MONGOC_FIND_AND_MODIFY_RETURN_NEW);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +

    Outputs:

    +
    {
    +   "lastErrorObject" : {
    +      "updatedExisting" : false,
    +      "n" : 1,
    +      "upserted" : {"$oid" : "56562a99d13e6d86239c7b00"}
    +   },
    +                       "value" : {
    +                          "_id" : {"$oid" : "56562a99d13e6d86239c7b00"},
    +                          "age" : 34,
    +                          "firstname" : "Zlatan",
    +                          "goals" : 342,
    +                          "lastname" : "Ibrahimovic",
    +                          "profession" : "Football player",
    +                          "position" : "striker"
    +                       },
    +                                 "ok" : 1
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_max_time_ms.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_max_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..2071a6065e0ea5a8d6e719108768dbcffad8ea82 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_max_time_ms.html @@ -0,0 +1,274 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_max_time_ms() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_set_max_time_ms()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_set_max_time_ms (
    +   mongoc_find_and_modify_opts_t *opts, uint32_t max_time_ms);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • opts: A mongoc_find_and_modify_opts_t.

    • +
    • max_time_ms: The maximum server-side execution time permitted, in milliseconds, or 0 to specify no maximum time (the default setting).

    • +
    +
    +
    +

    Description

    +

    Adds a maxTimeMS argument to the builder.

    +
    +
    +

    Returns

    +

    Returns true if it successfully added the option to the builder, otherwise false and logs an error.

    +

    Note: although max_time_ms is a uint32_t, it is possible to set it as a uint64_t through the options arguments in some cursor returning functions like mongoc_collection_find_with_opts().

    +
    +
    +

    Setting maxTimeMS

    +
    +
    opts.c
    +
    void
    +fam_opts (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_t *update;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   mongoc_write_concern_t *wc;
    +   bson_t extra = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +
    +   /* Bump his age */
    +   update = BCON_NEW ("$inc", "{", "age", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   /* Abort if the operation takes too long. */
    +   mongoc_find_and_modify_opts_set_max_time_ms (opts, 100);
    +
    +   /* Set write concern w: 2 */
    +   wc = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_w (wc, 2);
    +   mongoc_write_concern_append (wc, &extra);
    +
    +   /* Some future findAndModify option the driver doesn't support conveniently
    +    */
    +   BSON_APPEND_INT32 (&extra, "futureOption", 42);
    +   mongoc_find_and_modify_opts_append (opts, &extra);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (&extra);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_write_concern_destroy (wc);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_sort.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_sort.html new file mode 100644 index 0000000000000000000000000000000000000000..4740c757be28a5cac524dd8a34a430671421da27 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_sort.html @@ -0,0 +1,278 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_sort() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_set_sort()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_set_sort (mongoc_find_and_modify_opts_t *opts,
    +                                      const bson_t *sort);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • opts: A mongoc_find_and_modify_opts_t.

    • +
    • sort: Determines which document the operation modifies if the query selects multiple documents. findAndModify modifies the first document in the sort order specified by this argument.

    • +
    +
    +
    +

    Description

    +

    Adds sort argument to the builder.

    +

    sort does not have to remain valid after calling this function.

    +
    +
    +

    Returns

    +

    Returns true if it successfully added the option to the builder, otherwise false.

    +
    +
    +

    Setting sort

    +
    +
    sort.c
    +
    void
    +fam_sort (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t *update;
    +   bson_t sort = BSON_INITIALIZER;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find all users with the lastname Ibrahimovic */
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +
    +   /* Sort by age (descending) */
    +   BSON_APPEND_INT32 (&sort, "age", -1);
    +
    +   /* Bump his goal tally */
    +   update = BCON_NEW ("$set", "{", "oldest", BCON_BOOL (true), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +   mongoc_find_and_modify_opts_set_sort (opts, &sort);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&sort);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +

    Outputs:

    +
    {
    +   "lastErrorObject" : {"updatedExisting" : true, "n" : 1},
    +                       "value" : {
    +                          "_id" : {"$oid" : "56562a99d13e6d86239c7b00"},
    +                          "age" : 35,
    +                          "firstname" : "Zlatan",
    +                          "goals" : 343,
    +                          "lastname" : "Ibrahimovic",
    +                          "profession" : "Football player",
    +                          "position" : "striker",
    +                          "author" : true
    +                       },
    +                                 "ok" : 1
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_update.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_update.html new file mode 100644 index 0000000000000000000000000000000000000000..1db3b98fbaa267171b40e2b5e5f2bc5c12a2307c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_set_update.html @@ -0,0 +1,277 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_update() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_set_update()

    +
    +

    Synopsis

    +
    bool
    +mongoc_find_and_modify_opts_set_update (mongoc_find_and_modify_opts_t *opts,
    +                                        const bson_t *update);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Adds update argument to the builder.

    +

    update does not have to remain valid after calling this function.

    +
    +
    +

    Returns

    +

    Returns true if it successfully added the option to the builder, otherwise false.

    +
    +
    +

    Setting update

    +
    +
    update.c
    +
    void
    +fam_update (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t *update;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +
    +   /* Make him a book author */
    +   update = BCON_NEW ("$set", "{", "author", BCON_BOOL (true), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   /* Note that the document returned is the _previous_ version of the document
    +    * To fetch the modified new version, use
    +    * mongoc_find_and_modify_opts_set_flags (opts,
    +    * MONGOC_FIND_AND_MODIFY_RETURN_NEW);
    +    */
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +

    Outputs:

    +
    {
    +   "lastErrorObject" : {"updatedExisting" : true, "n" : 1},
    +                       "value" : {
    +                          "_id" : {"$oid" : "56562a99d13e6d86239c7b00"},
    +                          "age" : 35,
    +                          "firstname" : "Zlatan",
    +                          "goals" : 342,
    +                          "lastname" : "Ibrahimovic",
    +                          "profession" : "Football player",
    +                          "position" : "striker"
    +                       },
    +                                 "ok" : 1
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_find_and_modify_opts_t.html b/libmongoc/1.24.0/mongoc_find_and_modify_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..d872a774ee68f9fff972281d29cd799c4d6ba2ae --- /dev/null +++ b/libmongoc/1.24.0/mongoc_find_and_modify_opts_t.html @@ -0,0 +1,701 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_find_and_modify_opts_t

    +

    find_and_modify abstraction

    +
    +

    Synopsis

    +

    mongoc_find_and_modify_opts_t is a builder interface to construct the findAndModify command.

    +

    It was created to be able to accommodate new arguments to the findAndModify command.

    +

    As of MongoDB 3.2, the mongoc_write_concern_t specified on the mongoc_collection_t will be used, if any.

    +
    +
    +

    Example

    +
    +
    flags.c
    +
    void
    +fam_flags (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bson_t *update;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +   BSON_APPEND_INT32 (&query, "age", 34);
    +   BSON_APPEND_INT32 (
    +      &query, "goals", (16 + 35 + 23 + 57 + 16 + 14 + 28 + 84) + (1 + 6 + 62));
    +
    +   /* Add his football position */
    +   update = BCON_NEW ("$set", "{", "position", BCON_UTF8 ("striker"), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   /* Create the document if it didn't exist, and return the updated document */
    +   mongoc_find_and_modify_opts_set_flags (
    +      opts, MONGOC_FIND_AND_MODIFY_UPSERT | MONGOC_FIND_AND_MODIFY_RETURN_NEW);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    bypass.c
    +
    void
    +fam_bypass (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_t *update;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +
    +   /* Bump his age */
    +   update = BCON_NEW ("$inc", "{", "age", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +   /* He can still play, even though he is pretty old. */
    +   mongoc_find_and_modify_opts_set_bypass_document_validation (opts, true);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    update.c
    +
    void
    +fam_update (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t *update;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +
    +   /* Make him a book author */
    +   update = BCON_NEW ("$set", "{", "author", BCON_BOOL (true), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   /* Note that the document returned is the _previous_ version of the document
    +    * To fetch the modified new version, use
    +    * mongoc_find_and_modify_opts_set_flags (opts,
    +    * MONGOC_FIND_AND_MODIFY_RETURN_NEW);
    +    */
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    fields.c
    +
    void
    +fam_fields (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t fields = BSON_INITIALIZER;
    +   bson_t *update;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic */
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +
    +   /* Return his goal tally */
    +   BSON_APPEND_INT32 (&fields, "goals", 1);
    +
    +   /* Bump his goal tally */
    +   update = BCON_NEW ("$inc", "{", "goals", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +   mongoc_find_and_modify_opts_set_fields (opts, &fields);
    +   /* Return the new tally */
    +   mongoc_find_and_modify_opts_set_flags (opts,
    +                                          MONGOC_FIND_AND_MODIFY_RETURN_NEW);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&fields);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    sort.c
    +
    void
    +fam_sort (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t *update;
    +   bson_t sort = BSON_INITIALIZER;
    +   bson_t reply;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find all users with the lastname Ibrahimovic */
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +
    +   /* Sort by age (descending) */
    +   BSON_APPEND_INT32 (&sort, "age", -1);
    +
    +   /* Bump his goal tally */
    +   update = BCON_NEW ("$set", "{", "oldest", BCON_BOOL (true), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +   mongoc_find_and_modify_opts_set_sort (opts, &sort);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (update);
    +   bson_destroy (&sort);
    +   bson_destroy (&query);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    opts.c
    +
    void
    +fam_opts (mongoc_collection_t *collection)
    +{
    +   mongoc_find_and_modify_opts_t *opts;
    +   bson_t reply;
    +   bson_t *update;
    +   bson_error_t error;
    +   bson_t query = BSON_INITIALIZER;
    +   mongoc_write_concern_t *wc;
    +   bson_t extra = BSON_INITIALIZER;
    +   bool success;
    +
    +
    +   /* Find Zlatan Ibrahimovic, the striker */
    +   BSON_APPEND_UTF8 (&query, "firstname", "Zlatan");
    +   BSON_APPEND_UTF8 (&query, "lastname", "Ibrahimovic");
    +   BSON_APPEND_UTF8 (&query, "profession", "Football player");
    +
    +   /* Bump his age */
    +   update = BCON_NEW ("$inc", "{", "age", BCON_INT32 (1), "}");
    +
    +   opts = mongoc_find_and_modify_opts_new ();
    +   mongoc_find_and_modify_opts_set_update (opts, update);
    +
    +   /* Abort if the operation takes too long. */
    +   mongoc_find_and_modify_opts_set_max_time_ms (opts, 100);
    +
    +   /* Set write concern w: 2 */
    +   wc = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_w (wc, 2);
    +   mongoc_write_concern_append (wc, &extra);
    +
    +   /* Some future findAndModify option the driver doesn't support conveniently
    +    */
    +   BSON_APPEND_INT32 (&extra, "futureOption", 42);
    +   mongoc_find_and_modify_opts_append (opts, &extra);
    +
    +   success = mongoc_collection_find_and_modify_with_opts (
    +      collection, &query, opts, &reply, &error);
    +
    +   if (success) {
    +      char *str;
    +
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +   }
    +
    +   bson_destroy (&reply);
    +   bson_destroy (&extra);
    +   bson_destroy (update);
    +   bson_destroy (&query);
    +   mongoc_write_concern_destroy (wc);
    +   mongoc_find_and_modify_opts_destroy (opts);
    +}
    +
    +
    +
    +
    +
    fam.c
    +
    int
    +main (void)
    +{
    +   mongoc_collection_t *collection;
    +   mongoc_database_t *database;
    +   mongoc_client_t *client;
    +   const char *uri_string =
    +      "mongodb://localhost:27017/admin?appname=find-and-modify-opts-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +   bson_t *options;
    +
    +   mongoc_init ();
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   database = mongoc_client_get_database (client, "databaseName");
    +
    +   options = BCON_NEW ("validator",
    +                       "{",
    +                       "age",
    +                       "{",
    +                       "$lte",
    +                       BCON_INT32 (34),
    +                       "}",
    +                       "}",
    +                       "validationAction",
    +                       BCON_UTF8 ("error"),
    +                       "validationLevel",
    +                       BCON_UTF8 ("moderate"));
    +
    +   collection = mongoc_database_create_collection (
    +      database, "collectionName", options, &error);
    +   if (!collection) {
    +      fprintf (
    +         stderr, "Got error: \"%s\" on line %d\n", error.message, __LINE__);
    +      return EXIT_FAILURE;
    +   }
    +
    +   fam_flags (collection);
    +   fam_bypass (collection);
    +   fam_update (collection);
    +   fam_fields (collection);
    +   fam_opts (collection);
    +   fam_sort (collection);
    +
    +   mongoc_collection_drop (collection, NULL);
    +   bson_destroy (options);
    +   mongoc_uri_destroy (uri);
    +   mongoc_database_destroy (database);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +

    Outputs:

    +
    {
    +    "lastErrorObject": {
    +        "updatedExisting": false,
    +        "n": 1,
    +        "upserted": {
    +            "$oid": "56562a99d13e6d86239c7b00"
    +        }
    +    },
    +    "value": {
    +        "_id": {
    +            "$oid": "56562a99d13e6d86239c7b00"
    +        },
    +        "age": 34,
    +        "firstname": "Zlatan",
    +        "goals": 342,
    +        "lastname": "Ibrahimovic",
    +        "profession": "Football player",
    +        "position": "striker"
    +    },
    +    "ok": 1
    +}
    +{
    +    "lastErrorObject": {
    +        "updatedExisting": true,
    +        "n": 1
    +    },
    +    "value": {
    +        "_id": {
    +            "$oid": "56562a99d13e6d86239c7b00"
    +        },
    +        "age": 34,
    +        "firstname": "Zlatan",
    +        "goals": 342,
    +        "lastname": "Ibrahimovic",
    +        "profession": "Football player",
    +        "position": "striker"
    +    },
    +    "ok": 1
    +}
    +{
    +    "lastErrorObject": {
    +        "updatedExisting": true,
    +        "n": 1
    +    },
    +    "value": {
    +        "_id": {
    +            "$oid": "56562a99d13e6d86239c7b00"
    +        },
    +        "age": 35,
    +        "firstname": "Zlatan",
    +        "goals": 342,
    +        "lastname": "Ibrahimovic",
    +        "profession": "Football player",
    +        "position": "striker"
    +    },
    +    "ok": 1
    +}
    +{
    +    "lastErrorObject": {
    +        "updatedExisting": true,
    +        "n": 1
    +    },
    +    "value": {
    +        "_id": {
    +            "$oid": "56562a99d13e6d86239c7b00"
    +        },
    +        "goals": 343
    +    },
    +    "ok": 1
    +}
    +{
    +    "lastErrorObject": {
    +        "updatedExisting": true,
    +        "n": 1
    +    },
    +    "value": {
    +        "_id": {
    +            "$oid": "56562a99d13e6d86239c7b00"
    +        },
    +        "age": 35,
    +        "firstname": "Zlatan",
    +        "goals": 343,
    +        "lastname": "Ibrahimovic",
    +        "profession": "Football player",
    +        "position": "striker",
    +        "author": true
    +    },
    +    "ok": 1
    +}
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_get_major_version.html b/libmongoc/1.24.0/mongoc_get_major_version.html new file mode 100644 index 0000000000000000000000000000000000000000..417265723b7d8e0ce00e97ac4f4a75b362b1a8b4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_get_major_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_major_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_major_version()

    +
    +

    Synopsis

    +
    int
    +mongoc_get_major_version (void);
    +
    +
    +
    +
    +

    Returns

    +

    The value of MONGOC_MAJOR_VERSION when libmongoc was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_get_micro_version.html b/libmongoc/1.24.0/mongoc_get_micro_version.html new file mode 100644 index 0000000000000000000000000000000000000000..e6681a0604a2c9d15de81751d45288b855824ec3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_get_micro_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_micro_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_micro_version()

    +
    +

    Synopsis

    +
    int
    +mongoc_get_micro_version (void);
    +
    +
    +
    +
    +

    Returns

    +

    The value of MONGOC_MICRO_VERSION when libmongoc was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_get_minor_version.html b/libmongoc/1.24.0/mongoc_get_minor_version.html new file mode 100644 index 0000000000000000000000000000000000000000..8e5d6054c182a8848709019dfb4fa8c38d40d376 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_get_minor_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_minor_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_minor_version()

    +
    +

    Synopsis

    +
    int
    +mongoc_get_minor_version (void);
    +
    +
    +
    +
    +

    Returns

    +

    The value of MONGOC_MINOR_VERSION when libmongoc was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_get_version.html b/libmongoc/1.24.0/mongoc_get_version.html new file mode 100644 index 0000000000000000000000000000000000000000..dffcb730098c9e5ab5ce7db48e58dac453d32808 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_get_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_version()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_get_version (void);
    +
    +
    +
    +
    +

    Returns

    +

    A string representation of libmongoc’s version, formatted something like “1.2.3” or “1.2.3-pre”.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_abort_upload.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_abort_upload.html new file mode 100644 index 0000000000000000000000000000000000000000..c957d832136f0a00f3f327882a57eb315961e936 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_abort_upload.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_abort_upload() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_abort_upload()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_bucket_abort_upload (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Aborts the upload of a GridFS upload stream.

    +
    +
    +

    Returns

    +

    True on success. False otherwise, and sets an error on stream.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_delete_by_id.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_delete_by_id.html new file mode 100644 index 0000000000000000000000000000000000000000..c59dd1e3646dca456a4d47760d6e83ace0361a4c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_delete_by_id.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_delete_by_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_delete_by_id()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_bucket_delete_by_id (mongoc_gridfs_bucket_t *bucket,
    +                                   const bson_value_t *file_id,
    +                                   bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Deletes a file and its contents from GridFS.

    +
    +
    +

    Returns

    +

    True if the operation succeeded. False otherwise, and sets error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_destroy.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..784934b37ddd4651e248a081e911d65cebc9aec4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_bucket_destroy (mongoc_gridfs_bucket_t *bucket);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Destroys a mongoc_gridfs_bucket_t. Does nothing if passed NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_download_to_stream.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_download_to_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..1383a50629d2dda9d319b5de62cf3400c280a8fd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_download_to_stream.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_download_to_stream() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_download_to_stream()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_bucket_download_to_stream (mongoc_gridfs_bucket_t *bucket,
    +                                         const bson_value_t *file_id,
    +                                         mongoc_stream_t *destination,
    +                                         bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Reads from the GridFS file and writes to the destination stream.

    +

    Writes the full contents of the file to the destination stream. +The destination stream is not closed after calling mongoc_gridfs_bucket_download_to_stream(); call mongoc_stream_close() after.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    True if the operation succeeded. False otherwise, and sets error.

    +
    +

    See also

    +
    +
    mongoc_stream_file_new() and mongoc_stream_file_new_for_path(), which can be used to create a destination stream from a file.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_find.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_find.html new file mode 100644 index 0000000000000000000000000000000000000000..3e951f580c00ceb2a2a322bf7ec3d922b6271bc8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_find.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_find() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_find()

    +
    +

    Synopsis

    +
    mongoc_cursor_t *
    +mongoc_gridfs_bucket_find (mongoc_gridfs_bucket_t *bucket,
    +                           const bson_t *filter,
    +                           const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Finds file documents from the bucket’s files collection.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_cursor_t that must be freed with mongoc_cursor_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_new.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_new.html new file mode 100644 index 0000000000000000000000000000000000000000..944acde39a173afa4a05e60a0c0b625d8e20fdf4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_new.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_new()

    +
    +

    Synopsis

    +
    mongoc_gridfs_bucket_t *
    +mongoc_gridfs_bucket_new (mongoc_database_t *db,
    +                          const bson_t *opts,
    +                          const mongoc_read_prefs_t *read_prefs,
    +                          bson_error_t* error) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    + +
    +
    +

    Description

    +

    Creates a new mongoc_gridfs_bucket_t. Use this handle to perform GridFS operations.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_gridfs_bucket_t that should be freed with mongoc_gridfs_bucket_destroy() or NULL on failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_open_download_stream.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_open_download_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..1bf1e2e5943cb30b7205d427c07431d7aedd1e32 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_open_download_stream.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_open_download_stream() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_open_download_stream()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_gridfs_bucket_open_download_stream (mongoc_gridfs_bucket_t *bucket,
    +                                           const bson_value_t *file_id,
    +                                           bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Opens a stream for reading a file from GridFS.

    +
    +
    +

    Returns

    +

    A mongoc_stream_t that can be read from or NULL on failure. Errors on this stream can be retrieved with mongoc_gridfs_bucket_stream_error().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_open_upload_stream.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_open_upload_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..83b7e156938199e6fe893cbba3b178de7c88d93d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_open_upload_stream.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_open_upload_stream() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_open_upload_stream()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_gridfs_bucket_open_upload_stream (mongoc_gridfs_bucket_t *bucket,
    +                                         const char *filename,
    +                                         const bson_t *opts,
    +                                         bson_value_t *file_id,
    +                                         bson_error_t *error)
    +  BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • chunkSizeBytes: An int32 chunk size to use for this file. Overrides the chunkSizeBytes set on bucket.

    • +
    • metadata: A bson_t representing metadata to include with the file.

    • +
    +
    +
    +

    Description

    +

    Opens a stream for writing to a new file in GridFS. The file id is generated automatically. +To specify an explicit file id, use mongoc_gridfs_bucket_open_upload_stream_with_id().

    +
    +
    +

    Returns

    +

    A mongoc_stream_t that can be written to or NULL on failure. Errors on this stream can be retrieved with mongoc_gridfs_bucket_stream_error(). After calling mongoc_stream_close() the file is completely written in GridFS.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_open_upload_stream_with_id.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_open_upload_stream_with_id.html new file mode 100644 index 0000000000000000000000000000000000000000..f8e8926c9d7af3aa45684083c42f545066053965 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_open_upload_stream_with_id.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_open_upload_stream_with_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_open_upload_stream_with_id()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_gridfs_bucket_open_upload_stream_with_id (mongoc_gridfs_bucket_t *bucket,
    +                                                 const bson_value_t *file_id,
    +                                                 const char *filename,
    +                                                 const bson_t *opts,
    +                                                 bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • chunkSizeBytes: An int32 chunk size to use for this file. Overrides the chunkSizeBytes set on bucket.

    • +
    • metadata: A bson_t representing metadata to include with the file.

    • +
    +
    +
    +

    Description

    +

    Opens a stream for writing to a new file in GridFS for a specified file id. +To have libmongoc generate an id, use mongoc_gridfs_bucket_open_upload_stream().

    +
    +
    +

    Returns

    +

    A mongoc_stream_t that can be written to or NULL on failure. Errors on this stream can be retrieved with mongoc_gridfs_bucket_stream_error(). After calling mongoc_stream_close() the file is completely written in GridFS.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_stream_error.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_stream_error.html new file mode 100644 index 0000000000000000000000000000000000000000..31c908f6daca4012dbecabb29856f816708876d7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_stream_error.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_stream_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_stream_error()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_bucket_stream_error (mongoc_stream_t *stream,
    +                                   bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieves an error for a GridFS stream if one exists.

    +
    +
    +

    Returns

    +

    True if an error occurred on the stream and sets error. False otherwise.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_t.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_t.html new file mode 100644 index 0000000000000000000000000000000000000000..73784d28441f0d58d710a1867ef4d6498e3df33a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_t.html @@ -0,0 +1,333 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_t

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_gridfs_bucket_t mongoc_gridfs_bucket_t;
    +
    +
    +
    +
    +

    Description

    +

    mongoc_gridfs_bucket_t provides a spec-compliant MongoDB GridFS implementation, superseding mongoc_gridfs_t. See the GridFS MongoDB documentation.

    +
    +
    +

    Thread Safety

    +

    mongoc_gridfs_bucket_t is NOT thread-safe and should only be used in the same thread as the owning mongoc_client_t.

    +
    +
    +

    Lifecycle

    +

    It is an error to free a mongoc_gridfs_bucket_t before freeing all derived instances of mongoc_stream_t. The owning mongoc_client_t must outlive the mongoc_gridfs_bucket_t.

    +
    +
    +

    Example

    +
    +
    example-gridfs-bucket.c
    +
    #include <stdio.h>
    +#include <stdlib.h>
    +
    +#include <mongoc/mongoc.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   const char *uri_string =
    +      "mongodb://localhost:27017/?appname=new-gridfs-example";
    +   mongoc_client_t *client;
    +   mongoc_database_t *db;
    +   mongoc_stream_t *file_stream;
    +   mongoc_gridfs_bucket_t *bucket;
    +   mongoc_cursor_t *cursor;
    +   bson_t filter;
    +   bool res;
    +   bson_value_t file_id;
    +   bson_error_t error;
    +   const bson_t *doc;
    +   char *str;
    +   mongoc_init ();
    +
    +   if (argc != 3) {
    +      fprintf (stderr, "usage: %s SOURCE_FILE_PATH FILE_COPY_PATH\n", argv[0]);
    +      return EXIT_FAILURE;
    +   }
    +
    +   /* 1. Make a bucket. */
    +   client = mongoc_client_new (uri_string);
    +   db = mongoc_client_get_database (client, "test");
    +   bucket = mongoc_gridfs_bucket_new (db, NULL, NULL, &error);
    +   if (!bucket) {
    +      printf ("Error creating gridfs bucket: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   /* 2. Insert a file.  */
    +   file_stream = mongoc_stream_file_new_for_path (argv[1], O_RDONLY, 0);
    +   res = mongoc_gridfs_bucket_upload_from_stream (
    +      bucket, "my-file", file_stream, NULL, &file_id, &error);
    +   if (!res) {
    +      printf ("Error uploading file: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_stream_close (file_stream);
    +   mongoc_stream_destroy (file_stream);
    +
    +   /* 3. Download the file in GridFS to a local file. */
    +   file_stream = mongoc_stream_file_new_for_path (argv[2], O_CREAT | O_RDWR, 0);
    +   if (!file_stream) {
    +      perror ("Error opening file stream");
    +      return EXIT_FAILURE;
    +   }
    +
    +   res = mongoc_gridfs_bucket_download_to_stream (
    +      bucket, &file_id, file_stream, &error);
    +   if (!res) {
    +      printf ("Error downloading file to stream: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +   mongoc_stream_close (file_stream);
    +   mongoc_stream_destroy (file_stream);
    +
    +   /* 4. List what files are available in GridFS. */
    +   bson_init (&filter);
    +   cursor = mongoc_gridfs_bucket_find (bucket, &filter, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   /* 5. Delete the file that we added. */
    +   res = mongoc_gridfs_bucket_delete_by_id (bucket, &file_id, &error);
    +   if (!res) {
    +      printf ("Error deleting the file: %s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   /* 6. Cleanup. */
    +   mongoc_stream_close (file_stream);
    +   mongoc_stream_destroy (file_stream);
    +   mongoc_cursor_destroy (cursor);
    +   bson_destroy (&filter);
    +   mongoc_gridfs_bucket_destroy (bucket);
    +   mongoc_database_destroy (db);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +

    See also

    + +
    +
    The non spec-compliant mongoc_gridfs_t.
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_upload_from_stream.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_upload_from_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..e545cc94cea659f52f91dd269aa0a9fe4a62a4b2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_upload_from_stream.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_upload_from_stream() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_upload_from_stream()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_bucket_upload_from_stream (mongoc_gridfs_bucket_t *bucket,
    +                                         const char *filename,
    +                                         mongoc_stream_t *source,
    +                                         const bson_t *opts,
    +                                         bson_value_t *file_id,
    +                                         bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • chunkSizeBytes: An int32 chunk size to use for this file. Overrides the chunkSizeBytes set on bucket.

    • +
    • metadata: A bson_t representing metadata to include with the file.

    • +
    +
    +
    +

    Description

    +

    Reads from the source stream and writes to a new file in GridFS. The file id is generated automatically. +To specify an explicit file id, use mongoc_gridfs_bucket_upload_from_stream_with_id().

    +

    Reads from the source stream using mongoc_stream_read() until the return value indicates end-of-file. +The source stream is not closed after calling mongoc_gridfs_bucket_upload_from_stream(); call mongoc_stream_close() after.

    +
    +
    +

    Returns

    +

    True if the operation succeeded. False otherwise and sets error.

    +
    +

    See also

    +
    +
    mongoc_stream_file_new() and mongoc_stream_file_new_for_path(), which can be used to create a source stream from a file.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_bucket_upload_from_stream_with_id.html b/libmongoc/1.24.0/mongoc_gridfs_bucket_upload_from_stream_with_id.html new file mode 100644 index 0000000000000000000000000000000000000000..be9253f0adc6a43596df3ceb097d11bcb8911396 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_bucket_upload_from_stream_with_id.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_upload_from_stream_with_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_bucket_upload_from_stream_with_id()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_bucket_upload_from_stream_with_id (mongoc_gridfs_bucket_t *bucket,
    +                                                 const bson_value_t *file_id,
    +                                                 const char *filename,
    +                                                 mongoc_stream_t *source,
    +                                                 const bson_t *opts,
    +                                                 bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +

    opts may be NULL or a BSON document with additional command options:

    +
      +
    • chunkSizeBytes: An int32 chunk size to use for this file. Overrides the chunkSizeBytes set on bucket.

    • +
    • metadata: A bson_t representing metadata to include with the file.

    • +
    +
    +
    +

    Description

    +

    Reads from the source stream and writes to a new file in GridFS. +To have libmongoc generate an id, use mongoc_gridfs_bucket_upload_from_stream().

    +

    Reads from the source stream using mongoc_stream_read() until the return value indicates end-of-file. +The source stream is not closed after calling mongoc_gridfs_bucket_upload_from_stream(); call mongoc_stream_close() after.

    +
    +
    +

    Returns

    +

    True if the operation succeeded. False otherwise and sets error.

    +
    +

    See also

    +
    +
    mongoc_stream_file_new() and mongoc_stream_file_new_for_path(), which can be used to create a source stream from a file.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_create_file.html b/libmongoc/1.24.0/mongoc_gridfs_create_file.html new file mode 100644 index 0000000000000000000000000000000000000000..946c43fafebf82dbbc9315874807f56fd375d735 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_create_file.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_gridfs_create_file() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_create_file()

    +
    +

    Synopsis

    +
    mongoc_gridfs_file_t *
    +mongoc_gridfs_create_file (mongoc_gridfs_t *gridfs,
    +                           mongoc_gridfs_file_opt_t *opt)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall create a new mongoc_gridfs_file_t.

    +

    Use mongoc_gridfs_file_writev() to write to the file.

    +
    +
    +

    Returns

    +

    Returns a newly allocated mongoc_gridfs_file_t that should be freed with mongoc_gridfs_file_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_create_file_from_stream.html b/libmongoc/1.24.0/mongoc_gridfs_create_file_from_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..6351cd8440904fa38a49b2fa1f21d6bde379f67f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_create_file_from_stream.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_gridfs_create_file_from_stream() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_create_file_from_stream()

    +
    +

    Synopsis

    +
    mongoc_gridfs_file_t *
    +mongoc_gridfs_create_file_from_stream (mongoc_gridfs_t *gridfs,
    +                                       mongoc_stream_t *stream,
    +                                       mongoc_gridfs_file_opt_t *opt)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall create a new mongoc_gridfs_file_t and fill it with the contents of stream. Note that this function will read from stream until End of File, making it best suited for file-backed streams.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_gridfs_file_t that should be freed with mongoc_gridfs_file_destroy() when no longer in use. +Returns NULL and logs an error message if there is a network or server error writing data to the MongoDB server.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_destroy.html b/libmongoc/1.24.0/mongoc_gridfs_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..a5ed64f7e069f7a8dbc0fc647f240dc3c4178728 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_destroy (mongoc_gridfs_t *gridfs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall destroy the gridfs structure referenced by gridfs and any resources associated with the gridfs. Does nothing if gridfs is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_drop.html b/libmongoc/1.24.0/mongoc_gridfs_drop.html new file mode 100644 index 0000000000000000000000000000000000000000..3c6683ad797be358321941375281e673cefddac7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_drop.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_drop() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_drop()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_drop (mongoc_gridfs_t *gridfs, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Requests that an entire GridFS be dropped, including all files associated with it.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_destroy.html b/libmongoc/1.24.0/mongoc_gridfs_file_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..2dc2940e49d1a19d25e5ff01bc3348763f80a664 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_destroy (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Destroys the mongoc_gridfs_file_t instance and any resources associated with it. Does nothing if file is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_error.html b/libmongoc/1.24.0/mongoc_gridfs_file_error.html new file mode 100644 index 0000000000000000000000000000000000000000..244b698089975bb4e24c05177a0c68db54b8b2b7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_error.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_error()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_file_error (mongoc_gridfs_file_t *file, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function checks to see if there has been an error associated with the last operation upon file.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns false if there has been no registered error, otherwise true and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_aliases.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_aliases.html new file mode 100644 index 0000000000000000000000000000000000000000..940ada9f0f5f8b722427cbc5aab3da445884fa5b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_aliases.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_aliases() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_aliases()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_gridfs_file_get_aliases (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the aliases associated with a gridfs file.

    +
    +
    +

    Returns

    +

    Returns a bson_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_chunk_size.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_chunk_size.html new file mode 100644 index 0000000000000000000000000000000000000000..7a5805cd37a1205c9953e37eef6d0432d8bb0f02 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_chunk_size.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_chunk_size() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_chunk_size()

    +
    +

    Synopsis

    +
    int32_t
    +mongoc_gridfs_file_get_chunk_size (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the chunk size used with the underlying gridfs file.

    +
    +
    +

    Returns

    +

    A signed 32-bit integer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_content_type.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_content_type.html new file mode 100644 index 0000000000000000000000000000000000000000..b2436a21f7651201a0221b7be50d89396a5ed74e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_content_type.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_content_type() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_content_type()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_gridfs_file_get_content_type (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the content type specified for the underlying file.

    +
    +
    +

    Returns

    +

    Returns a string which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_filename.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..07d54a42e384ae7b355c37163debcc1e2924ed1f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_filename.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_filename() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_filename()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_gridfs_file_get_filename (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the filename for the given gridfs file.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_id.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_id.html new file mode 100644 index 0000000000000000000000000000000000000000..7140e33de226c93ce06fa455446708836872e6e6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_id.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_id()

    +
    +

    Synopsis

    +
    const bson_value_t *
    +mongoc_gridfs_file_get_id (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the id of a gridfs file.

    +

    The C Driver always uses an ObjectId for _id, but files created by other drivers may have any type of _id.

    +
    +
    +

    Returns

    +

    Returns a bson_value_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_length.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_length.html new file mode 100644 index 0000000000000000000000000000000000000000..8ff4ccd7f76358685fb64428e20648379b970617 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_length.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_length() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_length()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_gridfs_file_get_length (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the length of the gridfs file in bytes.

    +
    +
    +

    Returns

    +

    A 64-bit signed integer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_md5.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_md5.html new file mode 100644 index 0000000000000000000000000000000000000000..89efcacc2d5e425a07f9fcc05a001d7db676b468 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_md5.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_md5() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_md5()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_gridfs_file_get_md5 (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the pre-computed MD5 for the underlying gridfs file.

    +
    +
    +

    Returns

    +

    Returns a string that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_metadata.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_metadata.html new file mode 100644 index 0000000000000000000000000000000000000000..3903366c57cae840359a7371fb7bf54332e27dfb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_metadata.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_metadata() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_metadata()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_gridfs_file_get_metadata (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a bson document containing the metadata for the gridfs file.

    +
    +
    +

    Returns

    +

    Returns a bson_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_get_upload_date.html b/libmongoc/1.24.0/mongoc_gridfs_file_get_upload_date.html new file mode 100644 index 0000000000000000000000000000000000000000..b8a174da9798c473dd45d6b472310e0c9ce825a9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_get_upload_date.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_upload_date() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_get_upload_date()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_gridfs_file_get_upload_date (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the specified upload date of the gridfs file in milliseconds since the UNIX epoch.

    +
    +
    +

    Returns

    +

    A signed int64 with the upload date in milliseconds since the UNIX epoch.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_list_destroy.html b/libmongoc/1.24.0/mongoc_gridfs_file_list_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..7e22281d1b34893ceb1ab2d877b61a98f5f6a255 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_list_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_list_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_list_destroy (mongoc_gridfs_file_list_t *list);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees a mongoc_gridfs_file_list_t and releases any associated resources. Does nothing if list is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_list_error.html b/libmongoc/1.24.0/mongoc_gridfs_file_list_error.html new file mode 100644 index 0000000000000000000000000000000000000000..a81b9096dce862646ec66ea1e30e8bd4eaea11ce --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_list_error.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_list_error()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_file_list_error (mongoc_gridfs_file_list_t *list,
    +                               bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches any error that has occurred while trying to retrieve the file list.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    false if no error has been registered, otherwise true and error is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_list_next.html b/libmongoc/1.24.0/mongoc_gridfs_file_list_next.html new file mode 100644 index 0000000000000000000000000000000000000000..b4bd06b8ee9e8f763c9e5b848010db0967a18b49 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_list_next.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_next() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_list_next()

    +
    +

    Synopsis

    +
    mongoc_gridfs_file_t *
    +mongoc_gridfs_file_list_next (mongoc_gridfs_file_list_t *list)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall iterate the underlying gridfs file list, returning the next file each iteration. This is a blocking function.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_gridfs_file_t that should be freed with mongoc_gridfs_file_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_list_t.html b/libmongoc/1.24.0/mongoc_gridfs_file_list_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f9683101295bd382a3aaefeae8cf7efe84b1e568 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_list_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_list_t

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_gridfs_file_list_t mongoc_gridfs_file_list_t;
    +
    +
    +
    +
    +

    Description

    +

    mongoc_gridfs_file_list_t provides a gridfs file list abstraction. It provides iteration and basic marshalling on top of a regular mongoc_collection_find_with_opts() style query. In interface, it’s styled after mongoc_cursor_t.

    +
    +
    +

    Example

    +
    mongoc_gridfs_file_list_t *list;
    +mongoc_gridfs_file_t *file;
    +
    +list = mongoc_gridfs_find (gridfs, query);
    +
    +while ((file = mongoc_gridfs_file_list_next (list))) {
    +   do_something (file);
    +
    +   mongoc_gridfs_file_destroy (file);
    +}
    +
    +mongoc_gridfs_file_list_destroy (list);
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_opt_t.html b/libmongoc/1.24.0/mongoc_gridfs_file_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a1ed6b3bec0654a9151a3bd2a91de9f8e6186f8f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_opt_t.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_opt_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_opt_t

    +
    +

    Synopsis

    +
    typedef struct {
    +   const char *md5;
    +   const char *filename;
    +   const char *content_type;
    +   const bson_t *aliases;
    +   const bson_t *metadata;
    +   uint32_t chunk_size;
    +} mongoc_gridfs_file_opt_t;
    +
    +
    +
    +
    +

    Description

    +

    This structure contains options that can be set on a mongoc_gridfs_file_t. It can be used by various functions when creating a new gridfs file.

    +
    +
    +

    Functions

    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_readv.html b/libmongoc/1.24.0/mongoc_gridfs_file_readv.html new file mode 100644 index 0000000000000000000000000000000000000000..a7122b0d79ebbfb06be6daa9df59cdb8d8b8a4c0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_readv.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_readv() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_readv()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_gridfs_file_readv (mongoc_gridfs_file_t *file,
    +                          mongoc_iovec_t *iov,
    +                          size_t iovcnt,
    +                          size_t min_bytes,
    +                          uint32_t timeout_msec);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • file: A mongoc_gridfs_file_t.

    • +
    • iov: An array of mongoc_iovec_t.

    • +
    • iovcnt: The number of elements in iov.

    • +
    • min_bytes: The minimum number of bytes that must be read or an error will be synthesized.

    • +
    • timeout_msec: Unused.

    • +
    +
    +
    +

    Description

    +

    This function performs a scattered read from file, potentially blocking to read from the MongoDB server.

    +

    The timeout_msec parameter is unused.

    +
    +
    +

    Returns

    +

    Returns the number of bytes read, or -1 on failure. Use mongoc_gridfs_file_error() to retrieve error details.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_remove.html b/libmongoc/1.24.0/mongoc_gridfs_file_remove.html new file mode 100644 index 0000000000000000000000000000000000000000..ecb1f7b8ce0404afd008335865039b94a2f79262 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_remove.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_remove() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_remove()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_file_remove (mongoc_gridfs_file_t *file, bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Removes file and its data chunks from the MongoDB server.

    +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_save.html b/libmongoc/1.24.0/mongoc_gridfs_file_save.html new file mode 100644 index 0000000000000000000000000000000000000000..d9722a73b4880cd54d9938cb71f8002823e9da07 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_save.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_save() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_save()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_file_save (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Saves modifications to file to the MongoDB server.

    +

    If an error occurred, false is returned and the error can be retrieved with mongoc_gridfs_file_error().

    +

    Modifying GridFS files is NOT thread-safe. Only one thread or process can access a GridFS file while it is being modified.

    +
    +
    +

    Returns

    +

    Returns true if successful, otherwise false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_seek.html b/libmongoc/1.24.0/mongoc_gridfs_file_seek.html new file mode 100644 index 0000000000000000000000000000000000000000..169df0491c9b46288301feec991ac61249f25708 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_seek.html @@ -0,0 +1,234 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_seek() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_seek()

    +
    +

    Synopsis

    +
    int
    +mongoc_gridfs_file_seek (mongoc_gridfs_file_t *file, int64_t delta, int whence);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • file: A mongoc_gridfs_file_t.

    • +
    • delta: The amount to move the file position. May be positive or negative.

    • +
    • whence: One of SEEK_SET, SEEK_CUR or SEEK_END.

    • +
    +
    +
    +

    Description

    +

    Adjust the file position pointer in the given file by delta, starting from the position whence. The whence argument is interpreted as in fseek(2):

    + + + + + + + + + + + + +

    SEEK_SET

    Set the position relative to the start of the file.

    SEEK_CUR

    Move delta relative to the current file position.

    SEEK_END

    Move delta relative to the end of the file.

    +

    On success, the file’s underlying position pointer is set appropriately. On failure, the file position is NOT changed and errno is set to indicate the error.

    +
    +
    +

    Errors

    + + + + + + + + + +

    EINVAL

    whence is not one of SEEK_SET, SEEK_CUR or SEEK_END.

    EINVAL

    The resulting file position would be negative.

    +
    +
    +

    Returns

    +

    Returns 0 if successful; otherwise -1 and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_set_aliases.html b/libmongoc/1.24.0/mongoc_gridfs_file_set_aliases.html new file mode 100644 index 0000000000000000000000000000000000000000..24d0b93bbfcb5af28ef03fedbe92aa3d0a32d0d3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_set_aliases.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_aliases() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_set_aliases()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_set_aliases (mongoc_gridfs_file_t *file, const bson_t *bson);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the aliases for a gridfs file.

    +

    You need to call mongoc_gridfs_file_save() to persist this change.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_set_content_type.html b/libmongoc/1.24.0/mongoc_gridfs_file_set_content_type.html new file mode 100644 index 0000000000000000000000000000000000000000..ab23eb713a46666b4aa802b0ebfccf1346cc944b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_set_content_type.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_content_type() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_set_content_type()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_set_content_type (mongoc_gridfs_file_t *file,
    +                                     const char *content_type);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the content type for the gridfs file. This should be something like "text/plain".

    +

    You need to call mongoc_gridfs_file_save() to persist this change.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_set_filename.html b/libmongoc/1.24.0/mongoc_gridfs_file_set_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..b6fda4a48f030a2bed4063048cbacd52d23a2e69 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_set_filename.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_filename() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_set_filename()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_set_filename (mongoc_gridfs_file_t *file,
    +                                 const char *filename);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the filename for file.

    +

    You need to call mongoc_gridfs_file_save() to persist this change.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_set_id.html b/libmongoc/1.24.0/mongoc_gridfs_file_set_id.html new file mode 100644 index 0000000000000000000000000000000000000000..9ef8aab382be508ab73d27acd0dee2e2c81cc7d9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_set_id.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_set_id()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_file_set_id (mongoc_gridfs_file_t *file,
    +                           const bson_value_t *id,
    +                           bson_error_t error);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the id of file to any BSON type.

    +

    If an error occurred, false is returned.

    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_set_md5.html b/libmongoc/1.24.0/mongoc_gridfs_file_set_md5.html new file mode 100644 index 0000000000000000000000000000000000000000..c5c9cab587ab9cc8f41a249199ec7985afcac514 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_set_md5.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_md5() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_set_md5()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_set_md5 (mongoc_gridfs_file_t *file, const char *md5);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the MD5 checksum for file.

    +

    You need to call mongoc_gridfs_file_save() to persist this change.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_set_metadata.html b/libmongoc/1.24.0/mongoc_gridfs_file_set_metadata.html new file mode 100644 index 0000000000000000000000000000000000000000..87bab267eff6ee6d7763bbaecf65342747a004dd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_set_metadata.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_metadata() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_set_metadata()

    +
    +

    Synopsis

    +
    void
    +mongoc_gridfs_file_set_metadata (mongoc_gridfs_file_t *file,
    +                                 const bson_t *metadata);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the metadata associated with file.

    +

    You need to call mongoc_gridfs_file_save() to persist this change.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_t.html b/libmongoc/1.24.0/mongoc_gridfs_file_t.html new file mode 100644 index 0000000000000000000000000000000000000000..8b3e177219a0b825a0145791bac3b797132d955e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_t.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_gridfs_file_t mongoc_gridfs_file_t;
    +
    +
    +
    +
    +

    Description

    +

    This structure provides a MongoDB GridFS file abstraction. It provides several APIs.

    +
      +
    • readv, writev, seek, and tell.

    • +
    • General file metadata such as filename and length.

    • +
    • GridFS metadata such as md5, filename, content_type, aliases, metadata, chunk_size, and upload_date.

    • +
    +
    +
    +

    Thread Safety

    +

    This structure is NOT thread-safe and should only be used from one thread at a time.

    +
    +
    +

    Functions

    + +
    + +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_tell.html b/libmongoc/1.24.0/mongoc_gridfs_file_tell.html new file mode 100644 index 0000000000000000000000000000000000000000..8608685ff490cef166cdda005ab2356dee73e00b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_tell.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_tell() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_tell()

    +
    +

    Synopsis

    +
    uint64_t
    +mongoc_gridfs_file_tell (mongoc_gridfs_file_t *file);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function returns the current position indicator within file.

    +
    +
    +

    Returns

    +

    Returns a file position as an unsigned 64-bit integer.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_file_writev.html b/libmongoc/1.24.0/mongoc_gridfs_file_writev.html new file mode 100644 index 0000000000000000000000000000000000000000..c832ef3c2e799ffc7e36781bc9633b4920cb8845 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_file_writev.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_writev() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_file_writev()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_gridfs_file_writev (mongoc_gridfs_file_t *file,
    +                           const mongoc_iovec_t *iov,
    +                           size_t iovcnt,
    +                           uint32_t timeout_msec);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a gathered write to the underlying gridfs file.

    +

    The timeout_msec parameter is unused.

    +

    Modifying GridFS files is NOT thread-safe. Only one thread or process can access a GridFS file while it is being modified.

    +
    +
    +

    Returns

    +

    Returns the number of bytes written, or -1 on failure. Use mongoc_gridfs_file_error() to retrieve error details.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_find.html b/libmongoc/1.24.0/mongoc_gridfs_find.html new file mode 100644 index 0000000000000000000000000000000000000000..410f0d0141e9416afea7a76b49a4903792ee0b8f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_find.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_gridfs_find() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_find()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.5.0: This function is deprecated, use mongoc_gridfs_find_with_opts() instead.

    +
    +
    +
    +

    Synopsis

    +
    mongoc_gridfs_file_list_t *
    +mongoc_gridfs_find (mongoc_gridfs_t *gridfs,
    +                    const bson_t *query) BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_gridfs_find_with_opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Finds all gridfs files matching query. You can iterate the matched gridfs files with the resulting file list.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_gridfs_file_list_t that should be freed with mongoc_gridfs_file_list_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_find_one.html b/libmongoc/1.24.0/mongoc_gridfs_find_one.html new file mode 100644 index 0000000000000000000000000000000000000000..012e3b1f720c04da9d7473a222253d7ba85a7922 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_find_one.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_one() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_find_one()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.5.0: This function is deprecated, use mongoc_gridfs_find_one_with_opts() instead.

    +
    +
    +
    +

    Synopsis

    +
    mongoc_gridfs_file_t *
    +mongoc_gridfs_find_one (mongoc_gridfs_t *gridfs,
    +                        const bson_t *query,
    +                        bson_error_t *error) BSON_GNUC_WARN_UNUSED_RESULT
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_gridfs_find_one_with_opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall execute a query on the underlying gridfs implementation. The first file matching query will be returned. If there is an error, NULL is returned and error is filled out; if there is no error but no matching file is found, NULL is returned and the error code and domain are 0.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_gridfs_file_t or NULL if no file could be found. You must free the resulting file with mongoc_gridfs_file_destroy() if non-NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_find_one_by_filename.html b/libmongoc/1.24.0/mongoc_gridfs_find_one_by_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..d65c89a582f9ae38ec5675c55654036984ad30d0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_find_one_by_filename.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_one_by_filename() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_find_one_by_filename()

    +
    +

    Synopsis

    +
    mongoc_gridfs_file_t *
    +mongoc_gridfs_find_one_by_filename (mongoc_gridfs_t *gridfs,
    +                                    const char *filename,
    +                                    bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • gridfs: A mongoc_gridfs_t.

    • +
    • filename: A UTF-8 encoded string containing the filename.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    Finds the first file matching the filename specified. If there is an error, NULL is returned and error is filled out; if there is no error but no matching file is found, NULL is returned and the error code and domain are 0.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns a newly allocated mongoc_gridfs_file_t if successful. You must free the resulting file with mongoc_gridfs_file_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_find_one_with_opts.html b/libmongoc/1.24.0/mongoc_gridfs_find_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..21041d95dc0229e7c35a40fc5014273a69a618eb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_find_one_with_opts.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_one_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_find_one_with_opts()

    +
    +

    Synopsis

    +
    mongoc_gridfs_file_t *
    +mongoc_gridfs_find_one_with_opts (mongoc_gridfs_t *gridfs,
    +                                  const bson_t *filter,
    +                                  const bson_t *opts,
    +                                  bson_error_t *error)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • gridfs: A mongoc_gridfs_t.

    • +
    • filter: A bson_t containing the query to execute.

    • +
    • opts: A bson_t query options, including sort order and which fields to return. Can be NULL.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    Find the first GridFS file matching filter. If there is an error, NULL is returned and error is filled out; if there is no error but no matching file is found, NULL is returned and the error code and domain are 0.

    +

    See mongoc_collection_find_with_opts() for a description of the filter and opts parameters.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    +

    Returns

    +

    Returns a newly allocated mongoc_gridfs_file_t if successful. You must free the resulting file with mongoc_gridfs_file_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_find_with_opts.html b/libmongoc/1.24.0/mongoc_gridfs_find_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..afeec4ef18474c2d44ab66f78aef893dab1d57bf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_find_with_opts.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_with_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_find_with_opts()

    +
    +

    Synopsis

    +
    mongoc_gridfs_file_list_t *
    +mongoc_gridfs_find_with_opts (mongoc_gridfs_t *gridfs,
    +                              const bson_t *filter,
    +                              const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • gridfs: A mongoc_gridfs_t.

    • +
    • filter: A bson_t containing the query to execute.

    • +
    • opts: A bson_t query options, including sort order and which fields to return. Can be NULL.

    • +
    +
    +
    +

    Description

    +

    Finds all gridfs files matching filter. You can iterate the matched gridfs files with the resulting file list.

    +

    See mongoc_collection_find_with_opts() for a description of the filter and opts parameters.

    +

    This function is considered a retryable read operation. +Upon a transient error (a network error, errors due to replica set failover, etc.) the operation is safely retried once. +If retryreads is false in the URI (see mongoc_uri_t) the retry behavior does not apply.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_gridfs_file_list_t that should be freed with mongoc_gridfs_file_list_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_get_chunks.html b/libmongoc/1.24.0/mongoc_gridfs_get_chunks.html new file mode 100644 index 0000000000000000000000000000000000000000..96fe0e628607a5f14cdf5515cb8cabe9ddd4936c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_get_chunks.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_get_chunks() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_get_chunks()

    +
    +

    Synopsis

    +
    mongoc_collection_t *
    +mongoc_gridfs_get_chunks (mongoc_gridfs_t *gridfs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns a mongoc_collection_t that contains the chunks for files. This instance is owned by the mongoc_gridfs_t instance and should not be modified or freed.

    +
    +
    +

    Returns

    +

    Returns a mongoc_collection_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_get_files.html b/libmongoc/1.24.0/mongoc_gridfs_get_files.html new file mode 100644 index 0000000000000000000000000000000000000000..8f7e407524f46713a06b5121d81fe55011a3aa45 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_get_files.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_get_files() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_get_files()

    +
    +

    Synopsis

    +
    mongoc_collection_t *
    +mongoc_gridfs_get_files (mongoc_gridfs_t *gridfs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Retrieves the mongoc_collection_t containing the file metadata for GridFS. This instance is owned by the mongoc_gridfs_t and should not be modified or freed.

    +
    +
    +

    Returns

    +

    Returns a mongoc_collection_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_remove_by_filename.html b/libmongoc/1.24.0/mongoc_gridfs_remove_by_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..e14a8ebaf21904c8824fda35e53659e16c8a43bc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_remove_by_filename.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_gridfs_remove_by_filename() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_remove_by_filename()

    +
    +

    Synopsis

    +
    bool
    +mongoc_gridfs_remove_by_filename (mongoc_gridfs_t *gridfs,
    +                                  const char *filename,
    +                                  bson_error_t *error);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • gridfs: A mongoc_gridfs_t.

    • +
    • filename: A UTF-8 encoded string containing the filename.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    Removes all files matching filename and their data chunks from the MongoDB server.

    +
    +
    +

    Returns

    +

    Returns true if successful, including when no files match. Returns false and sets error if there are invalid arguments or a server or network error.

    +
    +
    +

    Errors

    +

    Errors are propagated via the error parameter.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_gridfs_t.html b/libmongoc/1.24.0/mongoc_gridfs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..757d258c475cc4117a7a135feacdac8ae39ee98d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_gridfs_t.html @@ -0,0 +1,403 @@ + + + + + + + + + + + + + + mongoc_gridfs_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_gridfs_t

    +
    +

    Warning

    +

    This GridFS implementation does not conform to the MongoDB GridFS specification. For a spec compliant implementation, use mongoc_gridfs_bucket_t.

    +
    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_gridfs_t mongoc_gridfs_t;
    +
    +
    +
    +
    +

    Description

    +

    mongoc_gridfs_t provides a MongoDB gridfs implementation. The system as a whole is made up of gridfs objects, which contain gridfs_files and gridfs_file_lists. Essentially, a basic file system API.

    +

    There are extensive caveats about the kind of use cases gridfs is practical for. In particular, any writing after initial file creation is likely to both break any concurrent readers and be quite expensive. That said, this implementation does allow for arbitrary writes to existing gridfs object, just use them with caution.

    +

    mongoc_gridfs also integrates tightly with the mongoc_stream_t abstraction, which provides some convenient wrapping for file creation and reading/writing. It can be used without, but its worth looking to see if your problem can fit that model.

    +
    +

    Warning

    +

    mongoc_gridfs_t does not support read preferences. In a replica set, GridFS queries are always routed to the primary.

    +
    +
    +
    +

    Thread Safety

    +

    mongoc_gridfs_t is NOT thread-safe and should only be used in the same thread as the owning mongoc_client_t.

    +
    +
    +

    Lifecycle

    +

    It is an error to free a mongoc_gridfs_t before freeing all related instances of mongoc_gridfs_file_t and mongoc_gridfs_file_list_t.

    +
    +
    +

    Example

    +
    +
    example-gridfs.c
    +
    #include <assert.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +#include <stdlib.h>
    +#include <fcntl.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_gridfs_t *gridfs;
    +   mongoc_gridfs_file_t *file;
    +   mongoc_gridfs_file_list_t *list;
    +   mongoc_gridfs_file_opt_t opt = {0};
    +   mongoc_client_t *client;
    +   const char *uri_string = "mongodb://127.0.0.1:27017/?appname=gridfs-example";
    +   mongoc_uri_t *uri;
    +   mongoc_stream_t *stream;
    +   bson_t filter;
    +   bson_t opts;
    +   bson_t child;
    +   bson_error_t error;
    +   ssize_t r;
    +   char buf[4096];
    +   mongoc_iovec_t iov;
    +   const char *filename;
    +   const char *command;
    +   bson_value_t id;
    +
    +   if (argc < 2) {
    +      fprintf (stderr, "usage - %s command ...\n", argv[0]);
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_init ();
    +
    +   iov.iov_base = (void *) buf;
    +   iov.iov_len = sizeof buf;
    +
    +   /* connect to localhost client */
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   assert (client);
    +   mongoc_client_set_error_api (client, 2);
    +
    +   /* grab a gridfs handle in test prefixed by fs */
    +   gridfs = mongoc_client_get_gridfs (client, "test", "fs", &error);
    +   assert (gridfs);
    +
    +   command = argv[1];
    +   filename = argv[2];
    +
    +   if (strcmp (command, "read") == 0) {
    +      if (argc != 3) {
    +         fprintf (stderr, "usage - %s read filename\n", argv[0]);
    +         return EXIT_FAILURE;
    +      }
    +      file = mongoc_gridfs_find_one_by_filename (gridfs, filename, &error);
    +      assert (file);
    +
    +      stream = mongoc_stream_gridfs_new (file);
    +      assert (stream);
    +
    +      for (;;) {
    +         r = mongoc_stream_readv (stream, &iov, 1, -1, 0);
    +
    +         assert (r >= 0);
    +
    +         if (r == 0) {
    +            break;
    +         }
    +
    +         if (fwrite (iov.iov_base, 1, r, stdout) != r) {
    +            MONGOC_ERROR ("Failed to write to stdout. Exiting.\n");
    +            exit (1);
    +         }
    +      }
    +
    +      mongoc_stream_destroy (stream);
    +      mongoc_gridfs_file_destroy (file);
    +   } else if (strcmp (command, "list") == 0) {
    +      bson_init (&filter);
    +
    +      bson_init (&opts);
    +      bson_append_document_begin (&opts, "sort", -1, &child);
    +      BSON_APPEND_INT32 (&child, "filename", 1);
    +      bson_append_document_end (&opts, &child);
    +
    +      list = mongoc_gridfs_find_with_opts (gridfs, &filter, &opts);
    +
    +      bson_destroy (&filter);
    +      bson_destroy (&opts);
    +
    +      while ((file = mongoc_gridfs_file_list_next (list))) {
    +         const char *name = mongoc_gridfs_file_get_filename (file);
    +         printf ("%s\n", name ? name : "?");
    +
    +         mongoc_gridfs_file_destroy (file);
    +      }
    +
    +      mongoc_gridfs_file_list_destroy (list);
    +   } else if (strcmp (command, "write") == 0) {
    +      if (argc != 4) {
    +         fprintf (stderr, "usage - %s write filename input_file\n", argv[0]);
    +         return EXIT_FAILURE;
    +      }
    +
    +      stream = mongoc_stream_file_new_for_path (argv[3], O_RDONLY, 0);
    +      assert (stream);
    +
    +      opt.filename = filename;
    +
    +      /* the driver generates a file_id for you */
    +      file = mongoc_gridfs_create_file_from_stream (gridfs, stream, &opt);
    +      assert (file);
    +
    +      id.value_type = BSON_TYPE_INT32;
    +      id.value.v_int32 = 1;
    +
    +      /* optional: the following method specifies a file_id of any
    +         BSON type */
    +      if (!mongoc_gridfs_file_set_id (file, &id, &error)) {
    +         fprintf (stderr, "%s\n", error.message);
    +         return EXIT_FAILURE;
    +      }
    +
    +      if (!mongoc_gridfs_file_save (file)) {
    +         mongoc_gridfs_file_error (file, &error);
    +         fprintf (stderr, "Could not save: %s\n", error.message);
    +         return EXIT_FAILURE;
    +      }
    +
    +      mongoc_gridfs_file_destroy (file);
    +   } else {
    +      fprintf (stderr, "Unknown command");
    +      return EXIT_FAILURE;
    +   }
    +
    +   mongoc_gridfs_destroy (gridfs);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +

    See also

    + +
    +
    The spec-compliant mongoc_gridfs_bucket_t.
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_handshake_data_append.html b/libmongoc/1.24.0/mongoc_handshake_data_append.html new file mode 100644 index 0000000000000000000000000000000000000000..62f25a192a9d37a9a7828211496dd88e41ba7702 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_handshake_data_append.html @@ -0,0 +1,255 @@ + + + + + + + + + + + + + + mongoc_handshake_data_append() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_handshake_data_append()

    +
    +

    Synopsis

    +
    bool
    +mongoc_handshake_data_append (const char *driver_name,
    +                              const char *driver_version,
    +                              const char *platform);
    +
    +
    +

    Appends the given strings to the handshake data for the underlying C Driver.

    +
    +
    +

    Description

    +

    This function is intended for use by drivers which wrap the C Driver. +Calling this function will store the given strings as handshake data about +the system and driver by appending them to the handshake data for the +underlying C Driver. These values, along with other handshake data collected +during mongoc_init will be sent to the server as part of the initial +connection handshake in the “client” document. This function must not be +called more than once, or after server monitoring begins. For a single-threaded +mongoc_client_t, server monitoring begins on the first operation +requiring a server. For a mongoc_client_pool_t, server monitoring +begins on the first call to :symbol:`mongoc_client_pool_pop.

    +

    The passed in strings are copied, and don’t have to remain valid after the +call to mongoc_handshake_data_append(). The driver may store truncated +versions of the passed in strings.

    +
    +

    Note

    +

    This function allocates memory, and therefore caution should be used when +using this in conjunction with bson_mem_set_vtable(). If this function is +called before bson_mem_set_vtable(), then bson_mem_restore_vtable() must be +called before calling mongoc_cleanup(). Failure to do so will result in +memory being freed by the wrong allocator.

    +
    +
    +
    +

    Parameters

    +
      +
    • driver_name: An optional string storing the name of the wrapping driver

    • +
    • driver_version: An optional string storing the version of the wrapping driver.

    • +
    • platform: An optional string storing any information about the current platform, for example configure options or compile flags.

    • +
    +
    +
    +

    Returns

    +

    true if the given fields are set successfully. Otherwise, it returns false and logs an error.

    +

    The default handshake data the driver sends with “hello” looks something +like:

    +
    client: {
    +  driver: {
    +    name: "mongoc",
    +    version: "1.5.0"
    +  },
    +  os: {...},
    +  platform: "CC=gcc CFLAGS=-Wall -pedantic"
    +}
    +
    +
    +

    If we call +mongoc_handshake_data_append() (“phongo”, “1.1.8”, “CC=clang / “) +and it returns true, the driver sends handshake data like:

    +
    client: {
    +  driver: {
    +    name: "mongoc / phongo",
    +    version: "1.5.0 / 1.1.8"
    +  },
    +  os: {...},
    +  platform: "CC=clang / gcc CFLAGS=-Wall -pedantic"
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_host_list_t.html b/libmongoc/1.24.0/mongoc_host_list_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b7e2e702a777c8dc46bede43fc58cea43bd03ef1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_host_list_t.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_host_list_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_host_list_t

    +
    +

    Synopsis

    +
    typedef struct {
    +   mongoc_host_list_t *next;
    +   char host[BSON_HOST_NAME_MAX + 1];
    +   char host_and_port[BSON_HOST_NAME_MAX + 7];
    +   uint16_t port;
    +   int family;
    +   void *padding[4];
    +} mongoc_host_list_t;
    +
    +
    +
    +
    +

    Description

    +

    The host and port of a MongoDB server. Can be part of a linked list: for example the return value of mongoc_uri_get_hosts() when multiple hosts are provided in the MongoDB URI.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_geo_get_default.html b/libmongoc/1.24.0/mongoc_index_opt_geo_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..65eb18bda487723a41a0a2e5d12b3263f03ce5eb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_geo_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_index_opt_geo_get_default() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_geo_get_default()

    +
    +

    Synopsis

    +
    const mongoc_index_opt_geo_t *
    +mongoc_index_opt_geo_get_default (void) BSON_GNUC_PURE;
    +
    +
    +
    +
    +

    Returns

    +

    Returns a pointer to the default GEO index creation options.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_geo_init.html b/libmongoc/1.24.0/mongoc_index_opt_geo_init.html new file mode 100644 index 0000000000000000000000000000000000000000..e885da5b6afcdba2ff96f0e0009798acb2b18077 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_geo_init.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_index_opt_geo_init() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_geo_init()

    +
    +

    Synopsis

    +
    void
    +mongoc_index_opt_geo_init (mongoc_index_opt_geo_t *opt);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function will initialize opt to the default values. It should be called before modifying any fields within the structure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_geo_t.html b/libmongoc/1.24.0/mongoc_index_opt_geo_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ddb6f13585c87dddcd17c476c392e804be8d6223 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_geo_t.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_index_opt_geo_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_geo_t

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct {
    +   uint8_t twod_sphere_version;
    +   uint8_t twod_bits_precision;
    +   double twod_location_min;
    +   double twod_location_max;
    +   double haystack_bucket_size;
    +   uint8_t *padding[32];
    +} mongoc_index_opt_geo_t;
    +
    +
    +
    +
    +

    Description

    +

    This structure contains the options that may be used for tuning a GEO index.

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_get_default.html b/libmongoc/1.24.0/mongoc_index_opt_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..15433638ee660c7f5552b83b84fffdcfea43caf6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_index_opt_get_default() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_get_default()

    +
    +

    Synopsis

    +
    const mongoc_index_opt_t *
    +mongoc_index_opt_get_default (void) BSON_GNUC_PURE;
    +
    +
    +
    +
    +

    Returns

    +

    Returns a pointer to the default index creation options.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_init.html b/libmongoc/1.24.0/mongoc_index_opt_init.html new file mode 100644 index 0000000000000000000000000000000000000000..cae57b1638efa4c0025664b1a930c7500cb5b7bc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_init.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_index_opt_init() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_init()

    +
    +

    Synopsis

    +
    void
    +mongoc_index_opt_init (mongoc_index_opt_t *opt);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function will initialize opt to the default values. It should be called before modifying any fields within the structure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_t.html b/libmongoc/1.24.0/mongoc_index_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c5abc44f8352ef0aef50cdf89f0406b8dec23635 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_t.html @@ -0,0 +1,270 @@ + + + + + + + + + + + + + + mongoc_index_opt_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_t

    +
    +

    Warning

    +
    +

    Deprecated since version 1.8.0: This structure is deprecated and should not be used in new code. See Manage Collection Indexes.

    +
    +
    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct {
    +   bool is_initialized;
    +   bool background;
    +   bool unique;
    +   const char *name;
    +   bool drop_dups;
    +   bool sparse;
    +   int32_t expire_after_seconds;
    +   int32_t v;
    +   const bson_t *weights;
    +   const char *default_language;
    +   const char *language_override;
    +   mongoc_index_opt_geo_t *geo_options;
    +   mongoc_index_opt_storage_t *storage_options;
    +   const bson_t *partial_filter_expression;
    +   const bson_t *collation;
    +   void *padding[4];
    +} mongoc_index_opt_t;
    +
    +
    +
    +
    +

    Description

    +

    This structure contains the options that may be used for tuning a specific index.

    +

    See the createIndexes documentations in the MongoDB manual for descriptions of individual options.

    +
    +

    Note

    +

    dropDups is deprecated as of MongoDB version 3.0.0. This option is silently ignored by the server and unique index builds using this option will fail if a duplicate value is detected.

    +
    +
    +
    +

    Example

    +
    {
    +   bson_t keys;
    +   bson_error_t error;
    +   mongoc_index_opt_t opt;
    +   mongoc_index_opt_geo_t geo_opt;
    +
    +   mongoc_index_opt_init (&opt);
    +   mongoc_index_opt_geo_init (&geo_opt);
    +
    +   bson_init (&keys);
    +   BSON_APPEND_UTF8 (&keys, "location", "2d");
    +
    +   geo_opt.twod_location_min = -123;
    +   geo_opt.twod_location_max = +123;
    +   geo_opt.twod_bits_precision = 30;
    +   opt.geo_options = &geo_opt;
    +
    +   collection = mongoc_client_get_collection (client, "test", "geo_test");
    +   if (mongoc_collection_create_index (collection, &keys, &opt, &error)) {
    +      /* Successfully created the geo index */
    +   }
    +   bson_destroy (&keys);
    +   mongoc_collection_destroy (&collection);
    +}
    +
    +
    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_wt_get_default.html b/libmongoc/1.24.0/mongoc_index_opt_wt_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..d4cdbf7e1c0bc9660d5e7362ffce13798e1d8b69 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_wt_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_index_opt_wt_get_default() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_wt_get_default()

    +
    +

    Synopsis

    +
    const mongoc_index_opt_wt_t *
    +mongoc_index_opt_wt_get_default (void) BSON_GNUC_PURE;
    +
    +
    +
    +
    +

    Returns

    +

    Returns a pointer to the default WiredTiger index creation options.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_wt_init.html b/libmongoc/1.24.0/mongoc_index_opt_wt_init.html new file mode 100644 index 0000000000000000000000000000000000000000..b004d2fae79cf2a67e2063310e39057d480308c0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_wt_init.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_index_opt_wt_init() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_wt_init()

    +
    +

    Synopsis

    +
    void
    +mongoc_index_opt_wt_init (mongoc_index_opt_wt_t *opt);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function will initialize opt to the default values. It should be called before modifying any fields within the structure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_index_opt_wt_t.html b/libmongoc/1.24.0/mongoc_index_opt_wt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..20e789aad89e5b519142a6ece51400a5e13b9669 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_index_opt_wt_t.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_index_opt_wt_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_index_opt_wt_t

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct {
    +   mongoc_index_opt_storage_t base;
    +   const char *config_str;
    +   void *padding[8];
    +} mongoc_index_opt_wt_t;
    +
    +
    +
    +
    +

    Description

    +

    This structure contains the options that may be used for tuning a WiredTiger specific index.

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_init.html b/libmongoc/1.24.0/mongoc_init.html new file mode 100644 index 0000000000000000000000000000000000000000..ae7a804e7b5755ad1325822f8c26f42afa4b55d6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_init.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_init() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_init()

    +
    +

    Synopsis

    +
    void
    +mongoc_init (void);
    +
    +
    +
    +
    +

    Description

    +

    Initialize the MongoDB C Driver by calling mongoc_init() exactly once at the beginning of your program. It is responsible for initializing global state such as process counters, SSL, and threading primitives.

    +

    Exception to this is mongoc_log_set_handler(), which should be called before mongoc_init() or some log traces would not use your log handling function. See Custom Log Handlers for a detailed example.

    +

    Call mongoc_cleanup() exactly once at the end of your program to release all memory and other resources allocated by the driver. You must not call any other MongoDB C Driver functions after mongoc_cleanup(). Note that mongoc_init() does not reinitialize the driver after mongoc_cleanup().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_insert_flags_t.html b/libmongoc/1.24.0/mongoc_insert_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..df3034743bf6420047191d6d9cb673cf3bf1b49e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_insert_flags_t.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_insert_flags_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_insert_flags_t

    +

    Flags for insert operations

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_INSERT_NONE = 0,
    +   MONGOC_INSERT_CONTINUE_ON_ERROR = 1 << 0,
    +} mongoc_insert_flags_t;
    +
    +#define MONGOC_INSERT_NO_VALIDATE (1U << 31)
    +
    +
    +
    +
    +

    Description

    +

    These flags correspond to the MongoDB wire protocol. They may be bitwise or’d together. They may modify how an insert happens on the MongoDB server.

    +
    +
    +

    Flag Values

    + + + + + + + + + + + + +

    MONGOC_INSERT_NONE

    Specify no insert flags.

    MONGOC_INSERT_CONTINUE_ON_ERROR

    Continue inserting documents from the insertion set even if one insert fails.

    MONGOC_INSERT_NO_VALIDATE

    Do not validate insertion documents before performing an insert. Validation can be expensive, so this can save some time if you know your documents are already valid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_iovec_t.html b/libmongoc/1.24.0/mongoc_iovec_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2413394c3e004b0835d18afc4a8deea8a0e52385 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_iovec_t.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_iovec_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_iovec_t

    +
    +

    Synopsis

    +
    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +#ifdef _WIN32
    +typedef struct {
    +   u_long iov_len;
    +   char *iov_base;
    +} mongoc_iovec_t;
    +#else
    +typedef struct iovec mongoc_iovec_t;
    +#endif
    +
    +
    +

    The mongoc_iovec_t structure is a portability abstraction for consumers of the mongoc_stream_t interfaces. It allows for scatter/gather I/O through the socket subsystem.

    +
    +

    Warning

    +

    When writing portable code, beware of the ordering of iov_len and iov_base as they are different on various platforms. Therefore, you should not use C initializers for initialization.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_optional_copy.html b/libmongoc/1.24.0/mongoc_optional_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..ccf6c66e5ef0f3e2073bee701c7e2500525bc389 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_optional_copy.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_optional_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_copy()

    +
    +

    Synopsis

    +
    void
    +mongoc_optional_copy (const mongoc_optional_t *source, mongoc_optional_t *copy);
    +
    +
    +

    Creates a deep copy of source into copy.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_optional_init.html b/libmongoc/1.24.0/mongoc_optional_init.html new file mode 100644 index 0000000000000000000000000000000000000000..ee8c9a7370fa4cb255f52acb29103013335f32c9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_optional_init.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_optional_init() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_init()

    +
    +

    Synopsis

    +
    void
    +mongoc_optional_init (mongoc_optional_t *opt);
    +
    +
    +

    Initializes values for a mongoc_optional_t.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_optional_is_set.html b/libmongoc/1.24.0/mongoc_optional_is_set.html new file mode 100644 index 0000000000000000000000000000000000000000..c7e7b1d07f4bd1cd9c19ff4ad680d75035970568 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_optional_is_set.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_optional_is_set() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_is_set()

    +
    +

    Synopsis

    +
    bool
    +mongoc_optional_is_set (const mongoc_optional_t *opt);
    +
    +
    +

    Returns whether a value for a mongoc_optional_t was set.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if a value was set, or false otherwise.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_optional_set_value.html b/libmongoc/1.24.0/mongoc_optional_set_value.html new file mode 100644 index 0000000000000000000000000000000000000000..b57d7796ce6fdf9af07be5ca33b1fea141446a5a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_optional_set_value.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_optional_set_value() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_set_value()

    +
    +

    Synopsis

    +
    void
    +mongoc_optional_set_value (mongoc_optional_t *opt);
    +
    +
    +

    Sets a value on a mongoc_optional_t. Once a value has been set, it cannot be unset, i.e. mongoc_optional_is_set will always return true after calling mongoc_optional_set_value.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_optional_t.html b/libmongoc/1.24.0/mongoc_optional_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c5163a71f9828678385e0b46034c843b15944983 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_optional_t.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_optional_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_t

    +

    A struct to store optional boolean values.

    +
    +

    Synopsis

    +

    Used to specify optional boolean flags, which may remain unset.

    +

    This is used within mongoc_server_api_t to track whether a flag was explicitly set.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_optional_value.html b/libmongoc/1.24.0/mongoc_optional_value.html new file mode 100644 index 0000000000000000000000000000000000000000..2c62fdb9e178a190738f7a8e33c7c5ee7f46a99c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_optional_value.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_optional_value() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_value()

    +
    +

    Synopsis

    +
    bool
    +mongoc_optional_value (const mongoc_optional_t *opt);
    +
    +
    +

    Returns the value for a mongoc_optional_t.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns the value that was set on the mongoc_optional_t. If no value was set, false is returned.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_query_flags_t.html b/libmongoc/1.24.0/mongoc_query_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..6974a8de5d58bf49354472f9cfe8d38c66522183 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_query_flags_t.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_query_flags_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_query_flags_t

    +

    Flags for query operations

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_QUERY_NONE = 0,
    +   MONGOC_QUERY_TAILABLE_CURSOR = 1 << 1,
    +   MONGOC_QUERY_SECONDARY_OK = 1 << 2,
    +   MONGOC_QUERY_OPLOG_REPLAY = 1 << 3,
    +   MONGOC_QUERY_NO_CURSOR_TIMEOUT = 1 << 4,
    +   MONGOC_QUERY_AWAIT_DATA = 1 << 5,
    +   MONGOC_QUERY_EXHAUST = 1 << 6,
    +   MONGOC_QUERY_PARTIAL = 1 << 7,
    +} mongoc_query_flags_t;
    +
    +
    +
    +
    +

    Description

    +

    These flags correspond to the MongoDB wire protocol. They may be bitwise or’d together. They may modify how a query is performed in the MongoDB server.

    +
    +
    +

    Flag Values

    + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    MONGOC_QUERY_NONE

    Specify no query flags.

    MONGOC_QUERY_TAILABLE_CURSOR

    Cursor will not be closed when the last data is retrieved. You can resume this cursor later.

    MONGOC_QUERY_SECONDARY_OK

    Allow query of replica set secondaries.

    MONGOC_QUERY_OPLOG_REPLAY

    Used internally by MongoDB.

    MONGOC_QUERY_NO_CURSOR_TIMEOUT

    The server normally times out an idle cursor after an inactivity period (10 minutes). This prevents that.

    MONGOC_QUERY_AWAIT_DATA

    Use with MONGOC_QUERY_TAILABLE_CURSOR. Block rather than returning no data. After a period, time out.

    MONGOC_QUERY_EXHAUST

    Stream the data down full blast in multiple “reply” packets. Faster when you are pulling down a lot of data and you know you want to retrieve it all. +Only applies to cursors created from a find operation (i.e. mongoc_collection_find()).

    MONGOC_QUERY_PARTIAL

    Get partial results from mongos if some shards are down (instead of throwing an error).

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_rand.html b/libmongoc/1.24.0/mongoc_rand.html new file mode 100644 index 0000000000000000000000000000000000000000..39f180c7aff99bf70ca821c5c3a3be58d0fb2832 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_rand.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_rand — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_rand

    +

    MongoDB Random Number Generator

    +
    +

    Synopsis

    +
    void
    +mongoc_rand_add (const void *buf, int num, double entropy);
    +
    +void
    +mongoc_rand_seed (const void *buf, int num);
    +
    +int
    +mongoc_rand_status (void);
    +
    +
    +
    +
    +

    Description

    +

    The mongoc_rand family of functions provide access to the low level randomness primitives used by the MongoDB C Driver. In particular, they control the creation of cryptographically strong pseudo-random bytes required by some security mechanisms.

    +

    While we can usually pull enough entropy from the environment, you may be required to seed the PRNG manually depending on your OS, hardware and other entropy consumers running on the same system.

    +
    +
    +

    Entropy

    +

    mongoc_rand_add and mongoc_rand_seed allow the user to directly provide entropy. They differ insofar as mongoc_rand_seed requires that each bit provided is fully random. mongoc_rand_add allows the user to specify the degree of randomness in the provided bytes as well.

    +
    +
    +

    Status

    +

    The mongoc_rand_status function allows the user to check the status of the mongoc PRNG. This can be used to guarantee sufficient entropy at program startup, rather than waiting for runtime errors to occur.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_rand_add.html b/libmongoc/1.24.0/mongoc_rand_add.html new file mode 100644 index 0000000000000000000000000000000000000000..1a5a7bcf14037b4fa8097f1e46c1c077275579d3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_rand_add.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_rand_add() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_rand_add()

    +
    +

    Synopsis

    +
    void
    +mongoc_rand_add (const void *buf, int num, double entropy);
    +
    +
    +
    +
    +

    Description

    +

    Mixes num bytes of data into the mongoc random number generator. Entropy specifies a lower bound estimate of the randomness contained in buf.

    +
    +
    +

    Parameters

    +
      +
    • buf: A buffer.

    • +
    • num: An int of number of bytes in buf.

    • +
    • entropy: A double of randomness estimate in buf.

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_rand_seed.html b/libmongoc/1.24.0/mongoc_rand_seed.html new file mode 100644 index 0000000000000000000000000000000000000000..d11748a8f37557e70ea0111994f245e77e61f1c4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_rand_seed.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_rand_seed() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_rand_seed()

    +
    +

    Synopsis

    +
    void
    +mongoc_rand_seed (const void *buf, int num);
    +
    +
    +
    +
    +

    Description

    +

    Seeds the mongoc random number generator with num bytes of entropy.

    +
    +
    +

    Parameters

    +
      +
    • buf: A buffer.

    • +
    • num: An int of number of bytes in buf.

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_rand_status.html b/libmongoc/1.24.0/mongoc_rand_status.html new file mode 100644 index 0000000000000000000000000000000000000000..853bdcb65585484d0b4b255f7c22e282cc56d85d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_rand_status.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_rand_status() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_rand_status()

    +
    +

    Synopsis

    +
    int
    +mongoc_rand_status (void);
    +
    +
    +
    +
    +

    Description

    +

    The status of the mongoc random number generator.

    +
    +
    +

    Returns

    +

    Returns 1 if the PRNG has been seeded with enough data, 0 otherwise.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_append.html b/libmongoc/1.24.0/mongoc_read_concern_append.html new file mode 100644 index 0000000000000000000000000000000000000000..c530aa5ac750a5a37b97e41fcbb08a16cc2cfc18 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_append.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_read_concern_append() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_append()

    +
    +

    Synopsis

    +
    bool
    +mongoc_read_concern_append (mongoc_read_concern_t *read_concern, bson_t *opts);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function appends a read concern to command options. It is useful for appending a read concern to command options before passing them to mongoc_client_read_command_with_opts() or a related function that takes an options document.

    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_read_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_copy.html b/libmongoc/1.24.0/mongoc_read_concern_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..4b965c457e3a7bf1ca2eb76de3d07e70747307cb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_concern_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_copy()

    +
    +

    Synopsis

    +
    mongoc_read_concern_t *
    +mongoc_read_concern_copy (const mongoc_read_concern_t *read_concern)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a deep copy of read_concern.

    +
    +
    +

    Returns

    +

    Returns a newly allocated copy of read_concern that should be freed with mongoc_read_concern_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_destroy.html b/libmongoc/1.24.0/mongoc_read_concern_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..f4c141d5bbbfa7d5bff4172bffaa0f4c97bfedb4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_concern_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_concern_destroy (mongoc_read_concern_t *read_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees all resources associated with the read concern structure. Does nothing if read_concern is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_get_level.html b/libmongoc/1.24.0/mongoc_read_concern_get_level.html new file mode 100644 index 0000000000000000000000000000000000000000..20dadc78eec22a1de53a811ec27e477ceddf6ca8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_get_level.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_concern_get_level() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_get_level()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_read_concern_get_level (const mongoc_read_concern_t *read_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns the currently set read concern.

    +
    +
    +

    Returns

    +

    Returns the current readConcern. If none is set, returns NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_is_default.html b/libmongoc/1.24.0/mongoc_read_concern_is_default.html new file mode 100644 index 0000000000000000000000000000000000000000..255f708566d49929f6caea669e8782fefaab0ba1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_is_default.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_concern_is_default() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_is_default()

    +
    +

    Synopsis

    +
    bool
    +mongoc_read_concern_is_default (mongoc_read_concern_t *read_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns true if read_concern has not been modified from the default. For example, if no “readConcern” option is set in the MongoDB URI and you have not called mongoc_client_set_read_concern(), then mongoc_read_concern_is_default() is true for the read concern returned by mongoc_client_get_read_concern().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_new.html b/libmongoc/1.24.0/mongoc_read_concern_new.html new file mode 100644 index 0000000000000000000000000000000000000000..47233563fe1324217ac3ad8910d83dd72345d263 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_read_concern_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_new()

    +
    +

    Synopsis

    +
    mongoc_read_concern_t *
    +mongoc_read_concern_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    Creates a newly allocated read concern that can be configured based on user preference. This should be freed with mongoc_read_concern_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_set_level.html b/libmongoc/1.24.0/mongoc_read_concern_set_level.html new file mode 100644 index 0000000000000000000000000000000000000000..e2aa76ae678d5b55fd10b93df04326080120cede --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_set_level.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_read_concern_set_level() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_set_level()

    +
    +

    Synopsis

    +
    bool
    +mongoc_read_concern_set_level (mongoc_read_concern_t *read_concern,
    +                               const char *level);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the read concern level. See mongoc_read_concern_t for details.

    +

    Beginning in version 1.9.0, this function can now alter the read concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would return false +instead of altering the read concern.

    +
    +
    +

    Returns

    +

    Returns true if the read concern level was set, or false otherwise.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_concern_t.html b/libmongoc/1.24.0/mongoc_read_concern_t.html new file mode 100644 index 0000000000000000000000000000000000000000..242645e576053734431272b24964734f90508a1f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_concern_t.html @@ -0,0 +1,241 @@ + + + + + + + + + + + + + + mongoc_read_concern_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_concern_t

    +

    Read Concern abstraction

    +
    +

    Synopsis

    +

    New in MongoDB 3.2.

    +

    The mongoc_read_concern_t allows clients to choose a level of isolation for their reads. The default, MONGOC_READ_CONCERN_LEVEL_LOCAL, is right for the great majority of applications.

    +

    You can specify a read concern on connection objects, database objects, or collection objects.

    +

    See readConcern on the MongoDB website for more information.

    +

    Read Concern is only sent to MongoDB when it has explicitly been set by mongoc_read_concern_set_level() to anything other than NULL.

    +
    +
    +

    Read Concern Levels

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Macro

    Description

    First MongoDB version

    MONGOC_READ_CONCERN_LEVEL_LOCAL

    Level “local”, the default.

    3.2

    MONGOC_READ_CONCERN_LEVEL_MAJORITY

    Level “majority”.

    3.2

    MONGOC_READ_CONCERN_LEVEL_LINEARIZABLE

    Level “linearizable”.

    3.4

    MONGOC_READ_CONCERN_LEVEL_AVAILABLE

    Level “available”.

    3.6

    MONGOC_READ_CONCERN_LEVEL_SNAPSHOT

    Level “snapshot”.

    4.0

    +

    For the sake of compatibility with future versions of MongoDB, mongoc_read_concern_set_level() allows any string, not just this list of known read concern levels.

    +

    See Read Concern Levels in the MongoDB manual for more information about the individual read concern levels.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_mode_t.html b/libmongoc/1.24.0/mongoc_read_mode_t.html new file mode 100644 index 0000000000000000000000000000000000000000..9719107602bdbab137e73bbc61aa598573110af8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_mode_t.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_mode_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_mode_t

    +

    Read Preference Modes

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_READ_PRIMARY = (1 << 0),
    +   MONGOC_READ_SECONDARY = (1 << 1),
    +   MONGOC_READ_PRIMARY_PREFERRED = (1 << 2) | MONGOC_READ_PRIMARY,
    +   MONGOC_READ_SECONDARY_PREFERRED = (1 << 2) | MONGOC_READ_SECONDARY,
    +   MONGOC_READ_NEAREST = (1 << 3) | MONGOC_READ_SECONDARY,
    +} mongoc_read_mode_t;
    +
    +
    +
    +
    +

    Description

    +

    This enum describes how reads should be dispatched. The default is MONGOC_READ_PRIMARY.

    +

    Please see the MongoDB website for a description of Read Preferences.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_add_tag.html b/libmongoc/1.24.0/mongoc_read_prefs_add_tag.html new file mode 100644 index 0000000000000000000000000000000000000000..ed5838f4cc80307e870add4a0841cf1b6a1152d9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_add_tag.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_read_prefs_add_tag() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_add_tag()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_prefs_add_tag (mongoc_read_prefs_t *read_prefs, const bson_t *tag);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall add a tag to a read preference.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_copy.html b/libmongoc/1.24.0/mongoc_read_prefs_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..840ea56da8915a2ad858a6f88bcc2b1743d1cda1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_prefs_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_copy()

    +
    +

    Synopsis

    +
    mongoc_read_prefs_t *
    +mongoc_read_prefs_copy (const mongoc_read_prefs_t *read_prefs)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function shall deep copy a read preference.

    +
    +
    +

    Returns

    +

    Returns a newly allocated read preference that should be freed with mongoc_read_prefs_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_destroy.html b/libmongoc/1.24.0/mongoc_read_prefs_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..f09101e8236f565b45d3ca4ee31effcac14c5934 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_prefs_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_prefs_destroy (mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees a read preference and all associated resources. Does nothing if read_prefs is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_get_hedge.html b/libmongoc/1.24.0/mongoc_read_prefs_get_hedge.html new file mode 100644 index 0000000000000000000000000000000000000000..42468682248e16fede883a7f9d121dc4b4f76ee8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_get_hedge.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_hedge() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_get_hedge()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_read_prefs_get_hedge (const mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches any read preference hedge document that has been registered.

    +
    +
    +

    Returns

    +

    Returns a bson_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_get_max_staleness_seconds.html b/libmongoc/1.24.0/mongoc_read_prefs_get_max_staleness_seconds.html new file mode 100644 index 0000000000000000000000000000000000000000..a1fa2b1e01d5dcaa344392443e99b6cf2823b7aa --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_get_max_staleness_seconds.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_max_staleness_seconds() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_get_max_staleness_seconds()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_read_prefs_get_max_staleness_seconds (
    +   const mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Clients estimate the staleness of each secondary, and select for reads only those secondaries whose estimated staleness is less than or equal to maxStalenessSeconds. The default is MONGOC_NO_MAX_STALENESS.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_get_mode.html b/libmongoc/1.24.0/mongoc_read_prefs_get_mode.html new file mode 100644 index 0000000000000000000000000000000000000000..4734b44272c53b028033a30cb50161bd3fbf431d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_get_mode.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_mode() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_get_mode()

    +
    +

    Synopsis

    +
    mongoc_read_mode_t
    +mongoc_read_prefs_get_mode (const mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the mongoc_read_mode_t for the read preference.

    +
    +
    +

    Returns

    +

    Returns the read preference mode.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_get_tags.html b/libmongoc/1.24.0/mongoc_read_prefs_get_tags.html new file mode 100644 index 0000000000000000000000000000000000000000..ed21b924103748fae4c56bd1b8efd78f1e361236 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_get_tags.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_tags() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_get_tags()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_read_prefs_get_tags (const mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches any read preference tags that have been registered.

    +
    +
    +

    Returns

    +

    Returns a bson_t that should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_is_valid.html b/libmongoc/1.24.0/mongoc_read_prefs_is_valid.html new file mode 100644 index 0000000000000000000000000000000000000000..9ed6d802f9511c7d4bb0090c6cdc5ea7aa1a9570 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_is_valid.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_prefs_is_valid() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_is_valid()

    +
    +

    Synopsis

    +
    bool
    +mongoc_read_prefs_is_valid (const mongoc_read_prefs_t *read_prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a consistency check of read_prefs to ensure it makes sense and can be satisfied.

    +

    This only performs local consistency checks.

    +
    +
    +

    Returns

    +

    Returns true if the read pref is valid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_new.html b/libmongoc/1.24.0/mongoc_read_prefs_new.html new file mode 100644 index 0000000000000000000000000000000000000000..df8ecb4bb99af14c69dc02a6324400de89ef5e57 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_new.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_prefs_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_new()

    +
    +

    Synopsis

    +
    mongoc_read_prefs_t *
    +mongoc_read_prefs_new (mongoc_read_mode_t read_mode)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Creates a new mongoc_read_prefs_t using the mode specified.

    +
    +
    +

    Returns

    +

    Returns a newly allocated mongoc_read_prefs_t that should be freed with mongoc_read_prefs_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_set_hedge.html b/libmongoc/1.24.0/mongoc_read_prefs_set_hedge.html new file mode 100644 index 0000000000000000000000000000000000000000..a37e07f56ee403b9439a5f50e0d3d01c7e272fea --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_set_hedge.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_hedge() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_set_hedge()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_prefs_set_hedge (mongoc_read_prefs_t *read_prefs,
    +                             const bson_t *hedge);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the hedge document to be used for the read preference. Sharded clusters running MongoDB 4.4 or later can dispatch read operations in parallel, returning the result from the fastest host and cancelling the unfinished operations.

    +

    For example, this is a valid hedge document

    +
    {
    +   enabled: true
    +}
    +
    +
    +

    Appropriate values for the enabled key are true or false.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_set_max_staleness_seconds.html b/libmongoc/1.24.0/mongoc_read_prefs_set_max_staleness_seconds.html new file mode 100644 index 0000000000000000000000000000000000000000..091e13f929000b0ce25b6fc84e0bcd53c5e8ad19 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_set_max_staleness_seconds.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_max_staleness_seconds() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_set_max_staleness_seconds()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_prefs_set_max_staleness_seconds (mongoc_read_prefs_t *read_prefs,
    +                                             int64_t max_staleness_seconds);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • read_prefs: A mongoc_read_prefs_t.

    • +
    • max_staleness_seconds: A positive integer or MONGOC_NO_MAX_STALENESS.

    • +
    +
    +
    +

    Description

    +

    Sets the maxStalenessSeconds to be used for the read preference. Clients estimate the staleness of each secondary, and select for reads only those secondaries whose estimated staleness is less than or equal to maxStalenessSeconds.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_set_mode.html b/libmongoc/1.24.0/mongoc_read_prefs_set_mode.html new file mode 100644 index 0000000000000000000000000000000000000000..8955a90b787bd9afd21ed60e6de3a1bd9f738a9a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_set_mode.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_mode() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_set_mode()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_prefs_set_mode (mongoc_read_prefs_t *read_prefs,
    +                            mongoc_read_mode_t mode);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the read preference mode. See the MongoDB website for more information on Read Preferences.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_set_tags.html b/libmongoc/1.24.0/mongoc_read_prefs_set_tags.html new file mode 100644 index 0000000000000000000000000000000000000000..decb9bff5fbd0105b74f04fa5f935823bd861efb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_set_tags.html @@ -0,0 +1,272 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_tags() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_set_tags()

    +
    +

    Synopsis

    +
    void
    +mongoc_read_prefs_set_tags (mongoc_read_prefs_t *read_prefs,
    +                            const bson_t *tags);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the tags to be used for the read preference. Only mongod instances matching these tags will be suitable for handling the request.

    +
    +
    +

    Examples

    +
    #include <mongoc/mongoc.h>
    +
    +static void
    +run_query_with_read_prefs_tags (mongoc_collection_t *collection)
    +{
    +   char *str;
    +   const bson_t *doc;
    +   bson_t filter = BSON_INITIALIZER;
    +   bson_error_t error;
    +   mongoc_cursor_t *cursor;
    +   mongoc_read_prefs_t *read_prefs;
    +   /*  Create a tagset representing
    +    *  [
    +    *    {"dc": "ny", "rack": "1" }, // Any node in rack1 in the ny datacenter
    +    *    {"dc": "ny", "rack": "2" }, // Any node in rack2 in the ny datacenter
    +    *    {"dc": "ny" },              // Any node in the ny datacenter
    +    *    {}                          // If all else fails, just any available node
    +    * ]
    +    */
    +   bson_t *tags = BCON_NEW (
    +      "0", "{", "dc", BCON_UTF8("ny"), "rack", BCON_UTF8("1"), "}",
    +      "1", "{", "dc", BCON_UTF8("ny"), "rack", BCON_UTF8("2"), "}",
    +      "2", "{", "dc", BCON_UTF8("ny"), "}",
    +      "3", "{", "}"
    +   );
    +
    +   read_prefs = mongoc_read_prefs_new (MONGOC_READ_SECONDARY);
    +   mongoc_read_prefs_set_tags (read_prefs, tags);
    +   bson_destroy (tags);
    +
    +   cursor =
    +      mongoc_collection_find_with_opts (collection, &filter, NULL, read_prefs);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +   if (mongoc_cursor_error (cursor, &error)) {
    +      fprintf (stderr, "Cursor error: %s\n", error.message);
    +   }
    +
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_read_prefs_destroy (read_prefs);
    +   bson_destroy (doc);
    +}
    +
    +int main (void)
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +
    +   mongoc_init ();
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost/?appname=rp_tags&replicaSet=foo");
    +   mongoc_client_set_error_api (client, 2);
    +   collection = mongoc_client_get_collection (client, "dbname", "collname");
    +   run_query_with_read_prefs_tags (collection);
    +
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup();
    +}
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_read_prefs_t.html b/libmongoc/1.24.0/mongoc_read_prefs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ea7f8dee51a84b3c796777fd66167d10c6809aef --- /dev/null +++ b/libmongoc/1.24.0/mongoc_read_prefs_t.html @@ -0,0 +1,271 @@ + + + + + + + + + + + + + + mongoc_read_prefs_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_read_prefs_t

    +

    A read preference abstraction

    +
    +

    Synopsis

    +

    mongoc_read_prefs_t provides an abstraction on top of the MongoDB connection read preferences. It allows for hinting to the driver which nodes in a replica set should be accessed first and how.

    +

    You can specify a read preference mode on connection objects, database objects, collection objects, or per-operation. Generally, it makes the most sense to stick with the global default mode, MONGOC_READ_PRIMARY. All of the other modes come with caveats that won’t be covered in great detail here.

    +
    +
    +

    Read Modes

    + + + + + + + + + + + + + + + + + + +

    MONGOC_READ_PRIMARY

    Default mode. All operations read from the current replica set primary.

    MONGOC_READ_SECONDARY

    All operations read from among the nearest secondary members of the replica set.

    MONGOC_READ_PRIMARY_PREFERRED

    In most situations, operations read from the primary but if it is unavailable, operations read from secondary members.

    MONGOC_READ_SECONDARY_PREFERRED

    In most situations, operations read from among the nearest secondary members, but if no secondaries are available, operations read from the primary.

    MONGOC_READ_NEAREST

    Operations read from among the nearest members of the replica set, irrespective of the member’s type.

    +
    +
    +

    Tag Sets

    +

    Tag sets allow you to specify custom read preferences and write concerns so that your application can target operations to specific members.

    +

    Custom read preferences and write concerns evaluate tags sets in different ways: read preferences consider the value of a tag when selecting a member to read from, while write concerns ignore the value of a tag when selecting a member, except to consider whether or not the value is unique.

    +

    You can specify tag sets with the following read preference modes:

    +
      +
    • primaryPreferred

    • +
    • secondary

    • +
    • secondaryPreferred

    • +
    • nearest

    • +
    +

    Tags are not compatible with MONGOC_READ_PRIMARY and, in general, only apply when selecting a secondary member of a set for a read operation. However, the nearest read mode, when combined with a tag set, will select the nearest member that matches the specified tag set, which may be a primary or secondary.

    +

    Tag sets are represented as a comma-separated list of colon-separated key-value +pairs when provided as a connection string, e.g. dc:ny,rack:1.

    +

    To specify a list of tag sets, using multiple readPreferenceTags, e.g.

    +
    readPreferenceTags=dc:ny,rack:1;readPreferenceTags=dc:ny;readPreferenceTags=
    +
    +
    +

    Note the empty value for the last one, which means “match any secondary as a last resort”.

    +

    Order matters when using multiple readPreferenceTags.

    +

    Tag Sets can also be configured using mongoc_read_prefs_set_tags().

    +

    All interfaces use the same member selection logic to choose the member to which to direct read operations, basing the choice on read preference mode and tag sets.

    +
    +
    +

    Max Staleness

    +

    When connected to replica set running MongoDB 3.4 or later, the driver estimates the staleness of each secondary based on lastWriteDate values provided in server hello responses.

    +

    Max Staleness is the maximum replication lag in seconds (wall clock time) that a secondary can suffer and still be eligible for reads. The default is MONGOC_NO_MAX_STALENESS, which disables staleness checks. Otherwise, it must be a positive integer at least MONGOC_SMALLEST_MAX_STALENESS_SECONDS (90 seconds).

    +

    Max Staleness is also supported by sharded clusters of replica sets if all servers run MongoDB 3.4 or later.

    +
    +
    +

    Hedged Reads

    +

    When connecting to a sharded cluster running MongoDB 4.4 or later, reads can be sent in parallel to the two “best” hosts. Once one result returns, any other outstanding operations that were part of the hedged read are cancelled.

    +

    When the read preference mode is MONGOC_READ_NEAREST and the sharded cluster is running MongoDB 4.4 or later, hedged reads are enabled by default. Additionally, hedged reads may be explicitly enabled or disabled by calling mongoc_read_prefs_set_hedge() with a BSON document, e.g.

    +
    {
    +   enabled: true
    +}
    +
    +
    +

    Appropriate values for the enabled key are true or false.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_remove_flags_t.html b/libmongoc/1.24.0/mongoc_remove_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..193535e0d65ff668dc857a10c7abc270ca55ca04 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_remove_flags_t.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_remove_flags_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_remove_flags_t

    +

    Flags for deletion operations

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_REMOVE_NONE = 0,
    +   MONGOC_REMOVE_SINGLE_REMOVE = 1 << 0,
    +} mongoc_remove_flags_t;
    +
    +
    +
    +
    +

    Description

    +

    These flags correspond to the MongoDB wire protocol. They may be bitwise or’d together. They may change the number of documents that are removed during a remove command.

    +
    +
    +

    Flag Values

    + + + + + + + + + +

    MONGOC_REMOVE_NONE

    Specify no removal flags. All matching documents will be removed.

    MONGOC_REMOVE_SINGLE_REMOVE

    Only remove the first matching document from the selector.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_reply_flags_t.html b/libmongoc/1.24.0/mongoc_reply_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..9e2f5c3bcb5fafab28746c7fb30fcc5103341c20 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_reply_flags_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_reply_flags_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_reply_flags_t

    +

    Flags from server replies

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_REPLY_NONE = 0,
    +   MONGOC_REPLY_CURSOR_NOT_FOUND = 1 << 0,
    +   MONGOC_REPLY_QUERY_FAILURE = 1 << 1,
    +   MONGOC_REPLY_SHARD_CONFIG_STALE = 1 << 2,
    +   MONGOC_REPLY_AWAIT_CAPABLE = 1 << 3,
    +} mongoc_reply_flags_t;
    +
    +
    +
    +
    +

    Description

    +

    These flags correspond to the wire protocol. They may be bitwise or’d together.

    +
    +
    +

    Flag Values

    + + + + + + + + + + + + + + + + + + +

    MONGOC_REPLY_NONE

    No flags set.

    MONGOC_REPLY_CURSOR_NOT_FOUND

    No matching cursor was found on the server.

    MONGOC_REPLY_QUERY_FAILURE

    The query failed or was invalid. Error document has been provided.

    MONGOC_REPLY_SHARD_CONFIG_STALE

    Shard config is stale.

    MONGOC_REPLY_AWAIT_CAPABLE

    If the returned cursor is capable of MONGOC_QUERY_AWAIT_DATA.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_copy.html b/libmongoc/1.24.0/mongoc_server_api_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..9b873cc4d35c2e4571e531d7062f6f44d5d96a72 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_copy.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_server_api_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_copy()

    +
    +

    Synopsis

    +
    mongoc_server_api_t *
    +mongoc_server_api_copy (const mongoc_server_api_t *api)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Creates a deep copy of api.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns a newly allocated copy of api that must be freed with mongoc_server_api_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_deprecation_errors.html b/libmongoc/1.24.0/mongoc_server_api_deprecation_errors.html new file mode 100644 index 0000000000000000000000000000000000000000..5eb6a84e6ea8a3f4e6ed2ad117a9e4aefbc5c35e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_deprecation_errors.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_server_api_deprecation_errors() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_deprecation_errors()

    +
    +

    Synopsis

    +
    void
    +mongoc_server_api_deprecation_errors (mongoc_server_api_t *api,
    +                                      bool deprecation_errors);
    +
    +
    +

    Set whether or not to error on commands that are deprecated in this API version.

    +
    +
    +

    Parameters

    +
      +
    • api: A mongoc_server_api_t.

    • +
    • deprecation_errors: Whether or not to error on commands that are deprecated.

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_destroy.html b/libmongoc/1.24.0/mongoc_server_api_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..038b16a71944b1033202cff7679d8819dfc49e43 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_destroy.html @@ -0,0 +1,192 @@ + + + + + + + + + + + + + + mongoc_server_api_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_server_api_destroy (mongoc_server_api_t *api);
    +
    +
    +

    Free a mongoc_server_api_t. Does nothing if api is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_get_deprecation_errors.html b/libmongoc/1.24.0/mongoc_server_api_get_deprecation_errors.html new file mode 100644 index 0000000000000000000000000000000000000000..7a58ee0d87c6c262e0b2032dde7b2bc4a3c794c9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_get_deprecation_errors.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_get_deprecation_errors() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_get_deprecation_errors()

    +
    +

    Synopsis

    +
    const mongoc_optional_t *
    +mongoc_server_api_get_deprecation_errors (const mongoc_server_api_t *api);
    +
    +
    +

    Returns the value of the deprecation_errors flag for the mongoc_server_api_t.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns a mongoc_optional_t indicating whether the deprecation_errors flag was set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_get_strict.html b/libmongoc/1.24.0/mongoc_server_api_get_strict.html new file mode 100644 index 0000000000000000000000000000000000000000..311715884f5f826eb6ee45e0791cf3359be4c9ee --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_get_strict.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_get_strict() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_get_strict()

    +
    +

    Synopsis

    +
    const mongoc_optional_t *
    +mongoc_server_api_get_strict (const mongoc_server_api_t *api);
    +
    +
    +

    Returns the value of the strict flag for the mongoc_server_api_t.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns a mongoc_optional_t indicating whether the strict flag was set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_get_version.html b/libmongoc/1.24.0/mongoc_server_api_get_version.html new file mode 100644 index 0000000000000000000000000000000000000000..b68e1744dddc724338cac7d3f0eaa82e6c1c252e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_get_version.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_get_version() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_get_version()

    +
    +

    Synopsis

    +
    mongoc_server_api_version_t
    +mongoc_server_api_get_version (const mongoc_server_api_t *api);
    +
    +
    +

    Fetch the declared API version as from a mongoc_server_api_t.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns a mongoc_server_api_version_t with the API version declare in the mongoc_server_api_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_new.html b/libmongoc/1.24.0/mongoc_server_api_new.html new file mode 100644 index 0000000000000000000000000000000000000000..d35c4e1eca651e58b8399d519bfedffe274f9b95 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_new.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_server_api_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_new()

    +
    +

    Synopsis

    +
    mongoc_server_api_t *
    +mongoc_server_api_new (mongoc_server_api_version_t version)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a struct to hold server API preferences.

    +
    +
    +

    Returns

    +

    A new mongoc_server_api_t you must free with mongoc_server_api_destroy().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_strict.html b/libmongoc/1.24.0/mongoc_server_api_strict.html new file mode 100644 index 0000000000000000000000000000000000000000..19121a2e368b543864072473a94499a5d556dd6e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_strict.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_server_api_strict() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_strict()

    +
    +

    Synopsis

    +
    void
    +mongoc_server_api_strict (mongoc_server_api_t *api, bool strict);
    +
    +
    +

    Set whether to be strict about the list of allowed commands in this API version.

    +
    +
    +

    Parameters

    +
      +
    • api: A mongoc_server_api_t.

    • +
    • strict: Whether or not to be struct about the list of allowed API commands.

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_t.html b/libmongoc/1.24.0/mongoc_server_api_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3a38e3189d0c8834e17b1ac9bf31acbb07ea82dd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_t.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_server_api_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_t

    +

    A versioned API to use for connections.

    +
    +

    Synopsis

    +

    Used to specify which version of the MongoDB server’s API to use for driver connections.

    +

    The server API type takes a mongoc_server_api_version_t. It can optionally be strict about the list of allowed commands in that API version, and can also optionally provide errors for deprecated commands in that API version.

    +

    A mongoc_server_api_t can be set on a client, and will then be sent to MongoDB for most commands run using that client.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_version_from_string.html b/libmongoc/1.24.0/mongoc_server_api_version_from_string.html new file mode 100644 index 0000000000000000000000000000000000000000..897d0f9bafc39cba61a6e4f400242e1440aeb9c3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_version_from_string.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_server_api_version_from_string() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_version_from_string()

    +
    +

    Synopsis

    +
    bool
    +mongoc_server_api_version_from_string (const char *version,
    +                                       mongoc_server_api_version_t *out);
    +
    +
    +

    Given a string version, populates out with the equivalent mongoc_server_api_version_t if version represents a valid API version.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True on success, false on failure. On success, out is populated with the converted version string. On failure, out is not altered.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_version_t.html b/libmongoc/1.24.0/mongoc_server_api_version_t.html new file mode 100644 index 0000000000000000000000000000000000000000..bda6d3e95aa20699acdb0e639074042feb872329 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_version_t.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_server_api_version_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_version_t

    +

    A representation of server API version numbers.

    +
    +

    Synopsis

    +

    Used to specify which version of the MongoDB server’s API to use for driver connections.

    +
    +
    +

    Supported API Versions

    +

    The driver currently supports the following MongoDB API versions:

    + + + + + + + + + + + +

    Enum value

    MongoDB version string

    MONGOC_SERVER_API_V1

    “1”

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_api_version_to_string.html b/libmongoc/1.24.0/mongoc_server_api_version_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..52d6eab601da7d09299de03afb3f0492e97b4405 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_api_version_to_string.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_version_to_string() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_api_version_to_string()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_server_api_version_to_string (mongoc_server_api_version_t version);
    +
    +
    +

    Returns the string representation of version, or NULL if version has no string representation.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns the string representation of version or NULL. The returned string should not be freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_destroy.html b/libmongoc/1.24.0/mongoc_server_description_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..53234c520fb92c4c425a80ef2827b2dd2fb5b86e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_server_description_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_server_description_destroy (mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees all resources associated with the server description. Does nothing if description is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_hello_response.html b/libmongoc/1.24.0/mongoc_server_description_hello_response.html new file mode 100644 index 0000000000000000000000000000000000000000..cc2c19038d0e3b96c12b930ceae8b9b76ee0ae18 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_hello_response.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_server_description_hello_response() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_hello_response()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_server_description_hello_response (
    +   const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The client or client pool periodically runs a +“hello” +command on each server, to update its view of the MongoDB deployment. Use +mongoc_client_get_server_descriptions() and +mongoc_server_description_hello_response() to get the most recent “hello” +response.

    +
    +
    +

    Returns

    +

    A reference to a BSON document, owned by the server description. The document is empty if the driver is not connected to the server.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_host.html b/libmongoc/1.24.0/mongoc_server_description_host.html new file mode 100644 index 0000000000000000000000000000000000000000..d248478df7df8f5aaefb03035e4c57bb8ac51bfb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_host.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_server_description_host() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_host()

    +
    +

    Synopsis

    +
    mongoc_host_list_t *
    +mongoc_server_description_host (const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Return the server’s host and port. This object is owned by the server description.

    +
    +
    +

    Returns

    +

    A reference to the server description’s mongoc_host_list_t, which you must not modify or free.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_id.html b/libmongoc/1.24.0/mongoc_server_description_id.html new file mode 100644 index 0000000000000000000000000000000000000000..4f2da01ffdbf62d8b897fc25ae4e7d284e050c3c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_id.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_server_description_id() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_id()

    +
    +

    Synopsis

    +
    uint32_t
    +mongoc_server_description_id (const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Get the server’s id, an opaque identifier generated by the client or client pool.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_ismaster.html b/libmongoc/1.24.0/mongoc_server_description_ismaster.html new file mode 100644 index 0000000000000000000000000000000000000000..9f5a731c3df0e9ccc5304079451e6b79d3beccf5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_ismaster.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_server_description_ismaster() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_ismaster()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.18.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_server_description_hello_response() in new code.

    +
    +
    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_server_description_ismaster (
    +   const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    The client or client pool periodically runs a “hello” command on each server, to update its view of the MongoDB deployment. Use mongoc_client_get_server_descriptions() and mongoc_server_description_hello_response() to get the most recent “hello” response.

    +
    +
    +

    Returns

    +

    A reference to a BSON document, owned by the server description. The document is empty if the driver is not connected to the server.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_last_update_time.html b/libmongoc/1.24.0/mongoc_server_description_last_update_time.html new file mode 100644 index 0000000000000000000000000000000000000000..f8629c3bfff965fc77d331cb7f20efa56cf6ff03 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_last_update_time.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_server_description_last_update_time() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_last_update_time()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_server_description_last_update_time (const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Get the last point in time when we processed a hello for this server, or, if we have not processed any hellos since creating the description, the time the server description was initialized.

    +
    +
    +

    Returns

    +

    The server’s last update time, in microseconds.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_new_copy.html b/libmongoc/1.24.0/mongoc_server_description_new_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..4b3f473a040fd925ace87b4475f5ff72a852f43d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_new_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_server_description_new_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_new_copy()

    +
    +

    Synopsis

    +
    mongoc_server_description_t *
    +mongoc_server_description_new_copy (
    +   const mongoc_server_description_t *description) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a deep copy of description.

    +
    +
    +

    Returns

    +

    Returns a newly allocated copy of description that should be freed with mongoc_server_description_destroy() when no longer in use. Returns NULL if description is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_round_trip_time.html b/libmongoc/1.24.0/mongoc_server_description_round_trip_time.html new file mode 100644 index 0000000000000000000000000000000000000000..5a7f6ef8e84ad88c933bfdd9ac4f95205e4b724c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_round_trip_time.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_description_round_trip_time() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_round_trip_time()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_server_description_round_trip_time (
    +   const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Get the server’s round trip time in milliseconds. This is the client’s measurement of the duration of a “hello” command.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_t.html b/libmongoc/1.24.0/mongoc_server_description_t.html new file mode 100644 index 0000000000000000000000000000000000000000..be1e27dbdca40fb841fb61070009cf91bf45b017 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_t.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_server_description_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_t

    +

    Server description

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +typedef struct _mongoc_server_description_t mongoc_server_description_t
    +
    +
    +

    mongoc_server_description_t holds information about a mongod or mongos the driver is connected to.

    +
    +
    +

    Lifecycle

    +

    Clean up a mongoc_server_description_t with mongoc_server_description_destroy() when necessary.

    +

    Applications receive a temporary reference to a mongoc_server_description_t as a parameter to an SDAM Monitoring callback that must not be destroyed. See +Introduction to Application Performance Monitoring.

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_description_type.html b/libmongoc/1.24.0/mongoc_server_description_type.html new file mode 100644 index 0000000000000000000000000000000000000000..2c60fd1cdce325bff9709cae2b8867d0202f0cda --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_description_type.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_server_description_type() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_description_type()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_server_description_type (const mongoc_server_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function returns a string, one of the server types defined in the Server Discovery And Monitoring Spec:

    +
      +
    • Standalone

    • +
    • Mongos

    • +
    • PossiblePrimary

    • +
    • LoadBalancer

    • +
    • RSPrimary

    • +
    • RSSecondary

    • +
    • RSArbiter

    • +
    • RSOther

    • +
    • RSGhost

    • +
    • Unknown

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_server_descriptions_destroy_all.html b/libmongoc/1.24.0/mongoc_server_descriptions_destroy_all.html new file mode 100644 index 0000000000000000000000000000000000000000..b1753c0bb2ea51eb9f33347778402850405baf62 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_server_descriptions_destroy_all.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_server_descriptions_destroy_all() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_server_descriptions_destroy_all()

    +
    +

    Synopsis

    +
    void
    +mongoc_server_descriptions_destroy_all (mongoc_server_description_t **sds,
    +                                        size_t n);
    +
    +
    +

    Frees the array of mongoc_server_description_t structs returned by mongoc_client_get_server_descriptions().

    +
    +
    +

    Parameters

    +
      +
    • sds: The array of server descriptions.

    • +
    • n: The number of elements in sds.

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opt_t.html b/libmongoc/1.24.0/mongoc_session_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..310b104902a8e18f9ba46fa550fa412d37cbb959 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opt_t.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_session_opt_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opt_t

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_session_opt_t mongoc_session_opt_t;
    +
    +
    +
    +

    Synopsis

    +

    Start a session with mongoc_client_start_session(), use the session for a sequence of operations and multi-document transactions, then free it with mongoc_client_session_destroy(). Any mongoc_cursor_t or mongoc_change_stream_t using a session must be destroyed before the session, and a session must be destroyed before the mongoc_client_t it came from.

    +

    By default, sessions are causally consistent. To disable causal consistency, before starting a session create a mongoc_session_opt_t with mongoc_session_opts_new() and call mongoc_session_opts_set_causal_consistency(), then free the struct with mongoc_session_opts_destroy().

    +

    Unacknowledged writes are prohibited with sessions.

    +

    A mongoc_client_session_t must be used by only one thread at a time. Due to session pooling, mongoc_client_start_session() may return a session that has been idle for some time and is about to be closed after its idle timeout. Use the session within one minute of acquiring it to refresh the session and avoid a timeout.

    +

    See the example code for mongoc_session_opts_set_causal_consistency().

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_clone.html b/libmongoc/1.24.0/mongoc_session_opts_clone.html new file mode 100644 index 0000000000000000000000000000000000000000..915f4f134d3a931192c3dba4426e47d0e75c6592 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_clone.html @@ -0,0 +1,305 @@ + + + + + + + + + + + + + + mongoc_session_opts_clone() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_clone()

    +
    +

    Synopsis

    +
    mongoc_session_opt_t *
    +mongoc_session_opts_clone (const mongoc_session_opt_t *opts)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a copy of a session options struct.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A new mongoc_session_opt_t that must be freed with mongoc_session_opts_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_destroy.html b/libmongoc/1.24.0/mongoc_session_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..3d08bf51404bfd5b1ee9879ea2de9b7f658ad683 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_destroy.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_session_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_session_opts_destroy (mongoc_session_opt_t *opts);
    +
    +
    +

    Free a mongoc_session_opt_t. Does nothing if opts is NULL.

    +
    +
    +

    Parameters

    + +
    +
    +

    Example

    +

    See the example code for mongoc_session_opts_set_causal_consistency().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_get_causal_consistency.html b/libmongoc/1.24.0/mongoc_session_opts_get_causal_consistency.html new file mode 100644 index 0000000000000000000000000000000000000000..aafb445223dbf7d26dc2328bdc6cd3d299e761bb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_get_causal_consistency.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_causal_consistency() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_get_causal_consistency()

    +
    +

    Synopsis

    +
    bool
    +mongoc_session_opts_get_causal_consistency (const mongoc_session_opt_t *opts);
    +
    +
    +

    Return true if this session is configured for causal consistency (the default), else false. See mongoc_session_opts_set_causal_consistency().

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_get_default_transaction_opts.html b/libmongoc/1.24.0/mongoc_session_opts_get_default_transaction_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a053eb1f0e3893146d06840ac2031bb58a2f8201 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_get_default_transaction_opts.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_default_transaction_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_get_default_transaction_opts()

    +
    +

    Synopsis

    +
    const mongoc_transaction_opt_t *
    +mongoc_session_opts_get_default_transaction_opts (const mongoc_session_opt_t *opts);
    +
    +
    +

    The default options for transactions started with this session. See mongoc_session_opts_set_default_transaction_opts().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_transaction_opt_t that is valid only for the lifetime of opts.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_get_snapshot.html b/libmongoc/1.24.0/mongoc_session_opts_get_snapshot.html new file mode 100644 index 0000000000000000000000000000000000000000..de8d48228db2c4d82ac688487e89aedbde7affe0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_get_snapshot.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_snapshot() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_get_snapshot()

    +
    +

    Synopsis

    +
    bool
    +mongoc_session_opts_get_snapshot (const mongoc_session_opt_t *opts);
    +
    +
    +

    Return true if this session is configured for snapshot reads, false by default. See mongoc_session_opts_set_snapshot().

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_get_transaction_opts.html b/libmongoc/1.24.0/mongoc_session_opts_get_transaction_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..f5229ca51534f92607cea4f147f9c4cdb5b3f6ae --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_get_transaction_opts.html @@ -0,0 +1,306 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_transaction_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_get_transaction_opts()

    +
    +

    Synopsis

    +
    mongoc_transaction_opt_t *
    +mongoc_session_opts_get_transaction_opts (
    +   const mongoc_client_session_t *session) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    The options for the current transaction started with this session.

    +

    If this session is not in a transaction, then the returned value is NULL. See mongoc_client_session_in_transaction().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    If the session is in a transaction, a new mongoc_transaction_opt_t that must be freed with mongoc_transaction_opts_destroy(). Otherwise, NULL.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_new.html b/libmongoc/1.24.0/mongoc_session_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..bc12c2684d2d18e1a68d755d949c9287fef17d32 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_new.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_session_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_new()

    +
    +

    Synopsis

    +
    mongoc_session_opt_t *
    +mongoc_session_opts_new (void);
    +
    +
    +

    Start a session with mongoc_client_start_session(), use the session for a sequence of operations and multi-document transactions, then free it with mongoc_client_session_destroy(). Any mongoc_cursor_t or mongoc_change_stream_t using a session must be destroyed before the session, and a session must be destroyed before the mongoc_client_t it came from.

    +

    By default, sessions are causally consistent. To disable causal consistency, before starting a session create a mongoc_session_opt_t with mongoc_session_opts_new() and call mongoc_session_opts_set_causal_consistency(), then free the struct with mongoc_session_opts_destroy().

    +

    Unacknowledged writes are prohibited with sessions.

    +

    A mongoc_client_session_t must be used by only one thread at a time. Due to session pooling, mongoc_client_start_session() may return a session that has been idle for some time and is about to be closed after its idle timeout. Use the session within one minute of acquiring it to refresh the session and avoid a timeout.

    +

    See the example code for mongoc_session_opts_set_causal_consistency().

    +
    +
    +

    Returns

    +

    A new mongoc_session_opt_t that must be freed with mongoc_session_opts_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_set_causal_consistency.html b/libmongoc/1.24.0/mongoc_session_opts_set_causal_consistency.html new file mode 100644 index 0000000000000000000000000000000000000000..9e18111f888514dc1932501764f72ee610fe7dd4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_set_causal_consistency.html @@ -0,0 +1,346 @@ + + + + + + + + + + + + + + mongoc_session_opts_set_causal_consistency() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_set_causal_consistency()

    +
    +

    Synopsis

    +
    void
    +mongoc_session_opts_set_causal_consistency (mongoc_session_opt_t *opts,
    +                                            bool causal_consistency);
    +
    +
    +

    Configure causal consistency in a session. If true (the default), each operation in the session will be causally ordered after the previous read or write operation. Set to false to disable causal consistency. See the MongoDB Manual Entry for Causal Consistency.

    +

    Causal consistency and snapshot reads are mutually exclusive. Attempting to set both to true will result in an error. See mongoc_session_opts_set_snapshot().

    +

    Unacknowledged writes are not causally consistent. If you execute a write operation with a mongoc_write_concern_t on which you have called mongoc_write_concern_set_w() with a value of 0, the write does not participate in causal consistency.

    +
    +
    +

    Parameters

    + +
    +
    +

    Example

    +
    mongoc_client_t *client;
    +mongoc_session_opt_t *session_opts;
    +mongoc_client_session_t *client_session;
    +mongoc_collection_t *collection;
    +bson_t insert_opts = BSON_INITIALIZER;
    +bson_t *doc;
    +bson_error_t error;
    +bool r;
    +
    +client = mongoc_client_new ("mongodb://example/?appname=session-opts-example");
    +mongoc_client_set_error_api (client, 2);
    +
    +session_opts = mongoc_session_opts_new ();
    +mongoc_session_opts_set_causal_consistency (session_opts, false);
    +client_session = mongoc_client_start_session (client, session_opts, &error);
    +mongoc_session_opts_destroy (session_opts);
    +
    +if (!client_session) {
    +   fprintf (stderr, "Failed to start session: %s\n", error.message);
    +   abort ();
    +}
    +
    +collection = mongoc_client_get_collection (client, "test", "collection");
    +doc = BCON_NEW ("_id", BCON_INT32 (1));
    +r = mongoc_client_session_append (client_session, &insert_opts, NULL);
    +if (!r) {
    +   fprintf (stderr, "mongoc_client_session_append failed: %s\n", error.message);
    +   abort ();
    +}
    +
    +r = mongoc_collection_insert_one (
    +   collection, doc, &insert_opts, NULL /* reply */, &error);
    +
    +if (!r) {
    +   fprintf (stderr, "Insert failed: %s\n", error.message);
    +   abort ();
    +}
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_set_default_transaction_opts.html b/libmongoc/1.24.0/mongoc_session_opts_set_default_transaction_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..9decaeada0ab825ca4ca6d45164b438bbaaca2a6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_set_default_transaction_opts.html @@ -0,0 +1,309 @@ + + + + + + + + + + + + + + mongoc_session_opts_set_default_transaction_opts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_set_default_transaction_opts()

    +
    +

    Synopsis

    +
    void
    +mongoc_session_opts_set_default_transaction_opts (
    +   mongoc_session_opt_t *opts, const mongoc_transaction_opt_t *txn_opts);
    +
    +
    +

    Set the default options for transactions started with this session. The txn_opts argument is copied and can be freed after calling this function.

    +

    When a session is first created with mongoc_client_start_session(), it inherits from the client the read concern, write concern, and read preference with which to start transactions. Each of these fields can be overridden independently. Create a mongoc_transaction_opt_t with mongoc_transaction_opts_new(), and pass a non-NULL option to any of the mongoc_transaction_opt_t setter functions:

    + +

    Pass the resulting transaction options to mongoc_session_opts_set_default_transaction_opts(). Each field set in the transaction options overrides the inherited client configuration. There is an opportunity to override each one of these fields again by passing a mongoc_transaction_opt_t to mongoc_client_session_start_transaction().

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_session_opts_set_snapshot.html b/libmongoc/1.24.0/mongoc_session_opts_set_snapshot.html new file mode 100644 index 0000000000000000000000000000000000000000..47b83cfc2f2db08f74b7373f00f38abfcc0dc577 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_session_opts_set_snapshot.html @@ -0,0 +1,343 @@ + + + + + + + + + + + + + + mongoc_session_opts_set_snapshot() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_session_opts_set_snapshot()

    +
    +

    Synopsis

    +
    void
    +mongoc_session_opts_set_snapshot (mongoc_session_opt_t *opts,
    +                                  bool snapshot);
    +
    +
    +

    Configure snapshot reads for a session. If true (false by default), each read operation in the session will be sent with a “snapshot” level read concern. After the first read operation (“find”, “aggregate” or “distinct”), subsequent read operations will read from the same point in time as the first read operation. Set to true to enable snapshot reads. See the official documentation for Read Concern “snapshot”.

    +

    Snapshot reads and causal consistency are mutually exclusive. Attempting to set both to true will result in an error. See mongoc_session_opts_set_causal_consistency().

    +

    Snapshot reads can only be used on MongoDB server version 5.0 and later and cannot be used during a transaction. A write operation in a snapshot-enabled session will also result in an error.

    +
    +
    +

    Parameters

    + +
    +
    +

    Example

    +
    mongoc_client_t *client;
    +mongoc_session_opt_t *session_opts;
    +mongoc_client_session_t *client_session;
    +mongoc_collection_t *collection;
    +bson_t query_opts = BSON_INITIALIZER;
    +bson_t filter = BSON_INITIALIZER;
    +bson_t pipeline = BSON_INITIALIZER;
    +
    +client = mongoc_client_new ("mongodb://example/?appname=session-opts-example");
    +mongoc_client_set_error_api (client, MONGOC_ERROR_API_VERSION_2);
    +
    +session_opts = mongoc_session_opts_new ();
    +mongoc_session_opts_set_snapshot (session_opts, true);
    +client_session = mongoc_client_start_session (client, session_opts, &error);
    +mongoc_session_opts_destroy (session_opts);
    +
    +if (!client_session) {
    +   fprintf (stderr, "Failed to start session: %s\n", error.message);
    +   abort ();
    +}
    +
    +collection = mongoc_client_get_collection (client, "test", "collection");
    +r = mongoc_client_session_append (client_session, &find_opts, &error);
    +if (!r) {
    +   fprintf (stderr, "mongoc_client_session_append failed: %s\n", error.message);
    +   abort ();
    +}
    +
    +/* First read operation will set the snapshot time for subsequent reads. */
    +cursor = mongoc_collection_find_with_opts (collection, filter, &query_opts, NULL);
    +
    +/* Subsequent read operations will automatically read from the same point
    + * in time as the first read operation. */
    +cursor = mongoc_collection_aggregate (collection, MONGOC_QUERY_NONE, pipeline, &query_opts, NULL);
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_accept.html b/libmongoc/1.24.0/mongoc_socket_accept.html new file mode 100644 index 0000000000000000000000000000000000000000..cb5f833fc8f8ab36419dd4e64dbdfee600dcd5f8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_accept.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_socket_accept() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_accept()

    +
    +

    Synopsis

    +
    mongoc_socket_t *
    +mongoc_socket_accept (mongoc_socket_t *sock,
    +                      int64_t expire_at) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • expire_at: An int64_t containing a timeout in milliseconds.

    • +
    +
    +
    +

    Description

    +

    This function is a wrapper around the BSD socket accept() interface. It allows for more portability between UNIX-like and Microsoft Windows platforms.

    +
    +
    +

    Returns

    +

    NULL upon failure to accept or timeout. A newly allocated mongoc_socket_t that should be released with mongoc_socket_destroy() on success.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_bind.html b/libmongoc/1.24.0/mongoc_socket_bind.html new file mode 100644 index 0000000000000000000000000000000000000000..b944133db9cecc904cb1b8fc56dfe3eba4ed7fd3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_bind.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_socket_bind() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_bind()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_bind (mongoc_socket_t *sock,
    +                    const struct sockaddr *addr,
    +                    mongoc_socklen_t addrlen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • addr: A struct sockaddr.

    • +
    • addrlen: A mongoc_socklen_t.

    • +
    +
    +
    +

    Description

    +

    This function is a wrapper around the BSD socket bind() interface. It provides better portability between UNIX-like and Microsoft Windows platforms.

    +
    +
    +

    Returns

    +

    0 on success, -1 on failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_close.html b/libmongoc/1.24.0/mongoc_socket_close.html new file mode 100644 index 0000000000000000000000000000000000000000..23930198daa0f55862678b82ee1200de70b03607 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_close.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_socket_close() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_close()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_close (mongoc_socket_t *socket);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function is a wrapper around the BSD socket shutdown() and close() functions, and their Windows equivalents. The socket is shut down only if the current process is the same as the process that opened the socket. Regardless, the socket is then closed.

    +
    +
    +

    Returns

    +

    0 on success, -1 on failure to close the socket. On failure, the socket’s errno is set; retrieve it with mongoc_socket_errno().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_connect.html b/libmongoc/1.24.0/mongoc_socket_connect.html new file mode 100644 index 0000000000000000000000000000000000000000..391399ebc5a0e8dbef9a80d7d7d8c90d10ac4b35 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_connect.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_socket_connect() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_connect()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_connect (mongoc_socket_t *sock,
    +                       const struct sockaddr *addr,
    +                       mongoc_socklen_t addrlen,
    +                       int64_t expire_at);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • addr: A struct sockaddr.

    • +
    • addrlen: A mongoc_socklen_t.

    • +
    • expire_at: A int64_t containing the absolute timeout using the monotonic clock.

    • +
    +
    +
    +

    Description

    +

    This function is a wrapper around the BSD socket connect() interface. It provides better portability between UNIX-like and Microsoft Windows platforms.

    +

    This function performs a socket connection but will fail if expire_at has been reached by the monotonic clock. Keep in mind that this is an absolute timeout in milliseconds. You should add your desired timeout to System Clock.

    +
    +
    +

    Returns

    +

    0 if successful, -1 on failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_destroy.html b/libmongoc/1.24.0/mongoc_socket_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..2e3d030fb2f871ec316cb6d76c312ba904f743ec --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_socket_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_socket_destroy (mongoc_socket_t *sock);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function releases all resources associated with a mongoc_socket_t. This should be called when you are no longer using the socket. Does nothing if sock is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_errno.html b/libmongoc/1.24.0/mongoc_socket_errno.html new file mode 100644 index 0000000000000000000000000000000000000000..edddbef73ff5a3efa05c50118551cc5316671deb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_errno.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_socket_errno() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_errno()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_errno (mongoc_socket_t *sock);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function returns the currently captured errno for a socket. This may be useful to check was the last errno was after another function call has been made that clears the threads errno variable.

    +
    +
    +

    Returns

    +

    0 if there is no error, otherwise a specific errno.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_getnameinfo.html b/libmongoc/1.24.0/mongoc_socket_getnameinfo.html new file mode 100644 index 0000000000000000000000000000000000000000..fbc231da0dc8097804bf5573dec06ac9948ce6e0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_getnameinfo.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_socket_getnameinfo() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_getnameinfo()

    +
    +

    Synopsis

    +
    char *
    +mongoc_socket_getnameinfo (mongoc_socket_t *sock) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This is a helper around getting the local name of a socket. It is a wrapper around getpeername() and getnameinfo().

    +
    +
    +

    Returns

    +

    A newly allocated string that should be freed with bson_free().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_getsockname.html b/libmongoc/1.24.0/mongoc_socket_getsockname.html new file mode 100644 index 0000000000000000000000000000000000000000..f2a251a3f1b047ce94ba5094a307820fd37e0d97 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_getsockname.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_socket_getsockname() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_getsockname()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_getsockname (mongoc_socket_t *sock,
    +                           struct sockaddr *addr,
    +                           mongoc_socklen_t *addrlen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • addr: A struct sockaddr.

    • +
    • addrlen: A mongoc_socklen_t.

    • +
    +
    +
    +

    Description

    +

    Retrieves the socket name for sock. The result is stored in addr. addrlen should be the size of the addr when calling this.

    +
    +
    +

    Returns

    +

    0 if successful, otherwise -1 and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_listen.html b/libmongoc/1.24.0/mongoc_socket_listen.html new file mode 100644 index 0000000000000000000000000000000000000000..a569e1cd3bde714b3709cc80d3ada150ada92e52 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_listen.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_socket_listen() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_listen()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_listen (mongoc_socket_t *sock, unsigned int backlog);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function is similar to the BSD sockets listen() function. It is meant for socket servers.

    +
    +
    +

    Returns

    +

    0 on success, -1 on failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_new.html b/libmongoc/1.24.0/mongoc_socket_new.html new file mode 100644 index 0000000000000000000000000000000000000000..30de8ce633db10e722b5aadb47f1dcb1e4b2960b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_new.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_socket_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_new()

    +
    +

    Synopsis

    +
    mongoc_socket_t *
    +mongoc_socket_new (int domain,
    +                   int type,
    +                   int protocol) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • domain: An int containing the address family such as AF_INET.

    • +
    • type: An int containing the socket type such as SOCK_STREAM.

    • +
    • protocol: A protocol subset, typically 0.

    • +
    +
    +
    +

    Description

    +

    Creates a new mongoc_socket_t structure. This calls socket() underneath to create a network socket.

    +
    +
    +

    Returns

    +

    A new socket if successful, otherwise NULL and errno is set. The result should be freed with mongoc_socket_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_recv.html b/libmongoc/1.24.0/mongoc_socket_recv.html new file mode 100644 index 0000000000000000000000000000000000000000..497036a1b66ed83a4f24f4d8aa5f1a922b850969 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_recv.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_socket_recv() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_recv()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_socket_recv (mongoc_socket_t *sock,
    +                    void *buf,
    +                    size_t buflen,
    +                    int flags,
    +                    int64_t expire_at);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • buf: A buffer to read into.

    • +
    • buflen: A size_t with the number of bytes to receive.

    • +
    • flags: flags for recv().

    • +
    • expire_at: A int64_t with the time to expire in monotonic time using System Clock, which is in microseconds.

    • +
    +
    +
    +

    Description

    +

    This function performs a recv() on the underlying socket.

    +
    +
    +

    Returns

    +

    The number of bytes received on success, 0 on stream closed, and -1 if there was a failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_send.html b/libmongoc/1.24.0/mongoc_socket_send.html new file mode 100644 index 0000000000000000000000000000000000000000..865a5cccbc51f2defdadcd004f21908c505fc52e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_send.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_socket_send() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_send()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_socket_send (mongoc_socket_t *sock,
    +                    const void *buf,
    +                    size_t buflen,
    +                    int64_t expire_at);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • buf: A buffer to send.

    • +
    • buflen: A size_t with the number of bytes in buf.

    • +
    • expire_at: A int64_t with an absolute timeout for the operation or 0. The timeout is in monotonic time using microseconds. You can retrieve the current monotonic time with System Clock.

    • +
    +
    +
    +

    Description

    +

    Sends buflen bytes in buf to the destination. If a timeout expired, the number of bytes sent will be returned or -1 if no bytes were sent.

    +
    +
    +

    Returns

    +

    -1 on failure and errno is set, or the number of bytes sent.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_sendv.html b/libmongoc/1.24.0/mongoc_socket_sendv.html new file mode 100644 index 0000000000000000000000000000000000000000..dcf8a0b4a26d80091d123dae507f714d1b637cc8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_sendv.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_socket_sendv() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_sendv()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_socket_sendv (mongoc_socket_t *sock,
    +                     mongoc_iovec_t *iov,
    +                     size_t iovcnt,
    +                     int64_t expire_at);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • iov: A mongoc_iovec_t.

    • +
    • iovcnt: A size_t containing the number of elements in iov.

    • +
    • expire_at: A int64_t with absolute timeout in monotonic time. The monotonic clock is in microseconds and can be fetched using System Clock.

    • +
    +
    +
    +

    Description

    +

    Sends a vector of buffers to the destination. This uses sendmsg() when available to perform a gathered write. If IOV_MAX is reached, a fallback will be used.

    +
    +
    +

    Returns

    +

    the number of bytes sent on success, or -1 on failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_setsockopt.html b/libmongoc/1.24.0/mongoc_socket_setsockopt.html new file mode 100644 index 0000000000000000000000000000000000000000..3fe3f919b028726f2e2497bff1cc5828bf865c8c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_setsockopt.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_socket_setsockopt() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_setsockopt()

    +
    +

    Synopsis

    +
    int
    +mongoc_socket_setsockopt (mongoc_socket_t *sock,
    +                          int level,
    +                          int optname,
    +                          const void *optval,
    +                          mongoc_socklen_t optlen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • sock: A mongoc_socket_t.

    • +
    • level: A sockopt level.

    • +
    • optname: A sockopt name.

    • +
    • optval: A the value for the sockopt.

    • +
    • optlen: A mongoc_socklen_t that contains the length of optval.

    • +
    +
    +
    +

    Description

    +

    This is a helper function for setsockopt().

    +
    +
    +

    Returns

    +

    0 on success, -1 on failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_socket_t.html b/libmongoc/1.24.0/mongoc_socket_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1e3861a8992e1ef5bd288fa41e6b34577a6d79be --- /dev/null +++ b/libmongoc/1.24.0/mongoc_socket_t.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_socket_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_socket_t

    +

    Portable socket abstraction

    +
    +

    Synopsis

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_socket_t mongoc_socket_t
    +
    +
    +
    +
    +

    Synopsis

    +

    This structure provides a socket abstraction that is friendlier for portability than BSD sockets directly. Inconsistencies between Linux, various BSDs, Solaris, and Windows are handled here.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_ssl_opt_get_default.html b/libmongoc/1.24.0/mongoc_ssl_opt_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..c8f23577a1c202770d3d4bd3286e94943df6937a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_ssl_opt_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_ssl_opt_get_default() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_ssl_opt_get_default()

    +
    +

    Synopsis

    +
    const mongoc_ssl_opt_t *
    +mongoc_ssl_opt_get_default (void) BSON_GNUC_PURE;
    +
    +
    +
    +
    +

    Returns

    +

    Returns the default SSL options for the process. This should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_ssl_opt_t.html b/libmongoc/1.24.0/mongoc_ssl_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a04749da89fa52862df15e4651145fae5b67cd9c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_ssl_opt_t.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_ssl_opt_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_ssl_opt_t

    +
    +

    Synopsis

    +
    typedef struct {
    +   const char *pem_file;
    +   const char *pem_pwd;
    +   const char *ca_file;
    +   const char *ca_dir;
    +   const char *crl_file;
    +   bool weak_cert_validation;
    +   bool allow_invalid_hostname;
    +   void *internal;
    +   void *padding[6];
    +} mongoc_ssl_opt_t;
    +
    +
    +
    +
    +

    Description

    +

    This structure is used to set the TLS options for a mongoc_client_t or mongoc_client_pool_t.

    +

    Beginning in version 1.2.0, once a pool or client has any TLS options set, all connections use TLS, even if ssl=true is omitted from the MongoDB URI. Before, TLS options were ignored unless tls=true was included in the URI.

    +

    As of 1.4.0, the mongoc_client_pool_set_ssl_opts() and mongoc_client_set_ssl_opts() will not only shallow copy the struct, but will also copy the const char*. It is therefore no longer needed to make sure the values remain valid after setting them.

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_buffered_new.html b/libmongoc/1.24.0/mongoc_stream_buffered_new.html new file mode 100644 index 0000000000000000000000000000000000000000..67f8b9d3cd861bdd14b20eb455ca20f8a0e95c8f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_buffered_new.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_stream_buffered_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_buffered_new()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_stream_buffered_new (mongoc_stream_t *base_stream,
    +                        size_t buffer_size) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • base_stream: A mongoc_stream_t to buffer.

    • +
    • buffer_size: A size_t containing the desired buffer size.

    • +
    +

    This function shall create a new mongoc_stream_t that buffers bytes to and from the underlying base_stream.

    +

    buffer_size will be used as the initial buffer size. It may grow past this size.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_stream_buffered_t on success, otherwise NULL. This should be freed with mongoc_stream_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_buffered_t.html b/libmongoc/1.24.0/mongoc_stream_buffered_t.html new file mode 100644 index 0000000000000000000000000000000000000000..54439790b9040710c00eab37f25cec82933ede8c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_buffered_t.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_stream_buffered_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_buffered_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_stream_buffered_t mongoc_stream_buffered_t;
    +
    +
    +
    +
    +

    Description

    +

    mongoc_stream_buffered_t should be considered a subclass of mongoc_stream_t. It performs buffering on an underlying stream.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_close.html b/libmongoc/1.24.0/mongoc_stream_close.html new file mode 100644 index 0000000000000000000000000000000000000000..49ac0195972d5812433687e5a14b2d407bb28b9e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_close.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_stream_close() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_close()

    +
    +

    Synopsis

    +
    int
    +mongoc_stream_close (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall close underlying file-descriptors of stream.

    +
    +
    +

    Returns

    +

    0 on success, otherwise -1 and errno is set.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_cork.html b/libmongoc/1.24.0/mongoc_stream_cork.html new file mode 100644 index 0000000000000000000000000000000000000000..ffcc61574d87f21678aca83d1b7a026b9c9a4601 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_cork.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_stream_cork() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_cork()

    +
    +

    Synopsis

    +
    int
    +mongoc_stream_cork (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall prevent the writing of bytes to the underlying socket.

    +
    +

    Note

    +

    Not all streams implement this function. Buffering generally works better.

    +
    +
    +
    +

    Returns

    +

    0 on success, -1 on failure and errno is set.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_destroy.html b/libmongoc/1.24.0/mongoc_stream_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5796d90d82ab51bcc8e48b50bf6dfbdd72f2d8f4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_stream_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_stream_destroy (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall release all resources associated with a mongoc_stream_t, including freeing the structure. It is invalid to use stream after calling this function. Does nothing if stream is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_file_get_fd.html b/libmongoc/1.24.0/mongoc_stream_file_get_fd.html new file mode 100644 index 0000000000000000000000000000000000000000..19ebeec1a2e2e984338354dcafe534816f232b5d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_file_get_fd.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_stream_file_get_fd() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_file_get_fd()

    +
    +

    Synopsis

    +
    int
    +mongoc_stream_file_get_fd (mongoc_stream_file_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall return the underlying file-descriptor of a mongoc_stream_file_t.

    +
    +

    Warning

    +

    Performing operations on the underlying file-descriptor may not be safe if used in conjunction with buffering. Avoid reading or writing from this file-descriptor.

    +
    +
    +
    +

    Returns

    +

    A file-descriptor that should not be modified by the caller.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_file_new.html b/libmongoc/1.24.0/mongoc_stream_file_new.html new file mode 100644 index 0000000000000000000000000000000000000000..d93d459324224d061cff54d7b7f9f0cabe0ea78b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_file_new.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_stream_file_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_file_new()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_stream_file_new (int fd) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • fd: A UNIX style file-descriptor.

    • +
    +

    Creates a new mongoc_stream_file_t using the file-descriptor provided.

    +
    +
    +

    Returns

    +

    NULL upon failure, otherwise a newly allocated mongoc_stream_file_t that should be freed with mongoc_stream_destroy() when no longer in use.

    +

    errno is set upon failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_file_new_for_path.html b/libmongoc/1.24.0/mongoc_stream_file_new_for_path.html new file mode 100644 index 0000000000000000000000000000000000000000..87f23980f47278fdc44e38d1024c4c10ad027608 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_file_new_for_path.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_stream_file_new_for_path() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_file_new_for_path()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_stream_file_new_for_path (const char *path,
    +                                 int flags,
    +                                 int mode) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • path: The path of the target file.

    • +
    • flags: Flags to be passed to open().

    • +
    • mode: An optional mode to be passed to open() when creating a file.

    • +
    +

    This function shall create a new mongoc_stream_file_t after opening the underlying file with open() or the platform equivalent.

    +
    +
    +

    Returns

    +

    NULL on failure, otherwise a newly allocated mongoc_stream_file_t that should be freed with mongoc_stream_destroy() when no longer in use.

    +

    errno is set upon failure.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_file_t.html b/libmongoc/1.24.0/mongoc_stream_file_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ce97ec13648655f1cb756a6c242e09ce246da84b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_file_t.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_stream_file_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_file_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_stream_file_t mongoc_stream_file_t
    +
    +
    +

    mongoc_stream_file_t is a mongoc_stream_t subclass for working with standard UNIX style file-descriptors.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_flush.html b/libmongoc/1.24.0/mongoc_stream_flush.html new file mode 100644 index 0000000000000000000000000000000000000000..d43a92c134a1dec8b8748f37aefe7ac136778d1b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_flush.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_stream_flush() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_flush()

    +
    +

    Synopsis

    +
    int
    +mongoc_stream_flush (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall flush any buffered bytes in the underlying stream to the physical transport. It mimics the API and semantics of fflush(), forcing a write of user space buffered data.

    +

    Not all stream implementations may implement this feature.

    +
    +
    +

    Returns

    +

    0 is returned on success, otherwise -1 and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_get_base_stream.html b/libmongoc/1.24.0/mongoc_stream_get_base_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..22f037f9561c3cdb646755ce4b2301f2942ffa73 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_get_base_stream.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_stream_get_base_stream() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_get_base_stream()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_stream_get_base_stream (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall fetch the underlying stream for streams that wrap a base stream. Such implementations include mongoc_stream_buffered_t and mongoc_stream_tls_t.

    +
    +
    +

    Returns

    +

    A mongoc_stream_t or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_gridfs_new.html b/libmongoc/1.24.0/mongoc_stream_gridfs_new.html new file mode 100644 index 0000000000000000000000000000000000000000..6f8c3f26793ae03f186b5a256c65d372dab87237 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_gridfs_new.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_stream_gridfs_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_gridfs_new()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_stream_gridfs_new (mongoc_gridfs_file_t *file)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall create a new mongoc_stream_t to read from and write to a GridFS file. GridFS files are created with mongoc_gridfs_create_file() or mongoc_gridfs_create_file_from_stream().

    +

    This function does not transfer ownership of file. Therefore, file must remain valid for the lifetime of this stream.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_stream_t if successful, otherwise NULL.

    +

    Note, the returned stream ignores read and write timeouts passed to mongoc_stream_readv(), mongoc_stream_writev(), and so on. It uses the “socketTimeoutMS” and “connectTimeoutMS” values from the MongoDB URI.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_read.html b/libmongoc/1.24.0/mongoc_stream_read.html new file mode 100644 index 0000000000000000000000000000000000000000..5afab852854817dc051a4b87b125f9fea9324d15 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_read.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_stream_read() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_read()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_stream_read (mongoc_stream_t *stream,
    +                    void *buf,
    +                    size_t count,
    +                    size_t min_bytes,
    +                    int32_t timeout_msec);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • stream: A mongoc_stream_t.

    • +
    • buf: The buffer to read into.

    • +
    • count: The number of bytes to read.

    • +
    • min_bytes: The minimum number of bytes to read, or else indicate failure.

    • +
    • timeout_msec: The number of milliseconds to wait before failure, a timeout of 0 will not block. If negative, use the default timeout.

    • +
    +

    The mongoc_stream_read() function shall perform a read from a mongoc_stream_t. It’s modeled on the API and semantics of read(), though the parameters map only loosely.

    +
    +
    +

    Returns

    +

    The mongoc_stream_read() function returns the number of bytes read on success. It returns >= 0 and < min_bytes when end-of-file is encountered and -1 on failure. errno is set upon failure.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_readv.html b/libmongoc/1.24.0/mongoc_stream_readv.html new file mode 100644 index 0000000000000000000000000000000000000000..65df200a542f34b249d72f65ee686d2de3651f30 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_readv.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_stream_readv() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_readv()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_stream_readv (mongoc_stream_t *stream,
    +                     mongoc_iovec_t *iov,
    +                     size_t iovcnt,
    +                     size_t min_bytes,
    +                     int32_t timeout_msec);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • stream: A mongoc_stream_t.

    • +
    • iov: A vector of mongoc_iovec_t.

    • +
    • iovcnt: The number of items in iov.

    • +
    • min_bytes: The minimum number of bytes to read or failure will be indicated.

    • +
    • timeout_msec: A timeout in milliseconds, or 0 to indicate non-blocking. A negative value with use the default timeout.

    • +
    +

    This function is identical to mongoc_stream_read() except that it takes a mongoc_iovec_t to perform gathered I/O.

    +
    +
    +

    Returns

    +

    >= 0 on success, -1 on failure and errno is set.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_setsockopt.html b/libmongoc/1.24.0/mongoc_stream_setsockopt.html new file mode 100644 index 0000000000000000000000000000000000000000..207ea0eca433d62f2688d31bbde7fa97de1278ab --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_setsockopt.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_stream_setsockopt() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_setsockopt()

    +
    +

    Synopsis

    +
    int
    +mongoc_stream_setsockopt (mongoc_stream_t *stream,
    +                          int level,
    +                          int optname,
    +                          void *optval,
    +                          mongoc_socklen_t optlen);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • stream: A mongoc_stream_t.

    • +
    • level: The level to pass to setsockopt().

    • +
    • optname: The optname to pass to setsockopt().

    • +
    • optval: The optval to pass to setsockopt().

    • +
    • optlen: The optlen to pass to setsockopt().

    • +
    +

    This function is a wrapper around setsockopt() for streams that wrap sockets.

    +
    +
    +

    Returns

    +

    0 on success, otherwise -1 and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_should_retry.html b/libmongoc/1.24.0/mongoc_stream_should_retry.html new file mode 100644 index 0000000000000000000000000000000000000000..ff6c00728bd8aa93c09cee82b01fe1f7a6d1f021 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_should_retry.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_stream_should_retry() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_should_retry()

    +
    +

    Synopsis

    +
    bool
    +mongoc_stream_should_retry (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True if the stream is open and has encountered a retryable network error such as EAGAIN or if a TLS exchange is in progress and needs more data.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_socket_get_socket.html b/libmongoc/1.24.0/mongoc_stream_socket_get_socket.html new file mode 100644 index 0000000000000000000000000000000000000000..cc6c340d76e77d1a4a0df6928e73c7e4c0d3de19 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_socket_get_socket.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_stream_socket_get_socket() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_socket_get_socket()

    +
    +

    Synopsis

    +
    mongoc_socket_t *
    +mongoc_stream_socket_get_socket (mongoc_stream_socket_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    Retrieves the underlying mongoc_socket_t for a mongoc_stream_socket_t.

    +
    +
    +

    Returns

    +

    A mongoc_stream_socket_t.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_socket_new.html b/libmongoc/1.24.0/mongoc_stream_socket_new.html new file mode 100644 index 0000000000000000000000000000000000000000..0bf561f75b06381e067dba59b2c38ae6807435a2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_socket_new.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_stream_socket_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_socket_new()

    +
    +

    Synopsis

    +
    mongoc_stream_t *
    +mongoc_stream_socket_new (mongoc_socket_t *socket)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +

    Creates a new mongoc_stream_socket_t using the mongoc_socket_t provided.

    +
    +

    Warning

    +

    This function transfers ownership of socket to the newly allocated stream.

    +
    +
    +
    +

    Returns

    +

    A newly allocated mongoc_stream_socket_t that should be freed with mongoc_stream_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_socket_t.html b/libmongoc/1.24.0/mongoc_stream_socket_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a2a4a1dfecc5a013fbe4ed2924c6064f7c2194ff --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_socket_t.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_stream_socket_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_socket_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_stream_socket_t mongoc_stream_socket_t
    +
    +
    +

    mongoc_stream_socket_t should be considered a subclass of mongoc_stream_t that works upon socket streams.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_t.html b/libmongoc/1.24.0/mongoc_stream_t.html new file mode 100644 index 0000000000000000000000000000000000000000..fd94bf76e1e6485cdf96c47fbf2e3d0289715a04 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_t.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_stream_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_stream_t mongoc_stream_t
    +
    +
    +

    mongoc_stream_t provides a generic streaming IO abstraction based on a struct of pointers interface. The idea is to allow wrappers, perhaps other language drivers, to easily shim their IO system on top of mongoc_stream_t.

    +

    The API for the stream abstraction is currently private and non-extensible.

    +
    +
    +

    Stream Types

    +

    There are a number of built in stream types that come with mongoc. The default configuration is a buffered unix stream. If TLS is in use, that in turn is wrapped in a tls stream.

    + +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_timed_out.html b/libmongoc/1.24.0/mongoc_stream_timed_out.html new file mode 100644 index 0000000000000000000000000000000000000000..6641302787756b7068fe7beb102bf7168692f684 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_timed_out.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_stream_timed_out() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_timed_out()

    +
    +

    Synopsis

    +
    bool
    +mongoc_stream_timed_out (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True if there has been a network timeout error on this stream.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_tls_t.html b/libmongoc/1.24.0/mongoc_stream_tls_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c5b5b03f69aa02f12ca3ba1e0516922b7d37d723 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_tls_t.html @@ -0,0 +1,190 @@ + + + + + + + + + + + + + + mongoc_stream_tls_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_tls_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_stream_tls_t mongoc_stream_tls_t
    +
    +
    +

    mongoc_stream_tls_t is a mongoc_stream_t subclass for working with TLS streams.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_uncork.html b/libmongoc/1.24.0/mongoc_stream_uncork.html new file mode 100644 index 0000000000000000000000000000000000000000..d236b6b741678d5a6352cd4c2ca759dc63be901a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_uncork.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_stream_uncork() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_uncork()

    +
    +

    Synopsis

    +
    int
    +mongoc_stream_uncork (mongoc_stream_t *stream);
    +
    +
    +
    +
    +

    Parameters

    + +

    This function shall allow a previously corked socket to pass bytes to the underlying socket.

    +
    +

    Note

    +

    Not all streams implement this function. Buffering generally works better.

    +
    +
    +
    +

    Returns

    +

    0 on success, -1 on failure and errno is set.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_write.html b/libmongoc/1.24.0/mongoc_stream_write.html new file mode 100644 index 0000000000000000000000000000000000000000..29c427274594088575914ea3f5c8cd3a428c4a1a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_write.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_stream_write() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_write()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_stream_write (mongoc_stream_t *stream,
    +                     void *buf,
    +                     size_t count,
    +                     int32_t timeout_msec);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • stream: A mongoc_stream_t.

    • +
    • buf: The buffer to write.

    • +
    • count: The number of bytes to write.

    • +
    • timeout_msec: The number of milliseconds to wait before failure, a timeout of 0 will not block. If negative, use the default timeout.

    • +
    +

    The mongoc_stream_write() function shall perform a write to a mongoc_stream_t. It’s modeled on the API and semantics of write(), though the parameters map only loosely.

    +
    +
    +

    Returns

    +

    The mongoc_stream_write() function returns the number of bytes written on success. It returns -1 and sets errno upon failure.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_stream_writev.html b/libmongoc/1.24.0/mongoc_stream_writev.html new file mode 100644 index 0000000000000000000000000000000000000000..003eaa255075d79bf378833826803030db8a32f8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_stream_writev.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_stream_writev() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_stream_writev()

    +
    +

    Synopsis

    +
    ssize_t
    +mongoc_stream_writev (mongoc_stream_t *stream,
    +                      mongoc_iovec_t *iov,
    +                      size_t iovcnt,
    +                      int32_t timeout_msec);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • stream: A mongoc_stream_t.

    • +
    • iov: A vector of mongoc_iovec_t.

    • +
    • iovcnt: The number of items in iov.

    • +
    • timeout_msec: The number of milliseconds to block before indicating failure, or 0 for non-blocking. Negative values indicate the default timeout.

    • +
    +

    The mongoc_stream_writev() function shall perform a write +to a mongoc_stream_t. It’s modeled on the +API and semantics of writev(), though the parameters map only +loosely.

    +
    +
    +

    Returns

    +

    The number of bytes written on success, or -1 upon failure and errno is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_destroy.html b/libmongoc/1.24.0/mongoc_topology_description_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..e88ae0d33de06e809020bf4f639137bdf5ee5d6a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_topology_description_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_topology_description_destroy (mongoc_topology_description_t *description);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees all resources associated with the topology description. Does nothing if description is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_get_servers.html b/libmongoc/1.24.0/mongoc_topology_description_get_servers.html new file mode 100644 index 0000000000000000000000000000000000000000..3b9872e1c79ba6405983ca1645784ec03085eb63 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_get_servers.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_topology_description_get_servers() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_get_servers()

    +
    +

    Synopsis

    +
    mongoc_server_description_t **
    +mongoc_topology_description_get_servers (
    +   const mongoc_topology_description_t *td,
    +   size_t *n) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Fetches an array of mongoc_server_description_t structs for all known servers in the topology.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A newly allocated array that must be freed with mongoc_server_descriptions_destroy_all().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_has_readable_server.html b/libmongoc/1.24.0/mongoc_topology_description_has_readable_server.html new file mode 100644 index 0000000000000000000000000000000000000000..eaab4035b9dca1c410cebd00eb75dcb3b5789bfd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_has_readable_server.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_topology_description_has_readable_server() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_has_readable_server()

    +
    +

    Synopsis

    +
    bool
    +mongoc_topology_description_has_readable_server (
    +  const mongoc_topology_description_t *td, const mongoc_read_prefs_t *prefs);
    +
    +
    +

    Determines if the topology has a readable server available. Servers are filtered +by the given read preferences only if the driver is connected to a replica set, +otherwise the read preferences are ignored. This function uses the driver’s +current knowledge of the state of the MongoDB server or servers it is connected +to; it does no I/O and it does not block.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True if there is a known server matching prefs.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_has_writable_server.html b/libmongoc/1.24.0/mongoc_topology_description_has_writable_server.html new file mode 100644 index 0000000000000000000000000000000000000000..6b49f610f68629e4ecd8978ec1c7544039c4cd8a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_has_writable_server.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_topology_description_has_writable_server() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_has_writable_server()

    +
    +

    Synopsis

    +
    bool
    +mongoc_topology_description_has_writable_server (
    +   const mongoc_topology_description_t *td);
    +
    +
    +

    Determines if the topology has a writable server available, such as a primary, +mongos, or standalone. This function uses the driver’s current knowledge of the +state of the MongoDB server or servers it is connected to; it does no I/O and it +does not block.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    True if there is a known writable server.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_new_copy.html b/libmongoc/1.24.0/mongoc_topology_description_new_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..b23010c631d1d210a738b8f817f79d7c99dd0781 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_new_copy.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_topology_description_new_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_new_copy()

    +
    +

    Synopsis

    +
    mongoc_topology_description_t *
    +mongoc_topology_description_new_copy (
    +   const mongoc_topology_description_t *description)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a deep copy of description.

    +
    +
    +

    Returns

    +

    Returns a newly allocated copy of description that should be freed with mongoc_topology_description_destroy() when no longer in use. Returns NULL if description is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_t.html b/libmongoc/1.24.0/mongoc_topology_description_t.html new file mode 100644 index 0000000000000000000000000000000000000000..e98be3ed12d0ff9f6a1027cc2ad59f369922c883 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_t.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_topology_description_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_t

    +

    Status of MongoDB Servers

    +
    +

    Synopsis

    +
    typedef struct _mongoc_topology_description_t mongoc_topology_description_t;
    +
    +
    +

    mongoc_topology_description_t is an opaque type representing the driver’s knowledge of the MongoDB server or servers it is connected to. +Its API conforms to the SDAM Monitoring Specification.

    +

    Applications receive a temporary reference to a mongoc_topology_description_t as a parameter to an SDAM Monitoring callback that must not be destroyed. See Introduction to Application Performance Monitoring.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_topology_description_type.html b/libmongoc/1.24.0/mongoc_topology_description_type.html new file mode 100644 index 0000000000000000000000000000000000000000..71ede309ac87af96a5709366aea12426067e2a5f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_topology_description_type.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_topology_description_type() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_topology_description_type()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_topology_description_type (const mongoc_topology_description_t *td);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function returns a string, one of the topology types defined in the Server Discovery And Monitoring Spec:

    +
      +
    • Unknown

    • +
    • Single

    • +
    • Sharded

    • +
    • ReplicaSetNoPrimary

    • +
    • ReplicaSetWithPrimary

    • +
    • LoadBalanced

    • +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opt_t.html b/libmongoc/1.24.0/mongoc_transaction_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..6a35a90af5fc635a3f174a4c2dd84f9a411ea25e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opt_t.html @@ -0,0 +1,405 @@ + + + + + + + + + + + + + + mongoc_transaction_opt_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opt_t

    +
    #include <mongoc/mongoc.h>
    +
    +typedef struct _mongoc_transaction_opt_t mongoc_transaction_opt_t;
    +
    +
    +
    +

    Synopsis

    +

    Options for starting a multi-document transaction.

    +

    When a session is first created with mongoc_client_start_session(), it inherits from the client the read concern, write concern, and read preference with which to start transactions. Each of these fields can be overridden independently. Create a mongoc_transaction_opt_t with mongoc_transaction_opts_new(), and pass a non-NULL option to any of the mongoc_transaction_opt_t setter functions:

    + +

    Pass the resulting transaction options to mongoc_client_session_start_transaction(). Each field set in the transaction options overrides the inherited client configuration.

    +
    +
    +

    Example

    +
    +
    example-transaction.c
    +
    /* gcc example-transaction.c -o example-transaction \
    + *     $(pkg-config --cflags --libs libmongoc-1.0) */
    +
    +/* ./example-transaction [CONNECTION_STRING] */
    +
    +#include <stdio.h>
    +#include <mongoc/mongoc.h>
    +
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   int exit_code = EXIT_FAILURE;
    +
    +   mongoc_client_t *client = NULL;
    +   mongoc_database_t *database = NULL;
    +   mongoc_collection_t *collection = NULL;
    +   mongoc_client_session_t *session = NULL;
    +   mongoc_session_opt_t *session_opts = NULL;
    +   mongoc_transaction_opt_t *default_txn_opts = NULL;
    +   mongoc_transaction_opt_t *txn_opts = NULL;
    +   mongoc_read_concern_t *read_concern = NULL;
    +   mongoc_write_concern_t *write_concern = NULL;
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=transaction-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +   bson_t *doc = NULL;
    +   bson_t *insert_opts = NULL;
    +   int32_t i;
    +   int64_t start;
    +   bson_t reply = BSON_INITIALIZER;
    +   char *reply_json;
    +   bool r;
    +
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      MONGOC_ERROR ("failed to parse URI: %s\n"
    +                    "error message:       %s\n",
    +                    uri_string,
    +                    error.message);
    +      goto done;
    +   }
    +
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      goto done;
    +   }
    +
    +   mongoc_client_set_error_api (client, 2);
    +   database = mongoc_client_get_database (client, "example-transaction");
    +
    +   /* inserting into a nonexistent collection normally creates it, but a
    +    * collection can't be created in a transaction; create it now */
    +   collection =
    +      mongoc_database_create_collection (database, "collection", NULL, &error);
    +
    +   if (!collection) {
    +      /* code 48 is NamespaceExists, see error_codes.err in mongodb source */
    +      if (error.code == 48) {
    +         collection = mongoc_database_get_collection (database, "collection");
    +      } else {
    +         MONGOC_ERROR ("Failed to create collection: %s", error.message);
    +         goto done;
    +      }
    +   }
    +
    +   /* a transaction's read preferences, read concern, and write concern can be
    +    * set on the client, on the default transaction options, or when starting
    +    * the transaction. for the sake of this example, set read concern on the
    +    * default transaction options. */
    +   default_txn_opts = mongoc_transaction_opts_new ();
    +   read_concern = mongoc_read_concern_new ();
    +   mongoc_read_concern_set_level (read_concern, "snapshot");
    +   mongoc_transaction_opts_set_read_concern (default_txn_opts, read_concern);
    +   session_opts = mongoc_session_opts_new ();
    +   mongoc_session_opts_set_default_transaction_opts (session_opts,
    +                                                     default_txn_opts);
    +
    +   session = mongoc_client_start_session (client, session_opts, &error);
    +   if (!session) {
    +      MONGOC_ERROR ("Failed to start session: %s", error.message);
    +      goto done;
    +   }
    +
    +   /* in this example, set write concern when starting the transaction */
    +   txn_opts = mongoc_transaction_opts_new ();
    +   write_concern = mongoc_write_concern_new ();
    +   mongoc_write_concern_set_wmajority (write_concern, 1000 /* wtimeout */);
    +   mongoc_transaction_opts_set_write_concern (txn_opts, write_concern);
    +
    +   insert_opts = bson_new ();
    +   if (!mongoc_client_session_append (session, insert_opts, &error)) {
    +      MONGOC_ERROR ("Could not add session to opts: %s", error.message);
    +      goto done;
    +   }
    +
    +retry_transaction:
    +   r = mongoc_client_session_start_transaction (session, txn_opts, &error);
    +   if (!r) {
    +      MONGOC_ERROR ("Failed to start transaction: %s", error.message);
    +      goto done;
    +   }
    +
    +   /* insert two documents - on error, retry the whole transaction */
    +   for (i = 0; i < 2; i++) {
    +      doc = BCON_NEW ("_id", BCON_INT32 (i));
    +      bson_destroy (&reply);
    +      r = mongoc_collection_insert_one (
    +         collection, doc, insert_opts, &reply, &error);
    +
    +      bson_destroy (doc);
    +
    +      if (!r) {
    +         MONGOC_ERROR ("Insert failed: %s", error.message);
    +         mongoc_client_session_abort_transaction (session, NULL);
    +
    +         /* a network error, primary failover, or other temporary error in a
    +          * transaction includes {"errorLabels": ["TransientTransactionError"]},
    +          * meaning that trying the entire transaction again may succeed
    +          */
    +         if (mongoc_error_has_label (&reply, "TransientTransactionError")) {
    +            goto retry_transaction;
    +         }
    +
    +         goto done;
    +      }
    +
    +      reply_json = bson_as_json (&reply, NULL);
    +      printf ("%s\n", reply_json);
    +      bson_free (reply_json);
    +   }
    +
    +   /* in case of transient errors, retry for 5 seconds to commit transaction */
    +   start = bson_get_monotonic_time ();
    +   while (bson_get_monotonic_time () - start < 5 * 1000 * 1000) {
    +      bson_destroy (&reply);
    +      r = mongoc_client_session_commit_transaction (session, &reply, &error);
    +      if (r) {
    +         /* success */
    +         break;
    +      } else {
    +         MONGOC_ERROR ("Warning: commit failed: %s", error.message);
    +         if (mongoc_error_has_label (&reply, "TransientTransactionError")) {
    +            goto retry_transaction;
    +         } else if (mongoc_error_has_label (&reply,
    +                                            "UnknownTransactionCommitResult")) {
    +            /* try again to commit */
    +            continue;
    +         }
    +
    +         /* unrecoverable error trying to commit */
    +         break;
    +      }
    +   }
    +
    +   exit_code = EXIT_SUCCESS;
    +
    +done:
    +   bson_destroy (&reply);
    +   bson_destroy (insert_opts);
    +   mongoc_write_concern_destroy (write_concern);
    +   mongoc_read_concern_destroy (read_concern);
    +   mongoc_transaction_opts_destroy (txn_opts);
    +   mongoc_transaction_opts_destroy (default_txn_opts);
    +   mongoc_client_session_destroy (session);
    +   mongoc_collection_destroy (collection);
    +   mongoc_database_destroy (database);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +
    +   mongoc_cleanup ();
    +
    +   return exit_code;
    +}
    +
    +
    +
    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_clone.html b/libmongoc/1.24.0/mongoc_transaction_opts_clone.html new file mode 100644 index 0000000000000000000000000000000000000000..ca84c4e4133b4aa585e08068b13b6afca8492332 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_clone.html @@ -0,0 +1,305 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_clone() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_clone()

    +
    +

    Synopsis

    +
    mongoc_transaction_opt_t *
    +mongoc_transaction_opts_clone (const mongoc_transaction_opt_t *opts)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +

    Create a copy of a transaction options struct.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A new mongoc_transaction_opt_t that must be freed with mongoc_transaction_opts_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_destroy.html b/libmongoc/1.24.0/mongoc_transaction_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..1ac0d074a8de0b2d70e4c1a591f45d36b1742020 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_destroy.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_transaction_opts_destroy (mongoc_transaction_opt_t *opts);
    +
    +
    +

    Free a mongoc_transaction_opt_t. Does nothing if opts is NULL.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_get_max_commit_time_ms.html b/libmongoc/1.24.0/mongoc_transaction_opts_get_max_commit_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..aed2a381881a0d7d0ab0709e7121387324137238 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_get_max_commit_time_ms.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_max_commit_time_ms() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_get_max_commit_time_ms()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_transaction_opts_get_max_commit_time_ms (const mongoc_transaction_opt_t *opts);
    +
    +
    +

    Return the transaction options’ max commit time, in milliseconds. See mongoc_transaction_opts_set_max_commit_time_ms().

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_get_read_concern.html b/libmongoc/1.24.0/mongoc_transaction_opts_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..b557960e59c4a692c0844d2ee33aac7762ab943f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_get_read_concern.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_get_read_concern()

    +
    +

    Synopsis

    +
    const mongoc_read_concern_t *
    +mongoc_transaction_opts_get_read_concern (const mongoc_transaction_opt_t *opts);
    +
    +
    +

    Return the transaction options’ mongoc_read_concern_t. See mongoc_transaction_opts_set_read_concern().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_read_concern_t that is valid only for the lifetime of opts.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_get_read_prefs.html b/libmongoc/1.24.0/mongoc_transaction_opts_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..1f08d51db0a1cbfc8e45c46c6b8b12d710217985 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_get_read_prefs.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_get_read_prefs()

    +
    +

    Synopsis

    +
    const mongoc_read_prefs_t *
    +mongoc_transaction_opts_get_read_prefs (const mongoc_transaction_opt_t *opts);
    +
    +
    +

    Return the transaction options’ mongoc_read_prefs_t. See mongoc_transaction_opts_set_read_prefs().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_read_prefs_t that is valid only for the lifetime of opts.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_get_write_concern.html b/libmongoc/1.24.0/mongoc_transaction_opts_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..cf2340a797bf10ed2fd19dc32012fbd43b55acf4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_get_write_concern.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_get_write_concern()

    +
    +

    Synopsis

    +
    const mongoc_write_concern_t *
    +mongoc_transaction_opts_get_write_concern (const mongoc_transaction_opt_t *opts);
    +
    +
    +

    Return the transaction options’ mongoc_write_concern_t. See mongoc_transaction_opts_set_write_concern().

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    A mongoc_write_concern_t that is valid only for the lifetime of opts.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_new.html b/libmongoc/1.24.0/mongoc_transaction_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..b7e778198fc4d2bd3a8b4531ee6ddbb2a922f4bf --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_new.html @@ -0,0 +1,298 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_new()

    +
    +

    Synopsis

    +
    mongoc_transaction_opt_t *
    +mongoc_transaction_opts_new (void);
    +
    +
    +

    Create a mongoc_transaction_opt_t to configure multi-document transactions.

    +
    +
    +

    Returns

    +

    A new mongoc_transaction_opt_t that must be freed with mongoc_transaction_opts_destroy().

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_set_max_commit_time_ms.html b/libmongoc/1.24.0/mongoc_transaction_opts_set_max_commit_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..4df5b84b71cdb9419143773776ca0800058de3bc --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_set_max_commit_time_ms.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_max_commit_time_ms() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_set_max_commit_time_ms()

    +
    +

    Synopsis

    +
    void
    +mongoc_transaction_opts_set_max_commit_time_ms (mongoc_transaction_opt_t *opts,
    +                                                int64_t max_commit_time_ms);
    +
    +
    +

    Configure the transaction’s max commit time, in milliseconds.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_set_read_concern.html b/libmongoc/1.24.0/mongoc_transaction_opts_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..befecad822c472267caf7eab1a72d5e6d559c851 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_set_read_concern.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_set_read_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_transaction_opts_set_read_concern (mongoc_transaction_opt_t *opts,
    +                                          const mongoc_read_concern_t *read_concern);
    +
    +
    +

    Configure the transaction’s read concern. The argument is copied into the struct and can be freed after calling this function.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_set_read_prefs.html b/libmongoc/1.24.0/mongoc_transaction_opts_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..74a11a0af24fb8002f875b2fce89c35018032f07 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_set_read_prefs.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_set_read_prefs()

    +
    +

    Synopsis

    +
    void
    +mongoc_transaction_opts_set_read_prefs (mongoc_transaction_opt_t *opts,
    +                                        const mongoc_read_prefs_t *read_prefs);
    +
    +
    +

    Configure the transaction’s read preference. The argument is copied into the struct and can be freed after calling this function.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_opts_set_write_concern.html b/libmongoc/1.24.0/mongoc_transaction_opts_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..1a9ad46430061a642b2211fb8fae2ec2c33fdc0b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_opts_set_write_concern.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_opts_set_write_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_transaction_opts_set_write_concern (mongoc_transaction_opt_t *opts,
    +                                           const mongoc_write_concern_t *write_concern);
    +
    +
    +

    Configure the transaction’s write concern. The argument is copied into the struct and can be freed after calling this function.

    +
    +
    +

    Parameters

    + + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_transaction_state_t.html b/libmongoc/1.24.0/mongoc_transaction_state_t.html new file mode 100644 index 0000000000000000000000000000000000000000..151692e3d7c32d498e66ac3c82869b7c6a8e83e8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_transaction_state_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_transaction_state_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_transaction_state_t

    +

    Constants for transaction states

    +
    +

    Synopsis

    +
    typedef enum {
    +  MONGOC_TRANSACTION_NONE = 0,
    +  MONGOC_TRANSACTION_STARTING = 1,
    +  MONGOC_TRANSACTION_IN_PROGRESS = 2,
    +  MONGOC_TRANSACTION_COMMITTED = 3,
    +  MONGOC_TRANSACTION_ABORTED = 4,
    +} mongoc_transaction_state_t;
    +
    +
    +
    +
    +

    Description

    +

    These constants describe the current transaction state of a session.

    +
    +
    +

    Flag Values

    + + + + + + + + + + + + + + + + + + +

    MONGOC_TRANSACTION_NONE

    There is no transaction in progress.

    MONGOC_TRANSACTION_STARTING

    A transaction has been started, but no operation has been sent to the server.

    MONGOC_TRANSACTION_IN_PROGRESS

    A transaction is in progress.

    MONGOC_TRANSACTION_COMMITTED

    The transaction was committed.

    MONGOC_TRANSACTION_ABORTED

    The transaction was aborted.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_update_flags_t.html b/libmongoc/1.24.0/mongoc_update_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3e0a6d9d5acdae7beec4a3eba29533252de85bef --- /dev/null +++ b/libmongoc/1.24.0/mongoc_update_flags_t.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_update_flags_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_update_flags_t

    +

    Flags for update operations

    +
    +

    Synopsis

    +
    typedef enum {
    +   MONGOC_UPDATE_NONE = 0,
    +   MONGOC_UPDATE_UPSERT = 1 << 0,
    +   MONGOC_UPDATE_MULTI_UPDATE = 1 << 1,
    +} mongoc_update_flags_t;
    +
    +#define MONGOC_UPDATE_NO_VALIDATE (1U << 31)
    +
    +
    +
    +
    +

    Description

    +

    These flags correspond to the MongoDB wire protocol. They may be bitwise or’d together. The allow for modifying the way an update is performed in the MongoDB server.

    +
    +
    +

    Flag Values

    + + + + + + + + + + + + + + + +

    MONGOC_UPDATE_NONE

    No update flags set.

    MONGOC_UPDATE_UPSERT

    If an upsert should be performed.

    MONGOC_UPDATE_MULTI_UPDATE

    If more than a single matching document should be updated. By default only the first document is updated.

    MONGOC_UPDATE_NO_VALIDATE

    Do not perform client side BSON validations when performing an update. This is useful if you already know your BSON documents are valid.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_copy.html b/libmongoc/1.24.0/mongoc_uri_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..7157f0908203c664af1a511f5dbdea9a3059a3c7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_copy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_copy()

    +
    +

    Synopsis

    +
    mongoc_uri_t *
    +mongoc_uri_copy (const mongoc_uri_t *uri) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Copies the entire contents of a URI.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_uri_t that should be freed with mongoc_uri_destroy(). May return NULL on invalid host.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_destroy.html b/libmongoc/1.24.0/mongoc_uri_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..16c0a13edea900e1bfb7b4c1770f8bb90897af17 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_uri_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_uri_destroy (mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees all resources associated with a uri. Does nothing if uri is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_auth_mechanism.html b/libmongoc/1.24.0/mongoc_uri_get_auth_mechanism.html new file mode 100644 index 0000000000000000000000000000000000000000..41eebed453f7f911e16f76032f1e27ad5b27f134 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_auth_mechanism.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_uri_get_auth_mechanism() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_auth_mechanism()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_auth_mechanism (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the authMechanism parameter to an URI if provided.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed. Returns NULL if the authMechanism parameter was not provided to uri.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_auth_source.html b/libmongoc/1.24.0/mongoc_uri_get_auth_source.html new file mode 100644 index 0000000000000000000000000000000000000000..b8f3edd54da9636c611c20a6e9413538b43b8a80 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_auth_source.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_uri_get_auth_source() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_auth_source()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_auth_source (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the authSource parameter of an URI if provided.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed if the authSource parameter is provided, otherwise NULL.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_compressors.html b/libmongoc/1.24.0/mongoc_uri_get_compressors.html new file mode 100644 index 0000000000000000000000000000000000000000..7ad333fd0f9d621d0617ade53def9d418452f93c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_compressors.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_uri_get_compressors() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_compressors()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_uri_get_compressors (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns a bson document with the enabled compressors as the keys or an empty document if no compressors were provided.

    +
    +
    +

    Example

    +
    mongoc_client_t *client;
    +mongoc_uri_t *uri;
    +
    +uri = mongoc_uri_new ("mongodb://localhost/?compressors=zlib,snappy,zstd");
    +
    +if (bson_has_field (mongoc_uri_get_compressors (uri), "snappy")) {
    +   /* snappy enabled */
    +}
    +
    +
    +
    +
    +

    Returns

    +

    A bson_t * which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_database.html b/libmongoc/1.24.0/mongoc_uri_get_database.html new file mode 100644 index 0000000000000000000000000000000000000000..5c7032d9908d569d44553ea62e01c2e7f63d99b7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_database.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_database() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_database()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_database (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the database portion of an URI if provided. This is the portion after the / but before the ?.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_hosts.html b/libmongoc/1.24.0/mongoc_uri_get_hosts.html new file mode 100644 index 0000000000000000000000000000000000000000..f433b619be1f7cf6a851025f7717925b17327842 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_hosts.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_hosts() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_hosts()

    +
    +

    Synopsis

    +
    const mongoc_host_list_t *
    +mongoc_uri_get_hosts (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a linked list of hosts that were defined in the URI (the comma-separated host section).

    +
    +
    +

    Returns

    +

    A linked list of mongoc_host_list_t structures that should not be modified or freed. Returns NULL if this URI’s scheme is “mongodb+srv://”.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_mechanism_properties.html b/libmongoc/1.24.0/mongoc_uri_get_mechanism_properties.html new file mode 100644 index 0000000000000000000000000000000000000000..e93548d9694ef1226d864e82c0012d630031f66a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_mechanism_properties.html @@ -0,0 +1,254 @@ + + + + + + + + + + + + + + mongoc_uri_get_mechanism_properties() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_mechanism_properties()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_get_mechanism_properties (const mongoc_uri_t *uri,
    +                                     bson_t *properties /* OUT */);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the “authMechanismProperties” options set on this mongoc_uri_t. The out-parameter properties should be an uninitialized, stack-allocated bson_t. It is statically initialized with bson_init_static() to point to the internal data of uri, so its contents must not be modified and it becomes invalid after uri is destroyed.

    +
    +
    +

    Returns

    +

    If no “authMechanismProperties” have been set on uri, this functions returns false and properties remains uninitialized.

    +
    +
    +

    Example

    +
    mongoc_uri_t *uri;
    +bson_t props;
    +
    +uri = mongoc_uri_new (
    +   "mongodb://user%40DOMAIN.COM:password@localhost/?authMechanism=GSSAPI"
    +   "&authMechanismProperties=SERVICE_NAME:other,CANONICALIZE_HOST_NAME:true");
    +
    +if (mongoc_uri_get_mechanism_properties (uri, &props)) {
    +   char *json = bson_as_canonical_extended_json (&props, NULL);
    +   printf ("%s\n", json);
    +   bson_free (json);
    +} else {
    +   printf ("No authMechanismProperties.\n");
    +}
    +
    +
    +

    This code produces the output:

    +
    { "SERVICE_NAME" : "other", "CANONICALIZE_HOST_NAME" : "true" }
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_option_as_bool.html b/libmongoc/1.24.0/mongoc_uri_get_option_as_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..4bda08e02f1b6e25df0ada892e4c4e0d3d8dd0c9 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_option_as_bool.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_bool() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_option_as_bool()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_get_option_as_bool (const mongoc_uri_t *uri,
    +                               const char *option,
    +                               bool fallback);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • fallback: A default value to return.

    • +
    +
    +
    +

    Description

    +

    Returns the value of the URI option if it is set and of the correct type (bool). If not set, or set to an invalid type, returns fallback.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_option_as_int32.html b/libmongoc/1.24.0/mongoc_uri_get_option_as_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..0bc0b9b9d9b6d3758efb68addd39ab755c7d7018 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_option_as_int32.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_int32() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_option_as_int32()

    +
    +

    Synopsis

    +
    int32_t
    +mongoc_uri_get_option_as_int32 (const mongoc_uri_t *uri,
    +                                const char *option,
    +                                int32_t fallback);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • fallback: A default value to return.

    • +
    +
    +
    +

    Description

    +

    Returns the value of the URI option if it is set and of the correct type (integer). Returns fallback if the option is not set, set to an invalid type, or zero.

    +

    Zero is considered “unset”, so URIs can be constructed like so, and still accept default values:

    +
    bson_strdup_printf ("mongodb://localhost/?connectTimeoutMS=%d", myvalue)
    +
    +
    +

    If myvalue is non-zero it is the connection timeout; if it is zero the driver uses the default timeout.

    +

    When reading an option that is an int64, this function will return the value as int32_t. If the value is outside the range of a 32-bit integer, a warning will be emitted and fallback is returned instead.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_option_as_int64.html b/libmongoc/1.24.0/mongoc_uri_get_option_as_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..e9b8701a7d3e6f300796fd1dc44e489a195a17b3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_option_as_int64.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_option_as_int64()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_uri_get_option_as_int64 (const mongoc_uri_t *uri,
    +                                const char *option,
    +                                int64_t fallback);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • fallback: A default value to return.

    • +
    +
    +
    +

    Description

    +

    Returns the value of the URI option if it is set and of the correct type (integer). Returns fallback if the option is not set, set to an invalid type, or zero.

    +

    Zero is considered “unset”, so URIs can be constructed like so, and still accept default values:

    +
    bson_strdup_printf ("mongodb://localhost/?wTimeoutMS=%" PRId64, myvalue)
    +
    +
    +

    If myvalue is non-zero it is the write concern timeout; if it is zero the driver uses the default timeout.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_option_as_utf8.html b/libmongoc/1.24.0/mongoc_uri_get_option_as_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..a7f3432daf9c61cbf9450bc8522c83ef4a6551e5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_option_as_utf8.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_utf8() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_option_as_utf8()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_option_as_utf8 (const mongoc_uri_t *uri,
    +                               const char *option,
    +                               const char *fallback);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • fallback: A default value to return.

    • +
    +
    +
    +

    Description

    +

    Returns the value of the URI option if it is set and of the correct type (string). This value is a pointer into the URI’s internal buffer, and is only valid until the URI is modified or freed. If the option is not set, or set to an invalid type, returns fallback.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_options.html b/libmongoc/1.24.0/mongoc_uri_get_options.html new file mode 100644 index 0000000000000000000000000000000000000000..70bc9545b171094f958fb3cd408d2fb1e948bf90 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_options.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_options() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_options()

    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_uri_get_options (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a bson document containing all of the options provided after the ? of a URI.

    +
    +
    +

    Returns

    +

    A bson_t which should not be modified or freed if uri has options provided, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_password.html b/libmongoc/1.24.0/mongoc_uri_get_password.html new file mode 100644 index 0000000000000000000000000000000000000000..b7799119d44caf2c627733d648db14030a0e8fa2 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_password.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_password() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_password()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_password (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the password portion of an URI.

    +
    +
    +

    Returns

    +

    A string which should not be modified or freed if uri has a password specified, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_read_concern.html b/libmongoc/1.24.0/mongoc_uri_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..4077a56ac15eed178b803641a5c0c57256a4bd05 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_read_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_read_concern()

    +
    +

    Synopsis

    +
    const mongoc_read_concern_t *
    +mongoc_uri_get_read_concern (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a read concern that is owned by the URI instance. This read concern is configured based on URI parameters.

    +
    +
    +

    Returns

    +

    Returns a mongoc_read_concern_t that should not be modified or freed if a read concern is provided to uri, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_read_prefs.html b/libmongoc/1.24.0/mongoc_uri_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..b9d71149d77c1a1176e45960d153a3fbf5a7e93c --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_read_prefs.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_uri_get_read_prefs() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_read_prefs()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.2.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_uri_get_read_prefs_t() in new code.

    +
    +
    +
    +

    Synopsis

    +
    const bson_t *
    +mongoc_uri_get_read_prefs (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a bson document containing read preference tag information from a URI. Note that this does not include the read preference mode.

    +
    +
    +

    Returns

    +

    Returns a bson document that should not be modified or freed if uri has read preferences, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_read_prefs_t.html b/libmongoc/1.24.0/mongoc_uri_get_read_prefs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7274f86e85989df760f6d57ae080a630cffd985a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_read_prefs_t.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_read_prefs_t() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_read_prefs_t()

    +
    +

    Synopsis

    +
    const mongoc_read_prefs_t *
    +mongoc_uri_get_read_prefs_t (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a read preference that is owned by the URI instance. This read preference concern is configured based on URI parameters.

    +
    +
    +

    Returns

    +

    Returns a mongoc_read_prefs_t that should not be modified or freed if uri has read preferences, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_replica_set.html b/libmongoc/1.24.0/mongoc_uri_get_replica_set.html new file mode 100644 index 0000000000000000000000000000000000000000..0bf0d898d13c4ca8da235c725dbd8272907be319 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_replica_set.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_replica_set() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_replica_set()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_replica_set (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the replicaSet parameter of an URI.

    +
    +
    +

    Returns

    +

    Returns a string which should not be modified or freed. Returns NULL if the replicaSet parameter was not provided to uri.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_service.html b/libmongoc/1.24.0/mongoc_uri_get_service.html new file mode 100644 index 0000000000000000000000000000000000000000..394dda5874f6aa152374c2cc78346654ceae4d37 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_service.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_uri_get_service() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_service()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.21.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_uri_get_srv_hostname() in new code.

    +
    +
    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_service (const mongoc_uri_t *uri)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_uri_get_srv_hostname);
    +
    +
    +
    +
    +

    Parameters

    + +

    Returns the SRV host and domain name of a MongoDB URI.

    +
    +
    +

    Returns

    +

    A string if this URI’s scheme is “mongodb+srv://”, or NULL if the scheme is “mongodb://”.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_srv_hostname.html b/libmongoc/1.24.0/mongoc_uri_get_srv_hostname.html new file mode 100644 index 0000000000000000000000000000000000000000..141752eb21059509c9619ce9293a525a2a142f27 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_srv_hostname.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_srv_hostname() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_srv_hostname()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_srv_hostname (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns the SRV host and domain name of a MongoDB URI.

    +
    +
    +

    Returns

    +

    A string if this URI’s scheme is “mongodb+srv://”, or NULL if the scheme is “mongodb://”.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_srv_service_name.html b/libmongoc/1.24.0/mongoc_uri_get_srv_service_name.html new file mode 100644 index 0000000000000000000000000000000000000000..574f0ee150c5573df7285be034bfebbdf0dfc199 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_srv_service_name.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_srv_service_name() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_srv_service_name()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_srv_service_name (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns the SRV service name of a MongoDB URI.

    +
    +
    +

    Returns

    +

    A string corresponding to the value of the srvServiceName URI option if present. Otherwise, the default value “mongodb”.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_ssl.html b/libmongoc/1.24.0/mongoc_uri_get_ssl.html new file mode 100644 index 0000000000000000000000000000000000000000..667c14b0dc43b98596c180b0f6fc773049fda962 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_ssl.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_uri_get_ssl() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_ssl()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.15.0: This function is deprecated and should not be used in new code. See Manage Collection Indexes.

    +
    +
    +

    This function is deprecated and should not be used in new code.

    +

    Please use mongoc_uri_get_tls() in new code.

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_get_ssl (const mongoc_uri_t *uri)
    +   BSON_GNUC_DEPRECATED_FOR (mongoc_uri_get_tls);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a boolean indicating if TLS was specified for use in the URI.

    +
    +
    +

    Returns

    +

    Returns a boolean, true indicating that TLS should be used. This returns true if any TLS option is specified.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_string.html b/libmongoc/1.24.0/mongoc_uri_get_string.html new file mode 100644 index 0000000000000000000000000000000000000000..376c9e21feccfe4181d7b7b1d458d54612d7d5b3 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_string.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_string() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_string()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_string (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the URI as a string.

    +
    +
    +

    Returns

    +

    Returns a string which should not be modified or freed.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_tls.html b/libmongoc/1.24.0/mongoc_uri_get_tls.html new file mode 100644 index 0000000000000000000000000000000000000000..742b4beb49e65112eb9d7ac8520a24d5f1a6723e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_tls.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_tls() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_tls()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_get_tls (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a boolean indicating if TLS was specified for use in the URI.

    +
    +
    +

    Returns

    +

    Returns a boolean, true indicating that TLS should be used. This returns true if any TLS option is specified.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_username.html b/libmongoc/1.24.0/mongoc_uri_get_username.html new file mode 100644 index 0000000000000000000000000000000000000000..30dbe77a7834c18a947fed25519137e317218e28 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_username.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_username() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_username()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_uri_get_username (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the username portion of a URI.

    +
    +
    +

    Returns

    +

    Returns a string which should not be modified or freed if uri has a username provided, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_get_write_concern.html b/libmongoc/1.24.0/mongoc_uri_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..a36619f3542e3e191368bceeca672de54debc741 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_get_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_get_write_concern()

    +
    +

    Synopsis

    +
    const mongoc_write_concern_t *
    +mongoc_uri_get_write_concern (const mongoc_uri_t *uri);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches a write concern that is owned by the URI instance. This write concern is configured based on URI parameters.

    +
    +
    +

    Returns

    +

    Returns a mongoc_write_concern_t that should not be modified or freed if uri has a write concern provided, otherwise NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_has_option.html b/libmongoc/1.24.0/mongoc_uri_has_option.html new file mode 100644 index 0000000000000000000000000000000000000000..f172486975c6bb8b3688f5ee46547ef761c18453 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_has_option.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_uri_has_option() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_has_option()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_has_option (const mongoc_uri_t *uri, const char *option);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    +
    +
    +

    Description

    +

    Returns true if the option was present in the initial MongoDB URI.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_new.html b/libmongoc/1.24.0/mongoc_uri_new.html new file mode 100644 index 0000000000000000000000000000000000000000..65e010f5e733139998524242dc653887d2874169 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_new.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_uri_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_new()

    +
    +

    Synopsis

    +
    mongoc_uri_t *
    +mongoc_uri_new (const char *uri_string) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri_string: A string containing a URI.

    • +
    +
    +
    +

    Description

    +

    Calls mongoc_uri_new_with_error().

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_uri_t if successful. Otherwise NULL, using +MONGOC_WARNING on error.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_new_for_host_port.html b/libmongoc/1.24.0/mongoc_uri_new_for_host_port.html new file mode 100644 index 0000000000000000000000000000000000000000..3740cd1a46c6f641f4ef6571ec24b858d440bb23 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_new_for_host_port.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_uri_new_for_host_port() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_new_for_host_port()

    +
    +

    Synopsis

    +
    mongoc_uri_t *
    +mongoc_uri_new_for_host_port (const char *hostname, uint16_t port);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • hostname: A string containing the hostname.

    • +
    • port: A uint16_t.

    • +
    +
    +
    +

    Description

    +

    Creates a new mongoc_uri_t based on the hostname and port provided.

    +
    +
    +

    Returns

    +

    Returns a newly allocated mongoc_uri_t that should be freed with mongoc_uri_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_new_with_error.html b/libmongoc/1.24.0/mongoc_uri_new_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..1702066dc574e6fbfd92c46dbbd4a4e763670bac --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_new_with_error.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_uri_new_with_error() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_new_with_error()

    +
    +

    Synopsis

    +
    mongoc_uri_t *
    +mongoc_uri_new_with_error (const char *uri_string,
    +                           bson_error_t *error) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri_string: A string containing a URI.

    • +
    • error: An optional location for a bson_error_t or NULL.

    • +
    +
    +
    +

    Description

    +

    Parses a string containing a MongoDB style URI connection string.

    +
    +
    +

    Returns

    +

    A newly allocated mongoc_uri_t if successful. Otherwise NULL +populating error with the error description.

    +
    +

    Warning

    +

    Failure to handle the result of this function is a programming error.

    +
    +
    +
    +

    Examples

    +

    Examples of some valid MongoDB connection strings can be seen below.

    +

    "mongodb://localhost/"

    +

    "mongodb://localhost/?replicaSet=myreplset"

    +

    "mongodb://myuser:mypass@localhost/"

    +

    "mongodb://kerberosuser%40EXAMPLE.COM@example.com/?authMechanism=GSSAPI"

    +

    "mongodb://[::1]:27017/"

    +

    "mongodb://10.0.0.1:27017,10.0.0.1:27018,[::1]:27019/?tls=true"

    +

    "mongodb://%2Ftmp%2Fmongodb-27017.sock"

    +

    "mongodb://user:pass@%2Ftmp%2Fmongodb-27017.sock"

    +

    "mongodb://localhost,[::1]/mydb?authSource=mydb"

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_option_is_bool.html b/libmongoc/1.24.0/mongoc_uri_option_is_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..78f6f3cb44241f8f0f353a647674fc59ec5539b4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_option_is_bool.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_bool() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_option_is_bool()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_option_is_bool (const char *option);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • option: The name of an option, case insensitive.

    • +
    +
    +
    +

    Description

    +

    Returns true if the option is a known MongoDB URI option of boolean type. For example, “tls=false” is a valid MongoDB URI option, so mongoc_uri_option_is_bool ("tls") is true.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_option_is_int32.html b/libmongoc/1.24.0/mongoc_uri_option_is_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..665698c052145d935897d94bc730ca5de39fce7d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_option_is_int32.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_int32() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_option_is_int32()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_option_is_int32 (const char *option);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • option: The name of an option, case insensitive.

    • +
    +
    +
    +

    Description

    +

    Returns true if the option is a known MongoDB URI option of integer type. For example, “zlibCompressionLevel=5” is a valid integer MongoDB URI option, so mongoc_uri_option_is_int32 ("zlibCompressionLevel") is true. This will also return true for all 64-bit integer options.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_option_is_int64.html b/libmongoc/1.24.0/mongoc_uri_option_is_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..7619f63684a99841ff95c1e51a401d092991b4da --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_option_is_int64.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_option_is_int64()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_option_is_int64 (const char *option);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • option: The name of an option, case insensitive.

    • +
    +
    +
    +

    Description

    +

    Returns true if the option is a known MongoDB URI option of 64-bit integer type. For example, “wTimeoutMS=100” is a valid 64-bit integer MongoDB URI option, so mongoc_uri_option_is_int64 ("wTimeoutMS") is true.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_option_is_utf8.html b/libmongoc/1.24.0/mongoc_uri_option_is_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..dd03269679f1f928282a351bad2aad83e8419d5d --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_option_is_utf8.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_utf8() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_option_is_utf8()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_option_is_utf8 (const char *option);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • option: The name of an option, case insensitive.

    • +
    +
    +
    +

    Description

    +

    Returns true if the option is a known MongoDB URI option of string type. For example, “replicaSet=my_rs” is a valid MongoDB URI option, so mongoc_uri_option_is_utf8 ("replicaSet") is true.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_auth_mechanism.html b/libmongoc/1.24.0/mongoc_uri_set_auth_mechanism.html new file mode 100644 index 0000000000000000000000000000000000000000..f53e46fb039fad009090190f45b41265c43a80e0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_auth_mechanism.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_uri_set_auth_mechanism() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_auth_mechanism()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_auth_mechanism (mongoc_uri_t *uri, const char *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • value: The new “authMechanism” value.

    • +
    +
    +
    +

    Description

    +

    Sets the “authMechanism” URI option, such as “SCRAM-SHA-1” or “GSSAPI”, after the URI has been parsed from a string.

    +

    Updates the option in-place if already set, otherwise appends it to the URI’s bson_t of options.

    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if value is not valid UTF-8.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_auth_source.html b/libmongoc/1.24.0/mongoc_uri_set_auth_source.html new file mode 100644 index 0000000000000000000000000000000000000000..4bd07c19ce2d3ceeebbf7ec43a22d7e62e7c9f0a --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_auth_source.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_uri_set_auth_source() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_auth_source()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_auth_source (mongoc_uri_t *uri, const char *value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • value: The new “authSource” value.

    • +
    +
    +
    +

    Description

    +

    Sets the “authSource” URI option, after the URI has been parsed from a string.

    +

    Updates the option in-place if already set, otherwise appends it to the URI’s bson_t of options.

    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if value is not valid UTF-8.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_compressors.html b/libmongoc/1.24.0/mongoc_uri_set_compressors.html new file mode 100644 index 0000000000000000000000000000000000000000..ca927fadede2c750f90f7b559060812139e42cce --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_compressors.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_uri_set_compressors() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_compressors()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_compressors (mongoc_uri_t *uri, const char *compressors);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • compressors: A string consisting of one or more comma (,) separated compressors (e.g. “snappy,zlib”) or NULL. Passing NULL clears any existing compressors set on uri.

    • +
    +
    +
    +

    Description

    +

    Sets the URI’s compressors, after the URI has been parsed from a string. +Will overwrite any previously set value.

    +
    +
    +

    Example

    +
    mongoc_client_t *client;
    +mongoc_uri_t *uri;
    +
    +uri = mongoc_uri_new ("mongodb://localhost/");
    +mongoc_uri_set_compressors (uri, "snappy,zlib,zstd");
    +mongoc_client_new_from_uri (uri);
    +/* Snappy & zlib & zstd compressors are enabled */
    +
    +
    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if compressors is not valid UTF-8. +Logs a warning to stderr with the MONGOC_WARNING macro +if compressor is not available.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_database.html b/libmongoc/1.24.0/mongoc_uri_set_database.html new file mode 100644 index 0000000000000000000000000000000000000000..ae7a9251ff99f65523875902ff2d49833e9c4e6e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_database.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_uri_set_database() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_database()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_database (mongoc_uri_t *uri, const char *database);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the URI’s database, after the URI has been parsed from a string.

    +

    The driver authenticates to this database if the connection string includes authentication credentials. This database is also the return value of mongoc_client_get_default_database().

    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if database is not valid UTF-8.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_mechanism_properties.html b/libmongoc/1.24.0/mongoc_uri_set_mechanism_properties.html new file mode 100644 index 0000000000000000000000000000000000000000..d32b339eefc5ea67554326d5e9d18041307cf2ff --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_mechanism_properties.html @@ -0,0 +1,250 @@ + + + + + + + + + + + + + + mongoc_uri_set_mechanism_properties() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_mechanism_properties()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_mechanism_properties (mongoc_uri_t *uri,
    +                                     const bson_t *properties);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Replaces all the options in URI’s “authMechanismProperties” after the URI has been parsed from a string.

    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if properties is not valid BSON data.

    +
    +
    +

    Example

    +
    mongoc_uri_t *uri;
    +bson_t props = BSON_INITIALIZER;
    +
    +uri = mongoc_uri_new (
    +   "mongodb://user%40DOMAIN.COM:password@localhost/?authMechanism=GSSAPI"
    +   "&authMechanismProperties=SERVICE_NAME:other,CANONICALIZE_HOST_NAME:true");
    +
    +/* replace all options: replace service name "other" with "my_service", unset
    + * "CANONICALIZE_HOST_NAME" and accept its default.
    + */
    +BSON_APPEND_UTF8 (&props, "SERVICE_NAME", "my_service");
    +mongoc_uri_set_mechanism_properties (uri, &props);
    +
    +bson_destroy (&props);
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_option_as_bool.html b/libmongoc/1.24.0/mongoc_uri_set_option_as_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..d1b2d23b670247a08a8e709c2908cd1eaeb74d11 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_option_as_bool.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_bool() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_option_as_bool()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_option_as_bool (const mongoc_uri_t *uri,
    +                               const char *option,
    +                               bool value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • value: The new value.

    • +
    +
    +
    +

    Description

    +

    Sets an individual URI option, after the URI has been parsed from a string.

    +

    Only known options of type bool can be set.

    +

    Updates the option in-place if already set, otherwise appends it to the URI’s bson_t of options.

    +
    +
    +

    Returns

    +

    True if successfully set (the named option is a known option of type bool).

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_option_as_int32.html b/libmongoc/1.24.0/mongoc_uri_set_option_as_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..d14ec1dccf8d17134ebdcff32a37681d0166ad43 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_option_as_int32.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_int32() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_option_as_int32()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_option_as_int32 (const mongoc_uri_t *uri,
    +                                const char *option,
    +                                int32_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • value: The new value.

    • +
    +
    +
    +

    Description

    +

    Sets an individual URI option, after the URI has been parsed from a string.

    +

    Only known options of type integer can be set. Some integer options, such as minHeartbeatFrequencyMS, have additional constraints.

    +

    Updates the option in-place if already set, otherwise appends it to the URI’s bson_t of options.

    +
    +
    +

    Returns

    +

    True if successfully set (the named option is a known option of type int32 or int64).

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_option_as_int64.html b/libmongoc/1.24.0/mongoc_uri_set_option_as_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..0208f35b29913530292846ecff6f12be507dc4a8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_option_as_int64.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_option_as_int64()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_option_as_int64 (const mongoc_uri_t *uri,
    +                                const char *option,
    +                                int64_t value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • value: The new value.

    • +
    +
    +
    +

    Description

    +

    Sets an individual URI option, after the URI has been parsed from a string.

    +

    Only known options of type int32 or int64 can be set. For 32-bit integer options, the function returns false when trying to set a 64-bit value that exceeds the range of an int32_t. Values that fit into an int32_t will be set correctly. In both cases, a warning will be emitted.

    +

    Updates the option in-place if already set, otherwise appends it to the URI’s bson_t of options.

    +
    +
    +

    Returns

    +

    True if successfully set (the named option is a known option of type int64).

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_option_as_utf8.html b/libmongoc/1.24.0/mongoc_uri_set_option_as_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..3787d0840bd04eb78b61aa1e061d2298476bfd9b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_option_as_utf8.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_utf8() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_option_as_utf8()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_option_as_utf8 (const mongoc_uri_t *uri,
    +                               const char *option,
    +                               utf8 value);
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • uri: A mongoc_uri_t.

    • +
    • option: The name of an option, case insensitive.

    • +
    • value: The new value.

    • +
    +
    +
    +

    Description

    +

    Sets an individual URI option, after the URI has been parsed from a string.

    +

    Only known string-type options can be set.

    +

    Updates the option in-place if already set, otherwise appends it to the URI’s bson_t of options.

    +
    +
    +

    Returns

    +

    True if successfully set (the named option is a known option of string type).

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_password.html b/libmongoc/1.24.0/mongoc_uri_set_password.html new file mode 100644 index 0000000000000000000000000000000000000000..56867e8c1d33997738a6ca63189e1fea28039326 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_password.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_uri_set_password() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_password()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_password (mongoc_uri_t *uri, const char *password);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the URI’s password, after the URI has been parsed from a string. The driver authenticates with this password if the username is also set.

    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if password is not valid UTF-8.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_read_concern.html b/libmongoc/1.24.0/mongoc_uri_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..2c6696b521c8ec57308a4ea21dc3e0adb60c761b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_read_concern.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_uri_set_read_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_read_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_uri_set_read_concern (mongoc_uri_t *uri,
    +                             const mongoc_read_concern_t *rc);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets a MongoDB URI’s read concern option, after the URI has been parsed from a string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_read_prefs_t.html b/libmongoc/1.24.0/mongoc_uri_set_read_prefs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1961c0a8322d4f27a064fe63ef0a3e689b57492f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_read_prefs_t.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_uri_set_read_prefs_t() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_read_prefs_t()

    +
    +

    Synopsis

    +
    void
    +mongoc_uri_set_read_prefs_t (mongoc_uri_t *uri,
    +                             const mongoc_read_prefs_t *prefs);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets a MongoDB URI’s read preferences, after the URI has been parsed from a string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_username.html b/libmongoc/1.24.0/mongoc_uri_set_username.html new file mode 100644 index 0000000000000000000000000000000000000000..05b7167cba0ce350bc373e84e1177fb4c103e41e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_username.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_uri_set_username() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_username()

    +
    +

    Synopsis

    +
    bool
    +mongoc_uri_set_username (mongoc_uri_t *uri, const char *username);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the URI’s username, after the URI has been parsed from a string. The driver authenticates with this username if the password is also set.

    +
    +
    +

    Returns

    +

    Returns false if the option cannot be set, for example if username is not valid UTF-8.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_set_write_concern.html b/libmongoc/1.24.0/mongoc_uri_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..29655b122eb669e0a3346fd9f7dac2f3faf7eb37 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_set_write_concern.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_uri_set_write_concern() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_set_write_concern()

    +
    +

    Synopsis

    +
    void
    +mongoc_uri_set_write_concern (mongoc_uri_t *uri,
    +                              const mongoc_write_concern_t *wc);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets a MongoDB URI’s write concern option, after the URI has been parsed from a string.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_t.html b/libmongoc/1.24.0/mongoc_uri_t.html new file mode 100644 index 0000000000000000000000000000000000000000..67b5dcf9b972516f93f4bb7d955cfb55234d6bbd --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_t.html @@ -0,0 +1,610 @@ + + + + + + + + + + + + + + mongoc_uri_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +

    mongoc_uri_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_uri_t mongoc_uri_t;
    +
    +
    +
    +
    +

    Description

    +

    mongoc_uri_t provides an abstraction on top of the MongoDB connection URI format. It provides standardized parsing as well as convenience methods for extracting useful information such as replica hosts or authorization information.

    +

    See Connection String URI Reference on the MongoDB website for more information.

    +
    +
    +

    Format

    +
    mongodb[+srv]://                             <1>
    +   [username:password@]                      <2>
    +   host1                                     <3>
    +   [:port1]                                  <4>
    +   [,host2[:port2],...[,hostN[:portN]]]      <5>
    +   [/[database]                              <6>
    +   [?options]]                               <7>
    +
    +
    +
      +
    1. “mongodb” is the specifier of the MongoDB protocol. Use “mongodb+srv” with a single service name in place of “host1” to specify the initial list of servers with an SRV record.

    2. +
    3. An optional username and password.

    4. +
    5. The only required part of the uri. This specifies either a hostname, IPv4 address, IPv6 address enclosed in “[” and “]”, or UNIX domain socket.

    6. +
    7. An optional port number. Defaults to :27017.

    8. +
    9. Extra optional hosts and ports. You would specify multiple hosts, for example, for connections to replica sets.

    10. +
    11. The name of the database to authenticate if the connection string includes authentication credentials. If /database is not specified and the connection string includes credentials, defaults to the ‘admin’ database.

    12. +
    13. Connection specific options.

    14. +
    +
    +

    Note

    +

    Option names are case-insensitive. Do not repeat the same option (e.g. “mongodb://localhost/db?opt=value1&OPT=value2”) since this may have unexpected results.

    +
    +

    The MongoDB C Driver exposes constants for each supported connection option. These constants make it easier to discover connection options, but their string values can be used as well.

    +

    For example, the following calls are equal.

    +
    uri = mongoc_uri_new ("mongodb://localhost/?" MONGOC_URI_APPNAME "=applicationName");
    +uri = mongoc_uri_new ("mongodb://localhost/?appname=applicationName");
    +uri = mongoc_uri_new ("mongodb://localhost/?appName=applicationName");
    +
    +
    +
    +
    +

    Replica Set Example

    +

    To describe a connection to a replica set named ‘test’ with the following mongod hosts:

    +
      +
    • db1.example.com on port 27017

    • +
    • db2.example.com on port 2500

    • +
    +

    You would use a connection string that resembles the following.

    +
    mongodb://db1.example.com,db2.example.com:2500/?replicaSet=test
    +
    +
    +
    +
    +

    SRV Example

    +

    If you have configured an SRV record with a name like “_mongodb._tcp.server.example.com” whose records are a list of one or more MongoDB server hostnames, use a connection string like this:

    +
    uri = mongoc_uri_new ("mongodb+srv://server.example.com/?replicaSet=rs&appName=applicationName");
    +
    +
    +

    The driver prefixes the service name with “_mongodb._tcp.”, then performs a DNS SRV query to resolve the service name to one or more hostnames. If this query succeeds, the driver performs a DNS TXT query on the service name (without the “_mongodb._tcp” prefix) for additional URI options configured as TXT records.

    +

    On Unix, the MongoDB C Driver relies on libresolv to look up SRV and TXT records. If libresolv is unavailable, then using a “mongodb+srv” URI will cause an error. If your libresolv lacks res_nsearch then the driver will fall back to res_search, which is not thread-safe.

    +
    +
    +

    IPv4 and IPv6

    +

    If connecting to a hostname that has both IPv4 and IPv6 DNS records, the behavior follows RFC-6555. A connection to the IPv6 address is attempted first. If IPv6 fails, then a connection is attempted to the IPv4 address. If the connection attempt to IPv6 does not complete within 250ms, then IPv4 is tried in parallel. Whichever succeeds connection first cancels the other. The successful DNS result is cached for 10 minutes.

    +

    As a consequence, attempts to connect to a mongod only listening on IPv4 may be delayed if there are both A (IPv4) and AAAA (IPv6) DNS records associated with the host.

    +

    To avoid a delay, configure hostnames to match the MongoDB configuration. That is, only create an A record if the mongod is only listening on IPv4.

    +
    +
    +

    Connection Options

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Default

    Description

    MONGOC_URI_RETRYREADS

    retryreads

    true

    If “true” and the server is a MongoDB 3.6+ standalone, replica set, or sharded cluster, the driver safely retries a read that failed due to a network error or replica set failover.

    MONGOC_URI_RETRYWRITES

    retrywrites

    true if driver built w/ TLS

    If “true” and the server is a MongoDB 3.6+ replica set or sharded cluster, the driver safely retries a write that failed due to a network error or replica set failover. Only inserts, updates of single documents, or deletes of single +documents are retried.

    MONGOC_URI_APPNAME

    appname

    Empty (no appname)

    The client application name. This value is used by MongoDB when it logs connection information and profile information, such as slow queries.

    MONGOC_URI_TLS

    tls

    Empty (not set, same as false)

    {true|false}, indicating if TLS must be used. (See also mongoc_client_set_ssl_opts() and mongoc_client_pool_set_ssl_opts().)

    MONGOC_URI_COMPRESSORS

    compressors

    Empty (no compressors)

    Comma separated list of compressors, if any, to use to compress the wire protocol messages. Snappy, zlib, and zstd are optional build time dependencies, and enable the “snappy”, “zlib”, and “zstd” values respectively.

    MONGOC_URI_CONNECTTIMEOUTMS

    connecttimeoutms

    10,000 ms (10 seconds)

    This setting applies to new server connections. It is also used as the socket timeout for server discovery and monitoring operations.

    MONGOC_URI_SOCKETTIMEOUTMS

    sockettimeoutms

    300,000 ms (5 minutes)

    The time in milliseconds to attempt to send or receive on a socket before the attempt times out.

    MONGOC_URI_REPLICASET

    replicaset

    Empty (no replicaset)

    The name of the Replica Set that the driver should connect to.

    MONGOC_URI_ZLIBCOMPRESSIONLEVEL

    zlibcompressionlevel

    -1

    When the MONGOC_URI_COMPRESSORS includes “zlib” this options configures the zlib compression level, when the zlib compressor is used to compress client data.

    MONGOC_URI_LOADBALANCED

    loadbalanced

    false

    If true, this indicates the driver is connecting to a MongoDB cluster behind a load balancer.

    MONGOC_URI_SRVMAXHOSTS

    srvmaxhosts

    0

    If zero, the number of hosts in DNS results is unlimited. If greater than zero, the number of hosts in DNS results is limited to being less than or equal to the given value.

    +

    Setting any of the *timeoutMS options above to 0 will be interpreted as “use the default value”.

    +
    +
    +

    Authentication Options

    + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_AUTHMECHANISM

    authmechanism

    Specifies the mechanism to use when authenticating as the provided user. See Authentication for supported values.

    MONGOC_URI_AUTHMECHANISMPROPERTIES

    authmechanismproperties

    Certain authentication mechanisms have additional options that can be configured. These options should be provided as comma separated option_key:option_value pair and provided as authMechanismProperties. Specifying the same option_key multiple times has undefined behavior.

    MONGOC_URI_AUTHSOURCE

    authsource

    The authSource defines the database that should be used to authenticate to. It is unnecessary to provide this option the database name is the same as the database used in the URI.

    +
    +

    Mechanism Properties

    + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_CANONICALIZEHOSTNAME

    canonicalizehostname

    Use the canonical hostname of the service, rather than its configured alias, when authenticating with Cyrus-SASL Kerberos.

    MONGOC_URI_GSSAPISERVICENAME

    gssapiservicename

    Use alternative service name. The default is mongodb.

    +
    +
    +
    +

    TLS Options

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_TLS

    tls

    {true|false}, indicating if TLS must be used.

    MONGOC_URI_TLSCERTIFICATEKEYFILE

    tlscertificatekeyfile

    Path to PEM formatted Private Key, with its Public Certificate concatenated at the end.

    MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD

    tlscertificatekeypassword

    The password, if any, to use to unlock encrypted Private Key.

    MONGOC_URI_TLSCAFILE

    tlscafile

    One, or a bundle of, Certificate Authorities whom should be considered to be trusted.

    MONGOC_URI_TLSALLOWINVALIDCERTIFICATES

    tlsallowinvalidcertificates

    Accept and ignore certificate verification errors (e.g. untrusted issuer, expired, etc.)

    MONGOC_URI_TLSALLOWINVALIDHOSTNAMES

    tlsallowinvalidhostnames

    Ignore hostname verification of the certificate (e.g. Man In The Middle, using valid certificate, but issued for another hostname)

    MONGOC_URI_TLSINSECURE

    tlsinsecure

    {true|false}, indicating if insecure TLS options should be used. Currently this implies MONGOC_URI_TLSALLOWINVALIDCERTIFICATES and MONGOC_URI_TLSALLOWINVALIDHOSTNAMES.

    MONGOC_URI_TLSDISABLECERTIFICATEREVOCATIONCHECK

    tlsdisablecertificaterevocationcheck

    {true|false}, indicates if revocation checking (CRL / OCSP) should be disabled.

    MONGOC_URI_TLSDISABLEOCSPENDPOINTCHECK

    tlsdisableocspendpointcheck

    {true|false}, indicates if OCSP responder endpoints should not be requested when an OCSP response is not stapled.

    +

    See Configuring TLS for details about these options and about building libmongoc with TLS support.

    +
    +
    +

    Deprecated SSL Options

    +

    The following options have been deprecated and may be removed from future releases of libmongoc.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Deprecated For

    Key

    MONGOC_URI_SSL

    ssl

    MONGOC_URI_TLS

    tls

    MONGOC_URI_SSLCLIENTCERTIFICATEKEYFILE

    sslclientcertificatekeyfile

    MONGOC_URI_TLSCERTIFICATEKEYFILE

    tlscertificatekeyfile

    MONGOC_URI_SSLCLIENTCERTIFICATEKEYPASSWORD

    sslclientcertificatekeypassword

    MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD

    tlscertificatekeypassword

    MONGOC_URI_SSLCERTIFICATEAUTHORITYFILE

    sslcertificateauthorityfile

    MONGOC_URI_TLSCAFILE

    tlscafile

    MONGOC_URI_SSLALLOWINVALIDCERTIFICATES

    sslallowinvalidcertificates

    MONGOC_URI_TLSALLOWINVALIDCERTIFICATES

    tlsallowinvalidcertificates

    MONGOC_URI_SSLALLOWINVALIDHOSTNAMES

    sslallowinvalidhostnames

    MONGOC_URI_TLSALLOWINVALIDHOSTNAMES

    tlsallowinvalidhostnames

    +
    +
    +

    Server Discovery, Monitoring, and Selection Options

    +

    Clients in a mongoc_client_pool_t share a topology scanner that runs on a background thread. The thread wakes every heartbeatFrequencyMS (default 10 seconds) to scan all MongoDB servers in parallel. Whenever an application operation requires a server that is not known–for example, if there is no known primary and your application attempts an insert–the thread rescans all servers every half-second. In this situation the pooled client waits up to serverSelectionTimeoutMS (default 30 seconds) for the thread to find a server suitable for the operation, then returns an error with domain MONGOC_ERROR_SERVER_SELECTION.

    +

    Technically, the total time an operation may wait while a pooled client scans the topology is controlled both by serverSelectionTimeoutMS and connectTimeoutMS. The longest wait occurs if the last scan begins just at the end of the selection timeout, and a slow or down server requires the full connection timeout before the client gives up.

    +

    A non-pooled client is single-threaded. Every heartbeatFrequencyMS, it blocks the next application operation while it does a parallel scan. This scan takes as long as needed to check the slowest server: roughly connectTimeoutMS. Therefore the default heartbeatFrequencyMS for single-threaded clients is greater than for pooled clients: 60 seconds.

    +

    By default, single-threaded (non-pooled) clients scan only once when an operation requires a server that is not known. If you attempt an insert and there is no known primary, the client checks all servers once trying to find it, then succeeds or returns an error with domain MONGOC_ERROR_SERVER_SELECTION. But if you set serverSelectionTryOnce to “false”, the single-threaded client loops, checking all servers every half-second, until serverSelectionTimeoutMS.

    +

    The total time an operation may wait for a single-threaded client to scan the topology is determined by connectTimeoutMS in the try-once case, or serverSelectionTimeoutMS and connectTimeoutMS if serverSelectionTryOnce is set “false”.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_HEARTBEATFREQUENCYMS

    heartbeatfrequencyms

    The interval between server monitoring checks. Defaults to 10,000ms (10 seconds) in pooled (multi-threaded) mode, 60,000ms (60 seconds) in non-pooled mode (single-threaded).

    MONGOC_URI_SERVERSELECTIONTIMEOUTMS

    serverselectiontimeoutms

    A timeout in milliseconds to block for server selection before throwing an exception. The default is 30,0000ms (30 seconds).

    MONGOC_URI_SERVERSELECTIONTRYONCE

    serverselectiontryonce

    If “true”, the driver scans the topology exactly once after server selection fails, then either selects a server or returns an error. If it is false, then the driver repeatedly searches for a suitable server for up to serverSelectionTimeoutMS milliseconds (pausing a half second between attempts). The default for serverSelectionTryOnce is “false” for pooled clients, otherwise “true”. Pooled clients ignore serverSelectionTryOnce; they signal the thread to rescan the topology every half-second until serverSelectionTimeoutMS expires.

    MONGOC_URI_SOCKETCHECKINTERVALMS

    socketcheckintervalms

    Only applies to single threaded clients. If a socket has not been used within this time, its connection is checked with a quick “hello” call before it is used again. Defaults to 5,000ms (5 seconds).

    MONGOC_URI_DIRECTCONNECTION

    directconnection

    If “true”, the driver connects to a single server directly and will not monitor additional servers. If “false”, the driver connects based on the presence and value of the replicaSet option.

    +

    Setting any of the *TimeoutMS options above to 0 will be interpreted as “use the default value”.

    +
    +
    +

    Connection Pool Options

    +

    These options govern the behavior of a mongoc_client_pool_t. They are ignored by a non-pooled mongoc_client_t.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_MAXPOOLSIZE

    maxpoolsize

    The maximum number of clients created by a mongoc_client_pool_t total (both in the pool and checked out). The default value is 100. Once it is reached, mongoc_client_pool_pop() blocks until another thread pushes a client.

    MONGOC_URI_MINPOOLSIZE

    minpoolsize

    Deprecated. This option’s behavior does not match its name, and its actual behavior will likely hurt performance.

    MONGOC_URI_MAXIDLETIMEMS

    maxidletimems

    Not implemented.

    MONGOC_URI_WAITQUEUEMULTIPLE

    waitqueuemultiple

    Not implemented.

    MONGOC_URI_WAITQUEUETIMEOUTMS

    waitqueuetimeoutms

    The maximum time to wait for a client to become available from the pool.

    +
    +
    +

    Write Concern Options

    + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_W

    w

    Determines the write concern (guarantee). Valid values:

    +
      +
    • 0 = The driver will not acknowledge write operations but will pass or handle any network and socket errors that it receives to the client. If you disable write concern but enable the getLastError command’s w option, w overrides the w option.

    • +
    • 1 = Provides basic acknowledgement of write operations. By specifying 1, you require that a standalone mongod instance, or the primary for replica sets, acknowledge all write operations. For drivers released after the default write concern change, this is the default write concern setting.

    • +
    • majority = For replica sets, if you specify the special majority value to w option, write operations will only return successfully after a majority of the configured replica set members have acknowledged the write operation.

    • +
    • n = For replica sets, if you specify a number n greater than 1, operations with this write concern return only after n members of the set have acknowledged the write. If you set n to a number that is greater than the number of available set members or members that hold data, MongoDB will wait, potentially indefinitely, for these members to become available.

    • +
    • tags = For replica sets, you can specify a tag set to require that all members of the set that have these tags configured return confirmation of the write operation.

    • +
    +

    MONGOC_URI_WTIMEOUTMS

    wtimeoutms

    The time in milliseconds to wait for replication to succeed, as specified in the w option, before timing out. When wtimeoutMS is 0, write operations will never time out.

    MONGOC_URI_JOURNAL

    journal

    Controls whether write operations will wait until the mongod acknowledges the write operations and commits the data to the on disk journal.

    +
      +
    • true = Enables journal commit acknowledgement write concern. Equivalent to specifying the getLastError command with the j option enabled.

    • +
    • false = Does not require that mongod commit write operations to the journal before acknowledging the write operation. This is the default option for the journal parameter.

    • +
    +
    +
    +
    +

    Read Concern Options

    + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_READCONCERNLEVEL

    readconcernlevel

    The level of isolation for read operations. If the level is left unspecified, the server default will be used. See readConcern in the MongoDB Manual for details.

    +
    +
    +

    Read Preference Options

    +

    When connected to a replica set, the driver chooses which member to query using the read preference:

    +
      +
    1. Choose members whose type matches “readPreference”.

    2. +
    3. From these, if there are any tags sets configured, choose members matching the first tag set. If there are none, fall back to the next tag set and so on, until some members are chosen or the tag sets are exhausted.

    4. +
    5. From the chosen servers, distribute queries randomly among the server with the fastest round-trip times. These include the server with the fastest time and any whose round-trip time is no more than “localThresholdMS” slower.

    6. +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_READPREFERENCE

    readpreference

    Specifies the replica set read preference for this connection. This setting overrides any secondaryOk value. The read preference values are the following:

    +
      +
    • primary (default)

    • +
    • primaryPreferred

    • +
    • secondary

    • +
    • secondaryPreferred

    • +
    • nearest

    • +
    +

    MONGOC_URI_READPREFERENCETAGS

    readpreferencetags

    A representation of a tag set. See also Tag Sets.

    MONGOC_URI_LOCALTHRESHOLDMS

    localthresholdms

    How far to distribute queries, beyond the server with the fastest round-trip time. By default, only servers within 15ms of the fastest round-trip time receive queries.

    MONGOC_URI_MAXSTALENESSSECONDS

    maxstalenessseconds

    The maximum replication lag, in wall clock time, that a secondary can suffer and still be eligible. The smallest allowed value for maxStalenessSeconds is 90 seconds.

    +
    +

    Note

    +

    When connecting to more than one mongos, libmongoc’s localThresholdMS applies only to the selection of mongos servers. The threshold for selecting among replica set members in shards is controlled by the mongos’s localThreshold command line option.

    +
    +
    +
    +

    Legacy Options

    +

    For historical reasons, the following options are available. They should however not be used.

    + + + + + + + + + + + + + +

    Constant

    Key

    Description

    MONGOC_URI_SAFE

    safe

    {true|false} Same as w={1|0}

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_uri_unescape.html b/libmongoc/1.24.0/mongoc_uri_unescape.html new file mode 100644 index 0000000000000000000000000000000000000000..caf8f9af2fe3b553d7054865f4b3f0ce2dc6c475 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_uri_unescape.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_unescape() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_uri_unescape()

    +
    +

    Synopsis

    +
    char *
    +mongoc_uri_unescape (const char *escaped_string) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    +
      +
    • escaped_string: A utf8 encoded string.

    • +
    +
    +
    +

    Description

    +

    Unescapes an URI encoded string. For example, “%40” would become “@”.

    +
    +
    +

    Returns

    +

    Returns a newly allocated string that should be freed with bson_free(). If escaped_string contains an invalid UTF-8 character or an invalid escape sequence, returns NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_version.html b/libmongoc/1.24.0/mongoc_version.html new file mode 100644 index 0000000000000000000000000000000000000000..9346086c5e3034664b1caa6be83fb989d4cc7cf4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_version.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + Version Checks — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Version Checks

    +

    Conditional compilation based on mongoc version

    +
    +

    Description

    +

    The following preprocessor macros can be used to perform various checks based on the version of the library you are compiling against. +This may be useful if you only want to enable a feature on a certain version of the library.

    +
    #include <mongoc/mongoc.h>
    +
    +#define MONGOC_MAJOR_VERSION (x)
    +#define MONGOC_MINOR_VERSION (y)
    +#define MONGOC_MICRO_VERSION (z)
    +#define MONGOC_VERSION_S     "x.y.z"
    +#define MONGOC_VERSION_HEX   ((1 << 24) | (0 << 16) | (0 << 8) | 0)
    +#define MONGOC_CHECK_VERSION(major, minor, micro)
    +
    +
    +

    Only compile a block on MongoDB C Driver 1.1.0 and newer.

    +
    #if MONGOC_CHECK_VERSION(1, 1, 0)
    +static void
    +do_something (void)
    +{
    +}
    +#endif
    +
    +
    +
    +
    +

    Run-Time Version Checks

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_append.html b/libmongoc/1.24.0/mongoc_write_concern_append.html new file mode 100644 index 0000000000000000000000000000000000000000..1c8c5ce303047ccf90d60f29b428641009c2dd00 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_append.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_write_concern_append() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_append()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_append (mongoc_write_concern_t *write_concern,
    +                             bson_t *command);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    This function appends a write concern to command options. It is useful for appending a write concern to command options before passing them to mongoc_client_write_command_with_opts() or a related function that takes an options document.

    +
    +
    +

    Returns

    +

    Returns true on success. If any arguments are invalid, returns false and logs an error.

    +
    +
    +

    Example

    +

    See the example code for mongoc_client_write_command_with_opts().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_copy.html b/libmongoc/1.24.0/mongoc_write_concern_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..a9c07c8fe6c453763ec7a7ed72b9085e30652cf7 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_write_concern_copy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_copy()

    +
    +

    Synopsis

    +
    mongoc_write_concern_t *
    +mongoc_write_concern_copy (const mongoc_write_concern_t *write_concern)
    +   BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Performs a deep copy of write_concern.

    +
    +
    +

    Returns

    +

    Returns a newly allocated copy of write_concern that should be freed with mongoc_write_concern_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_destroy.html b/libmongoc/1.24.0/mongoc_write_concern_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5664b7a67b69c7e6d91c9d59b0534e6d17b12f3b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_write_concern_destroy() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_destroy()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_destroy (mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Frees all resources associated with the write concern structure. Does nothing if write_concern is NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_fsync.html b/libmongoc/1.24.0/mongoc_write_concern_get_fsync.html new file mode 100644 index 0000000000000000000000000000000000000000..b5cdfc8336aba3de0f2a27b69998ec83c65388f8 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_fsync.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_fsync() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_fsync()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.4.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_write_concern_get_journal() in new code.

    +
    +
    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_get_fsync (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches if an fsync should be performed before returning success on a write operation.

    +
    +
    +

    Returns

    +

    Returns true if fsync is set as part of the write concern.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_journal.html b/libmongoc/1.24.0/mongoc_write_concern_get_journal.html new file mode 100644 index 0000000000000000000000000000000000000000..707a44767491399c2dd46d32ae8acce41edb2a34 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_journal.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_journal() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_journal()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_get_journal (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches if the write should be journaled before indicating success.

    +
    +
    +

    Returns

    +

    Returns true if the write should be journaled.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_w.html b/libmongoc/1.24.0/mongoc_write_concern_get_w.html new file mode 100644 index 0000000000000000000000000000000000000000..ac8fb00f0c46af869c697d66f888a47513ef8b3b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_w.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_w() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_w()

    +
    +

    Synopsis

    +
    int32_t
    +mongoc_write_concern_get_w (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches the w parameter of the write concern.

    +
    +
    +

    Returns

    +

    Returns an integer containing the w value. If wmajority is set, this would be MONGOC_WRITE_CONCERN_W_MAJORITY.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_wmajority.html b/libmongoc/1.24.0/mongoc_write_concern_get_wmajority.html new file mode 100644 index 0000000000000000000000000000000000000000..490578ccf7e2c7ac627c25d50d36bb76e53dacfb --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_wmajority.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wmajority() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_wmajority()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_get_wmajority (
    +   const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Fetches if the write should be written to a majority of nodes before indicating success.

    +
    +
    +

    Returns

    +

    Returns true if wmajority is set.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_wtag.html b/libmongoc/1.24.0/mongoc_write_concern_get_wtag.html new file mode 100644 index 0000000000000000000000000000000000000000..c7407d269177082b621f7816641ea0423af20ca4 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_wtag.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wtag() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_wtag()

    +
    +

    Synopsis

    +
    const char *
    +mongoc_write_concern_get_wtag (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    A string containing the wtag setting if it has been set. Otherwise returns NULL.

    +
    +
    +

    Returns

    +

    Returns a string which should not be modified or freed, or NULL.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_wtimeout.html b/libmongoc/1.24.0/mongoc_write_concern_get_wtimeout.html new file mode 100644 index 0000000000000000000000000000000000000000..d31c92a0de6bc715560aaa520b50e1d0b017d7c5 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_wtimeout.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wtimeout() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_wtimeout()

    +
    +

    Synopsis

    +
    int32_t
    +mongoc_write_concern_get_wtimeout (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Get the timeout in milliseconds that the server should wait before returning with a write concern timeout.

    +

    A value of 0 indicates no write timeout.

    +
    +
    +

    Returns

    +

    Returns an 32-bit signed integer containing the timeout.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_get_wtimeout_int64.html b/libmongoc/1.24.0/mongoc_write_concern_get_wtimeout_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..9422e9ead4af7d54aa4e8e90fd6aef9b23b09869 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_get_wtimeout_int64.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wtimeout_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_get_wtimeout_int64()

    +
    +

    Synopsis

    +
    int64_t
    +mongoc_write_concern_get_wtimeout_int64 (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Get the timeout in milliseconds that the server should wait before returning with a write concern timeout.

    +

    A value of 0 indicates no write timeout.

    +
    +
    +

    Returns

    +

    Returns a 64-bit signed integer containing the timeout.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_is_acknowledged.html b/libmongoc/1.24.0/mongoc_write_concern_is_acknowledged.html new file mode 100644 index 0000000000000000000000000000000000000000..8288d47d62bb25ad3710881168c2de3ac395b854 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_is_acknowledged.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_write_concern_is_acknowledged() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_is_acknowledged()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_is_acknowledged (
    +   const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Test if this is an acknowledged or unacknowledged write concern.

    +

    If write_concern is NULL, returns true. (In other words, writes are acknowledged by default.)

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_is_default.html b/libmongoc/1.24.0/mongoc_write_concern_is_default.html new file mode 100644 index 0000000000000000000000000000000000000000..c50de5c253d713ee1814e3de35cd2b4dbc7c8f0b --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_is_default.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_write_concern_is_default() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_is_default()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_is_default (mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Returns true if write_concern has not been modified from the default. For example, if no “w” option is set in the MongoDB URI and you have not called mongoc_client_set_write_concern(), then +mongoc_write_concern_is_default() is true for the write concern returned by mongoc_client_get_write_concern().

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_is_valid.html b/libmongoc/1.24.0/mongoc_write_concern_is_valid.html new file mode 100644 index 0000000000000000000000000000000000000000..b28036cfa585b09c2c00dafeea3fe52de5d0954f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_is_valid.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_write_concern_is_valid() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_is_valid()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_is_valid (const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Test if this write concern uses an invalid combination of options.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_journal_is_set.html b/libmongoc/1.24.0/mongoc_write_concern_journal_is_set.html new file mode 100644 index 0000000000000000000000000000000000000000..3419ae693d43680abb48b5319be9de47877f5dc1 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_journal_is_set.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_write_concern_journal_is_set() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_journal_is_set()

    +
    +

    Synopsis

    +
    bool
    +mongoc_write_concern_journal_is_set (
    +   const mongoc_write_concern_t *write_concern);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Test whether this write concern’s “journal” option was explicitly set or uses the default setting.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_new.html b/libmongoc/1.24.0/mongoc_write_concern_new.html new file mode 100644 index 0000000000000000000000000000000000000000..c7738fed817ee2645120907f0d9d9d683a5a9b4e --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_write_concern_new() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_new()

    +
    +

    Synopsis

    +
    mongoc_write_concern_t *
    +mongoc_write_concern_new (void) BSON_GNUC_WARN_UNUSED_RESULT;
    +
    +
    +
    +
    +

    Returns

    +

    Creates a newly allocated write concern that can be configured based on user preference. This should be freed with mongoc_write_concern_destroy() when no longer in use.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_fsync.html b/libmongoc/1.24.0/mongoc_write_concern_set_fsync.html new file mode 100644 index 0000000000000000000000000000000000000000..2c6e8313f9cd0f8e6e4c78b6b37d23538610d4b0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_fsync.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_fsync() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_fsync()

    +
    +

    Warning

    +
    +

    Deprecated since version 1.4.0: This function is deprecated and should not be used in new code.

    +

    Please use mongoc_write_concern_set_journal() in new code.

    +
    +
    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_fsync (mongoc_write_concern_t *write_concern,
    +                                bool fsync_);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets if a fsync must be performed before indicating write success.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_journal.html b/libmongoc/1.24.0/mongoc_write_concern_set_journal.html new file mode 100644 index 0000000000000000000000000000000000000000..629e5a54cea1aa9f3485e004c8d27f0d6a8552a6 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_journal.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_journal() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_journal()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_journal (mongoc_write_concern_t *write_concern,
    +                                  bool journal);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets if the write must have been journaled before indicating success.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_w.html b/libmongoc/1.24.0/mongoc_write_concern_set_w.html new file mode 100644 index 0000000000000000000000000000000000000000..01e2c2efd774e8c34c24d40747bb611381f52da0 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_w.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_w() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_w()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_w (mongoc_write_concern_t *write_concern, int32_t w);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the w value for the write concern. See mongoc_write_concern_t for more information on this setting.

    +

    Unacknowledged writes are not causally consistent. If you execute a write operation with a mongoc_write_concern_t on which you have called mongoc_write_concern_set_w() with a value of 0, the write does not participate in causal consistency, even when executed with a mongoc_client_session_t.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_wmajority.html b/libmongoc/1.24.0/mongoc_write_concern_set_wmajority.html new file mode 100644 index 0000000000000000000000000000000000000000..a8e79b5b7879172e9e7535083fc511be4143a413 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_wmajority.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wmajority() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_wmajority()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_wmajority (mongoc_write_concern_t *write_concern,
    +                                    int32_t wtimeout_msec);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets if the write must have been propagated to a majority of nodes before indicating write success.

    +

    The timeout specifies how long, in milliseconds, the server should wait before indicating that the write has failed. This is not the same as a socket timeout. A value of zero may be used to indicate no timeout.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_wtag.html b/libmongoc/1.24.0/mongoc_write_concern_set_wtag.html new file mode 100644 index 0000000000000000000000000000000000000000..d60233f818e52372e5957f2f8f31ff5bab56b955 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_wtag.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wtag() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_wtag()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_wtag (mongoc_write_concern_t *write_concern,
    +                               const char *tag);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Sets the write tag that must be satisfied for the write to indicate success. Write tags are preset write concerns configured on your MongoDB server. See mongoc_write_concern_t for more information on this setting.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_wtimeout.html b/libmongoc/1.24.0/mongoc_write_concern_set_wtimeout.html new file mode 100644 index 0000000000000000000000000000000000000000..8b0c19286b6e9b4fc66331f66f5b03ca025ce37f --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_wtimeout.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wtimeout() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_wtimeout()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_wtimeout (mongoc_write_concern_t *write_concern,
    +                                   int32_t wtimeout_msec);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Set the timeout in milliseconds that the server should wait before returning with a write concern timeout. This is not the same as a socket timeout. A value of zero may be used to indicate no write concern timeout.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_set_wtimeout_int64.html b/libmongoc/1.24.0/mongoc_write_concern_set_wtimeout_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..2f4ea3fe6508052f8b368f6cf81a805d83616d46 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_set_wtimeout_int64.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wtimeout_int64() — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_set_wtimeout_int64()

    +
    +

    Synopsis

    +
    void
    +mongoc_write_concern_set_wtimeout_int64 (mongoc_write_concern_t *write_concern,
    +                                         int64_t wtimeout_msec);
    +
    +
    +
    +
    +

    Parameters

    + +
    +
    +

    Description

    +

    Set the timeout in milliseconds that the server should wait before returning with a write concern timeout. This is not the same as a socket timeout. A value of zero may be used to indicate no write concern timeout.

    +

    Beginning in version 1.9.0, this function can now alter the write concern after +it has been used in an operation. Previously, using the struct with an operation +would mark it as “frozen” and calling this function would log a warning instead +instead of altering the write concern.

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/mongoc_write_concern_t.html b/libmongoc/1.24.0/mongoc_write_concern_t.html new file mode 100644 index 0000000000000000000000000000000000000000..d75f231c2297a090c109e483c9e9fbebafb19c38 --- /dev/null +++ b/libmongoc/1.24.0/mongoc_write_concern_t.html @@ -0,0 +1,254 @@ + + + + + + + + + + + + + + mongoc_write_concern_t — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_write_concern_t

    +

    Write Concern abstraction

    +
    +

    Synopsis

    +

    mongoc_write_concern_t tells the driver what level of acknowledgement to await from the server. The default, MONGOC_WRITE_CONCERN_W_DEFAULT, is right for the great majority of applications.

    +

    You can specify a write concern on connection objects, database objects, collection objects, or per-operation. Data-modifying operations typically use the write concern of the object they operate on, and check the server response for a write concern error or write concern timeout. For example, mongoc_collection_drop_index() uses the collection’s write concern, and a write concern error or timeout in the response is considered a failure.

    +

    Exceptions to this principle are the generic command functions:

    + +

    These generic command functions do not automatically apply a write concern, and they do not check the server response for a write concern error or write concern timeout.

    +

    See Write Concern on the MongoDB website for more information.

    +
    +
    +

    Write Concern Levels

    +

    Set the write concern level with mongoc_write_concern_set_w().

    + + + + + + + + + + + + + + + +

    MONGOC_WRITE_CONCERN_W_DEFAULT (1)

    By default, writes block awaiting acknowledgement from MongoDB. Acknowledged write concern allows clients to catch network, duplicate key, and other errors.

    MONGOC_WRITE_CONCERN_W_UNACKNOWLEDGED (0)

    With this write concern, MongoDB does not acknowledge the receipt of write operation. Unacknowledged is similar to errors ignored; however, mongoc attempts to receive and handle network errors when possible.

    MONGOC_WRITE_CONCERN_W_MAJORITY (majority)

    Block until a write has been propagated to a majority of the nodes in the replica set.

    n

    Block until a write has been propagated to at least n nodes in the replica set.

    +
    +
    +

    Deprecations

    +

    The write concern MONGOC_WRITE_CONCERN_W_ERRORS_IGNORED (value -1) is a deprecated synonym for MONGOC_WRITE_CONCERN_W_UNACKNOWLEDGED (value 0), and will be removed in the next major release.

    +

    mongoc_write_concern_set_fsync() is deprecated.

    +
    +
    +

    Functions

    + +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/objects.inv b/libmongoc/1.24.0/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..3fa1812f7a7db6a5f745ae73815fac1301f1c5d0 Binary files /dev/null and b/libmongoc/1.24.0/objects.inv differ diff --git a/libmongoc/1.24.0/queryable-encryption.html b/libmongoc/1.24.0/queryable-encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..b5138c9965c6beccb119249e6be9fc66240821ac --- /dev/null +++ b/libmongoc/1.24.0/queryable-encryption.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + Queryable Encryption — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Queryable Encryption

    +

    Using Queryable Encryption requires MongoDB Server 7.0 or higher.

    +

    See the MongoDB Manual for Queryable Encryption for more +information about the feature.

    +

    API related to the “rangePreview” algorithm is still experimental and subject to breaking changes!

    +
    +

    Queryable Encryption in older MongoDB Server versions

    +

    MongoDB Server 6.0 introduced Queryable Encryption as a Public Technical +Preview. MongoDB Server 7.0 includes backwards breaking changes to the Queryable +Encryption protocol.

    +

    The backwards breaking changes are applied in the client protocol in +libmongocrypt 1.8.0. libmongoc 1.24.0 requires libmongocrypt 1.8.0 or newer. +libmongoc 1.24.0 no longer supports Queryable Encryption in MongoDB Server <7.0. +Using Queryable Encryption libmongoc 1.24.0 and higher requires MongoDB Server +>=7.0.

    +

    Using Queryable Encryption with libmongocrypt<1.8.0 on a MongoDB Server>=7.0, or +using libmongocrypt>=1.8.0 on a MongoDB Server<6.0 will result in a server error +when using the incompatible protocol.

    +
    +

    See also

    +
    +
    The MongoDB Manual for Queryable Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/search.html b/libmongoc/1.24.0/search.html new file mode 100644 index 0000000000000000000000000000000000000000..9ed86bed4179002a8b8eac317141e6a27e5ac403 --- /dev/null +++ b/libmongoc/1.24.0/search.html @@ -0,0 +1,126 @@ + + + + + + + + + + + + + Search — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +

    Search

    +
    + +

    + Please activate JavaScript to enable the search + functionality. +

    +
    +

    + From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list. +

    +
    + + + +
    + +
    + +
    + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/searchindex.js b/libmongoc/1.24.0/searchindex.js new file mode 100644 index 0000000000000000000000000000000000000000..74da951c20e3db2528409ef457549ecc1333870e --- /dev/null +++ b/libmongoc/1.24.0/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"docnames": ["advanced-connections", "aggregate", "api", "application-performance-monitoring", "authentication", "basic-troubleshooting", "bulk", "client-side-field-level-encryption", "configuring_tls", "connection-pooling", "cursors", "debugging", "distinct-mapreduce", "errors", "full_index", "gridfs", "guides", "in-use-encryption", "index", "init-cleanup", "installing", "lifecycle", "logging", "manage-collection-indexes", "mongoc-common-task-examples", "mongoc_apm_callbacks_destroy", "mongoc_apm_callbacks_new", "mongoc_apm_callbacks_t", "mongoc_apm_command_failed_get_command_name", "mongoc_apm_command_failed_get_context", "mongoc_apm_command_failed_get_duration", "mongoc_apm_command_failed_get_error", "mongoc_apm_command_failed_get_host", "mongoc_apm_command_failed_get_operation_id", "mongoc_apm_command_failed_get_reply", "mongoc_apm_command_failed_get_request_id", "mongoc_apm_command_failed_get_server_connection_id", "mongoc_apm_command_failed_get_server_connection_id_int64", "mongoc_apm_command_failed_get_server_id", "mongoc_apm_command_failed_get_service_id", "mongoc_apm_command_failed_t", "mongoc_apm_command_started_get_command", "mongoc_apm_command_started_get_command_name", "mongoc_apm_command_started_get_context", "mongoc_apm_command_started_get_database_name", "mongoc_apm_command_started_get_host", "mongoc_apm_command_started_get_operation_id", "mongoc_apm_command_started_get_request_id", "mongoc_apm_command_started_get_server_connection_id", "mongoc_apm_command_started_get_server_connection_id_int64", "mongoc_apm_command_started_get_server_id", "mongoc_apm_command_started_get_service_id", "mongoc_apm_command_started_t", "mongoc_apm_command_succeeded_get_command_name", "mongoc_apm_command_succeeded_get_context", "mongoc_apm_command_succeeded_get_duration", "mongoc_apm_command_succeeded_get_host", "mongoc_apm_command_succeeded_get_operation_id", "mongoc_apm_command_succeeded_get_reply", "mongoc_apm_command_succeeded_get_request_id", "mongoc_apm_command_succeeded_get_server_connection_id", "mongoc_apm_command_succeeded_get_server_connection_id_int64", "mongoc_apm_command_succeeded_get_server_id", "mongoc_apm_command_succeeded_get_service_id", "mongoc_apm_command_succeeded_t", "mongoc_apm_server_changed_get_context", "mongoc_apm_server_changed_get_host", "mongoc_apm_server_changed_get_new_description", "mongoc_apm_server_changed_get_previous_description", "mongoc_apm_server_changed_get_topology_id", "mongoc_apm_server_changed_t", "mongoc_apm_server_closed_get_context", "mongoc_apm_server_closed_get_host", "mongoc_apm_server_closed_get_topology_id", "mongoc_apm_server_closed_t", "mongoc_apm_server_heartbeat_failed_get_awaited", "mongoc_apm_server_heartbeat_failed_get_context", "mongoc_apm_server_heartbeat_failed_get_duration", "mongoc_apm_server_heartbeat_failed_get_error", "mongoc_apm_server_heartbeat_failed_get_host", "mongoc_apm_server_heartbeat_failed_t", "mongoc_apm_server_heartbeat_started_get_awaited", "mongoc_apm_server_heartbeat_started_get_context", "mongoc_apm_server_heartbeat_started_get_host", "mongoc_apm_server_heartbeat_started_t", "mongoc_apm_server_heartbeat_succeeded_get_awaited", "mongoc_apm_server_heartbeat_succeeded_get_context", "mongoc_apm_server_heartbeat_succeeded_get_duration", "mongoc_apm_server_heartbeat_succeeded_get_host", "mongoc_apm_server_heartbeat_succeeded_get_reply", "mongoc_apm_server_heartbeat_succeeded_t", "mongoc_apm_server_opening_get_context", "mongoc_apm_server_opening_get_host", "mongoc_apm_server_opening_get_topology_id", "mongoc_apm_server_opening_t", "mongoc_apm_set_command_failed_cb", "mongoc_apm_set_command_started_cb", "mongoc_apm_set_command_succeeded_cb", "mongoc_apm_set_server_changed_cb", "mongoc_apm_set_server_closed_cb", "mongoc_apm_set_server_heartbeat_failed_cb", "mongoc_apm_set_server_heartbeat_started_cb", "mongoc_apm_set_server_heartbeat_succeeded_cb", "mongoc_apm_set_server_opening_cb", "mongoc_apm_set_topology_changed_cb", "mongoc_apm_set_topology_closed_cb", "mongoc_apm_set_topology_opening_cb", "mongoc_apm_topology_changed_get_context", "mongoc_apm_topology_changed_get_new_description", "mongoc_apm_topology_changed_get_previous_description", "mongoc_apm_topology_changed_get_topology_id", "mongoc_apm_topology_changed_t", "mongoc_apm_topology_closed_get_context", "mongoc_apm_topology_closed_get_topology_id", "mongoc_apm_topology_closed_t", "mongoc_apm_topology_opening_get_context", "mongoc_apm_topology_opening_get_topology_id", "mongoc_apm_topology_opening_t", "mongoc_auto_encryption_opts_destroy", "mongoc_auto_encryption_opts_new", "mongoc_auto_encryption_opts_set_bypass_auto_encryption", "mongoc_auto_encryption_opts_set_bypass_query_analysis", "mongoc_auto_encryption_opts_set_encrypted_fields_map", "mongoc_auto_encryption_opts_set_extra", "mongoc_auto_encryption_opts_set_keyvault_client", "mongoc_auto_encryption_opts_set_keyvault_client_pool", "mongoc_auto_encryption_opts_set_keyvault_namespace", "mongoc_auto_encryption_opts_set_kms_credential_provider_callback", "mongoc_auto_encryption_opts_set_kms_providers", "mongoc_auto_encryption_opts_set_schema_map", "mongoc_auto_encryption_opts_set_tls_opts", "mongoc_auto_encryption_opts_t", "mongoc_bulk_operation_delete", "mongoc_bulk_operation_delete_one", "mongoc_bulk_operation_destroy", "mongoc_bulk_operation_execute", "mongoc_bulk_operation_get_hint", "mongoc_bulk_operation_get_write_concern", "mongoc_bulk_operation_insert", "mongoc_bulk_operation_insert_with_opts", "mongoc_bulk_operation_remove", "mongoc_bulk_operation_remove_many_with_opts", "mongoc_bulk_operation_remove_one", "mongoc_bulk_operation_remove_one_with_opts", "mongoc_bulk_operation_replace_one", "mongoc_bulk_operation_replace_one_with_opts", "mongoc_bulk_operation_set_bypass_document_validation", "mongoc_bulk_operation_set_client_session", "mongoc_bulk_operation_set_comment", "mongoc_bulk_operation_set_hint", "mongoc_bulk_operation_set_let", "mongoc_bulk_operation_t", "mongoc_bulk_operation_update", "mongoc_bulk_operation_update_many_with_opts", "mongoc_bulk_operation_update_one", "mongoc_bulk_operation_update_one_with_opts", "mongoc_change_stream_destroy", "mongoc_change_stream_error_document", "mongoc_change_stream_get_resume_token", "mongoc_change_stream_next", "mongoc_change_stream_t", "mongoc_check_version", "mongoc_cleanup", "mongoc_client_command", "mongoc_client_command_simple", "mongoc_client_command_simple_with_server_id", "mongoc_client_command_with_opts", "mongoc_client_destroy", "mongoc_client_enable_auto_encryption", "mongoc_client_encryption_add_key_alt_name", "mongoc_client_encryption_create_datakey", "mongoc_client_encryption_create_encrypted_collection", "mongoc_client_encryption_datakey_opts_destroy", "mongoc_client_encryption_datakey_opts_new", "mongoc_client_encryption_datakey_opts_set_keyaltnames", "mongoc_client_encryption_datakey_opts_set_keymaterial", "mongoc_client_encryption_datakey_opts_set_masterkey", "mongoc_client_encryption_datakey_opts_t", "mongoc_client_encryption_decrypt", "mongoc_client_encryption_delete_key", "mongoc_client_encryption_destroy", "mongoc_client_encryption_encrypt", "mongoc_client_encryption_encrypt_expression", "mongoc_client_encryption_encrypt_opts_destroy", "mongoc_client_encryption_encrypt_opts_new", "mongoc_client_encryption_encrypt_opts_set_algorithm", "mongoc_client_encryption_encrypt_opts_set_contention_factor", "mongoc_client_encryption_encrypt_opts_set_keyaltname", "mongoc_client_encryption_encrypt_opts_set_keyid", "mongoc_client_encryption_encrypt_opts_set_query_type", "mongoc_client_encryption_encrypt_opts_set_range_opts", "mongoc_client_encryption_encrypt_opts_t", "mongoc_client_encryption_encrypt_range_opts_destroy", "mongoc_client_encryption_encrypt_range_opts_new", "mongoc_client_encryption_encrypt_range_opts_set_max", "mongoc_client_encryption_encrypt_range_opts_set_min", "mongoc_client_encryption_encrypt_range_opts_set_precision", "mongoc_client_encryption_encrypt_range_opts_set_sparsity", "mongoc_client_encryption_encrypt_range_opts_t", "mongoc_client_encryption_get_crypt_shared_version", "mongoc_client_encryption_get_key", "mongoc_client_encryption_get_key_by_alt_name", "mongoc_client_encryption_get_keys", "mongoc_client_encryption_new", "mongoc_client_encryption_opts_destroy", "mongoc_client_encryption_opts_new", "mongoc_client_encryption_opts_set_keyvault_client", "mongoc_client_encryption_opts_set_keyvault_namespace", "mongoc_client_encryption_opts_set_kms_credential_provider_callback", "mongoc_client_encryption_opts_set_kms_providers", "mongoc_client_encryption_opts_set_tls_opts", "mongoc_client_encryption_opts_t", "mongoc_client_encryption_remove_key_alt_name", "mongoc_client_encryption_rewrap_many_datakey", "mongoc_client_encryption_rewrap_many_datakey_result_destroy", "mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result", "mongoc_client_encryption_rewrap_many_datakey_result_new", "mongoc_client_encryption_rewrap_many_datakey_result_t", "mongoc_client_encryption_t", "mongoc_client_find_databases_with_opts", "mongoc_client_get_collection", "mongoc_client_get_crypt_shared_version", "mongoc_client_get_database", "mongoc_client_get_database_names", "mongoc_client_get_database_names_with_opts", "mongoc_client_get_default_database", "mongoc_client_get_gridfs", "mongoc_client_get_handshake_description", "mongoc_client_get_read_concern", "mongoc_client_get_read_prefs", "mongoc_client_get_server_description", "mongoc_client_get_server_descriptions", "mongoc_client_get_server_status", "mongoc_client_get_uri", "mongoc_client_get_write_concern", "mongoc_client_new", "mongoc_client_new_from_uri", "mongoc_client_new_from_uri_with_error", "mongoc_client_pool_destroy", "mongoc_client_pool_enable_auto_encryption", "mongoc_client_pool_max_size", "mongoc_client_pool_min_size", "mongoc_client_pool_new", "mongoc_client_pool_new_with_error", "mongoc_client_pool_pop", "mongoc_client_pool_push", "mongoc_client_pool_set_apm_callbacks", "mongoc_client_pool_set_appname", "mongoc_client_pool_set_error_api", "mongoc_client_pool_set_server_api", "mongoc_client_pool_set_ssl_opts", "mongoc_client_pool_t", "mongoc_client_pool_try_pop", "mongoc_client_read_command_with_opts", "mongoc_client_read_write_command_with_opts", "mongoc_client_reset", "mongoc_client_select_server", "mongoc_client_session_abort_transaction", "mongoc_client_session_advance_cluster_time", "mongoc_client_session_advance_operation_time", "mongoc_client_session_append", "mongoc_client_session_commit_transaction", "mongoc_client_session_destroy", "mongoc_client_session_get_client", "mongoc_client_session_get_cluster_time", "mongoc_client_session_get_dirty", "mongoc_client_session_get_lsid", "mongoc_client_session_get_operation_time", "mongoc_client_session_get_opts", "mongoc_client_session_get_server_id", "mongoc_client_session_get_transaction_state", "mongoc_client_session_in_transaction", "mongoc_client_session_start_transaction", "mongoc_client_session_t", "mongoc_client_session_with_transaction", "mongoc_client_session_with_transaction_cb_t", "mongoc_client_set_apm_callbacks", "mongoc_client_set_appname", "mongoc_client_set_error_api", "mongoc_client_set_read_concern", "mongoc_client_set_read_prefs", "mongoc_client_set_server_api", "mongoc_client_set_ssl_opts", "mongoc_client_set_stream_initiator", "mongoc_client_set_write_concern", "mongoc_client_start_session", "mongoc_client_t", "mongoc_client_watch", "mongoc_client_write_command_with_opts", "mongoc_collection_aggregate", "mongoc_collection_command", "mongoc_collection_command_simple", "mongoc_collection_command_with_opts", "mongoc_collection_copy", "mongoc_collection_count", "mongoc_collection_count_documents", "mongoc_collection_count_with_opts", "mongoc_collection_create_bulk_operation", "mongoc_collection_create_bulk_operation_with_opts", "mongoc_collection_create_index", "mongoc_collection_create_index_with_opts", "mongoc_collection_create_indexes_with_opts", "mongoc_collection_delete", "mongoc_collection_delete_many", "mongoc_collection_delete_one", "mongoc_collection_destroy", "mongoc_collection_drop", "mongoc_collection_drop_index", "mongoc_collection_drop_index_with_opts", "mongoc_collection_drop_with_opts", "mongoc_collection_ensure_index", "mongoc_collection_estimated_document_count", "mongoc_collection_find", "mongoc_collection_find_and_modify", "mongoc_collection_find_and_modify_with_opts", "mongoc_collection_find_indexes", "mongoc_collection_find_indexes_with_opts", "mongoc_collection_find_with_opts", "mongoc_collection_get_last_error", "mongoc_collection_get_name", "mongoc_collection_get_read_concern", "mongoc_collection_get_read_prefs", "mongoc_collection_get_write_concern", "mongoc_collection_insert", "mongoc_collection_insert_bulk", "mongoc_collection_insert_many", "mongoc_collection_insert_one", "mongoc_collection_keys_to_index_string", "mongoc_collection_read_command_with_opts", "mongoc_collection_read_write_command_with_opts", "mongoc_collection_remove", "mongoc_collection_rename", "mongoc_collection_rename_with_opts", "mongoc_collection_replace_one", "mongoc_collection_save", "mongoc_collection_set_read_concern", "mongoc_collection_set_read_prefs", "mongoc_collection_set_write_concern", "mongoc_collection_stats", "mongoc_collection_t", "mongoc_collection_update", "mongoc_collection_update_many", "mongoc_collection_update_one", "mongoc_collection_validate", "mongoc_collection_watch", "mongoc_collection_write_command_with_opts", "mongoc_cursor_clone", "mongoc_cursor_current", "mongoc_cursor_destroy", "mongoc_cursor_error", "mongoc_cursor_error_document", "mongoc_cursor_get_batch_size", "mongoc_cursor_get_hint", "mongoc_cursor_get_host", "mongoc_cursor_get_id", "mongoc_cursor_get_limit", "mongoc_cursor_get_max_await_time_ms", "mongoc_cursor_is_alive", "mongoc_cursor_more", "mongoc_cursor_new_from_command_reply", "mongoc_cursor_new_from_command_reply_with_opts", "mongoc_cursor_next", "mongoc_cursor_set_batch_size", "mongoc_cursor_set_hint", "mongoc_cursor_set_limit", "mongoc_cursor_set_max_await_time_ms", "mongoc_cursor_t", "mongoc_database_add_user", "mongoc_database_aggregate", "mongoc_database_command", "mongoc_database_command_simple", "mongoc_database_command_with_opts", "mongoc_database_copy", "mongoc_database_create_collection", "mongoc_database_destroy", "mongoc_database_drop", "mongoc_database_drop_with_opts", "mongoc_database_find_collections", "mongoc_database_find_collections_with_opts", "mongoc_database_get_collection", "mongoc_database_get_collection_names", "mongoc_database_get_collection_names_with_opts", "mongoc_database_get_name", "mongoc_database_get_read_concern", "mongoc_database_get_read_prefs", "mongoc_database_get_write_concern", "mongoc_database_has_collection", "mongoc_database_read_command_with_opts", "mongoc_database_read_write_command_with_opts", "mongoc_database_remove_all_users", "mongoc_database_remove_user", "mongoc_database_set_read_concern", "mongoc_database_set_read_prefs", "mongoc_database_set_write_concern", "mongoc_database_t", "mongoc_database_watch", "mongoc_database_write_command_with_opts", "mongoc_delete_flags_t", "mongoc_error_has_label", "mongoc_find_and_modify_opts_append", "mongoc_find_and_modify_opts_destroy", "mongoc_find_and_modify_opts_get_bypass_document_validation", "mongoc_find_and_modify_opts_get_fields", "mongoc_find_and_modify_opts_get_flags", "mongoc_find_and_modify_opts_get_max_time_ms", "mongoc_find_and_modify_opts_get_sort", "mongoc_find_and_modify_opts_get_update", "mongoc_find_and_modify_opts_new", "mongoc_find_and_modify_opts_set_bypass_document_validation", "mongoc_find_and_modify_opts_set_fields", "mongoc_find_and_modify_opts_set_flags", "mongoc_find_and_modify_opts_set_max_time_ms", "mongoc_find_and_modify_opts_set_sort", "mongoc_find_and_modify_opts_set_update", "mongoc_find_and_modify_opts_t", "mongoc_get_major_version", "mongoc_get_micro_version", "mongoc_get_minor_version", "mongoc_get_version", "mongoc_gridfs_bucket_abort_upload", "mongoc_gridfs_bucket_delete_by_id", "mongoc_gridfs_bucket_destroy", "mongoc_gridfs_bucket_download_to_stream", "mongoc_gridfs_bucket_find", "mongoc_gridfs_bucket_new", "mongoc_gridfs_bucket_open_download_stream", "mongoc_gridfs_bucket_open_upload_stream", "mongoc_gridfs_bucket_open_upload_stream_with_id", "mongoc_gridfs_bucket_stream_error", "mongoc_gridfs_bucket_t", "mongoc_gridfs_bucket_upload_from_stream", "mongoc_gridfs_bucket_upload_from_stream_with_id", "mongoc_gridfs_create_file", "mongoc_gridfs_create_file_from_stream", "mongoc_gridfs_destroy", "mongoc_gridfs_drop", "mongoc_gridfs_file_destroy", "mongoc_gridfs_file_error", "mongoc_gridfs_file_get_aliases", "mongoc_gridfs_file_get_chunk_size", "mongoc_gridfs_file_get_content_type", "mongoc_gridfs_file_get_filename", "mongoc_gridfs_file_get_id", "mongoc_gridfs_file_get_length", "mongoc_gridfs_file_get_md5", "mongoc_gridfs_file_get_metadata", "mongoc_gridfs_file_get_upload_date", "mongoc_gridfs_file_list_destroy", "mongoc_gridfs_file_list_error", "mongoc_gridfs_file_list_next", "mongoc_gridfs_file_list_t", "mongoc_gridfs_file_opt_t", "mongoc_gridfs_file_readv", "mongoc_gridfs_file_remove", "mongoc_gridfs_file_save", "mongoc_gridfs_file_seek", "mongoc_gridfs_file_set_aliases", "mongoc_gridfs_file_set_content_type", "mongoc_gridfs_file_set_filename", "mongoc_gridfs_file_set_id", "mongoc_gridfs_file_set_md5", "mongoc_gridfs_file_set_metadata", "mongoc_gridfs_file_t", "mongoc_gridfs_file_tell", "mongoc_gridfs_file_writev", "mongoc_gridfs_find", "mongoc_gridfs_find_one", "mongoc_gridfs_find_one_by_filename", "mongoc_gridfs_find_one_with_opts", "mongoc_gridfs_find_with_opts", "mongoc_gridfs_get_chunks", "mongoc_gridfs_get_files", "mongoc_gridfs_remove_by_filename", "mongoc_gridfs_t", "mongoc_handshake_data_append", "mongoc_host_list_t", "mongoc_index_opt_geo_get_default", "mongoc_index_opt_geo_init", "mongoc_index_opt_geo_t", "mongoc_index_opt_get_default", "mongoc_index_opt_init", "mongoc_index_opt_t", "mongoc_index_opt_wt_get_default", "mongoc_index_opt_wt_init", "mongoc_index_opt_wt_t", "mongoc_init", "mongoc_insert_flags_t", "mongoc_iovec_t", "mongoc_optional_copy", "mongoc_optional_init", "mongoc_optional_is_set", "mongoc_optional_set_value", "mongoc_optional_t", "mongoc_optional_value", "mongoc_query_flags_t", "mongoc_rand", "mongoc_rand_add", "mongoc_rand_seed", "mongoc_rand_status", "mongoc_read_concern_append", "mongoc_read_concern_copy", "mongoc_read_concern_destroy", "mongoc_read_concern_get_level", "mongoc_read_concern_is_default", "mongoc_read_concern_new", "mongoc_read_concern_set_level", "mongoc_read_concern_t", "mongoc_read_mode_t", "mongoc_read_prefs_add_tag", "mongoc_read_prefs_copy", "mongoc_read_prefs_destroy", "mongoc_read_prefs_get_hedge", "mongoc_read_prefs_get_max_staleness_seconds", "mongoc_read_prefs_get_mode", "mongoc_read_prefs_get_tags", "mongoc_read_prefs_is_valid", "mongoc_read_prefs_new", "mongoc_read_prefs_set_hedge", "mongoc_read_prefs_set_max_staleness_seconds", "mongoc_read_prefs_set_mode", "mongoc_read_prefs_set_tags", "mongoc_read_prefs_t", "mongoc_remove_flags_t", "mongoc_reply_flags_t", "mongoc_server_api_copy", "mongoc_server_api_deprecation_errors", "mongoc_server_api_destroy", "mongoc_server_api_get_deprecation_errors", "mongoc_server_api_get_strict", "mongoc_server_api_get_version", "mongoc_server_api_new", "mongoc_server_api_strict", "mongoc_server_api_t", "mongoc_server_api_version_from_string", "mongoc_server_api_version_t", "mongoc_server_api_version_to_string", "mongoc_server_description_destroy", "mongoc_server_description_hello_response", "mongoc_server_description_host", "mongoc_server_description_id", "mongoc_server_description_ismaster", "mongoc_server_description_last_update_time", "mongoc_server_description_new_copy", "mongoc_server_description_round_trip_time", "mongoc_server_description_t", "mongoc_server_description_type", "mongoc_server_descriptions_destroy_all", "mongoc_session_opt_t", "mongoc_session_opts_clone", "mongoc_session_opts_destroy", "mongoc_session_opts_get_causal_consistency", "mongoc_session_opts_get_default_transaction_opts", "mongoc_session_opts_get_snapshot", "mongoc_session_opts_get_transaction_opts", "mongoc_session_opts_new", "mongoc_session_opts_set_causal_consistency", "mongoc_session_opts_set_default_transaction_opts", "mongoc_session_opts_set_snapshot", "mongoc_socket_accept", "mongoc_socket_bind", "mongoc_socket_close", "mongoc_socket_connect", "mongoc_socket_destroy", "mongoc_socket_errno", "mongoc_socket_getnameinfo", "mongoc_socket_getsockname", "mongoc_socket_listen", "mongoc_socket_new", "mongoc_socket_recv", "mongoc_socket_send", "mongoc_socket_sendv", "mongoc_socket_setsockopt", "mongoc_socket_t", "mongoc_ssl_opt_get_default", "mongoc_ssl_opt_t", "mongoc_stream_buffered_new", "mongoc_stream_buffered_t", "mongoc_stream_close", "mongoc_stream_cork", "mongoc_stream_destroy", "mongoc_stream_file_get_fd", "mongoc_stream_file_new", "mongoc_stream_file_new_for_path", "mongoc_stream_file_t", "mongoc_stream_flush", "mongoc_stream_get_base_stream", "mongoc_stream_gridfs_new", "mongoc_stream_read", "mongoc_stream_readv", "mongoc_stream_setsockopt", "mongoc_stream_should_retry", "mongoc_stream_socket_get_socket", "mongoc_stream_socket_new", "mongoc_stream_socket_t", "mongoc_stream_t", "mongoc_stream_timed_out", "mongoc_stream_tls_t", "mongoc_stream_uncork", "mongoc_stream_write", "mongoc_stream_writev", "mongoc_topology_description_destroy", "mongoc_topology_description_get_servers", "mongoc_topology_description_has_readable_server", "mongoc_topology_description_has_writable_server", "mongoc_topology_description_new_copy", "mongoc_topology_description_t", "mongoc_topology_description_type", "mongoc_transaction_opt_t", "mongoc_transaction_opts_clone", "mongoc_transaction_opts_destroy", "mongoc_transaction_opts_get_max_commit_time_ms", "mongoc_transaction_opts_get_read_concern", "mongoc_transaction_opts_get_read_prefs", "mongoc_transaction_opts_get_write_concern", "mongoc_transaction_opts_new", "mongoc_transaction_opts_set_max_commit_time_ms", "mongoc_transaction_opts_set_read_concern", "mongoc_transaction_opts_set_read_prefs", "mongoc_transaction_opts_set_write_concern", "mongoc_transaction_state_t", "mongoc_update_flags_t", "mongoc_uri_copy", "mongoc_uri_destroy", "mongoc_uri_get_auth_mechanism", "mongoc_uri_get_auth_source", "mongoc_uri_get_compressors", "mongoc_uri_get_database", "mongoc_uri_get_hosts", "mongoc_uri_get_mechanism_properties", "mongoc_uri_get_option_as_bool", "mongoc_uri_get_option_as_int32", "mongoc_uri_get_option_as_int64", "mongoc_uri_get_option_as_utf8", "mongoc_uri_get_options", "mongoc_uri_get_password", "mongoc_uri_get_read_concern", "mongoc_uri_get_read_prefs", "mongoc_uri_get_read_prefs_t", "mongoc_uri_get_replica_set", "mongoc_uri_get_service", "mongoc_uri_get_srv_hostname", "mongoc_uri_get_srv_service_name", "mongoc_uri_get_ssl", "mongoc_uri_get_string", "mongoc_uri_get_tls", "mongoc_uri_get_username", "mongoc_uri_get_write_concern", "mongoc_uri_has_option", "mongoc_uri_new", "mongoc_uri_new_for_host_port", "mongoc_uri_new_with_error", "mongoc_uri_option_is_bool", "mongoc_uri_option_is_int32", "mongoc_uri_option_is_int64", "mongoc_uri_option_is_utf8", "mongoc_uri_set_auth_mechanism", "mongoc_uri_set_auth_source", "mongoc_uri_set_compressors", "mongoc_uri_set_database", "mongoc_uri_set_mechanism_properties", "mongoc_uri_set_option_as_bool", "mongoc_uri_set_option_as_int32", "mongoc_uri_set_option_as_int64", "mongoc_uri_set_option_as_utf8", "mongoc_uri_set_password", "mongoc_uri_set_read_concern", "mongoc_uri_set_read_prefs_t", "mongoc_uri_set_username", "mongoc_uri_set_write_concern", "mongoc_uri_t", "mongoc_uri_unescape", "mongoc_version", "mongoc_write_concern_append", "mongoc_write_concern_copy", "mongoc_write_concern_destroy", "mongoc_write_concern_get_fsync", "mongoc_write_concern_get_journal", "mongoc_write_concern_get_w", "mongoc_write_concern_get_wmajority", "mongoc_write_concern_get_wtag", "mongoc_write_concern_get_wtimeout", "mongoc_write_concern_get_wtimeout_int64", "mongoc_write_concern_is_acknowledged", "mongoc_write_concern_is_default", "mongoc_write_concern_is_valid", "mongoc_write_concern_journal_is_set", "mongoc_write_concern_new", "mongoc_write_concern_set_fsync", "mongoc_write_concern_set_journal", "mongoc_write_concern_set_w", "mongoc_write_concern_set_wmajority", "mongoc_write_concern_set_wtag", "mongoc_write_concern_set_wtimeout", "mongoc_write_concern_set_wtimeout_int64", "mongoc_write_concern_t", "queryable-encryption", "tutorial", "visual-studio-guide"], "filenames": ["advanced-connections.rst", "aggregate.rst", "api.rst", "application-performance-monitoring.rst", "authentication.rst", "basic-troubleshooting.rst", "bulk.rst", "client-side-field-level-encryption.rst", "configuring_tls.rst", "connection-pooling.rst", "cursors.rst", "debugging.rst", "distinct-mapreduce.rst", "errors.rst", "full_index.rst", "gridfs.rst", "guides.rst", "in-use-encryption.rst", "index.rst", "init-cleanup.rst", "installing.rst", "lifecycle.rst", "logging.rst", "manage-collection-indexes.rst", "mongoc-common-task-examples.rst", "mongoc_apm_callbacks_destroy.rst", "mongoc_apm_callbacks_new.rst", "mongoc_apm_callbacks_t.rst", "mongoc_apm_command_failed_get_command_name.rst", "mongoc_apm_command_failed_get_context.rst", "mongoc_apm_command_failed_get_duration.rst", "mongoc_apm_command_failed_get_error.rst", "mongoc_apm_command_failed_get_host.rst", "mongoc_apm_command_failed_get_operation_id.rst", "mongoc_apm_command_failed_get_reply.rst", "mongoc_apm_command_failed_get_request_id.rst", "mongoc_apm_command_failed_get_server_connection_id.rst", "mongoc_apm_command_failed_get_server_connection_id_int64.rst", "mongoc_apm_command_failed_get_server_id.rst", "mongoc_apm_command_failed_get_service_id.rst", "mongoc_apm_command_failed_t.rst", "mongoc_apm_command_started_get_command.rst", "mongoc_apm_command_started_get_command_name.rst", "mongoc_apm_command_started_get_context.rst", "mongoc_apm_command_started_get_database_name.rst", "mongoc_apm_command_started_get_host.rst", "mongoc_apm_command_started_get_operation_id.rst", "mongoc_apm_command_started_get_request_id.rst", "mongoc_apm_command_started_get_server_connection_id.rst", "mongoc_apm_command_started_get_server_connection_id_int64.rst", "mongoc_apm_command_started_get_server_id.rst", "mongoc_apm_command_started_get_service_id.rst", "mongoc_apm_command_started_t.rst", "mongoc_apm_command_succeeded_get_command_name.rst", "mongoc_apm_command_succeeded_get_context.rst", "mongoc_apm_command_succeeded_get_duration.rst", "mongoc_apm_command_succeeded_get_host.rst", "mongoc_apm_command_succeeded_get_operation_id.rst", "mongoc_apm_command_succeeded_get_reply.rst", "mongoc_apm_command_succeeded_get_request_id.rst", "mongoc_apm_command_succeeded_get_server_connection_id.rst", "mongoc_apm_command_succeeded_get_server_connection_id_int64.rst", "mongoc_apm_command_succeeded_get_server_id.rst", "mongoc_apm_command_succeeded_get_service_id.rst", "mongoc_apm_command_succeeded_t.rst", "mongoc_apm_server_changed_get_context.rst", "mongoc_apm_server_changed_get_host.rst", "mongoc_apm_server_changed_get_new_description.rst", "mongoc_apm_server_changed_get_previous_description.rst", "mongoc_apm_server_changed_get_topology_id.rst", "mongoc_apm_server_changed_t.rst", "mongoc_apm_server_closed_get_context.rst", "mongoc_apm_server_closed_get_host.rst", "mongoc_apm_server_closed_get_topology_id.rst", "mongoc_apm_server_closed_t.rst", "mongoc_apm_server_heartbeat_failed_get_awaited.rst", "mongoc_apm_server_heartbeat_failed_get_context.rst", "mongoc_apm_server_heartbeat_failed_get_duration.rst", "mongoc_apm_server_heartbeat_failed_get_error.rst", "mongoc_apm_server_heartbeat_failed_get_host.rst", "mongoc_apm_server_heartbeat_failed_t.rst", "mongoc_apm_server_heartbeat_started_get_awaited.rst", "mongoc_apm_server_heartbeat_started_get_context.rst", "mongoc_apm_server_heartbeat_started_get_host.rst", "mongoc_apm_server_heartbeat_started_t.rst", "mongoc_apm_server_heartbeat_succeeded_get_awaited.rst", "mongoc_apm_server_heartbeat_succeeded_get_context.rst", "mongoc_apm_server_heartbeat_succeeded_get_duration.rst", "mongoc_apm_server_heartbeat_succeeded_get_host.rst", "mongoc_apm_server_heartbeat_succeeded_get_reply.rst", "mongoc_apm_server_heartbeat_succeeded_t.rst", "mongoc_apm_server_opening_get_context.rst", "mongoc_apm_server_opening_get_host.rst", "mongoc_apm_server_opening_get_topology_id.rst", "mongoc_apm_server_opening_t.rst", "mongoc_apm_set_command_failed_cb.rst", "mongoc_apm_set_command_started_cb.rst", "mongoc_apm_set_command_succeeded_cb.rst", "mongoc_apm_set_server_changed_cb.rst", "mongoc_apm_set_server_closed_cb.rst", "mongoc_apm_set_server_heartbeat_failed_cb.rst", "mongoc_apm_set_server_heartbeat_started_cb.rst", "mongoc_apm_set_server_heartbeat_succeeded_cb.rst", "mongoc_apm_set_server_opening_cb.rst", "mongoc_apm_set_topology_changed_cb.rst", "mongoc_apm_set_topology_closed_cb.rst", "mongoc_apm_set_topology_opening_cb.rst", "mongoc_apm_topology_changed_get_context.rst", "mongoc_apm_topology_changed_get_new_description.rst", "mongoc_apm_topology_changed_get_previous_description.rst", "mongoc_apm_topology_changed_get_topology_id.rst", "mongoc_apm_topology_changed_t.rst", "mongoc_apm_topology_closed_get_context.rst", "mongoc_apm_topology_closed_get_topology_id.rst", "mongoc_apm_topology_closed_t.rst", "mongoc_apm_topology_opening_get_context.rst", "mongoc_apm_topology_opening_get_topology_id.rst", "mongoc_apm_topology_opening_t.rst", "mongoc_auto_encryption_opts_destroy.rst", "mongoc_auto_encryption_opts_new.rst", "mongoc_auto_encryption_opts_set_bypass_auto_encryption.rst", "mongoc_auto_encryption_opts_set_bypass_query_analysis.rst", "mongoc_auto_encryption_opts_set_encrypted_fields_map.rst", "mongoc_auto_encryption_opts_set_extra.rst", "mongoc_auto_encryption_opts_set_keyvault_client.rst", "mongoc_auto_encryption_opts_set_keyvault_client_pool.rst", "mongoc_auto_encryption_opts_set_keyvault_namespace.rst", "mongoc_auto_encryption_opts_set_kms_credential_provider_callback.rst", "mongoc_auto_encryption_opts_set_kms_providers.rst", "mongoc_auto_encryption_opts_set_schema_map.rst", "mongoc_auto_encryption_opts_set_tls_opts.rst", "mongoc_auto_encryption_opts_t.rst", "mongoc_bulk_operation_delete.rst", "mongoc_bulk_operation_delete_one.rst", "mongoc_bulk_operation_destroy.rst", "mongoc_bulk_operation_execute.rst", "mongoc_bulk_operation_get_hint.rst", "mongoc_bulk_operation_get_write_concern.rst", "mongoc_bulk_operation_insert.rst", "mongoc_bulk_operation_insert_with_opts.rst", "mongoc_bulk_operation_remove.rst", "mongoc_bulk_operation_remove_many_with_opts.rst", "mongoc_bulk_operation_remove_one.rst", "mongoc_bulk_operation_remove_one_with_opts.rst", "mongoc_bulk_operation_replace_one.rst", "mongoc_bulk_operation_replace_one_with_opts.rst", "mongoc_bulk_operation_set_bypass_document_validation.rst", "mongoc_bulk_operation_set_client_session.rst", "mongoc_bulk_operation_set_comment.rst", "mongoc_bulk_operation_set_hint.rst", "mongoc_bulk_operation_set_let.rst", "mongoc_bulk_operation_t.rst", "mongoc_bulk_operation_update.rst", "mongoc_bulk_operation_update_many_with_opts.rst", "mongoc_bulk_operation_update_one.rst", "mongoc_bulk_operation_update_one_with_opts.rst", "mongoc_change_stream_destroy.rst", "mongoc_change_stream_error_document.rst", "mongoc_change_stream_get_resume_token.rst", "mongoc_change_stream_next.rst", "mongoc_change_stream_t.rst", "mongoc_check_version.rst", "mongoc_cleanup.rst", "mongoc_client_command.rst", "mongoc_client_command_simple.rst", "mongoc_client_command_simple_with_server_id.rst", "mongoc_client_command_with_opts.rst", "mongoc_client_destroy.rst", "mongoc_client_enable_auto_encryption.rst", "mongoc_client_encryption_add_key_alt_name.rst", "mongoc_client_encryption_create_datakey.rst", "mongoc_client_encryption_create_encrypted_collection.rst", "mongoc_client_encryption_datakey_opts_destroy.rst", "mongoc_client_encryption_datakey_opts_new.rst", "mongoc_client_encryption_datakey_opts_set_keyaltnames.rst", "mongoc_client_encryption_datakey_opts_set_keymaterial.rst", "mongoc_client_encryption_datakey_opts_set_masterkey.rst", "mongoc_client_encryption_datakey_opts_t.rst", "mongoc_client_encryption_decrypt.rst", "mongoc_client_encryption_delete_key.rst", "mongoc_client_encryption_destroy.rst", "mongoc_client_encryption_encrypt.rst", "mongoc_client_encryption_encrypt_expression.rst", "mongoc_client_encryption_encrypt_opts_destroy.rst", "mongoc_client_encryption_encrypt_opts_new.rst", "mongoc_client_encryption_encrypt_opts_set_algorithm.rst", "mongoc_client_encryption_encrypt_opts_set_contention_factor.rst", "mongoc_client_encryption_encrypt_opts_set_keyaltname.rst", "mongoc_client_encryption_encrypt_opts_set_keyid.rst", "mongoc_client_encryption_encrypt_opts_set_query_type.rst", "mongoc_client_encryption_encrypt_opts_set_range_opts.rst", "mongoc_client_encryption_encrypt_opts_t.rst", "mongoc_client_encryption_encrypt_range_opts_destroy.rst", "mongoc_client_encryption_encrypt_range_opts_new.rst", "mongoc_client_encryption_encrypt_range_opts_set_max.rst", "mongoc_client_encryption_encrypt_range_opts_set_min.rst", "mongoc_client_encryption_encrypt_range_opts_set_precision.rst", "mongoc_client_encryption_encrypt_range_opts_set_sparsity.rst", "mongoc_client_encryption_encrypt_range_opts_t.rst", "mongoc_client_encryption_get_crypt_shared_version.rst", "mongoc_client_encryption_get_key.rst", "mongoc_client_encryption_get_key_by_alt_name.rst", "mongoc_client_encryption_get_keys.rst", "mongoc_client_encryption_new.rst", "mongoc_client_encryption_opts_destroy.rst", "mongoc_client_encryption_opts_new.rst", "mongoc_client_encryption_opts_set_keyvault_client.rst", "mongoc_client_encryption_opts_set_keyvault_namespace.rst", "mongoc_client_encryption_opts_set_kms_credential_provider_callback.rst", "mongoc_client_encryption_opts_set_kms_providers.rst", "mongoc_client_encryption_opts_set_tls_opts.rst", "mongoc_client_encryption_opts_t.rst", "mongoc_client_encryption_remove_key_alt_name.rst", "mongoc_client_encryption_rewrap_many_datakey.rst", "mongoc_client_encryption_rewrap_many_datakey_result_destroy.rst", "mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.rst", "mongoc_client_encryption_rewrap_many_datakey_result_new.rst", "mongoc_client_encryption_rewrap_many_datakey_result_t.rst", "mongoc_client_encryption_t.rst", "mongoc_client_find_databases_with_opts.rst", "mongoc_client_get_collection.rst", "mongoc_client_get_crypt_shared_version.rst", "mongoc_client_get_database.rst", "mongoc_client_get_database_names.rst", "mongoc_client_get_database_names_with_opts.rst", "mongoc_client_get_default_database.rst", "mongoc_client_get_gridfs.rst", "mongoc_client_get_handshake_description.rst", "mongoc_client_get_read_concern.rst", "mongoc_client_get_read_prefs.rst", "mongoc_client_get_server_description.rst", "mongoc_client_get_server_descriptions.rst", "mongoc_client_get_server_status.rst", "mongoc_client_get_uri.rst", "mongoc_client_get_write_concern.rst", "mongoc_client_new.rst", "mongoc_client_new_from_uri.rst", "mongoc_client_new_from_uri_with_error.rst", "mongoc_client_pool_destroy.rst", "mongoc_client_pool_enable_auto_encryption.rst", "mongoc_client_pool_max_size.rst", "mongoc_client_pool_min_size.rst", "mongoc_client_pool_new.rst", "mongoc_client_pool_new_with_error.rst", "mongoc_client_pool_pop.rst", "mongoc_client_pool_push.rst", "mongoc_client_pool_set_apm_callbacks.rst", "mongoc_client_pool_set_appname.rst", "mongoc_client_pool_set_error_api.rst", "mongoc_client_pool_set_server_api.rst", "mongoc_client_pool_set_ssl_opts.rst", "mongoc_client_pool_t.rst", "mongoc_client_pool_try_pop.rst", "mongoc_client_read_command_with_opts.rst", "mongoc_client_read_write_command_with_opts.rst", "mongoc_client_reset.rst", "mongoc_client_select_server.rst", "mongoc_client_session_abort_transaction.rst", "mongoc_client_session_advance_cluster_time.rst", "mongoc_client_session_advance_operation_time.rst", "mongoc_client_session_append.rst", "mongoc_client_session_commit_transaction.rst", "mongoc_client_session_destroy.rst", "mongoc_client_session_get_client.rst", "mongoc_client_session_get_cluster_time.rst", "mongoc_client_session_get_dirty.rst", "mongoc_client_session_get_lsid.rst", "mongoc_client_session_get_operation_time.rst", "mongoc_client_session_get_opts.rst", "mongoc_client_session_get_server_id.rst", "mongoc_client_session_get_transaction_state.rst", "mongoc_client_session_in_transaction.rst", "mongoc_client_session_start_transaction.rst", "mongoc_client_session_t.rst", "mongoc_client_session_with_transaction.rst", "mongoc_client_session_with_transaction_cb_t.rst", "mongoc_client_set_apm_callbacks.rst", "mongoc_client_set_appname.rst", "mongoc_client_set_error_api.rst", "mongoc_client_set_read_concern.rst", "mongoc_client_set_read_prefs.rst", "mongoc_client_set_server_api.rst", "mongoc_client_set_ssl_opts.rst", "mongoc_client_set_stream_initiator.rst", "mongoc_client_set_write_concern.rst", "mongoc_client_start_session.rst", "mongoc_client_t.rst", "mongoc_client_watch.rst", "mongoc_client_write_command_with_opts.rst", "mongoc_collection_aggregate.rst", "mongoc_collection_command.rst", "mongoc_collection_command_simple.rst", "mongoc_collection_command_with_opts.rst", "mongoc_collection_copy.rst", "mongoc_collection_count.rst", "mongoc_collection_count_documents.rst", "mongoc_collection_count_with_opts.rst", "mongoc_collection_create_bulk_operation.rst", "mongoc_collection_create_bulk_operation_with_opts.rst", "mongoc_collection_create_index.rst", "mongoc_collection_create_index_with_opts.rst", "mongoc_collection_create_indexes_with_opts.rst", "mongoc_collection_delete.rst", "mongoc_collection_delete_many.rst", "mongoc_collection_delete_one.rst", "mongoc_collection_destroy.rst", "mongoc_collection_drop.rst", "mongoc_collection_drop_index.rst", "mongoc_collection_drop_index_with_opts.rst", "mongoc_collection_drop_with_opts.rst", "mongoc_collection_ensure_index.rst", "mongoc_collection_estimated_document_count.rst", "mongoc_collection_find.rst", "mongoc_collection_find_and_modify.rst", "mongoc_collection_find_and_modify_with_opts.rst", "mongoc_collection_find_indexes.rst", "mongoc_collection_find_indexes_with_opts.rst", "mongoc_collection_find_with_opts.rst", "mongoc_collection_get_last_error.rst", "mongoc_collection_get_name.rst", "mongoc_collection_get_read_concern.rst", "mongoc_collection_get_read_prefs.rst", "mongoc_collection_get_write_concern.rst", "mongoc_collection_insert.rst", "mongoc_collection_insert_bulk.rst", "mongoc_collection_insert_many.rst", "mongoc_collection_insert_one.rst", "mongoc_collection_keys_to_index_string.rst", "mongoc_collection_read_command_with_opts.rst", "mongoc_collection_read_write_command_with_opts.rst", "mongoc_collection_remove.rst", "mongoc_collection_rename.rst", "mongoc_collection_rename_with_opts.rst", "mongoc_collection_replace_one.rst", "mongoc_collection_save.rst", "mongoc_collection_set_read_concern.rst", "mongoc_collection_set_read_prefs.rst", "mongoc_collection_set_write_concern.rst", "mongoc_collection_stats.rst", "mongoc_collection_t.rst", "mongoc_collection_update.rst", "mongoc_collection_update_many.rst", "mongoc_collection_update_one.rst", "mongoc_collection_validate.rst", "mongoc_collection_watch.rst", "mongoc_collection_write_command_with_opts.rst", "mongoc_cursor_clone.rst", "mongoc_cursor_current.rst", "mongoc_cursor_destroy.rst", "mongoc_cursor_error.rst", "mongoc_cursor_error_document.rst", "mongoc_cursor_get_batch_size.rst", "mongoc_cursor_get_hint.rst", "mongoc_cursor_get_host.rst", "mongoc_cursor_get_id.rst", "mongoc_cursor_get_limit.rst", "mongoc_cursor_get_max_await_time_ms.rst", "mongoc_cursor_is_alive.rst", "mongoc_cursor_more.rst", "mongoc_cursor_new_from_command_reply.rst", "mongoc_cursor_new_from_command_reply_with_opts.rst", "mongoc_cursor_next.rst", "mongoc_cursor_set_batch_size.rst", "mongoc_cursor_set_hint.rst", "mongoc_cursor_set_limit.rst", "mongoc_cursor_set_max_await_time_ms.rst", "mongoc_cursor_t.rst", "mongoc_database_add_user.rst", "mongoc_database_aggregate.rst", "mongoc_database_command.rst", "mongoc_database_command_simple.rst", "mongoc_database_command_with_opts.rst", "mongoc_database_copy.rst", "mongoc_database_create_collection.rst", "mongoc_database_destroy.rst", "mongoc_database_drop.rst", "mongoc_database_drop_with_opts.rst", "mongoc_database_find_collections.rst", "mongoc_database_find_collections_with_opts.rst", "mongoc_database_get_collection.rst", "mongoc_database_get_collection_names.rst", "mongoc_database_get_collection_names_with_opts.rst", "mongoc_database_get_name.rst", "mongoc_database_get_read_concern.rst", "mongoc_database_get_read_prefs.rst", "mongoc_database_get_write_concern.rst", "mongoc_database_has_collection.rst", "mongoc_database_read_command_with_opts.rst", "mongoc_database_read_write_command_with_opts.rst", "mongoc_database_remove_all_users.rst", "mongoc_database_remove_user.rst", "mongoc_database_set_read_concern.rst", "mongoc_database_set_read_prefs.rst", "mongoc_database_set_write_concern.rst", "mongoc_database_t.rst", "mongoc_database_watch.rst", "mongoc_database_write_command_with_opts.rst", "mongoc_delete_flags_t.rst", "mongoc_error_has_label.rst", "mongoc_find_and_modify_opts_append.rst", "mongoc_find_and_modify_opts_destroy.rst", "mongoc_find_and_modify_opts_get_bypass_document_validation.rst", "mongoc_find_and_modify_opts_get_fields.rst", "mongoc_find_and_modify_opts_get_flags.rst", "mongoc_find_and_modify_opts_get_max_time_ms.rst", "mongoc_find_and_modify_opts_get_sort.rst", "mongoc_find_and_modify_opts_get_update.rst", "mongoc_find_and_modify_opts_new.rst", "mongoc_find_and_modify_opts_set_bypass_document_validation.rst", "mongoc_find_and_modify_opts_set_fields.rst", "mongoc_find_and_modify_opts_set_flags.rst", "mongoc_find_and_modify_opts_set_max_time_ms.rst", "mongoc_find_and_modify_opts_set_sort.rst", "mongoc_find_and_modify_opts_set_update.rst", "mongoc_find_and_modify_opts_t.rst", "mongoc_get_major_version.rst", "mongoc_get_micro_version.rst", "mongoc_get_minor_version.rst", "mongoc_get_version.rst", "mongoc_gridfs_bucket_abort_upload.rst", "mongoc_gridfs_bucket_delete_by_id.rst", "mongoc_gridfs_bucket_destroy.rst", "mongoc_gridfs_bucket_download_to_stream.rst", "mongoc_gridfs_bucket_find.rst", "mongoc_gridfs_bucket_new.rst", "mongoc_gridfs_bucket_open_download_stream.rst", "mongoc_gridfs_bucket_open_upload_stream.rst", "mongoc_gridfs_bucket_open_upload_stream_with_id.rst", "mongoc_gridfs_bucket_stream_error.rst", "mongoc_gridfs_bucket_t.rst", "mongoc_gridfs_bucket_upload_from_stream.rst", "mongoc_gridfs_bucket_upload_from_stream_with_id.rst", "mongoc_gridfs_create_file.rst", "mongoc_gridfs_create_file_from_stream.rst", "mongoc_gridfs_destroy.rst", "mongoc_gridfs_drop.rst", "mongoc_gridfs_file_destroy.rst", "mongoc_gridfs_file_error.rst", "mongoc_gridfs_file_get_aliases.rst", "mongoc_gridfs_file_get_chunk_size.rst", "mongoc_gridfs_file_get_content_type.rst", "mongoc_gridfs_file_get_filename.rst", "mongoc_gridfs_file_get_id.rst", "mongoc_gridfs_file_get_length.rst", "mongoc_gridfs_file_get_md5.rst", "mongoc_gridfs_file_get_metadata.rst", "mongoc_gridfs_file_get_upload_date.rst", "mongoc_gridfs_file_list_destroy.rst", "mongoc_gridfs_file_list_error.rst", "mongoc_gridfs_file_list_next.rst", "mongoc_gridfs_file_list_t.rst", "mongoc_gridfs_file_opt_t.rst", "mongoc_gridfs_file_readv.rst", "mongoc_gridfs_file_remove.rst", "mongoc_gridfs_file_save.rst", "mongoc_gridfs_file_seek.rst", "mongoc_gridfs_file_set_aliases.rst", "mongoc_gridfs_file_set_content_type.rst", "mongoc_gridfs_file_set_filename.rst", "mongoc_gridfs_file_set_id.rst", "mongoc_gridfs_file_set_md5.rst", "mongoc_gridfs_file_set_metadata.rst", "mongoc_gridfs_file_t.rst", "mongoc_gridfs_file_tell.rst", "mongoc_gridfs_file_writev.rst", "mongoc_gridfs_find.rst", "mongoc_gridfs_find_one.rst", "mongoc_gridfs_find_one_by_filename.rst", "mongoc_gridfs_find_one_with_opts.rst", "mongoc_gridfs_find_with_opts.rst", "mongoc_gridfs_get_chunks.rst", "mongoc_gridfs_get_files.rst", "mongoc_gridfs_remove_by_filename.rst", "mongoc_gridfs_t.rst", "mongoc_handshake_data_append.rst", "mongoc_host_list_t.rst", "mongoc_index_opt_geo_get_default.rst", "mongoc_index_opt_geo_init.rst", "mongoc_index_opt_geo_t.rst", "mongoc_index_opt_get_default.rst", "mongoc_index_opt_init.rst", "mongoc_index_opt_t.rst", "mongoc_index_opt_wt_get_default.rst", "mongoc_index_opt_wt_init.rst", "mongoc_index_opt_wt_t.rst", "mongoc_init.rst", "mongoc_insert_flags_t.rst", "mongoc_iovec_t.rst", "mongoc_optional_copy.rst", "mongoc_optional_init.rst", "mongoc_optional_is_set.rst", "mongoc_optional_set_value.rst", "mongoc_optional_t.rst", "mongoc_optional_value.rst", "mongoc_query_flags_t.rst", "mongoc_rand.rst", "mongoc_rand_add.rst", "mongoc_rand_seed.rst", "mongoc_rand_status.rst", "mongoc_read_concern_append.rst", "mongoc_read_concern_copy.rst", "mongoc_read_concern_destroy.rst", "mongoc_read_concern_get_level.rst", "mongoc_read_concern_is_default.rst", "mongoc_read_concern_new.rst", "mongoc_read_concern_set_level.rst", "mongoc_read_concern_t.rst", "mongoc_read_mode_t.rst", "mongoc_read_prefs_add_tag.rst", "mongoc_read_prefs_copy.rst", "mongoc_read_prefs_destroy.rst", "mongoc_read_prefs_get_hedge.rst", "mongoc_read_prefs_get_max_staleness_seconds.rst", "mongoc_read_prefs_get_mode.rst", "mongoc_read_prefs_get_tags.rst", "mongoc_read_prefs_is_valid.rst", "mongoc_read_prefs_new.rst", "mongoc_read_prefs_set_hedge.rst", "mongoc_read_prefs_set_max_staleness_seconds.rst", "mongoc_read_prefs_set_mode.rst", "mongoc_read_prefs_set_tags.rst", "mongoc_read_prefs_t.rst", "mongoc_remove_flags_t.rst", "mongoc_reply_flags_t.rst", "mongoc_server_api_copy.rst", "mongoc_server_api_deprecation_errors.rst", "mongoc_server_api_destroy.rst", "mongoc_server_api_get_deprecation_errors.rst", "mongoc_server_api_get_strict.rst", "mongoc_server_api_get_version.rst", "mongoc_server_api_new.rst", "mongoc_server_api_strict.rst", "mongoc_server_api_t.rst", "mongoc_server_api_version_from_string.rst", "mongoc_server_api_version_t.rst", "mongoc_server_api_version_to_string.rst", "mongoc_server_description_destroy.rst", "mongoc_server_description_hello_response.rst", "mongoc_server_description_host.rst", "mongoc_server_description_id.rst", "mongoc_server_description_ismaster.rst", "mongoc_server_description_last_update_time.rst", "mongoc_server_description_new_copy.rst", "mongoc_server_description_round_trip_time.rst", "mongoc_server_description_t.rst", "mongoc_server_description_type.rst", "mongoc_server_descriptions_destroy_all.rst", "mongoc_session_opt_t.rst", "mongoc_session_opts_clone.rst", "mongoc_session_opts_destroy.rst", "mongoc_session_opts_get_causal_consistency.rst", "mongoc_session_opts_get_default_transaction_opts.rst", "mongoc_session_opts_get_snapshot.rst", "mongoc_session_opts_get_transaction_opts.rst", "mongoc_session_opts_new.rst", "mongoc_session_opts_set_causal_consistency.rst", "mongoc_session_opts_set_default_transaction_opts.rst", "mongoc_session_opts_set_snapshot.rst", "mongoc_socket_accept.rst", "mongoc_socket_bind.rst", "mongoc_socket_close.rst", "mongoc_socket_connect.rst", "mongoc_socket_destroy.rst", "mongoc_socket_errno.rst", "mongoc_socket_getnameinfo.rst", "mongoc_socket_getsockname.rst", "mongoc_socket_listen.rst", "mongoc_socket_new.rst", "mongoc_socket_recv.rst", "mongoc_socket_send.rst", "mongoc_socket_sendv.rst", "mongoc_socket_setsockopt.rst", "mongoc_socket_t.rst", "mongoc_ssl_opt_get_default.rst", "mongoc_ssl_opt_t.rst", "mongoc_stream_buffered_new.rst", "mongoc_stream_buffered_t.rst", "mongoc_stream_close.rst", "mongoc_stream_cork.rst", "mongoc_stream_destroy.rst", "mongoc_stream_file_get_fd.rst", "mongoc_stream_file_new.rst", "mongoc_stream_file_new_for_path.rst", "mongoc_stream_file_t.rst", "mongoc_stream_flush.rst", "mongoc_stream_get_base_stream.rst", "mongoc_stream_gridfs_new.rst", "mongoc_stream_read.rst", "mongoc_stream_readv.rst", "mongoc_stream_setsockopt.rst", "mongoc_stream_should_retry.rst", "mongoc_stream_socket_get_socket.rst", "mongoc_stream_socket_new.rst", "mongoc_stream_socket_t.rst", "mongoc_stream_t.rst", "mongoc_stream_timed_out.rst", "mongoc_stream_tls_t.rst", "mongoc_stream_uncork.rst", "mongoc_stream_write.rst", "mongoc_stream_writev.rst", "mongoc_topology_description_destroy.rst", "mongoc_topology_description_get_servers.rst", "mongoc_topology_description_has_readable_server.rst", "mongoc_topology_description_has_writable_server.rst", "mongoc_topology_description_new_copy.rst", "mongoc_topology_description_t.rst", "mongoc_topology_description_type.rst", "mongoc_transaction_opt_t.rst", "mongoc_transaction_opts_clone.rst", "mongoc_transaction_opts_destroy.rst", "mongoc_transaction_opts_get_max_commit_time_ms.rst", "mongoc_transaction_opts_get_read_concern.rst", "mongoc_transaction_opts_get_read_prefs.rst", "mongoc_transaction_opts_get_write_concern.rst", "mongoc_transaction_opts_new.rst", "mongoc_transaction_opts_set_max_commit_time_ms.rst", "mongoc_transaction_opts_set_read_concern.rst", "mongoc_transaction_opts_set_read_prefs.rst", "mongoc_transaction_opts_set_write_concern.rst", "mongoc_transaction_state_t.rst", "mongoc_update_flags_t.rst", "mongoc_uri_copy.rst", "mongoc_uri_destroy.rst", "mongoc_uri_get_auth_mechanism.rst", "mongoc_uri_get_auth_source.rst", "mongoc_uri_get_compressors.rst", "mongoc_uri_get_database.rst", "mongoc_uri_get_hosts.rst", "mongoc_uri_get_mechanism_properties.rst", "mongoc_uri_get_option_as_bool.rst", "mongoc_uri_get_option_as_int32.rst", "mongoc_uri_get_option_as_int64.rst", "mongoc_uri_get_option_as_utf8.rst", "mongoc_uri_get_options.rst", "mongoc_uri_get_password.rst", "mongoc_uri_get_read_concern.rst", "mongoc_uri_get_read_prefs.rst", "mongoc_uri_get_read_prefs_t.rst", "mongoc_uri_get_replica_set.rst", "mongoc_uri_get_service.rst", "mongoc_uri_get_srv_hostname.rst", "mongoc_uri_get_srv_service_name.rst", "mongoc_uri_get_ssl.rst", "mongoc_uri_get_string.rst", "mongoc_uri_get_tls.rst", "mongoc_uri_get_username.rst", "mongoc_uri_get_write_concern.rst", "mongoc_uri_has_option.rst", "mongoc_uri_new.rst", "mongoc_uri_new_for_host_port.rst", "mongoc_uri_new_with_error.rst", "mongoc_uri_option_is_bool.rst", "mongoc_uri_option_is_int32.rst", "mongoc_uri_option_is_int64.rst", "mongoc_uri_option_is_utf8.rst", "mongoc_uri_set_auth_mechanism.rst", "mongoc_uri_set_auth_source.rst", "mongoc_uri_set_compressors.rst", "mongoc_uri_set_database.rst", "mongoc_uri_set_mechanism_properties.rst", "mongoc_uri_set_option_as_bool.rst", "mongoc_uri_set_option_as_int32.rst", "mongoc_uri_set_option_as_int64.rst", "mongoc_uri_set_option_as_utf8.rst", "mongoc_uri_set_password.rst", "mongoc_uri_set_read_concern.rst", "mongoc_uri_set_read_prefs_t.rst", "mongoc_uri_set_username.rst", "mongoc_uri_set_write_concern.rst", "mongoc_uri_t.rst", "mongoc_uri_unescape.rst", "mongoc_version.rst", "mongoc_write_concern_append.rst", "mongoc_write_concern_copy.rst", "mongoc_write_concern_destroy.rst", "mongoc_write_concern_get_fsync.rst", "mongoc_write_concern_get_journal.rst", "mongoc_write_concern_get_w.rst", "mongoc_write_concern_get_wmajority.rst", "mongoc_write_concern_get_wtag.rst", "mongoc_write_concern_get_wtimeout.rst", "mongoc_write_concern_get_wtimeout_int64.rst", "mongoc_write_concern_is_acknowledged.rst", "mongoc_write_concern_is_default.rst", "mongoc_write_concern_is_valid.rst", "mongoc_write_concern_journal_is_set.rst", "mongoc_write_concern_new.rst", "mongoc_write_concern_set_fsync.rst", "mongoc_write_concern_set_journal.rst", "mongoc_write_concern_set_w.rst", "mongoc_write_concern_set_wmajority.rst", "mongoc_write_concern_set_wtag.rst", "mongoc_write_concern_set_wtimeout.rst", "mongoc_write_concern_set_wtimeout_int64.rst", "mongoc_write_concern_t.rst", "queryable-encryption.rst", "tutorial.rst", "visual-studio-guide.rst"], "titles": ["Advanced Connections", "Aggregation Framework Examples", "API Reference", "Application Performance Monitoring (APM)", "Authentication", "Basic Troubleshooting", "Bulk Write Operations", "Client-Side Field Level Encryption", "Configuring TLS", "Connection Pooling", "Cursors", "Aids for Debugging", "\u201cdistinct\u201d and \u201cmapReduce\u201d", "Error Reporting", "Index", "GridFS", "Guides", "In-Use Encryption", "libmongoc", "Initialization and cleanup", "Installing the MongoDB C Driver (libmongoc) and BSON library (libbson)", "Object Lifecycle", "Logging", "Manage Collection Indexes", "Common Tasks", "mongoc_apm_callbacks_destroy()", "mongoc_apm_callbacks_new()", "mongoc_apm_callbacks_t", "mongoc_apm_command_failed_get_command_name()", "mongoc_apm_command_failed_get_context()", "mongoc_apm_command_failed_get_duration()", "mongoc_apm_command_failed_get_error()", "mongoc_apm_command_failed_get_host()", "mongoc_apm_command_failed_get_operation_id()", "mongoc_apm_command_failed_get_reply()", "mongoc_apm_command_failed_get_request_id()", "mongoc_apm_command_failed_get_server_connection_id()", "mongoc_apm_command_failed_get_server_connection_id_int64()", "mongoc_apm_command_failed_get_server_id()", "mongoc_apm_command_failed_get_service_id()", "mongoc_apm_command_failed_t", "mongoc_apm_command_started_get_command()", "mongoc_apm_command_started_get_command_name()", "mongoc_apm_command_started_get_context()", "mongoc_apm_command_started_get_database_name()", "mongoc_apm_command_started_get_host()", "mongoc_apm_command_started_get_operation_id()", "mongoc_apm_command_started_get_request_id()", "mongoc_apm_command_started_get_server_connection_id()", "mongoc_apm_command_started_get_server_connection_id_int64()", "mongoc_apm_command_started_get_server_id()", "mongoc_apm_command_started_get_service_id()", "mongoc_apm_command_started_t", "mongoc_apm_command_succeeded_get_command_name()", "mongoc_apm_command_succeeded_get_context()", "mongoc_apm_command_succeeded_get_duration()", "mongoc_apm_command_succeeded_get_host()", "mongoc_apm_command_succeeded_get_operation_id()", "mongoc_apm_command_succeeded_get_reply()", "mongoc_apm_command_succeeded_get_request_id()", "mongoc_apm_command_succeeded_get_server_connection_id()", "mongoc_apm_command_succeeded_get_server_connection_id_int64()", "mongoc_apm_command_succeeded_get_server_id()", "mongoc_apm_command_succeeded_get_service_id()", "mongoc_apm_command_succeeded_t", "mongoc_apm_server_changed_get_context()", "mongoc_apm_server_changed_get_host()", "mongoc_apm_server_changed_get_new_description()", "mongoc_apm_server_changed_get_previous_description()", "mongoc_apm_server_changed_get_topology_id()", "mongoc_apm_server_changed_t", "mongoc_apm_server_closed_get_context()", "mongoc_apm_server_closed_get_host()", "mongoc_apm_server_closed_get_topology_id()", "mongoc_apm_server_closed_t", "mongoc_apm_server_heartbeat_failed_get_awaited()", "mongoc_apm_server_heartbeat_failed_get_context()", "mongoc_apm_server_heartbeat_failed_get_duration()", "mongoc_apm_server_heartbeat_failed_get_error()", "mongoc_apm_server_heartbeat_failed_get_host()", "mongoc_apm_server_heartbeat_failed_t", "mongoc_apm_server_heartbeat_started_get_awaited()", "mongoc_apm_server_heartbeat_started_get_context()", "mongoc_apm_server_heartbeat_started_get_host()", "mongoc_apm_server_heartbeat_started_t", "mongoc_apm_server_heartbeat_succeeded_get_awaited()", "mongoc_apm_server_heartbeat_succeeded_get_context()", "mongoc_apm_server_heartbeat_succeeded_get_duration()", "mongoc_apm_server_heartbeat_succeeded_get_host()", "mongoc_apm_server_heartbeat_succeeded_get_reply()", "mongoc_apm_server_heartbeat_succeeded_t", "mongoc_apm_server_opening_get_context()", "mongoc_apm_server_opening_get_host()", "mongoc_apm_server_opening_get_topology_id()", "mongoc_apm_server_opening_t", "mongoc_apm_set_command_failed_cb()", "mongoc_apm_set_command_started_cb()", "mongoc_apm_set_command_succeeded_cb()", "mongoc_apm_set_server_changed_cb()", "mongoc_apm_set_server_closed_cb()", "mongoc_apm_set_server_heartbeat_failed_cb()", "mongoc_apm_set_server_heartbeat_started_cb()", "mongoc_apm_set_server_heartbeat_succeeded_cb()", "mongoc_apm_set_server_opening_cb()", "mongoc_apm_set_topology_changed_cb()", "mongoc_apm_set_topology_closed_cb()", "mongoc_apm_set_topology_opening_cb()", "mongoc_apm_topology_changed_get_context()", "mongoc_apm_topology_changed_get_new_description()", "mongoc_apm_topology_changed_get_previous_description()", "mongoc_apm_topology_changed_get_topology_id()", "mongoc_apm_topology_changed_t", "mongoc_apm_topology_closed_get_context()", "mongoc_apm_topology_closed_get_topology_id()", "mongoc_apm_topology_closed_t", "mongoc_apm_topology_opening_get_context()", "mongoc_apm_topology_opening_get_topology_id()", "mongoc_apm_topology_opening_t", "mongoc_auto_encryption_opts_destroy()", "mongoc_auto_encryption_opts_new()", "mongoc_auto_encryption_opts_set_bypass_auto_encryption()", "mongoc_auto_encryption_opts_set_bypass_query_analysis()", "mongoc_auto_encryption_opts_set_encrypted_fields_map()", "mongoc_auto_encryption_opts_set_extra()", "mongoc_auto_encryption_opts_set_keyvault_client()", "mongoc_auto_encryption_opts_set_keyvault_client_pool()", "mongoc_auto_encryption_opts_set_keyvault_namespace()", "mongoc_auto_encryption_opts_set_kms_credential_provider_callback()", "mongoc_auto_encryption_opts_set_kms_providers()", "mongoc_auto_encryption_opts_set_schema_map()", "mongoc_auto_encryption_opts_set_tls_opts()", "mongoc_auto_encryption_opts_t", "mongoc_bulk_operation_delete()", "mongoc_bulk_operation_delete_one()", "mongoc_bulk_operation_destroy()", "mongoc_bulk_operation_execute()", "mongoc_bulk_operation_get_hint()", "mongoc_bulk_operation_get_write_concern()", "mongoc_bulk_operation_insert()", "mongoc_bulk_operation_insert_with_opts()", "mongoc_bulk_operation_remove()", "mongoc_bulk_operation_remove_many_with_opts()", "mongoc_bulk_operation_remove_one()", "mongoc_bulk_operation_remove_one_with_opts()", "mongoc_bulk_operation_replace_one()", "mongoc_bulk_operation_replace_one_with_opts()", "mongoc_bulk_operation_set_bypass_document_validation()", "mongoc_bulk_operation_set_client_session()", "mongoc_bulk_operation_set_comment()", "mongoc_bulk_operation_set_hint()", "mongoc_bulk_operation_set_let()", "mongoc_bulk_operation_t", "mongoc_bulk_operation_update()", "mongoc_bulk_operation_update_many_with_opts()", "mongoc_bulk_operation_update_one()", "mongoc_bulk_operation_update_one_with_opts()", "mongoc_change_stream_destroy()", "mongoc_change_stream_error_document()", "mongoc_change_stream_get_resume_token()", "mongoc_change_stream_next()", "mongoc_change_stream_t", "mongoc_check_version()", "mongoc_cleanup()", "mongoc_client_command()", "mongoc_client_command_simple()", "mongoc_client_command_simple_with_server_id()", "mongoc_client_command_with_opts()", "mongoc_client_destroy()", "mongoc_client_enable_auto_encryption()", "mongoc_client_encryption_add_key_alt_name()", "mongoc_client_encryption_create_datakey()", "mongoc_client_encryption_create_encrypted_collection()", "mongoc_client_encryption_datakey_opts_destroy()", "mongoc_client_encryption_datakey_opts_new()", "mongoc_client_encryption_datakey_opts_set_keyaltnames()", "mongoc_client_encryption_datakey_opts_set_keymaterial()", "mongoc_client_encryption_datakey_opts_set_masterkey()", "mongoc_client_encryption_datakey_opts_t", "mongoc_client_decryption_decrypt()", "mongoc_client_encryption_delete_key()", "mongoc_client_encryption_destroy()", "mongoc_client_encryption_encrypt()", "mongoc_client_encryption_encrypt_expression()", "mongoc_client_encryption_encrypt_opts_destroy()", "mongoc_client_encryption_encrypt_opts_new()", "mongoc_client_encryption_encrypt_opts_set_algorithm()", "mongoc_client_encryption_encrypt_opts_set_contention_factor()", "mongoc_client_encryption_encrypt_opts_set_keyaltname()", "mongoc_client_encryption_encrypt_opts_set_keyid()", "mongoc_client_encryption_encrypt_opts_set_query_type()", "mongoc_client_encryption_encrypt_opts_set_range_opts()", "mongoc_client_encryption_encrypt_opts_t", "mongoc_client_encryption_encrypt_range_opts_destroy()", "mongoc_client_encryption_encrypt_range_opts_new()", "mongoc_client_encryption_encrypt_range_opts_set_max()", "mongoc_client_encryption_encrypt_range_opts_set_min()", "mongoc_client_encryption_encrypt_range_opts_set_precision()", "mongoc_client_encryption_encrypt_range_opts_set_sparsity()", "mongoc_client_encryption_encrypt_range_opts_t", "mongoc_client_encryption_get_crypt_shared_version()", "mongoc_client_encryption_get_key()", "mongoc_client_encryption_get_key_by_alt_name()", "mongoc_client_encryption_get_keys()", "mongoc_client_encryption_new()", "mongoc_client_encryption_opts_destroy()", "mongoc_client_encryption_opts_new()", "mongoc_client_encryption_opts_set_keyvault_client()", "mongoc_client_encryption_opts_set_keyvault_namespace()", "mongoc_client_encryption_opts_set_kms_credential_provider_callback ()", "mongoc_client_encryption_opts_set_kms_providers()", "mongoc_client_encryption_opts_set_tls_opts()", "mongoc_client_encryption_opts_t", "mongoc_client_encryption_remove_key_alt_name()", "mongoc_client_encryption_rewrap_many_datakey()", "mongoc_client_encryption_rewrap_many_datakey_result_destroy()", "mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result()", "mongoc_client_encryption_rewrap_many_datakey_result_new()", "mongoc_client_encryption_rewrap_many_datakey_result_t", "mongoc_client_encryption_t", "mongoc_client_find_databases_with_opts()", "mongoc_client_get_collection()", "mongoc_client_get_crypt_shared_version()", "mongoc_client_get_database()", "mongoc_client_get_database_names()", "mongoc_client_get_database_names_with_opts()", "mongoc_client_get_default_database()", "mongoc_client_get_gridfs()", "mongoc_client_get_handshake_description()", "mongoc_client_get_read_concern()", "mongoc_client_get_read_prefs()", "mongoc_client_get_server_description()", "mongoc_client_get_server_descriptions()", "mongoc_client_get_server_status()", "mongoc_client_get_uri()", "mongoc_client_get_write_concern()", "mongoc_client_new()", "mongoc_client_new_from_uri()", "mongoc_client_new_from_uri_with_error()", "mongoc_client_pool_destroy()", "mongoc_client_pool_enable_auto_encryption()", "mongoc_client_pool_max_size()", "mongoc_client_pool_min_size()", "mongoc_client_pool_new()", "mongoc_client_pool_new_with_error()", "mongoc_client_pool_pop()", "mongoc_client_pool_push()", "mongoc_client_pool_set_apm_callbacks()", "mongoc_client_pool_set_appname()", "mongoc_client_pool_set_error_api()", "mongoc_client_pool_set_server_api()", "mongoc_client_pool_set_ssl_opts()", "mongoc_client_pool_t", "mongoc_client_pool_try_pop()", "mongoc_client_read_command_with_opts()", "mongoc_client_read_write_command_with_opts()", "mongoc_client_reset()", "mongoc_client_select_server()", "mongoc_client_session_abort_transaction()", "mongoc_client_session_advance_cluster_time()", "mongoc_client_session_advance_operation_time()", "mongoc_client_session_append()", "mongoc_client_session_commit_transaction()", "mongoc_client_session_destroy()", "mongoc_client_session_get_client()", "mongoc_client_session_get_cluster_time()", "mongoc_client_session_get_dirty()", "mongoc_client_session_get_lsid()", "mongoc_client_session_get_operation_time()", "mongoc_client_session_get_opts()", "mongoc_client_session_get_server_id()", "mongoc_client_session_get_transaction_state()", "mongoc_client_session_in_transaction()", "mongoc_client_session_start_transaction()", "mongoc_client_session_t", "mongoc_client_session_with_transaction()", "mongoc_client_session_with_transaction_cb_t", "mongoc_client_set_apm_callbacks()", "mongoc_client_set_appname()", "mongoc_client_set_error_api()", "mongoc_client_set_read_concern()", "mongoc_client_set_read_prefs()", "mongoc_client_set_server_api()", "mongoc_client_set_ssl_opts()", "mongoc_client_set_stream_initiator()", "mongoc_client_set_write_concern()", "mongoc_client_start_session()", "mongoc_client_t", "mongoc_client_watch()", "mongoc_client_write_command_with_opts()", "mongoc_collection_aggregate()", "mongoc_collection_command()", "mongoc_collection_command_simple()", "mongoc_collection_command_with_opts()", "mongoc_collection_copy()", "mongoc_collection_count()", "mongoc_collection_count_documents()", "mongoc_collection_count_with_opts()", "mongoc_collection_create_bulk_operation()", "mongoc_collection_create_bulk_operation_with_opts()", "mongoc_collection_create_index()", "mongoc_collection_create_index_with_opts()", "mongoc_collection_create_indexes_with_opts()", "mongoc_collection_delete()", "mongoc_collection_delete_many()", "mongoc_collection_delete_one()", "mongoc_collection_destroy()", "mongoc_collection_drop()", "mongoc_collection_drop_index()", "mongoc_collection_drop_index_with_opts()", "mongoc_collection_drop_with_opts()", "mongoc_collection_ensure_index()", "mongoc_collection_estimated_document_count()", "mongoc_collection_find()", "mongoc_collection_find_and_modify()", "mongoc_collection_find_and_modify_with_opts()", "mongoc_collection_find_indexes()", "mongoc_collection_find_indexes_with_opts()", "mongoc_collection_find_with_opts()", "mongoc_collection_get_last_error()", "mongoc_collection_get_name()", "mongoc_collection_get_read_concern()", "mongoc_collection_get_read_prefs()", "mongoc_collection_get_write_concern()", "mongoc_collection_insert()", "mongoc_collection_insert_bulk()", "mongoc_collection_insert_many()", "mongoc_collection_insert_one()", "mongoc_collection_keys_to_index_string()", "mongoc_collection_read_command_with_opts()", "mongoc_collection_read_write_command_with_opts()", "mongoc_collection_remove()", "mongoc_collection_rename()", "mongoc_collection_rename_with_opts()", "mongoc_collection_replace_one()", "mongoc_collection_save()", "mongoc_collection_set_read_concern()", "mongoc_collection_set_read_prefs()", "mongoc_collection_set_write_concern()", "mongoc_collection_stats()", "mongoc_collection_t", "mongoc_collection_update()", "mongoc_collection_update_many()", "mongoc_collection_update_one()", "mongoc_collection_validate()", "mongoc_collection_watch()", "mongoc_collection_write_command_with_opts()", "mongoc_cursor_clone()", "mongoc_cursor_current()", "mongoc_cursor_destroy()", "mongoc_cursor_error()", "mongoc_cursor_error_document()", "mongoc_cursor_get_batch_size()", "mongoc_cursor_get_hint()", "mongoc_cursor_get_host()", "mongoc_cursor_get_id()", "mongoc_cursor_get_limit()", "mongoc_cursor_get_max_await_time_ms()", "mongoc_cursor_is_alive()", "mongoc_cursor_more()", "mongoc_cursor_new_from_command_reply()", "mongoc_cursor_new_from_command_reply_with_opts()", "mongoc_cursor_next()", "mongoc_cursor_set_batch_size()", "mongoc_cursor_set_hint()", "mongoc_cursor_set_limit()", "mongoc_cursor_set_max_await_time_ms()", "mongoc_cursor_t", "mongoc_database_add_user()", "mongoc_database_aggregate()", "mongoc_database_command()", "mongoc_database_command_simple()", "mongoc_database_command_with_opts()", "mongoc_database_copy()", "mongoc_database_create_collection()", "mongoc_database_destroy()", "mongoc_database_drop()", "mongoc_database_drop_with_opts()", "mongoc_database_find_collections()", "mongoc_database_find_collections_with_opts()", "mongoc_database_get_collection()", "mongoc_database_get_collection_names()", "mongoc_database_get_collection_names_with_opts()", "mongoc_database_get_name()", "mongoc_database_get_read_concern()", "mongoc_database_get_read_prefs()", "mongoc_database_get_write_concern()", "mongoc_database_has_collection()", "mongoc_database_read_command_with_opts()", "mongoc_database_read_write_command_with_opts()", "mongoc_database_remove_all_users()", "mongoc_database_remove_user()", "mongoc_database_set_read_concern()", "mongoc_database_set_read_prefs()", "mongoc_database_set_write_concern()", "mongoc_database_t", "mongoc_database_watch()", "mongoc_database_write_command_with_opts()", "mongoc_delete_flags_t", "mongoc_error_has_label()", "mongoc_find_and_modify_opts_append()", "mongoc_find_and_modify_opts_destroy()", "mongoc_find_and_modify_opts_get_bypass_document_validation()", "mongoc_find_and_modify_opts_get_fields()", "mongoc_find_and_modify_opts_get_flags()", "mongoc_find_and_modify_opts_get_max_time_ms()", "mongoc_find_and_modify_opts_get_sort()", "mongoc_find_and_modify_opts_get_update()", "mongoc_find_and_modify_opts_new()", "mongoc_find_and_modify_opts_set_bypass_document_validation()", "mongoc_find_and_modify_opts_set_fields()", "mongoc_find_and_modify_opts_set_flags()", "mongoc_find_and_modify_opts_set_max_time_ms()", "mongoc_find_and_modify_opts_set_sort()", "mongoc_find_and_modify_opts_set_update()", "mongoc_find_and_modify_opts_t", "mongoc_get_major_version()", "mongoc_get_micro_version()", "mongoc_get_minor_version()", "mongoc_get_version()", "mongoc_gridfs_bucket_abort_upload()", "mongoc_gridfs_bucket_delete_by_id()", "mongoc_gridfs_bucket_destroy()", "mongoc_gridfs_bucket_download_to_stream()", "mongoc_gridfs_bucket_find()", "mongoc_gridfs_bucket_new()", "mongoc_gridfs_bucket_open_download_stream()", "mongoc_gridfs_bucket_open_upload_stream()", "mongoc_gridfs_bucket_open_upload_stream_with_id()", "mongoc_gridfs_bucket_stream_error()", "mongoc_gridfs_bucket_t", "mongoc_gridfs_bucket_upload_from_stream()", "mongoc_gridfs_bucket_upload_from_stream_with_id()", "mongoc_gridfs_create_file()", "mongoc_gridfs_create_file_from_stream()", "mongoc_gridfs_destroy()", "mongoc_gridfs_drop()", "mongoc_gridfs_file_destroy()", "mongoc_gridfs_file_error()", "mongoc_gridfs_file_get_aliases()", "mongoc_gridfs_file_get_chunk_size()", "mongoc_gridfs_file_get_content_type()", "mongoc_gridfs_file_get_filename()", "mongoc_gridfs_file_get_id()", "mongoc_gridfs_file_get_length()", "mongoc_gridfs_file_get_md5()", "mongoc_gridfs_file_get_metadata()", "mongoc_gridfs_file_get_upload_date()", "mongoc_gridfs_file_list_destroy()", "mongoc_gridfs_file_list_error()", "mongoc_gridfs_file_list_next()", "mongoc_gridfs_file_list_t", "mongoc_gridfs_file_opt_t", "mongoc_gridfs_file_readv()", "mongoc_gridfs_file_remove()", "mongoc_gridfs_file_save()", "mongoc_gridfs_file_seek()", "mongoc_gridfs_file_set_aliases()", "mongoc_gridfs_file_set_content_type()", "mongoc_gridfs_file_set_filename()", "mongoc_gridfs_file_set_id()", "mongoc_gridfs_file_set_md5()", "mongoc_gridfs_file_set_metadata()", "mongoc_gridfs_file_t", "mongoc_gridfs_file_tell()", "mongoc_gridfs_file_writev()", "mongoc_gridfs_find()", "mongoc_gridfs_find_one()", "mongoc_gridfs_find_one_by_filename()", "mongoc_gridfs_find_one_with_opts()", "mongoc_gridfs_find_with_opts()", "mongoc_gridfs_get_chunks()", "mongoc_gridfs_get_files()", "mongoc_gridfs_remove_by_filename()", "mongoc_gridfs_t", "mongoc_handshake_data_append()", "mongoc_host_list_t", "mongoc_index_opt_geo_get_default()", "mongoc_index_opt_geo_init()", "mongoc_index_opt_geo_t", "mongoc_index_opt_get_default()", "mongoc_index_opt_init()", "mongoc_index_opt_t", "mongoc_index_opt_wt_get_default()", "mongoc_index_opt_wt_init()", "mongoc_index_opt_wt_t", "mongoc_init()", "mongoc_insert_flags_t", "mongoc_iovec_t", "mongoc_optional_copy()", "mongoc_optional_init()", "mongoc_optional_is_set()", "mongoc_optional_set_value()", "mongoc_optional_t", "mongoc_optional_value()", "mongoc_query_flags_t", "mongoc_rand", "mongoc_rand_add()", "mongoc_rand_seed()", "mongoc_rand_status()", "mongoc_read_concern_append()", "mongoc_read_concern_copy()", "mongoc_read_concern_destroy()", "mongoc_read_concern_get_level()", "mongoc_read_concern_is_default()", "mongoc_read_concern_new()", "mongoc_read_concern_set_level()", "mongoc_read_concern_t", "mongoc_read_mode_t", "mongoc_read_prefs_add_tag()", "mongoc_read_prefs_copy()", "mongoc_read_prefs_destroy()", "mongoc_read_prefs_get_hedge()", "mongoc_read_prefs_get_max_staleness_seconds()", "mongoc_read_prefs_get_mode()", "mongoc_read_prefs_get_tags()", "mongoc_read_prefs_is_valid()", "mongoc_read_prefs_new()", "mongoc_read_prefs_set_hedge()", "mongoc_read_prefs_set_max_staleness_seconds()", "mongoc_read_prefs_set_mode()", "mongoc_read_prefs_set_tags()", "mongoc_read_prefs_t", "mongoc_remove_flags_t", "mongoc_reply_flags_t", "mongoc_server_api_copy()", "mongoc_server_api_deprecation_errors()", "mongoc_server_api_destroy()", "mongoc_server_api_get_deprecation_errors()", "mongoc_server_api_get_strict()", "mongoc_server_api_get_version()", "mongoc_server_api_new()", "mongoc_server_api_strict()", "mongoc_server_api_t", "mongoc_server_api_version_from_string()", "mongoc_server_api_version_t", "mongoc_server_api_version_to_string()", "mongoc_server_description_destroy()", "mongoc_server_description_hello_response()", "mongoc_server_description_host()", "mongoc_server_description_id()", "mongoc_server_description_ismaster()", "mongoc_server_description_last_update_time()", "mongoc_server_description_new_copy()", "mongoc_server_description_round_trip_time()", "mongoc_server_description_t", "mongoc_server_description_type()", "mongoc_server_descriptions_destroy_all()", "mongoc_session_opt_t", "mongoc_session_opts_clone()", "mongoc_session_opts_destroy()", "mongoc_session_opts_get_causal_consistency()", "mongoc_session_opts_get_default_transaction_opts()", "mongoc_session_opts_get_snapshot()", "mongoc_session_opts_get_transaction_opts()", "mongoc_session_opts_new()", "mongoc_session_opts_set_causal_consistency()", "mongoc_session_opts_set_default_transaction_opts()", "mongoc_session_opts_set_snapshot()", "mongoc_socket_accept()", "mongoc_socket_bind()", "mongoc_socket_close()", "mongoc_socket_connect()", "mongoc_socket_destroy()", "mongoc_socket_errno()", "mongoc_socket_getnameinfo()", "mongoc_socket_getsockname()", "mongoc_socket_listen()", "mongoc_socket_new()", "mongoc_socket_recv()", "mongoc_socket_send()", "mongoc_socket_sendv()", "mongoc_socket_setsockopt()", "mongoc_socket_t", "mongoc_ssl_opt_get_default()", "mongoc_ssl_opt_t", "mongoc_stream_buffered_new()", "mongoc_stream_buffered_t", "mongoc_stream_close()", "mongoc_stream_cork()", "mongoc_stream_destroy()", "mongoc_stream_file_get_fd()", "mongoc_stream_file_new()", "mongoc_stream_file_new_for_path()", "mongoc_stream_file_t", "mongoc_stream_flush()", "mongoc_stream_get_base_stream()", "mongoc_stream_gridfs_new()", "mongoc_stream_read()", "mongoc_stream_readv()", "mongoc_stream_setsockopt()", "mongoc_stream_should_retry()", "mongoc_stream_socket_get_socket()", "mongoc_stream_socket_new()", "mongoc_stream_socket_t", "mongoc_stream_t", "mongoc_stream_timed_out()", "mongoc_stream_tls_t", "mongoc_stream_uncork()", "mongoc_stream_write()", "mongoc_stream_writev()", "mongoc_topology_description_destroy()", "mongoc_topology_description_get_servers()", "mongoc_topology_description_has_readable_server()", "mongoc_topology_description_has_writable_server()", "mongoc_topology_description_new_copy()", "mongoc_topology_description_t", "mongoc_topology_description_type()", "mongoc_transaction_opt_t", "mongoc_transaction_opts_clone()", "mongoc_transaction_opts_destroy()", "mongoc_transaction_opts_get_max_commit_time_ms()", "mongoc_transaction_opts_get_read_concern()", "mongoc_transaction_opts_get_read_prefs()", "mongoc_transaction_opts_get_write_concern()", "mongoc_transaction_opts_new()", "mongoc_transaction_opts_set_max_commit_time_ms()", "mongoc_transaction_opts_set_read_concern()", "mongoc_transaction_opts_set_read_prefs()", "mongoc_transaction_opts_set_write_concern()", "mongoc_transaction_state_t", "mongoc_update_flags_t", "mongoc_uri_copy()", "mongoc_uri_destroy()", "mongoc_uri_get_auth_mechanism()", "mongoc_uri_get_auth_source()", "mongoc_uri_get_compressors()", "mongoc_uri_get_database()", "mongoc_uri_get_hosts()", "mongoc_uri_get_mechanism_properties()", "mongoc_uri_get_option_as_bool()", "mongoc_uri_get_option_as_int32()", "mongoc_uri_get_option_as_int64()", "mongoc_uri_get_option_as_utf8()", "mongoc_uri_get_options()", "mongoc_uri_get_password()", "mongoc_uri_get_read_concern()", "mongoc_uri_get_read_prefs()", "mongoc_uri_get_read_prefs_t()", "mongoc_uri_get_replica_set()", "mongoc_uri_get_service()", "mongoc_uri_get_srv_hostname()", "mongoc_uri_get_srv_service_name()", "mongoc_uri_get_ssl()", "mongoc_uri_get_string()", "mongoc_uri_get_tls()", "mongoc_uri_get_username()", "mongoc_uri_get_write_concern()", "mongoc_uri_has_option()", "mongoc_uri_new()", "mongoc_uri_new_for_host_port()", "mongoc_uri_new_with_error()", "mongoc_uri_option_is_bool()", "mongoc_uri_option_is_int32()", "mongoc_uri_option_is_int64()", "mongoc_uri_option_is_utf8()", "mongoc_uri_set_auth_mechanism()", "mongoc_uri_set_auth_source()", "mongoc_uri_set_compressors()", "mongoc_uri_set_database()", "mongoc_uri_set_mechanism_properties()", "mongoc_uri_set_option_as_bool()", "mongoc_uri_set_option_as_int32()", "mongoc_uri_set_option_as_int64()", "mongoc_uri_set_option_as_utf8()", "mongoc_uri_set_password()", "mongoc_uri_set_read_concern()", "mongoc_uri_set_read_prefs_t()", "mongoc_uri_set_username()", "mongoc_uri_set_write_concern()", "mongoc_uri_t", "mongoc_uri_unescape()", "Version Checks", "mongoc_write_concern_append()", "mongoc_write_concern_copy()", "mongoc_write_concern_destroy()", "mongoc_write_concern_get_fsync()", "mongoc_write_concern_get_journal()", "mongoc_write_concern_get_w()", "mongoc_write_concern_get_wmajority()", "mongoc_write_concern_get_wtag()", "mongoc_write_concern_get_wtimeout()", "mongoc_write_concern_get_wtimeout_int64()", "mongoc_write_concern_is_acknowledged()", "mongoc_write_concern_is_default()", "mongoc_write_concern_is_valid()", "mongoc_write_concern_journal_is_set()", "mongoc_write_concern_new()", "mongoc_write_concern_set_fsync()", "mongoc_write_concern_set_journal()", "mongoc_write_concern_set_w()", "mongoc_write_concern_set_wmajority()", "mongoc_write_concern_set_wtag()", "mongoc_write_concern_set_wtimeout()", "mongoc_write_concern_set_wtimeout_int64()", "mongoc_write_concern_t", "Queryable Encryption", "Tutorial", "Using libmongoc in a Microsoft Visual Studio project"], "terms": {"i": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "part": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "experiment": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "queryabl": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 696, 697], "encrypt": [0, 1, 2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 696, 697], "api": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "mai": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "subject": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "break": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "chang": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "futur": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "releas": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "thi": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "rang": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "algorithm": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "onli": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "intend": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "public": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "us": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695], "It": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "The": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 17, 18, 20, 21, 22, 23, 28, 29, 30, 32, 33, 34, 35, 36, 37, 38, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 65, 66, 67, 68, 69, 71, 72, 73, 76, 77, 79, 82, 83, 86, 87, 88, 89, 91, 92, 93, 107, 108, 109, 110, 112, 113, 115, 116, 118, 120, 121, 122, 123, 126, 127, 128, 129, 130, 135, 136, 138, 139, 148, 149, 151, 158, 159, 160, 161, 163, 164, 165, 166, 168, 169, 170, 171, 174, 175, 176, 178, 179, 181, 182, 185, 188, 190, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 207, 208, 209, 210, 212, 213, 218, 219, 220, 221, 222, 223, 224, 226, 227, 228, 229, 232, 234, 239, 240, 241, 244, 246, 247, 248, 250, 253, 254, 258, 259, 272, 274, 275, 276, 277, 278, 279, 280, 282, 283, 284, 286, 287, 288, 289, 290, 291, 292, 294, 295, 296, 297, 298, 300, 301, 302, 303, 304, 309, 311, 315, 316, 318, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 335, 336, 337, 338, 341, 342, 344, 345, 346, 350, 352, 359, 360, 361, 362, 363, 364, 365, 367, 368, 369, 370, 371, 373, 376, 377, 378, 387, 388, 391, 392, 393, 395, 396, 398, 399, 411, 413, 415, 416, 417, 422, 424, 426, 427, 429, 430, 431, 442, 452, 455, 464, 466, 473, 474, 475, 487, 494, 495, 498, 505, 506, 507, 512, 521, 523, 532, 534, 535, 537, 540, 541, 546, 551, 553, 556, 560, 565, 567, 568, 569, 570, 582, 587, 588, 589, 594, 598, 599, 616, 617, 618, 619, 620, 628, 629, 630, 631, 632, 647, 651, 652, 653, 654, 655, 656, 658, 660, 661, 662, 663, 664, 667, 669, 671, 690, 694, 695, 696, 697], "follow": [0, 1, 4, 5, 7, 8, 10, 12, 13, 17, 20, 22, 24, 119, 123, 128, 129, 130, 150, 160, 171, 176, 182, 209, 210, 253, 254, 272, 277, 288, 289, 291, 295, 298, 303, 304, 317, 328, 329, 333, 341, 342, 345, 368, 387, 388, 396, 399, 473, 521, 534, 669, 671, 696, 697], "guid": [0, 4, 14, 18, 20, 696], "contain": [0, 4, 11, 12, 13, 15, 20, 34, 123, 126, 128, 130, 144, 145, 152, 153, 154, 155, 160, 163, 164, 166, 171, 207, 209, 210, 219, 220, 224, 235, 253, 254, 274, 275, 287, 288, 289, 290, 291, 292, 294, 295, 296, 297, 302, 303, 304, 307, 308, 312, 313, 314, 315, 316, 317, 325, 326, 328, 329, 330, 333, 334, 338, 340, 341, 342, 344, 345, 368, 369, 370, 371, 377, 378, 380, 381, 386, 387, 388, 390, 394, 395, 396, 398, 423, 445, 451, 456, 457, 458, 460, 461, 467, 468, 469, 470, 471, 472, 473, 478, 481, 484, 496, 558, 561, 566, 567, 570, 571, 575, 633, 636, 648, 649, 650, 670, 677, 679, 680, 681, 691], "inform": [0, 4, 5, 7, 11, 135, 160, 171, 230, 289, 294, 296, 306, 307, 312, 317, 331, 333, 341, 342, 343, 350, 368, 375, 474, 506, 519, 544, 636, 669, 689, 691, 694, 695, 696], "specif": [0, 4, 7, 12, 13, 15, 20, 24, 152, 153, 154, 155, 163, 164, 165, 166, 176, 185, 213, 219, 224, 253, 254, 265, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 327, 328, 329, 332, 345, 368, 371, 376, 378, 381, 387, 388, 396, 398, 429, 473, 481, 484, 521, 563, 605, 669, 696], "certain": [0, 6, 13, 24, 669, 671], "type": [0, 5, 6, 20, 21, 151, 181, 189, 196, 208, 227, 286, 317, 323, 325, 326, 440, 442, 457, 459, 473, 521, 532, 545, 567, 605, 606, 629, 630, 631, 632, 651, 652, 653, 654, 660, 661, 662, 663, 669, 696], "configur": [0, 3, 4, 7, 9, 10, 11, 14, 16, 17, 18, 19, 21, 22, 120, 123, 128, 129, 130, 141, 143, 145, 153, 155, 166, 170, 171, 181, 182, 206, 209, 210, 218, 225, 228, 229, 234, 248, 250, 253, 254, 260, 268, 274, 278, 285, 288, 289, 292, 293, 295, 296, 301, 303, 304, 308, 309, 311, 317, 328, 329, 333, 335, 341, 342, 345, 368, 371, 372, 376, 383, 385, 387, 388, 389, 391, 396, 474, 504, 521, 550, 552, 555, 556, 557, 574, 594, 607, 614, 615, 616, 617, 618, 635, 637, 646, 669, 686, 691, 697], "For": [0, 4, 5, 9, 11, 13, 19, 20, 22, 23, 160, 171, 194, 195, 196, 198, 219, 224, 253, 279, 280, 284, 288, 289, 294, 295, 296, 306, 307, 311, 316, 317, 325, 328, 331, 345, 359, 360, 368, 373, 375, 378, 381, 387, 396, 473, 474, 503, 506, 517, 651, 652, 653, 654, 662, 669, 670, 683, 694, 696], "exampl": [0, 4, 5, 6, 7, 9, 10, 11, 13, 14, 16, 18, 19, 22, 23, 129, 130, 135, 162, 176, 210, 219, 262, 298, 300, 301, 303, 304, 308, 309, 316, 318, 325, 326, 327, 332, 333, 341, 358, 359, 360, 376, 398, 399, 424, 474, 475, 485, 503, 517, 547, 554, 651, 652, 653, 654, 655, 656, 658, 664, 667, 670, 683, 694, 696], "simpl": [0, 12, 696], "standalon": [0, 545, 603, 669, 696], "see": [0, 1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 17, 19, 20, 22, 23, 24, 122, 130, 135, 141, 143, 145, 152, 153, 154, 155, 160, 162, 166, 168, 170, 171, 185, 210, 219, 223, 224, 239, 248, 251, 253, 254, 260, 262, 263, 272, 273, 274, 278, 280, 286, 287, 288, 289, 292, 294, 295, 296, 298, 299, 300, 301, 303, 304, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 325, 326, 327, 328, 329, 331, 332, 333, 336, 341, 342, 343, 344, 345, 349, 350, 351, 357, 358, 362, 365, 368, 371, 373, 375, 376, 377, 378, 380, 381, 386, 387, 388, 392, 395, 396, 398, 399, 422, 423, 424, 429, 437, 465, 466, 467, 468, 469, 473, 481, 485, 499, 505, 506, 507, 519, 544, 547, 549, 550, 551, 552, 553, 554, 555, 557, 605, 607, 610, 611, 612, 613, 642, 669, 672, 689, 691, 694, 695, 696], "tutori": [0, 4, 6, 14, 18, 288, 345, 396, 697], "To": [0, 1, 3, 4, 5, 6, 7, 8, 9, 11, 13, 17, 20, 21, 22, 23, 132, 133, 140, 141, 142, 143, 144, 145, 152, 153, 154, 155, 166, 168, 181, 182, 219, 224, 227, 239, 253, 254, 273, 274, 285, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 413, 414, 426, 427, 430, 431, 521, 547, 554, 669, 696, 697], "establish": [0, 227, 287, 344, 366, 395, 696], "authent": [0, 5, 6, 12, 13, 14, 18, 20, 24, 168, 227, 239, 408, 623, 624, 628, 655, 656, 658, 659, 664, 667, 697], "enabl": [0, 5, 6, 7, 8, 11, 12, 17, 19, 22, 119, 124, 125, 131, 168, 171, 239, 282, 296, 408, 517, 521, 557, 625, 657, 669, 671], "page": [0, 21, 313, 314, 317, 696], "much": [0, 5, 17], "like": [0, 1, 3, 4, 5, 8, 9, 11, 12, 13, 19, 20, 241, 253, 258, 289, 312, 317, 328, 365, 368, 378, 387, 411, 418, 457, 473, 474, 558, 559, 561, 630, 631, 669, 696, 697], "simpli": [0, 5, 12, 20, 274, 294, 296, 302, 312, 330, 358, 696], "specifi": [0, 1, 3, 4, 5, 7, 8, 9, 12, 20, 128, 135, 141, 143, 145, 148, 149, 153, 155, 158, 159, 165, 198, 209, 225, 230, 244, 287, 289, 294, 295, 296, 298, 303, 304, 309, 311, 312, 313, 321, 322, 325, 326, 333, 336, 341, 342, 344, 363, 368, 395, 399, 411, 412, 414, 426, 427, 430, 431, 432, 433, 440, 446, 467, 473, 486, 492, 494, 495, 496, 506, 516, 521, 522, 532, 534, 634, 642, 644, 669, 690, 694], "name": [0, 1, 3, 4, 13, 20, 23, 24, 28, 42, 44, 53, 126, 130, 136, 149, 150, 163, 164, 165, 166, 169, 171, 174, 176, 187, 201, 207, 210, 212, 220, 222, 225, 226, 247, 253, 254, 277, 288, 289, 298, 303, 304, 307, 308, 312, 319, 331, 332, 333, 341, 342, 352, 363, 367, 368, 373, 378, 379, 380, 381, 382, 386, 390, 396, 399, 424, 426, 427, 430, 431, 473, 474, 481, 564, 565, 571, 629, 630, 631, 632, 639, 640, 641, 647, 651, 652, 653, 654, 658, 659, 660, 661, 662, 663, 669, 696], "replicaset": [0, 3, 9, 10, 160, 231, 520, 638, 650, 654, 669], "myreplset": [0, 10, 650], "uri": [0, 1, 3, 6, 9, 10, 12, 24, 123, 160, 219, 223, 224, 225, 231, 235, 236, 237, 242, 243, 244, 251, 253, 272, 273, 274, 279, 280, 284, 286, 287, 288, 289, 294, 295, 296, 311, 312, 313, 315, 316, 317, 328, 342, 344, 366, 368, 377, 378, 380, 381, 387, 395, 414, 422, 423, 465, 466, 467, 468, 469, 473, 475, 503, 574, 586, 607, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 683, 696], "includ": [0, 1, 3, 4, 5, 6, 7, 8, 10, 12, 13, 15, 18, 20, 22, 24, 136, 149, 160, 166, 176, 182, 219, 224, 231, 238, 246, 251, 253, 254, 272, 273, 274, 276, 286, 288, 289, 290, 291, 292, 294, 295, 296, 301, 308, 309, 311, 312, 313, 315, 316, 317, 323, 325, 326, 328, 329, 332, 342, 345, 350, 352, 359, 363, 366, 367, 368, 369, 371, 374, 376, 378, 381, 387, 388, 390, 394, 396, 398, 409, 426, 427, 429, 430, 431, 435, 450, 468, 469, 472, 473, 478, 481, 484, 487, 520, 544, 547, 572, 574, 579, 585, 607, 636, 658, 669, 671, 695, 697], "bson": [0, 10, 11, 13, 14, 18, 34, 128, 130, 139, 141, 143, 145, 150, 153, 155, 157, 159, 166, 169, 170, 178, 179, 181, 188, 194, 195, 200, 208, 209, 210, 212, 219, 224, 253, 254, 259, 264, 266, 267, 274, 287, 288, 289, 291, 292, 294, 295, 296, 298, 300, 301, 302, 303, 304, 308, 309, 311, 312, 316, 317, 323, 325, 326, 328, 329, 330, 332, 333, 341, 342, 344, 345, 350, 360, 361, 368, 371, 376, 378, 381, 387, 388, 395, 396, 399, 402, 405, 406, 424, 426, 427, 430, 431, 445, 456, 459, 461, 473, 521, 537, 540, 620, 625, 633, 636, 659, 697], "h": [0, 1, 3, 6, 7, 10, 12, 24, 160, 251, 253, 272, 273, 274, 286, 288, 289, 291, 294, 295, 296, 311, 312, 313, 317, 342, 366, 368, 394, 429, 450, 473, 478, 481, 484, 487, 520, 544, 547, 572, 607, 671, 697], "mongoc": [0, 1, 3, 5, 6, 7, 10, 12, 20, 24, 160, 251, 253, 272, 273, 274, 286, 288, 289, 291, 294, 295, 296, 311, 312, 313, 317, 342, 366, 368, 394, 429, 450, 473, 474, 478, 481, 484, 487, 495, 496, 497, 498, 520, 544, 547, 572, 594, 607, 671, 694, 697], "int": [0, 1, 3, 6, 7, 10, 12, 22, 24, 160, 161, 251, 253, 272, 273, 274, 286, 288, 295, 311, 313, 342, 350, 366, 394, 414, 415, 416, 417, 429, 455, 473, 475, 495, 496, 497, 498, 520, 559, 560, 561, 563, 565, 566, 567, 568, 571, 577, 578, 580, 581, 582, 584, 589, 597, 607, 696], "main": [0, 1, 3, 5, 6, 7, 10, 12, 19, 21, 22, 24, 160, 251, 253, 272, 273, 274, 286, 288, 313, 342, 350, 366, 394, 414, 429, 473, 520, 607, 696], "argc": [0, 3, 10, 12, 22, 24, 251, 253, 272, 273, 274, 286, 288, 350, 366, 394, 429, 473, 607, 696], "char": [0, 1, 3, 6, 7, 10, 12, 22, 23, 24, 28, 42, 44, 53, 126, 160, 163, 164, 165, 166, 169, 170, 171, 174, 185, 187, 189, 199, 201, 207, 212, 213, 220, 221, 222, 223, 224, 226, 235, 247, 251, 253, 254, 272, 273, 274, 277, 286, 288, 291, 307, 308, 312, 313, 317, 319, 327, 331, 332, 342, 350, 366, 367, 373, 379, 380, 381, 382, 386, 390, 394, 398, 399, 408, 409, 410, 411, 412, 413, 414, 418, 426, 427, 429, 430, 431, 440, 441, 444, 451, 457, 458, 460, 467, 472, 473, 474, 475, 481, 484, 487, 502, 505, 520, 533, 535, 545, 564, 574, 582, 606, 607, 623, 624, 626, 628, 629, 630, 631, 632, 634, 638, 639, 640, 641, 643, 645, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 660, 661, 662, 663, 664, 667, 670, 679, 691, 696], "argv": [0, 3, 10, 12, 22, 24, 251, 253, 272, 273, 274, 286, 288, 350, 366, 394, 429, 473, 607, 696], "mongoc_client_t": [0, 1, 2, 3, 4, 6, 7, 8, 9, 10, 12, 13, 14, 17, 18, 21, 24, 120, 124, 125, 147, 160, 163, 164, 165, 166, 167, 168, 181, 182, 206, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 241, 244, 245, 251, 252, 253, 254, 255, 256, 263, 272, 273, 274, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 287, 288, 309, 313, 342, 350, 359, 360, 366, 368, 394, 414, 429, 462, 473, 474, 520, 547, 554, 555, 557, 574, 607, 625, 657, 669, 696], "client": [0, 1, 3, 4, 5, 6, 9, 10, 12, 13, 14, 17, 18, 24, 35, 47, 59, 122, 124, 125, 129, 139, 145, 147, 153, 155, 157, 160, 163, 164, 165, 166, 167, 168, 185, 206, 213, 218, 219, 220, 221, 222, 223, 224, 225, 226, 228, 229, 230, 231, 232, 233, 234, 238, 239, 241, 244, 245, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 262, 265, 272, 273, 274, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 297, 298, 303, 304, 309, 313, 325, 326, 333, 336, 339, 341, 342, 350, 358, 359, 360, 366, 368, 383, 385, 392, 394, 414, 429, 473, 474, 481, 506, 512, 518, 520, 532, 537, 539, 540, 543, 555, 556, 557, 574, 607, 620, 625, 657, 669, 694, 695, 696], "mongoc_init": [0, 1, 3, 5, 6, 7, 10, 12, 14, 19, 21, 22, 24, 160, 162, 251, 253, 272, 273, 274, 286, 288, 313, 350, 366, 394, 414, 429, 473, 474, 520, 607, 696], "creat": [0, 1, 3, 4, 5, 6, 7, 9, 11, 13, 18, 19, 21, 23, 26, 27, 119, 157, 159, 163, 170, 171, 172, 176, 183, 192, 203, 204, 214, 220, 222, 226, 233, 235, 236, 237, 242, 243, 244, 249, 263, 272, 273, 274, 285, 287, 289, 297, 298, 300, 301, 305, 333, 341, 342, 344, 346, 350, 364, 365, 366, 367, 368, 369, 373, 391, 392, 393, 395, 407, 410, 414, 419, 422, 424, 426, 427, 428, 429, 430, 431, 432, 433, 442, 451, 481, 488, 494, 504, 516, 520, 524, 530, 541, 547, 548, 554, 556, 567, 575, 581, 582, 586, 592, 607, 608, 614, 649, 669, 686, 697], "our": [0, 5, 12, 274, 313, 696], "mongoc_client_new": [0, 4, 7, 9, 14, 21, 225, 286, 309, 350, 394, 429, 520, 555, 557, 696], "host01": 0, "27017": [0, 1, 3, 8, 12, 24, 160, 313, 342, 414, 429, 473, 650, 669, 696], "host02": 0, "host03": 0, "do": [0, 6, 12, 13, 17, 24, 167, 249, 251, 278, 281, 288, 345, 367, 396, 474, 486, 620, 669, 694, 696], "some": [0, 8, 12, 13, 17, 19, 21, 22, 24, 162, 273, 285, 317, 359, 360, 365, 399, 411, 414, 473, 485, 486, 494, 495, 547, 554, 650, 661, 669], "work": [0, 20, 24, 123, 578, 583, 593, 596, 597, 696], "todo": 0, "clean": [0, 544, 696], "up": [0, 7, 8, 12, 13, 273, 366, 473, 544, 669, 696], "mongoc_client_destroi": [0, 1, 3, 6, 7, 10, 12, 14, 21, 24, 160, 225, 235, 236, 237, 253, 272, 273, 274, 286, 288, 309, 313, 342, 350, 366, 394, 414, 429, 473, 520, 607, 696], "mongoc_cleanup": [0, 1, 3, 5, 6, 7, 12, 14, 19, 21, 22, 24, 160, 251, 253, 272, 273, 274, 286, 288, 313, 350, 366, 394, 414, 429, 473, 474, 485, 520, 607, 696], "return": [0, 1, 3, 6, 7, 9, 10, 12, 13, 21, 22, 24, 136, 160, 208, 245, 251, 262, 273, 286, 351, 355, 362, 365, 366, 394, 414, 429, 473, 475, 491, 494, 503, 517, 521, 523, 545, 546, 547, 550, 552, 606, 607, 610, 629, 630, 631, 632, 647, 651, 652, 653, 654, 669, 682, 683, 692, 693, 696], "0": [0, 1, 3, 4, 5, 6, 7, 8, 10, 11, 12, 19, 20, 22, 24, 36, 48, 60, 121, 122, 127, 128, 132, 133, 135, 160, 171, 182, 186, 189, 190, 192, 193, 194, 195, 196, 197, 198, 208, 209, 223, 224, 231, 232, 241, 251, 253, 267, 269, 272, 273, 274, 286, 287, 288, 294, 295, 296, 297, 299, 300, 302, 309, 310, 311, 312, 313, 315, 317, 324, 334, 338, 342, 343, 344, 350, 357, 359, 366, 377, 380, 381, 394, 395, 397, 409, 411, 429, 455, 465, 466, 467, 468, 473, 474, 481, 486, 494, 498, 505, 506, 507, 520, 522, 523, 540, 555, 557, 559, 560, 561, 563, 565, 566, 567, 568, 569, 571, 574, 577, 578, 584, 587, 588, 589, 597, 598, 599, 607, 619, 620, 636, 639, 642, 650, 669, 671, 675, 680, 681, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "multipl": [0, 20, 21, 151, 240, 241, 244, 245, 252, 274, 340, 342, 412, 475, 494, 521, 669], "hostnam": [0, 4, 8, 649, 669], "can": [0, 1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 19, 20, 21, 22, 24, 150, 159, 160, 166, 170, 174, 182, 196, 219, 224, 227, 244, 246, 247, 248, 250, 253, 254, 272, 274, 285, 286, 287, 288, 289, 290, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 312, 315, 316, 317, 323, 325, 326, 328, 329, 332, 333, 339, 341, 342, 344, 345, 359, 361, 364, 367, 368, 369, 371, 376, 378, 381, 387, 388, 394, 395, 396, 399, 408, 414, 422, 425, 426, 427, 430, 431, 451, 454, 464, 465, 468, 469, 473, 475, 486, 494, 495, 504, 505, 506, 515, 517, 521, 532, 556, 557, 569, 570, 607, 616, 617, 618, 630, 631, 650, 660, 661, 662, 663, 669, 671, 686, 687, 688, 689, 690, 691, 692, 693, 694, 696, 697], "string": [0, 1, 4, 7, 8, 9, 11, 12, 13, 24, 28, 42, 44, 53, 123, 128, 129, 130, 141, 143, 145, 153, 155, 170, 174, 176, 187, 199, 209, 210, 221, 223, 224, 235, 250, 274, 277, 282, 287, 289, 295, 303, 304, 307, 308, 309, 317, 319, 327, 333, 341, 342, 344, 368, 380, 381, 382, 386, 390, 395, 399, 418, 424, 440, 441, 444, 457, 458, 460, 467, 472, 474, 506, 521, 533, 534, 535, 545, 564, 606, 623, 624, 626, 632, 634, 638, 639, 640, 641, 643, 645, 648, 649, 650, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 679, 691, 696], "comma": [0, 521, 627, 657, 669], "separ": [0, 1, 20, 21, 24, 124, 125, 312, 317, 521, 627, 657, 669], "host": [0, 3, 4, 24, 32, 45, 56, 66, 72, 79, 83, 88, 92, 123, 176, 225, 286, 353, 366, 475, 517, 521, 538, 621, 627, 639, 640, 669, 696], "seed": [0, 495, 497, 498], "list": [0, 4, 5, 8, 13, 20, 23, 32, 45, 56, 66, 72, 79, 83, 88, 92, 166, 174, 219, 223, 224, 231, 253, 254, 287, 288, 289, 292, 295, 311, 316, 317, 328, 329, 344, 345, 368, 371, 373, 378, 381, 387, 388, 395, 396, 429, 447, 448, 449, 450, 465, 469, 473, 475, 506, 521, 531, 532, 627, 669, 697], "recommend": [0, 4, 7, 8, 15, 20, 160, 286, 311], "member": [0, 3, 13, 231, 521, 669], "allow": [0, 3, 6, 7, 8, 11, 15, 149, 160, 296, 363, 473, 487, 494, 495, 506, 521, 531, 532, 558, 594, 597, 620, 669, 694], "driver": [0, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 17, 18, 19, 22, 24, 40, 52, 64, 70, 74, 80, 84, 90, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 111, 114, 117, 123, 129, 136, 149, 162, 227, 248, 250, 251, 256, 265, 277, 278, 282, 284, 285, 312, 317, 337, 352, 354, 359, 360, 363, 393, 399, 411, 414, 442, 473, 474, 485, 495, 521, 532, 534, 537, 540, 544, 594, 602, 603, 605, 630, 631, 658, 664, 667, 669, 671, 694, 696, 697], "ani": [0, 5, 6, 7, 8, 12, 13, 19, 21, 24, 104, 111, 123, 124, 125, 145, 150, 153, 155, 160, 162, 166, 206, 208, 241, 246, 253, 254, 260, 264, 267, 272, 273, 275, 276, 278, 282, 285, 286, 287, 288, 289, 292, 294, 296, 298, 303, 304, 313, 317, 323, 325, 326, 328, 329, 333, 341, 342, 344, 345, 363, 364, 368, 371, 387, 388, 395, 396, 399, 414, 420, 422, 425, 426, 427, 430, 431, 434, 436, 442, 447, 448, 459, 473, 474, 477, 480, 483, 485, 499, 506, 511, 514, 520, 521, 541, 547, 554, 556, 574, 584, 607, 642, 644, 657, 669, 672, 696], "node": [0, 3, 286, 520, 521, 678, 690, 694], "mongo": [0, 1, 4, 10, 11, 13, 17, 20, 231, 253, 269, 288, 494, 544, 545, 603, 669, 696, 697], "should": [0, 1, 7, 8, 9, 10, 13, 19, 20, 21, 28, 32, 34, 36, 39, 41, 42, 44, 45, 48, 51, 53, 56, 58, 60, 63, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 123, 124, 125, 129, 132, 133, 137, 144, 152, 153, 154, 155, 158, 160, 162, 163, 164, 167, 171, 218, 220, 222, 223, 224, 225, 226, 228, 229, 232, 233, 234, 235, 236, 237, 238, 241, 242, 243, 255, 263, 274, 275, 283, 285, 286, 289, 290, 291, 293, 294, 295, 296, 297, 298, 299, 300, 302, 310, 311, 312, 313, 315, 316, 317, 318, 319, 320, 321, 322, 324, 327, 330, 334, 338, 341, 342, 343, 346, 347, 357, 359, 368, 369, 372, 377, 378, 379, 380, 381, 382, 383, 384, 385, 397, 407, 408, 424, 429, 432, 433, 438, 440, 441, 442, 444, 445, 449, 457, 462, 465, 469, 470, 471, 473, 474, 477, 480, 481, 483, 485, 487, 500, 504, 507, 509, 511, 514, 516, 521, 535, 540, 542, 558, 561, 562, 564, 565, 567, 573, 575, 576, 580, 581, 582, 592, 593, 604, 620, 621, 623, 624, 625, 626, 627, 628, 633, 634, 635, 636, 637, 638, 639, 642, 643, 644, 645, 646, 649, 669, 670, 673, 675, 676, 678, 679, 680, 681, 686, 687, 690, 692, 693, 696], "c": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 17, 18, 19, 22, 23, 24, 149, 160, 162, 227, 248, 250, 251, 253, 256, 272, 273, 274, 278, 282, 286, 288, 312, 313, 317, 342, 359, 360, 363, 366, 378, 399, 408, 409, 410, 411, 412, 413, 414, 429, 442, 473, 474, 485, 487, 495, 607, 669, 671, 697], "automat": [0, 8, 10, 11, 17, 20, 21, 120, 121, 123, 124, 125, 129, 131, 160, 168, 170, 181, 182, 220, 222, 227, 239, 256, 272, 312, 426, 430, 557, 694], "detect": [0, 13, 20, 481], "ha": [0, 1, 3, 8, 9, 10, 13, 21, 124, 125, 149, 157, 158, 171, 179, 200, 201, 227, 231, 244, 253, 258, 259, 264, 265, 267, 271, 273, 274, 277, 285, 289, 294, 296, 328, 334, 342, 347, 348, 349, 350, 354, 358, 359, 363, 364, 368, 387, 437, 448, 491, 498, 503, 505, 506, 511, 523, 535, 547, 554, 561, 563, 574, 590, 595, 602, 603, 619, 633, 634, 636, 637, 645, 646, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 679, 683, 687, 688, 689, 690, 691, 692, 693, 694, 696], "If": [0, 4, 5, 9, 10, 11, 12, 17, 20, 21, 22, 34, 120, 123, 145, 153, 155, 157, 159, 163, 171, 175, 186, 199, 213, 219, 221, 223, 224, 227, 230, 244, 246, 247, 251, 253, 256, 260, 261, 262, 264, 267, 274, 275, 276, 278, 283, 285, 287, 289, 294, 295, 296, 297, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 325, 326, 328, 330, 331, 332, 333, 334, 340, 341, 342, 344, 348, 350, 362, 363, 364, 368, 373, 376, 377, 378, 380, 381, 386, 387, 395, 399, 408, 422, 423, 454, 459, 465, 466, 467, 468, 469, 474, 493, 499, 502, 520, 523, 553, 555, 557, 569, 570, 587, 594, 598, 620, 628, 629, 630, 631, 632, 669, 670, 672, 677, 682, 689, 690, 696, 697], "more": [0, 4, 5, 7, 9, 10, 11, 22, 122, 129, 152, 153, 154, 155, 160, 213, 289, 294, 296, 306, 307, 312, 317, 331, 333, 341, 342, 343, 358, 359, 360, 366, 368, 375, 410, 474, 506, 519, 558, 590, 620, 657, 669, 689, 691, 694, 695, 696], "than": [0, 1, 4, 7, 9, 12, 13, 20, 122, 129, 160, 161, 258, 259, 277, 308, 317, 327, 474, 494, 495, 506, 512, 518, 572, 620, 669, 696], "one": [0, 1, 5, 6, 9, 11, 13, 17, 20, 21, 128, 160, 171, 182, 209, 227, 238, 244, 251, 252, 253, 273, 285, 286, 288, 296, 303, 304, 326, 327, 333, 341, 342, 362, 410, 428, 454, 455, 462, 464, 486, 521, 545, 547, 554, 556, 606, 657, 669, 696], "attempt": [0, 4, 6, 8, 13, 20, 123, 160, 227, 249, 274, 275, 281, 297, 298, 325, 350, 369, 376, 555, 557, 669, 694], "failov": [0, 219, 223, 224, 253, 272, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 607, 669], "between": [0, 4, 350, 558, 559, 561, 572, 669], "instanc": [0, 1, 12, 24, 226, 228, 229, 234, 274, 429, 436, 470, 471, 473, 520, 635, 637, 646, 669, 696], "paramet": [0, 13, 544, 605, 669], "when": [0, 4, 5, 6, 7, 8, 9, 10, 13, 15, 20, 21, 22, 27, 40, 52, 64, 70, 74, 80, 84, 90, 94, 111, 114, 117, 123, 127, 149, 157, 159, 163, 171, 176, 186, 189, 190, 194, 195, 196, 197, 208, 213, 220, 222, 225, 227, 235, 236, 237, 242, 243, 244, 254, 255, 256, 272, 274, 282, 285, 286, 287, 289, 290, 291, 293, 295, 297, 298, 312, 315, 316, 317, 329, 333, 341, 342, 344, 346, 352, 354, 359, 360, 363, 368, 369, 372, 377, 378, 388, 395, 407, 408, 415, 416, 417, 433, 449, 451, 465, 467, 468, 469, 472, 474, 475, 487, 494, 500, 504, 506, 521, 524, 541, 542, 544, 556, 562, 565, 567, 570, 575, 581, 582, 587, 592, 604, 607, 620, 630, 649, 662, 669, 673, 686, 689, 694, 695, 696, 697], "invalid": [0, 4, 8, 13, 24, 125, 139, 141, 143, 145, 153, 155, 164, 165, 166, 232, 246, 248, 253, 254, 255, 257, 260, 261, 272, 276, 278, 287, 288, 291, 292, 300, 301, 302, 303, 304, 308, 309, 313, 314, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 350, 363, 364, 367, 370, 371, 376, 386, 387, 388, 389, 390, 395, 396, 399, 435, 453, 459, 472, 499, 523, 579, 621, 628, 629, 630, 631, 632, 670, 672, 684], "myshard01": 0, "someth": [0, 3, 12, 20, 24, 251, 418, 457, 474, 696], "free": [0, 21, 25, 26, 134, 167, 170, 172, 178, 180, 181, 182, 183, 192, 204, 214, 226, 238, 262, 273, 285, 348, 374, 400, 429, 447, 466, 467, 468, 473, 501, 510, 526, 530, 536, 538, 546, 547, 549, 554, 579, 600, 609, 622, 674], "resolv": [0, 123, 350, 669], "howev": [0, 6, 10, 227, 274, 312, 521, 669, 694, 696], "directli": [0, 4, 9, 20, 21, 231, 232, 312, 343, 399, 495, 572, 669], "wrap": [0, 149, 171, 227, 256, 265, 286, 301, 359, 360, 363, 366, 473, 474, 585, 589, 594], "mongoc_uri_t": [0, 1, 2, 3, 4, 6, 8, 9, 10, 12, 14, 18, 24, 160, 219, 223, 224, 233, 236, 237, 242, 243, 251, 253, 272, 273, 274, 286, 287, 288, 289, 294, 295, 296, 311, 312, 313, 315, 316, 317, 328, 342, 344, 366, 368, 377, 378, 380, 381, 387, 395, 414, 422, 423, 465, 466, 467, 468, 469, 473, 607, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 696], "mongoc_uri_new": [0, 4, 8, 9, 14, 625, 628, 657, 659, 669], "1": [0, 1, 3, 5, 6, 7, 8, 10, 11, 12, 13, 18, 20, 23, 24, 36, 37, 48, 49, 60, 61, 121, 122, 127, 160, 171, 182, 186, 189, 190, 192, 193, 194, 195, 196, 197, 198, 208, 223, 231, 232, 241, 251, 253, 254, 272, 273, 274, 286, 288, 291, 294, 295, 296, 297, 299, 300, 302, 310, 311, 312, 313, 315, 317, 324, 329, 334, 338, 342, 343, 350, 357, 359, 360, 366, 377, 380, 388, 397, 399, 408, 409, 410, 411, 412, 413, 414, 418, 429, 452, 455, 464, 465, 466, 473, 474, 475, 481, 486, 494, 498, 505, 507, 520, 521, 522, 523, 534, 540, 555, 559, 560, 561, 565, 566, 568, 569, 570, 571, 574, 577, 578, 584, 587, 588, 589, 597, 598, 599, 607, 619, 620, 636, 639, 642, 650, 655, 669, 671, 675, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "both": [0, 9, 17, 20, 182, 227, 254, 317, 329, 388, 473, 555, 557, 662, 669], "dn": [0, 13, 669], "record": [0, 312, 366, 669], "behavior": [0, 7, 8, 9, 12, 13, 123, 130, 160, 210, 219, 223, 224, 241, 253, 287, 289, 294, 295, 296, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 669], "rfc": [0, 4, 8, 669], "6555": [0, 669], "A": [0, 4, 6, 9, 12, 13, 17, 18, 20, 21, 24, 26, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 67, 68, 69, 71, 72, 73, 75, 76, 77, 78, 79, 81, 82, 83, 85, 86, 87, 88, 89, 91, 92, 93, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 112, 113, 115, 116, 119, 120, 121, 122, 123, 124, 125, 126, 128, 129, 130, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 157, 158, 159, 160, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 192, 193, 194, 195, 196, 197, 199, 200, 201, 202, 203, 204, 205, 206, 209, 210, 212, 213, 214, 215, 216, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 395, 396, 398, 399, 400, 401, 402, 403, 404, 405, 406, 408, 409, 410, 411, 412, 413, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 477, 480, 483, 488, 489, 490, 491, 492, 493, 496, 497, 499, 500, 501, 502, 503, 505, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 524, 525, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 545, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 575, 577, 578, 579, 580, 581, 584, 585, 586, 587, 588, 589, 590, 591, 592, 595, 597, 598, 599, 600, 601, 602, 603, 604, 606, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 687, 688, 689, 690, 691, 692, 693, 696], "first": [0, 1, 3, 6, 9, 12, 20, 21, 24, 123, 135, 160, 164, 166, 219, 220, 222, 224, 246, 247, 248, 250, 253, 254, 288, 289, 291, 292, 295, 296, 297, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 365, 366, 368, 370, 371, 376, 378, 381, 387, 388, 396, 399, 412, 466, 467, 468, 474, 506, 521, 522, 556, 557, 607, 620, 669, 696], "fail": [0, 1, 3, 5, 6, 7, 10, 12, 13, 17, 20, 23, 24, 27, 34, 40, 80, 95, 100, 123, 135, 136, 160, 224, 249, 251, 253, 272, 273, 274, 281, 285, 286, 288, 294, 295, 296, 311, 313, 324, 342, 350, 366, 381, 389, 398, 414, 473, 481, 486, 520, 523, 555, 557, 561, 607, 669, 690, 696], "doe": [0, 4, 5, 7, 13, 15, 19, 20, 25, 122, 129, 134, 152, 153, 154, 155, 160, 162, 164, 165, 167, 169, 172, 180, 183, 192, 200, 201, 204, 212, 214, 219, 223, 224, 241, 253, 262, 274, 285, 287, 289, 291, 293, 294, 295, 296, 305, 309, 311, 312, 315, 316, 317, 325, 328, 344, 348, 358, 368, 370, 374, 377, 378, 380, 381, 387, 395, 399, 400, 409, 412, 413, 421, 422, 423, 434, 436, 447, 465, 466, 467, 468, 469, 473, 485, 501, 510, 526, 536, 549, 555, 562, 579, 586, 600, 602, 603, 609, 622, 636, 669, 674, 689, 694], "complet": [0, 9, 10, 13, 20, 22, 90, 97, 102, 272, 274, 283, 358, 359, 426, 427, 669], "within": [0, 9, 13, 20, 21, 171, 273, 274, 275, 285, 366, 386, 463, 477, 480, 483, 492, 547, 554, 669], "250m": [0, 669], "tri": [0, 13, 291, 669], "parallel": [0, 6, 517, 521, 669], "whichev": [0, 669], "succe": [0, 5, 6, 13, 27, 272, 313, 386, 607, 669], "cancel": [0, 517, 521, 669], "other": [0, 4, 7, 12, 13, 19, 20, 21, 24, 123, 129, 162, 238, 258, 259, 272, 277, 288, 295, 297, 298, 312, 317, 323, 325, 326, 327, 345, 350, 367, 390, 396, 442, 474, 485, 495, 506, 521, 594, 607, 628, 659, 669, 682, 694, 696], "success": [0, 3, 5, 11, 135, 136, 139, 141, 143, 145, 153, 155, 164, 165, 166, 168, 169, 170, 171, 178, 179, 181, 182, 200, 201, 202, 203, 208, 212, 213, 215, 226, 232, 239, 246, 253, 254, 260, 272, 275, 276, 278, 285, 288, 291, 292, 300, 301, 302, 303, 304, 308, 313, 314, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 345, 363, 364, 370, 371, 373, 376, 387, 388, 389, 390, 396, 399, 408, 409, 410, 411, 412, 413, 414, 419, 435, 453, 454, 455, 459, 467, 468, 472, 499, 533, 558, 559, 560, 561, 565, 566, 567, 568, 570, 571, 575, 577, 578, 584, 586, 587, 588, 589, 597, 598, 599, 607, 648, 650, 669, 672, 675, 676, 678, 687, 688, 690, 691, 696], "result": [0, 1, 4, 6, 7, 8, 10, 12, 33, 46, 57, 129, 159, 160, 164, 166, 168, 178, 179, 181, 182, 200, 201, 202, 213, 214, 215, 217, 219, 223, 224, 228, 229, 232, 234, 239, 253, 254, 274, 287, 288, 289, 290, 291, 292, 297, 298, 303, 304, 312, 313, 314, 315, 316, 317, 318, 325, 326, 328, 329, 333, 338, 341, 342, 344, 345, 346, 354, 358, 362, 364, 365, 366, 368, 369, 370, 371, 377, 378, 387, 388, 395, 396, 410, 455, 465, 466, 467, 468, 469, 474, 494, 517, 521, 555, 556, 557, 565, 567, 607, 648, 650, 669, 695, 696], "cach": [0, 4, 20, 158, 160, 669], "10": [0, 6, 9, 12, 20, 24, 232, 251, 317, 338, 343, 357, 494, 650, 669, 696], "minut": [0, 9, 21, 273, 285, 494, 547, 554, 669], "As": [0, 9, 294, 296, 302, 313, 330, 414, 574, 669], "consequ": [0, 669], "mongod": [0, 1, 3, 4, 12, 24, 520, 544, 669], "listen": [0, 160, 287, 344, 395, 566, 669], "delai": [0, 669], "ar": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 17, 20, 21, 22, 122, 123, 127, 128, 129, 130, 132, 133, 135, 138, 139, 140, 141, 142, 143, 144, 145, 148, 152, 153, 155, 160, 163, 164, 165, 166, 168, 185, 189, 208, 209, 210, 220, 222, 223, 224, 226, 232, 239, 241, 244, 246, 250, 251, 253, 254, 255, 257, 258, 259, 260, 261, 267, 272, 273, 276, 278, 285, 287, 288, 289, 291, 292, 294, 295, 296, 297, 298, 300, 301, 302, 303, 304, 308, 309, 310, 311, 312, 313, 314, 315, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 339, 340, 341, 342, 343, 344, 345, 349, 350, 358, 359, 360, 361, 363, 364, 366, 367, 368, 369, 370, 371, 373, 376, 377, 380, 381, 386, 387, 388, 389, 390, 394, 395, 396, 397, 399, 429, 435, 437, 448, 453, 459, 466, 467, 468, 472, 473, 474, 475, 486, 487, 494, 499, 517, 521, 522, 525, 547, 554, 555, 557, 562, 572, 586, 594, 602, 620, 657, 669, 671, 672, 682, 689, 691, 694, 695, 696, 697], "aaaa": [0, 669], "associ": [0, 4, 148, 156, 167, 180, 238, 262, 266, 283, 287, 305, 309, 344, 348, 374, 395, 400, 434, 435, 436, 437, 438, 447, 461, 501, 510, 536, 562, 579, 600, 622, 669, 674], "avoid": [0, 20, 21, 273, 285, 311, 547, 554, 580, 669], "match": [0, 1, 13, 20, 145, 153, 155, 182, 194, 195, 196, 197, 198, 213, 241, 289, 295, 301, 302, 303, 304, 311, 313, 327, 330, 331, 332, 333, 340, 341, 342, 350, 358, 410, 465, 466, 467, 468, 469, 472, 520, 521, 522, 523, 602, 620, 669, 696], "That": [0, 8, 473, 669], "On": [0, 4, 5, 19, 20, 135, 160, 168, 226, 235, 236, 237, 242, 243, 249, 281, 285, 313, 314, 350, 359, 360, 455, 533, 560, 669, 696], "system": [0, 3, 8, 20, 22, 123, 473, 474, 495, 561, 568, 569, 570, 594, 697], "pass": [0, 3, 4, 6, 12, 13, 24, 27, 29, 43, 54, 65, 71, 76, 82, 86, 91, 107, 112, 115, 123, 127, 128, 135, 139, 141, 143, 145, 153, 155, 158, 160, 172, 183, 192, 204, 208, 209, 214, 227, 246, 256, 272, 273, 274, 275, 276, 283, 289, 294, 296, 301, 302, 303, 304, 306, 307, 317, 325, 326, 330, 331, 338, 341, 342, 359, 364, 375, 413, 421, 474, 499, 556, 582, 586, 589, 597, 607, 650, 657, 669, 672, 696], "url": [0, 4], "encod": [0, 4, 128, 209, 458, 467, 472, 670], "path": [0, 4, 8, 11, 15, 17, 20, 123, 582, 669, 697], "which": [0, 3, 6, 7, 8, 11, 12, 13, 19, 20, 24, 39, 51, 63, 119, 124, 125, 129, 135, 141, 142, 143, 144, 145, 149, 152, 153, 154, 155, 158, 160, 162, 163, 165, 167, 168, 171, 208, 225, 226, 227, 239, 240, 241, 250, 251, 263, 268, 274, 282, 287, 289, 300, 317, 319, 324, 341, 342, 343, 344, 350, 360, 363, 366, 368, 369, 382, 395, 409, 412, 422, 430, 431, 440, 441, 468, 469, 473, 474, 485, 492, 521, 532, 534, 538, 555, 556, 568, 607, 623, 624, 625, 626, 633, 634, 638, 643, 645, 669, 679, 689, 697], "must": [0, 1, 4, 6, 7, 8, 9, 11, 12, 13, 19, 21, 24, 26, 119, 124, 125, 128, 135, 147, 151, 152, 153, 154, 155, 162, 166, 169, 170, 171, 173, 174, 178, 179, 181, 182, 184, 193, 194, 195, 196, 197, 198, 199, 200, 201, 203, 205, 206, 208, 209, 212, 213, 215, 216, 218, 221, 226, 227, 230, 231, 238, 244, 246, 247, 248, 250, 251, 253, 254, 256, 261, 272, 273, 285, 287, 288, 289, 290, 292, 295, 297, 300, 303, 304, 312, 313, 314, 315, 316, 317, 318, 323, 325, 326, 328, 329, 333, 338, 341, 342, 343, 344, 345, 359, 360, 361, 368, 369, 371, 377, 378, 387, 388, 395, 396, 408, 423, 424, 429, 452, 466, 467, 468, 474, 485, 521, 524, 530, 538, 544, 547, 548, 553, 554, 586, 601, 605, 608, 614, 628, 669, 687, 688, 690, 691, 696, 697], "suffix": [0, 424], "sock": [0, 558, 559, 561, 562, 563, 564, 565, 566, 568, 569, 570, 571, 650], "tmp": [0, 4, 24], "2ftmp": [0, 650], "2fmongodb": [0, 650], "usernam": [0, 4, 12, 24, 367, 390, 645, 664, 667, 669], "password": [0, 4, 8, 12, 24, 367, 628, 634, 659, 664, 667, 669], "so": [0, 4, 6, 7, 8, 9, 12, 20, 136, 159, 249, 250, 274, 281, 282, 312, 332, 339, 474, 486, 521, 586, 628, 630, 631, 651, 652, 653, 654, 669, 696], "user": [0, 4, 6, 7, 12, 15, 20, 24, 127, 160, 168, 208, 239, 274, 275, 283, 289, 290, 296, 312, 315, 316, 317, 367, 368, 369, 377, 378, 389, 390, 408, 412, 414, 495, 504, 584, 628, 650, 659, 669, 686, 696], "These": [0, 1, 6, 13, 397, 474, 486, 494, 522, 523, 619, 620, 669, 694], "instruct": [0, 12, 17, 20, 168, 239, 410, 696, 697], "ssl": [0, 19, 162, 250, 282, 485, 573, 574], "run": [0, 4, 6, 10, 20, 163, 164, 165, 166, 232, 253, 254, 274, 275, 283, 287, 288, 300, 338, 343, 344, 350, 368, 395, 396, 495, 517, 521, 532, 537, 540, 669, 696, 697], "local": [0, 4, 6, 8, 10, 11, 12, 20, 24, 128, 170, 176, 209, 253, 288, 296, 317, 323, 325, 326, 358, 429, 506, 515, 564, 696], "port": [0, 3, 12, 24, 176, 475, 538, 649, 669, 696], "tlsmode": [0, 4], "requiretl": [0, 4], "tlscertificatekeyfil": [0, 4, 8, 130, 210, 669], "pem": [0, 4, 8, 130, 210, 669], "tlscafil": [0, 4, 8, 130, 210, 669], "ca": [0, 1, 4], "add": [0, 3, 6, 11, 12, 13, 94, 103, 166, 169, 219, 224, 253, 254, 272, 273, 274, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 408, 409, 410, 411, 412, 413, 414, 424, 508, 561, 607, 696, 697], "true": [0, 3, 4, 6, 7, 8, 10, 11, 12, 24, 120, 121, 123, 139, 141, 143, 144, 145, 152, 153, 154, 155, 159, 160, 161, 164, 165, 166, 168, 169, 170, 178, 179, 181, 182, 200, 201, 208, 212, 213, 232, 239, 246, 247, 248, 249, 251, 253, 254, 256, 257, 260, 261, 271, 272, 274, 275, 276, 277, 278, 281, 287, 288, 289, 291, 292, 297, 300, 301, 302, 303, 304, 308, 309, 312, 313, 314, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 349, 350, 358, 361, 363, 364, 367, 368, 370, 371, 376, 386, 387, 388, 389, 390, 395, 396, 398, 399, 401, 408, 409, 410, 411, 412, 413, 414, 419, 420, 422, 428, 430, 431, 435, 437, 448, 453, 454, 459, 472, 474, 490, 491, 499, 503, 505, 515, 517, 521, 533, 550, 552, 555, 557, 574, 590, 595, 602, 603, 628, 642, 644, 647, 650, 651, 652, 653, 654, 659, 660, 661, 662, 663, 669, 672, 675, 676, 678, 682, 683, 696], "end": [0, 5, 8, 19, 160, 162, 262, 430, 431, 433, 455, 485, 587, 669, 696], "null": [0, 1, 3, 6, 7, 10, 11, 12, 13, 22, 23, 24, 25, 39, 51, 63, 127, 134, 135, 139, 141, 143, 145, 153, 155, 157, 158, 160, 164, 165, 166, 167, 170, 171, 172, 180, 183, 192, 199, 202, 203, 204, 208, 213, 214, 215, 219, 221, 223, 224, 225, 226, 227, 230, 231, 232, 235, 236, 237, 242, 243, 244, 251, 252, 253, 254, 256, 257, 260, 261, 262, 264, 272, 273, 274, 275, 276, 285, 286, 287, 288, 289, 290, 291, 292, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 347, 348, 349, 350, 360, 366, 367, 368, 369, 370, 371, 373, 374, 375, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 395, 396, 399, 400, 408, 409, 410, 411, 412, 413, 414, 420, 421, 422, 424, 425, 426, 427, 429, 430, 431, 433, 434, 435, 436, 437, 447, 448, 453, 466, 467, 468, 469, 472, 501, 502, 506, 510, 520, 526, 535, 536, 542, 549, 553, 555, 556, 557, 558, 562, 567, 575, 579, 581, 582, 585, 586, 600, 602, 604, 607, 609, 621, 622, 623, 624, 626, 627, 628, 633, 634, 635, 636, 637, 638, 639, 640, 645, 646, 648, 650, 657, 670, 674, 679, 682, 696], "localhost": [0, 1, 3, 4, 6, 7, 8, 12, 24, 123, 160, 342, 350, 394, 414, 429, 473, 520, 625, 628, 630, 631, 650, 657, 659, 669, 696], "requir": [0, 4, 7, 8, 11, 12, 17, 20, 24, 33, 46, 57, 119, 141, 143, 145, 153, 155, 161, 166, 168, 171, 176, 182, 197, 227, 239, 250, 253, 254, 274, 282, 287, 288, 289, 292, 295, 296, 298, 301, 303, 304, 308, 309, 311, 313, 325, 326, 328, 329, 333, 341, 342, 344, 345, 362, 366, 368, 371, 376, 387, 388, 395, 396, 399, 424, 474, 495, 669, 695, 696, 697], "certif": [0, 18, 669], "default": [0, 4, 5, 6, 8, 13, 19, 20, 21, 22, 123, 128, 159, 176, 186, 209, 225, 226, 228, 229, 234, 241, 244, 272, 273, 274, 279, 280, 283, 284, 285, 286, 287, 290, 297, 312, 317, 320, 321, 322, 334, 335, 336, 337, 340, 344, 350, 366, 383, 384, 385, 391, 392, 393, 395, 410, 411, 424, 474, 476, 477, 479, 480, 482, 483, 503, 506, 507, 512, 521, 547, 550, 551, 552, 554, 555, 556, 557, 573, 587, 588, 594, 598, 599, 602, 607, 620, 629, 630, 631, 632, 641, 659, 669, 682, 683, 685, 694, 696], "unless": [0, 8, 12, 24, 135, 289, 335, 368, 391, 574], "tlsallowconnectionswithoutcertif": 0, "provid": [0, 1, 4, 5, 6, 8, 12, 13, 15, 20, 22, 24, 122, 127, 128, 129, 130, 139, 145, 151, 153, 155, 165, 170, 171, 175, 176, 208, 209, 210, 213, 218, 235, 236, 237, 242, 243, 272, 274, 275, 286, 287, 289, 300, 301, 302, 303, 304, 308, 309, 325, 326, 330, 332, 333, 339, 341, 342, 344, 359, 366, 368, 373, 376, 394, 395, 429, 450, 462, 473, 475, 495, 521, 523, 532, 559, 561, 572, 581, 592, 594, 623, 624, 625, 626, 633, 635, 638, 645, 646, 649, 669, 696, 697], "present": [0, 4, 8, 20, 641, 647], "referenc": [0, 20, 434], "through": [0, 4, 8, 12, 15, 20, 124, 125, 249, 250, 282, 283, 296, 314, 365, 367, 370, 411, 487, 696], "constant": [0, 8, 12, 150, 289, 298, 303, 304, 333, 341, 342, 368, 399, 619, 669], "mongoc_uri_tlscertificatekeyfil": [0, 8, 130, 210, 669], "mongoc_uri_set_option_as_utf8": [0, 8, 14, 669], "mongoc_client_new_from_uri": [0, 1, 3, 6, 8, 10, 12, 14, 21, 24, 160, 235, 253, 272, 273, 274, 286, 288, 313, 342, 366, 414, 473, 607, 657, 696], "issu": [0, 4, 5, 8, 255, 669, 696], "trust": [0, 8, 669], "author": [0, 8, 389, 390, 412, 413, 414, 669], "nativ": [0, 4, 18], "store": [0, 4, 7, 8, 160, 165, 232, 295, 300, 311, 338, 370, 474, 492, 565, 696], "omit": [0, 159, 254, 288, 289, 317, 329, 345, 388, 396, 574], "variou": [0, 22, 166, 253, 254, 288, 289, 292, 297, 298, 317, 328, 329, 345, 368, 371, 387, 388, 396, 451, 487, 572, 671], "relat": [0, 3, 13, 19, 208, 473, 499, 672, 695], "3": [0, 1, 3, 4, 6, 11, 12, 20, 22, 24, 141, 143, 145, 153, 155, 166, 253, 254, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 312, 313, 317, 328, 329, 333, 341, 342, 345, 365, 368, 371, 376, 387, 388, 396, 408, 414, 418, 424, 429, 473, 481, 494, 506, 507, 520, 521, 523, 619, 669, 696], "4": [0, 3, 4, 6, 7, 12, 13, 20, 22, 24, 36, 37, 48, 49, 60, 61, 148, 160, 253, 254, 287, 288, 289, 295, 298, 303, 304, 311, 317, 325, 326, 329, 333, 341, 342, 344, 345, 368, 388, 395, 396, 399, 429, 473, 475, 481, 494, 506, 517, 521, 574, 619, 669, 675, 687], "ad": [0, 10, 11, 20, 148, 150, 151, 323, 325, 326, 367, 408, 409, 410, 411, 412, 413, 429, 697], "snappi": [0, 625, 657, 669], "support": [0, 4, 5, 6, 7, 13, 15, 17, 18, 128, 130, 141, 143, 145, 148, 153, 155, 168, 189, 198, 209, 210, 239, 285, 287, 289, 290, 295, 301, 303, 304, 317, 333, 341, 342, 343, 344, 368, 395, 399, 411, 414, 423, 473, 521, 669, 695], "zlib": [0, 625, 657, 669], "6": [0, 20, 24, 178, 181, 287, 295, 344, 395, 410, 414, 429, 494, 506, 574, 669, 695, 696], "zstd": [0, 625, 657, 669], "2": [0, 1, 3, 6, 7, 10, 11, 12, 13, 19, 20, 24, 36, 37, 48, 49, 60, 61, 141, 143, 145, 153, 155, 160, 166, 251, 253, 254, 272, 273, 274, 286, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 312, 313, 317, 328, 329, 333, 341, 342, 345, 350, 365, 366, 368, 371, 376, 387, 388, 396, 399, 408, 411, 414, 418, 424, 429, 455, 473, 494, 506, 507, 520, 523, 555, 574, 607, 619, 636, 669, 696], "compressor": [0, 625, 657, 669], "prioriti": [0, 166, 253, 254, 288, 289, 292, 317, 328, 329, 345, 368, 371, 387, 388, 396], "order": [0, 1, 3, 4, 21, 135, 141, 143, 145, 153, 155, 166, 253, 254, 288, 289, 292, 295, 296, 297, 298, 301, 303, 304, 308, 309, 311, 312, 313, 317, 325, 328, 329, 333, 341, 342, 345, 368, 371, 376, 387, 388, 396, 412, 468, 469, 487, 521, 555, 696], "want": [0, 5, 12, 225, 251, 293, 302, 330, 372, 494, 671, 696, 697], "messag": [0, 1, 3, 5, 6, 7, 10, 11, 12, 13, 22, 23, 24, 35, 47, 59, 148, 160, 168, 224, 231, 239, 248, 251, 253, 272, 273, 274, 286, 287, 288, 289, 291, 294, 295, 296, 298, 303, 304, 309, 311, 312, 313, 317, 325, 326, 333, 341, 342, 344, 350, 366, 368, 378, 381, 395, 399, 408, 409, 410, 411, 412, 413, 414, 429, 433, 473, 520, 555, 557, 607, 669, 696], "share": [0, 5, 7, 9, 17, 20, 123, 669, 696], "common": [0, 8, 12, 14, 16, 18, 366, 696], "note": [0, 1, 4, 6, 8, 12, 19, 20, 22, 162, 181, 186, 189, 247, 359, 365, 368, 411, 413, 414, 433, 485, 521, 586, 636], "might": [0, 4, 12, 13, 208, 358], "same": [0, 1, 4, 7, 13, 17, 20, 136, 147, 158, 208, 218, 250, 287, 294, 296, 344, 360, 395, 413, 429, 473, 495, 521, 557, 560, 669, 690, 692, 693], "send": [0, 6, 7, 13, 24, 80, 100, 129, 166, 176, 253, 254, 255, 288, 289, 292, 328, 329, 345, 368, 371, 387, 388, 396, 474, 569, 570, 669], "possibl": [0, 5, 6, 8, 10, 15, 20, 158, 291, 365, 411, 428, 694], "still": [0, 227, 300, 408, 414, 521, 630, 631, 669, 695], "repli": [0, 3, 5, 6, 7, 12, 13, 23, 24, 34, 58, 89, 135, 157, 160, 164, 165, 166, 179, 232, 253, 254, 261, 272, 273, 274, 275, 288, 289, 290, 291, 292, 295, 300, 301, 303, 304, 311, 312, 313, 314, 315, 316, 317, 325, 326, 328, 329, 333, 338, 341, 342, 343, 345, 350, 359, 360, 368, 369, 370, 371, 378, 387, 388, 396, 398, 399, 408, 409, 410, 411, 412, 413, 414, 494, 523, 555, 607, 696], "depend": [0, 3, 7, 17, 18, 20, 21, 495, 669, 697], "how": [0, 1, 5, 6, 7, 10, 12, 13, 20, 24, 248, 253, 272, 278, 288, 295, 311, 312, 486, 494, 507, 521, 669, 690, 696, 697], "wa": [0, 1, 6, 7, 9, 10, 13, 20, 21, 34, 94, 103, 135, 157, 159, 199, 208, 215, 221, 227, 244, 247, 248, 249, 250, 254, 257, 261, 263, 268, 271, 272, 274, 281, 282, 309, 311, 329, 350, 361, 366, 367, 388, 401, 402, 414, 415, 416, 417, 490, 492, 493, 505, 523, 527, 528, 541, 563, 568, 574, 619, 623, 638, 642, 644, 647, 685], "built": [0, 5, 13, 15, 20, 168, 239, 285, 594, 669], "unknown": [0, 3, 13, 350, 366, 473, 545, 606], "compil": [0, 4, 5, 8, 10, 12, 20, 22, 24, 250, 282, 415, 416, 417, 474, 671, 696], "valu": [0, 1, 4, 7, 8, 11, 12, 22, 122, 129, 136, 158, 166, 169, 171, 178, 181, 185, 186, 189, 194, 195, 196, 197, 198, 200, 208, 212, 219, 224, 244, 249, 253, 254, 274, 281, 287, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 328, 329, 332, 344, 345, 355, 356, 368, 371, 376, 378, 381, 387, 388, 395, 396, 399, 404, 408, 409, 410, 412, 413, 414, 415, 416, 417, 430, 431, 473, 474, 475, 477, 480, 481, 483, 488, 489, 490, 491, 492, 493, 517, 521, 527, 528, 534, 553, 555, 571, 574, 586, 588, 599, 629, 630, 631, 632, 641, 655, 656, 657, 658, 660, 661, 662, 663, 669, 677, 680, 681, 689, 690, 692, 693, 694, 696], "ignor": [0, 8, 254, 257, 294, 295, 296, 309, 311, 317, 329, 388, 408, 481, 521, 574, 586, 602, 669, 694], "build": [0, 1, 4, 8, 17, 18, 24, 149, 227, 253, 256, 288, 289, 313, 359, 360, 363, 368, 481, 669, 697], "cmake": [0, 4, 5, 8, 17, 19, 20, 697], "12": [0, 696], "higher": [0, 18, 227, 256, 359, 360, 695], "full": [0, 23, 313, 314, 343, 422, 494, 669], "found": [0, 5, 12, 13, 160, 256, 309, 317, 323, 326, 350, 378, 466, 467, 468, 523, 696], "doc": [0, 1, 3, 6, 10, 12, 20, 24, 160, 272, 273, 274, 286, 312, 317, 350, 366, 378, 429, 520, 555, 607, 696], "descript": [0, 8, 20, 67, 68, 108, 109, 130, 210, 231, 237, 243, 280, 392, 506, 544, 546, 601], "so_keepal": 0, "tcp": [0, 283], "keep": [0, 5, 7, 20, 241, 561], "aliv": 0, "tcp_keepidl": 0, "long": [0, 247, 399, 411, 414, 669, 690], "need": [0, 4, 6, 9, 20, 21, 127, 159, 171, 208, 220, 222, 274, 287, 312, 344, 395, 456, 457, 458, 460, 461, 574, 590, 669, 690, 696], "remain": [0, 1, 10, 246, 250, 276, 277, 282, 283, 399, 409, 412, 413, 474, 492, 574, 586, 628], "idl": [0, 21, 241, 273, 285, 494, 547, 554], "befor": [0, 4, 6, 19, 20, 21, 22, 94, 103, 149, 159, 162, 169, 212, 246, 247, 248, 250, 253, 254, 273, 274, 282, 285, 287, 288, 289, 295, 296, 305, 311, 312, 317, 329, 331, 332, 344, 345, 358, 363, 364, 388, 395, 396, 429, 473, 474, 477, 480, 483, 485, 486, 499, 547, 554, 574, 587, 598, 599, 626, 669, 672, 675, 676, 678, 680, 681, 687, 688, 690, 692, 693, 696, 697], "start": [0, 3, 4, 6, 8, 11, 12, 13, 18, 20, 21, 52, 84, 96, 152, 153, 154, 155, 158, 253, 271, 272, 273, 274, 275, 285, 287, 288, 344, 368, 395, 455, 547, 551, 553, 554, 555, 556, 557, 607, 619], "keepal": 0, "probe": 0, "120": [0, 274, 424], "second": [0, 1, 3, 6, 9, 20, 24, 160, 272, 274, 521, 607, 669], "tcp_keepintvl": 0, "time": [0, 3, 6, 9, 10, 13, 20, 21, 160, 246, 258, 259, 273, 274, 276, 283, 285, 286, 287, 317, 344, 365, 395, 411, 462, 486, 494, 521, 541, 543, 547, 554, 557, 568, 569, 570, 610, 615, 669, 696], "tcp_keepcnt": 0, "mani": [0, 13, 295, 311], "without": [0, 5, 7, 8, 12, 20, 24, 121, 123, 160, 166, 253, 254, 255, 274, 288, 292, 321, 328, 329, 345, 367, 371, 387, 388, 396, 473, 669], "acknowledg": [0, 284, 297, 337, 393, 669, 682, 694], "drop": [0, 1, 3, 19, 20, 23, 288, 308, 309, 331, 332, 345, 358, 376, 396, 435], "9": [0, 4, 20, 223, 241, 297, 302, 311, 315, 324, 334, 377, 380, 397, 505, 687, 688, 689, 690, 691, 692, 693, 696], "tcp_nodelai": 0, "packet": [0, 5, 22, 494], "soon": [0, 9], "buffer": [0, 6, 283, 358, 496, 497, 568, 569, 570, 575, 576, 578, 580, 584, 587, 594, 597, 598, 632], "small": 0, "nagl": 0, "option": [1, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694, 695, 696, 697], "document": [1, 3, 4, 7, 10, 12, 13, 17, 18, 21, 23, 34, 122, 123, 128, 130, 132, 133, 135, 138, 139, 140, 141, 142, 143, 144, 145, 146, 150, 152, 153, 154, 155, 157, 159, 160, 164, 166, 169, 170, 171, 176, 179, 200, 201, 202, 208, 209, 210, 212, 213, 219, 220, 222, 224, 253, 254, 257, 260, 261, 262, 264, 266, 271, 272, 273, 274, 285, 287, 288, 289, 290, 291, 292, 294, 295, 296, 298, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 340, 341, 342, 343, 344, 345, 347, 350, 351, 358, 359, 360, 361, 362, 364, 365, 366, 368, 369, 370, 371, 373, 376, 377, 378, 381, 387, 388, 395, 396, 399, 402, 405, 406, 408, 410, 412, 413, 414, 423, 424, 426, 427, 429, 430, 431, 445, 474, 481, 486, 499, 511, 517, 521, 522, 523, 537, 540, 547, 554, 557, 607, 614, 620, 625, 633, 636, 669, 672], "number": [1, 5, 6, 12, 33, 35, 46, 47, 57, 59, 136, 149, 150, 174, 176, 240, 241, 244, 287, 289, 290, 294, 295, 296, 298, 301, 303, 304, 311, 312, 324, 333, 341, 342, 344, 351, 352, 354, 362, 363, 364, 366, 368, 369, 395, 399, 452, 464, 495, 496, 497, 498, 522, 534, 546, 568, 569, 570, 587, 588, 594, 598, 599, 669, 696], "practic": [1, 7, 8, 12, 473], "displai": [1, 20], "capabl": [1, 11, 523], "publicli": 1, "avail": [1, 3, 4, 5, 6, 8, 13, 19, 20, 36, 37, 48, 49, 60, 61, 123, 158, 159, 240, 252, 296, 318, 408, 429, 506, 520, 521, 570, 602, 603, 657, 669, 696], "all": [1, 3, 4, 5, 6, 7, 8, 9, 10, 12, 19, 20, 21, 22, 33, 46, 57, 135, 139, 145, 146, 148, 150, 151, 153, 155, 160, 162, 167, 168, 180, 194, 195, 196, 198, 202, 213, 219, 224, 231, 238, 239, 241, 244, 250, 262, 272, 276, 282, 289, 290, 295, 297, 298, 301, 303, 304, 309, 311, 312, 316, 317, 324, 325, 326, 333, 341, 342, 348, 354, 362, 364, 365, 368, 369, 373, 374, 378, 380, 381, 389, 400, 412, 414, 423, 429, 435, 465, 469, 472, 473, 485, 494, 501, 510, 520, 521, 522, 536, 562, 574, 578, 579, 584, 597, 600, 601, 622, 633, 652, 659, 669, 674, 696, 697], "zipcod": 1, "unit": 1, "json": [1, 7, 13, 129, 160, 253, 288, 313, 628], "let": [1, 10, 150, 289, 298, 303, 304, 317, 333, 341, 342, 368, 399], "": [1, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 17, 20, 21, 22, 23, 24, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 50, 51, 53, 54, 55, 56, 57, 58, 59, 62, 63, 65, 66, 67, 68, 69, 71, 72, 73, 76, 77, 78, 79, 82, 83, 86, 87, 88, 89, 91, 92, 93, 107, 108, 109, 110, 112, 113, 115, 116, 123, 157, 160, 161, 163, 164, 165, 166, 176, 213, 219, 224, 231, 246, 251, 253, 254, 258, 259, 264, 267, 272, 273, 274, 276, 283, 286, 288, 291, 292, 294, 295, 296, 297, 300, 301, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 325, 326, 328, 329, 332, 342, 343, 345, 350, 351, 359, 360, 363, 366, 369, 370, 371, 373, 376, 377, 378, 381, 387, 388, 396, 399, 408, 409, 410, 411, 412, 413, 414, 418, 423, 429, 450, 455, 473, 520, 521, 532, 534, 538, 539, 541, 543, 555, 557, 560, 587, 598, 599, 602, 603, 605, 607, 615, 616, 617, 618, 627, 628, 632, 639, 640, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 685, 694, 696, 697], "check": [1, 2, 4, 5, 8, 9, 10, 14, 18, 20, 80, 84, 90, 100, 101, 102, 157, 163, 164, 165, 219, 271, 289, 290, 291, 309, 312, 315, 316, 317, 349, 350, 359, 360, 368, 369, 370, 378, 386, 437, 495, 515, 521, 563, 669, 694, 696], "everyth": [1, 6], "instal": [1, 4, 5, 8, 14, 18, 123, 697], "command": [1, 4, 5, 7, 11, 13, 18, 20, 27, 28, 33, 34, 36, 37, 40, 41, 42, 46, 48, 49, 52, 53, 57, 60, 61, 64, 80, 84, 90, 100, 101, 102, 121, 124, 125, 139, 141, 143, 145, 148, 153, 155, 160, 163, 164, 165, 166, 171, 202, 219, 224, 232, 253, 254, 255, 260, 274, 287, 288, 289, 290, 291, 292, 295, 296, 297, 298, 300, 301, 303, 304, 308, 309, 311, 313, 314, 315, 316, 318, 325, 326, 327, 328, 329, 332, 333, 338, 339, 341, 342, 343, 344, 345, 359, 360, 365, 368, 369, 370, 371, 373, 376, 377, 378, 381, 387, 388, 389, 390, 395, 396, 399, 407, 414, 424, 426, 427, 430, 431, 473, 499, 522, 525, 531, 532, 537, 540, 543, 669, 672, 694], "load": [1, 7, 8, 11, 13, 17, 39, 51, 63, 123, 199, 221, 227, 669], "mongoimport": 1, "d": [1, 3, 5, 160, 399, 408, 409, 410, 411, 412, 413, 414, 486, 494, 522, 523, 620, 630], "test": [1, 3, 6, 7, 10, 12, 13, 20, 24, 253, 273, 286, 288, 313, 366, 394, 398, 429, 473, 481, 555, 557, 669, 682, 684, 685, 696], "mongodb": [1, 3, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15, 17, 18, 19, 22, 23, 24, 27, 39, 40, 51, 52, 63, 64, 95, 96, 97, 123, 141, 143, 145, 148, 153, 154, 155, 160, 162, 166, 168, 171, 218, 219, 220, 222, 223, 224, 225, 227, 231, 235, 239, 250, 251, 253, 254, 272, 273, 274, 279, 280, 282, 284, 286, 287, 288, 289, 292, 293, 294, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 312, 313, 314, 316, 317, 325, 326, 328, 329, 332, 333, 336, 337, 339, 341, 342, 343, 344, 345, 346, 350, 351, 353, 359, 360, 362, 365, 366, 368, 371, 373, 376, 378, 381, 386, 387, 388, 392, 393, 394, 395, 396, 399, 408, 414, 424, 429, 433, 452, 453, 454, 462, 472, 473, 475, 481, 485, 486, 494, 495, 503, 506, 507, 517, 519, 520, 521, 522, 532, 534, 537, 540, 555, 557, 574, 586, 602, 603, 605, 607, 620, 625, 627, 628, 630, 631, 639, 640, 641, 647, 650, 651, 652, 653, 654, 657, 659, 665, 666, 668, 669, 671, 683, 691, 694, 697], "shell": [1, 10, 20, 24, 696], "verifi": [1, 8, 696], "import": [1, 8, 11, 20, 22, 171, 696], "successfulli": [1, 5, 20, 23, 64, 227, 249, 274, 277, 281, 309, 350, 367, 408, 409, 410, 411, 412, 413, 474, 481, 660, 661, 662, 663, 669, 696], "connect": [1, 3, 4, 5, 8, 12, 13, 14, 16, 18, 20, 24, 36, 37, 39, 48, 49, 51, 60, 61, 63, 70, 98, 104, 111, 123, 225, 227, 231, 235, 240, 250, 251, 277, 282, 286, 287, 336, 344, 350, 366, 392, 395, 473, 474, 506, 521, 532, 534, 537, 540, 544, 561, 574, 602, 603, 605, 630, 650, 658, 694, 697], "db": [1, 6, 10, 126, 129, 160, 207, 220, 225, 226, 231, 253, 287, 288, 309, 342, 350, 359, 360, 395, 424, 429, 669, 696], "count": [1, 6, 9, 12, 135, 253, 294, 296, 311, 328, 387, 587, 598], "29467": 1, "findon": 1, "_id": [1, 3, 6, 10, 12, 13, 160, 188, 272, 273, 274, 287, 296, 317, 323, 325, 326, 334, 342, 344, 395, 408, 409, 410, 412, 413, 414, 442, 555, 607, 696], "35004": 1, "acmar": 1, "loc": 1, "86": 1, "51557": 1, "33": 1, "584132": 1, "pop": [1, 282], "6055": 1, "al": 1, "each": [1, 5, 6, 9, 12, 21, 128, 150, 160, 166, 171, 209, 219, 227, 246, 253, 254, 274, 276, 287, 288, 289, 290, 292, 298, 301, 303, 304, 315, 316, 328, 329, 333, 341, 342, 344, 345, 362, 368, 371, 377, 378, 387, 388, 395, 396, 399, 409, 449, 495, 512, 518, 521, 537, 540, 555, 556, 557, 607, 669, 696, 697], "collect": [1, 3, 6, 7, 10, 12, 13, 14, 16, 18, 24, 122, 124, 125, 126, 129, 135, 160, 168, 170, 171, 179, 194, 195, 196, 197, 198, 200, 201, 202, 207, 213, 220, 222, 226, 239, 254, 272, 273, 274, 279, 284, 286, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 350, 358, 359, 360, 366, 368, 373, 376, 377, 378, 379, 380, 381, 386, 388, 391, 392, 393, 399, 408, 409, 410, 411, 412, 413, 414, 423, 424, 474, 481, 506, 520, 521, 555, 557, 607, 642, 694, 696], "form": [1, 12, 13, 24, 130, 182, 210, 301, 327], "In": [1, 4, 6, 7, 8, 9, 12, 13, 14, 16, 18, 20, 24, 118, 119, 120, 121, 122, 123, 124, 125, 126, 128, 129, 130, 131, 160, 166, 168, 206, 207, 209, 210, 218, 239, 253, 254, 274, 288, 289, 292, 295, 296, 309, 311, 315, 316, 317, 328, 329, 345, 368, 371, 377, 378, 387, 388, 396, 450, 473, 495, 521, 662, 669, 682], "field": [1, 6, 8, 12, 13, 14, 17, 23, 121, 122, 123, 129, 144, 145, 152, 153, 154, 155, 160, 163, 166, 168, 171, 182, 185, 194, 195, 196, 198, 212, 213, 218, 219, 224, 239, 253, 254, 287, 288, 289, 290, 292, 295, 296, 301, 303, 304, 308, 309, 311, 312, 313, 316, 317, 325, 326, 327, 328, 329, 332, 333, 334, 341, 342, 344, 345, 350, 368, 369, 371, 376, 378, 381, 386, 387, 388, 395, 396, 399, 402, 414, 468, 469, 474, 477, 480, 483, 556, 607, 696], "hold": [1, 11, 26, 251, 530, 544, 669, 696], "two": [1, 3, 6, 7, 9, 11, 15, 17, 20, 24, 253, 272, 288, 521, 607, 697], "letter": 1, "abbrevi": 1, "locat": [1, 20, 123, 135, 139, 141, 143, 157, 159, 164, 165, 166, 176, 223, 224, 226, 227, 232, 237, 243, 253, 254, 256, 257, 260, 261, 272, 274, 275, 288, 291, 292, 294, 295, 296, 299, 300, 301, 302, 303, 304, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 345, 349, 350, 361, 367, 370, 371, 373, 375, 376, 377, 380, 381, 386, 387, 388, 389, 390, 396, 435, 437, 448, 453, 466, 467, 468, 472, 481, 650], "latitud": 1, "longitud": 1, "arrai": [1, 6, 12, 13, 123, 153, 155, 171, 174, 199, 221, 231, 289, 301, 303, 304, 323, 324, 325, 326, 333, 340, 341, 342, 368, 380, 381, 452, 464, 546, 601, 696], "get": [1, 7, 12, 20, 135, 200, 201, 202, 215, 220, 222, 225, 230, 264, 266, 267, 268, 269, 274, 378, 494, 537, 539, 540, 541, 543, 564, 680, 681, 696], "greater": [1, 12, 161, 258, 259, 669], "pipelin": [1, 6, 160, 287, 289, 338, 340, 341, 342, 344, 359, 360, 368, 395, 557], "aggregation1": 1, "stdio": [1, 3, 6, 7, 10, 12, 24, 251, 253, 272, 273, 274, 286, 288, 291, 294, 295, 296, 311, 312, 313, 317, 366, 429, 473, 607, 696], "static": [1, 3, 6, 7, 10, 160, 251, 289, 291, 294, 295, 296, 311, 312, 317, 368, 520, 628, 671, 696], "void": [1, 3, 6, 7, 10, 12, 22, 24, 25, 26, 29, 31, 43, 54, 65, 69, 71, 73, 76, 78, 82, 86, 91, 93, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 110, 112, 113, 115, 116, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 132, 133, 134, 138, 140, 142, 144, 146, 147, 148, 149, 150, 152, 154, 156, 160, 162, 167, 172, 173, 174, 175, 176, 180, 183, 184, 185, 186, 187, 188, 189, 190, 192, 193, 194, 195, 196, 197, 204, 205, 206, 207, 208, 209, 210, 214, 216, 231, 238, 240, 241, 245, 246, 250, 251, 255, 258, 259, 262, 267, 274, 275, 276, 279, 280, 282, 283, 284, 286, 291, 294, 295, 296, 301, 305, 311, 312, 313, 317, 335, 336, 337, 342, 348, 350, 353, 362, 365, 374, 391, 392, 393, 399, 400, 402, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 421, 434, 436, 447, 456, 457, 458, 460, 461, 473, 475, 476, 477, 479, 480, 481, 482, 483, 484, 485, 488, 489, 491, 495, 496, 497, 498, 501, 504, 508, 510, 517, 518, 519, 520, 525, 526, 531, 536, 546, 549, 554, 555, 556, 557, 562, 568, 569, 571, 573, 574, 579, 587, 589, 598, 600, 609, 614, 615, 616, 617, 618, 622, 665, 666, 668, 671, 674, 686, 687, 688, 689, 690, 691, 692, 693, 696], "print_pipelin": 1, "mongoc_collection_t": [1, 2, 3, 6, 7, 10, 12, 14, 18, 21, 24, 160, 171, 220, 272, 273, 274, 286, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 340, 341, 342, 343, 344, 345, 350, 366, 373, 379, 394, 399, 408, 409, 410, 411, 412, 413, 414, 470, 471, 520, 555, 557, 607, 696], "mongoc_cursor_t": [1, 2, 10, 12, 14, 18, 21, 23, 163, 202, 219, 273, 285, 286, 289, 290, 305, 312, 315, 316, 317, 342, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 368, 369, 377, 378, 423, 429, 450, 520, 547, 554, 696], "cursor": [1, 5, 12, 13, 14, 16, 18, 23, 159, 163, 164, 219, 255, 273, 286, 287, 289, 290, 312, 315, 316, 317, 342, 344, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 368, 369, 377, 378, 395, 411, 429, 494, 520, 523, 557, 696], "bson_error_t": [1, 3, 6, 7, 10, 12, 13, 24, 31, 78, 135, 139, 141, 143, 145, 153, 155, 157, 160, 164, 165, 166, 168, 169, 170, 171, 178, 179, 181, 182, 200, 201, 202, 203, 208, 212, 213, 223, 224, 226, 227, 231, 232, 237, 239, 243, 249, 251, 253, 254, 256, 257, 260, 261, 272, 273, 274, 275, 281, 285, 286, 288, 289, 290, 291, 292, 294, 295, 296, 299, 300, 301, 302, 303, 304, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 345, 349, 350, 366, 367, 368, 369, 370, 371, 373, 375, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 396, 399, 408, 409, 410, 411, 412, 413, 414, 420, 422, 424, 425, 426, 427, 428, 429, 430, 431, 435, 437, 448, 453, 459, 466, 467, 468, 472, 473, 481, 520, 555, 607, 650, 696], "error": [1, 2, 3, 4, 5, 6, 7, 8, 10, 12, 14, 18, 20, 22, 23, 24, 31, 34, 78, 129, 147, 157, 159, 160, 163, 165, 168, 169, 170, 171, 178, 179, 181, 182, 186, 189, 190, 194, 195, 196, 197, 200, 201, 202, 203, 208, 212, 213, 227, 231, 235, 236, 237, 239, 242, 243, 246, 247, 248, 249, 251, 256, 257, 260, 261, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 284, 286, 287, 289, 290, 299, 306, 307, 312, 317, 327, 331, 344, 346, 347, 359, 360, 361, 363, 366, 368, 369, 375, 395, 398, 399, 408, 409, 410, 411, 412, 413, 414, 419, 420, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 433, 452, 454, 459, 464, 465, 469, 473, 474, 481, 494, 495, 499, 520, 523, 525, 532, 555, 557, 563, 590, 595, 607, 648, 650, 669, 672, 694, 695, 696], "const": [1, 3, 6, 7, 10, 12, 22, 23, 24, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 67, 68, 69, 71, 72, 73, 75, 76, 77, 78, 79, 81, 82, 83, 85, 86, 87, 88, 89, 91, 92, 93, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 112, 113, 115, 116, 122, 123, 126, 128, 129, 130, 132, 133, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 148, 149, 150, 152, 153, 154, 155, 157, 158, 159, 160, 163, 164, 165, 166, 169, 170, 171, 175, 176, 178, 179, 181, 182, 185, 187, 188, 189, 190, 194, 195, 199, 200, 201, 207, 208, 209, 210, 212, 213, 215, 219, 220, 221, 222, 224, 226, 228, 229, 231, 233, 234, 235, 236, 237, 242, 243, 247, 249, 250, 251, 253, 254, 256, 258, 260, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 277, 279, 280, 281, 282, 284, 286, 287, 288, 289, 290, 291, 292, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 307, 308, 310, 311, 312, 313, 314, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 340, 341, 342, 343, 344, 345, 346, 347, 350, 351, 352, 354, 357, 360, 361, 366, 367, 368, 369, 370, 371, 373, 376, 377, 378, 379, 381, 382, 383, 384, 385, 386, 387, 388, 390, 391, 392, 393, 395, 396, 398, 399, 401, 402, 403, 404, 405, 406, 409, 410, 412, 413, 414, 418, 420, 422, 423, 424, 425, 426, 427, 429, 430, 431, 438, 440, 441, 442, 444, 445, 451, 456, 457, 458, 459, 460, 461, 464, 465, 466, 467, 468, 469, 472, 473, 474, 476, 479, 481, 482, 484, 488, 490, 493, 495, 496, 497, 500, 502, 505, 508, 509, 511, 512, 513, 514, 515, 517, 520, 524, 527, 528, 529, 533, 535, 537, 538, 539, 540, 541, 542, 543, 545, 548, 550, 551, 552, 553, 556, 559, 561, 569, 571, 573, 574, 582, 601, 602, 603, 604, 606, 607, 608, 610, 611, 612, 613, 616, 617, 618, 621, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 670, 673, 675, 676, 677, 678, 679, 680, 681, 682, 684, 685, 691, 696], "bson_t": [1, 3, 6, 7, 10, 11, 12, 13, 23, 24, 34, 41, 58, 89, 122, 123, 128, 129, 130, 132, 133, 135, 138, 139, 140, 141, 142, 143, 144, 145, 150, 152, 153, 154, 155, 157, 158, 159, 160, 163, 164, 165, 166, 169, 171, 176, 179, 182, 200, 201, 208, 209, 210, 212, 213, 215, 219, 224, 227, 231, 232, 251, 253, 254, 258, 260, 261, 264, 266, 272, 273, 274, 275, 286, 287, 288, 289, 290, 291, 292, 294, 295, 296, 298, 299, 300, 301, 302, 303, 304, 306, 307, 308, 309, 310, 311, 312, 313, 314, 316, 317, 318, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 347, 350, 359, 360, 361, 366, 367, 368, 369, 370, 371, 373, 375, 376, 377, 378, 381, 387, 388, 395, 396, 398, 399, 402, 405, 406, 408, 409, 410, 411, 412, 413, 414, 423, 424, 426, 427, 429, 430, 431, 438, 445, 451, 456, 461, 465, 466, 468, 469, 473, 481, 499, 508, 511, 514, 517, 520, 537, 540, 555, 557, 607, 625, 628, 633, 636, 655, 656, 659, 660, 661, 662, 663, 672, 696], "str": [1, 6, 7, 10, 12, 24, 273, 274, 286, 291, 312, 313, 317, 350, 366, 399, 408, 409, 410, 411, 412, 413, 414, 429, 457, 458, 460, 520, 696], "bcon_new": [1, 3, 6, 7, 12, 23, 24, 160, 231, 253, 272, 273, 274, 288, 289, 291, 295, 296, 311, 312, 313, 317, 342, 350, 368, 399, 408, 409, 410, 411, 412, 413, 414, 520, 555, 607, 696], "group": [1, 369], "total_pop": 1, "sum": [1, 12], "gte": [1, 6, 182], "bcon_int32": [1, 3, 6, 7, 23, 24, 160, 231, 272, 273, 274, 291, 312, 313, 317, 342, 399, 408, 409, 411, 414, 555, 607, 696], "10000000": 1, "mongoc_collection_aggreg": [1, 14, 338, 339, 359, 360, 557], "mongoc_query_non": [1, 12, 289, 294, 296, 312, 494, 557, 696], "while": [1, 9, 10, 12, 13, 20, 23, 139, 141, 143, 145, 153, 155, 160, 208, 251, 272, 273, 275, 286, 312, 317, 349, 350, 366, 378, 429, 448, 450, 454, 464, 473, 495, 520, 521, 607, 669, 696], "mongoc_cursor_next": [1, 10, 12, 13, 14, 23, 159, 163, 273, 286, 289, 290, 312, 315, 316, 317, 342, 346, 350, 358, 364, 365, 366, 368, 369, 377, 378, 429, 520, 696], "bson_as_canonical_extended_json": [1, 3, 6, 7, 10, 12, 23, 24, 160, 253, 286, 288, 291, 312, 313, 317, 366, 399, 408, 409, 410, 411, 412, 413, 414, 429, 520, 628, 696], "printf": [1, 3, 6, 7, 10, 12, 23, 24, 160, 224, 231, 253, 272, 274, 288, 291, 294, 295, 296, 309, 311, 312, 313, 317, 342, 378, 381, 399, 408, 409, 410, 411, 412, 413, 414, 429, 473, 520, 607, 628, 696], "n": [1, 3, 5, 6, 7, 10, 12, 23, 24, 160, 224, 231, 251, 253, 272, 273, 274, 286, 288, 291, 294, 295, 296, 309, 311, 312, 313, 317, 342, 350, 359, 360, 366, 378, 381, 399, 408, 409, 410, 411, 412, 413, 414, 429, 473, 520, 546, 555, 557, 601, 607, 628, 669, 694, 696], "bson_fre": [1, 3, 6, 7, 10, 12, 23, 24, 160, 253, 272, 273, 274, 286, 288, 291, 312, 313, 317, 327, 342, 350, 366, 399, 408, 409, 410, 411, 412, 413, 414, 429, 520, 564, 607, 628, 670, 696], "mongoc_cursor_error": [1, 10, 12, 13, 14, 23, 163, 219, 273, 286, 312, 316, 317, 350, 359, 360, 361, 366, 378, 520], "fprintf": [1, 3, 6, 7, 10, 12, 24, 160, 224, 251, 253, 273, 286, 288, 291, 294, 295, 296, 309, 311, 312, 313, 317, 342, 350, 366, 378, 381, 399, 408, 409, 410, 411, 412, 413, 414, 429, 473, 520, 555, 557, 696], "stderr": [1, 3, 5, 6, 7, 10, 12, 22, 24, 160, 224, 251, 253, 273, 286, 288, 291, 294, 295, 296, 309, 311, 312, 313, 317, 342, 350, 366, 378, 381, 399, 408, 409, 410, 411, 412, 413, 414, 429, 473, 520, 555, 557, 657, 696], "failur": [1, 5, 13, 135, 171, 178, 181, 182, 208, 213, 223, 224, 226, 232, 249, 254, 272, 273, 274, 275, 281, 286, 288, 289, 290, 291, 294, 295, 296, 297, 298, 302, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 329, 333, 334, 340, 341, 342, 345, 346, 350, 359, 360, 366, 367, 368, 369, 370, 373, 378, 380, 381, 388, 396, 424, 425, 426, 427, 452, 455, 464, 474, 533, 558, 559, 560, 561, 566, 568, 569, 570, 571, 578, 581, 582, 587, 588, 597, 598, 599, 648, 650, 694, 696], "mongoc_cursor_destroi": [1, 10, 12, 14, 23, 163, 273, 286, 289, 290, 312, 315, 316, 317, 346, 350, 366, 368, 369, 377, 378, 423, 429, 520, 696], "bson_destroi": [1, 3, 6, 7, 10, 12, 23, 24, 135, 160, 164, 166, 169, 179, 182, 200, 231, 232, 251, 253, 254, 261, 272, 273, 274, 286, 288, 289, 291, 292, 295, 296, 300, 303, 304, 311, 312, 313, 314, 317, 325, 326, 328, 329, 333, 338, 341, 342, 343, 345, 350, 366, 368, 371, 378, 381, 387, 388, 396, 399, 408, 409, 410, 411, 412, 413, 414, 429, 473, 481, 520, 607, 659, 696], "uri_str": [1, 3, 6, 160, 235, 251, 253, 272, 273, 274, 286, 288, 313, 342, 350, 366, 414, 429, 473, 607, 648, 650, 696], "appnam": [1, 3, 6, 7, 247, 251, 253, 272, 273, 274, 277, 286, 288, 313, 342, 350, 366, 414, 429, 473, 520, 555, 557, 607, 669, 696], "mongoc_uri_new_with_error": [1, 3, 6, 10, 12, 14, 24, 160, 251, 253, 272, 273, 274, 286, 288, 313, 342, 366, 414, 473, 607, 648, 669, 696], "pars": [1, 3, 6, 7, 10, 12, 18, 24, 160, 166, 251, 253, 272, 273, 274, 286, 288, 292, 313, 342, 366, 371, 414, 473, 607, 650, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 696], "exit_failur": [1, 3, 6, 7, 10, 12, 24, 160, 251, 253, 272, 273, 274, 286, 288, 313, 342, 366, 414, 429, 473, 607, 696], "mongoc_client_set_error_api": [1, 3, 6, 10, 12, 13, 14, 24, 253, 272, 273, 274, 286, 288, 309, 313, 342, 350, 366, 414, 473, 520, 555, 557, 607], "mongoc_client_get_collect": [1, 3, 6, 7, 10, 14, 160, 273, 286, 309, 313, 342, 350, 366, 481, 520, 555, 557, 696], "mongoc_uri_destroi": [1, 3, 6, 10, 12, 14, 24, 160, 251, 253, 272, 273, 274, 286, 288, 313, 342, 366, 414, 473, 607, 621, 649, 669, 696], "mongoc_collection_destroi": [1, 3, 6, 7, 10, 12, 14, 24, 160, 220, 272, 273, 274, 286, 293, 309, 313, 339, 342, 350, 366, 379, 414, 481, 520, 607, 696], "exit_success": [1, 3, 6, 7, 10, 12, 160, 251, 253, 272, 273, 274, 286, 288, 313, 342, 366, 414, 429, 473, 607, 696], "you": [1, 3, 4, 5, 10, 11, 12, 13, 19, 20, 21, 22, 24, 26, 162, 166, 219, 224, 225, 226, 251, 253, 254, 286, 288, 289, 292, 293, 295, 296, 297, 298, 300, 301, 302, 303, 304, 308, 309, 311, 312, 316, 317, 323, 325, 326, 328, 329, 330, 332, 333, 341, 342, 345, 361, 368, 371, 372, 376, 378, 381, 387, 388, 396, 399, 456, 457, 458, 460, 461, 465, 466, 467, 468, 469, 473, 485, 486, 487, 494, 495, 503, 506, 521, 530, 538, 555, 561, 562, 569, 620, 669, 671, 683, 689, 690, 694, 696, 697], "pa": 1, "11881643": 1, "oh": 1, "10847115": 1, "ny": [1, 520, 521], "17990455": 1, "fl": 1, "12937284": 1, "tx": 1, "16986510": 1, "il": 1, "11430472": 1, "29760021": 1, "abov": [1, 6, 20, 22, 669, 697], "from": [1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 17, 18, 21, 23, 24, 36, 37, 48, 49, 60, 61, 75, 81, 85, 122, 123, 129, 147, 158, 159, 160, 164, 166, 167, 175, 206, 212, 219, 224, 227, 238, 240, 241, 244, 245, 247, 250, 251, 252, 253, 254, 255, 258, 259, 263, 272, 273, 274, 277, 279, 280, 282, 284, 285, 286, 287, 288, 289, 292, 294, 296, 298, 300, 301, 303, 304, 305, 308, 309, 311, 312, 316, 317, 320, 322, 325, 326, 328, 329, 332, 333, 336, 337, 339, 341, 342, 344, 345, 350, 354, 358, 359, 360, 361, 363, 365, 366, 368, 369, 371, 373, 376, 378, 381, 387, 388, 390, 392, 393, 394, 395, 396, 398, 399, 420, 422, 423, 424, 425, 430, 431, 433, 452, 453, 455, 462, 472, 486, 494, 495, 503, 517, 521, 522, 523, 529, 547, 554, 556, 557, 574, 575, 580, 586, 587, 607, 636, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 683, 694, 697], "oper": [1, 3, 5, 9, 12, 13, 14, 16, 18, 21, 24, 33, 46, 57, 95, 96, 97, 123, 132, 133, 135, 136, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 160, 163, 164, 165, 166, 168, 171, 215, 219, 223, 224, 227, 239, 253, 256, 258, 259, 264, 267, 272, 273, 274, 275, 279, 280, 284, 285, 287, 289, 290, 291, 292, 294, 295, 296, 297, 298, 311, 312, 315, 316, 317, 318, 320, 321, 322, 325, 328, 332, 335, 336, 337, 339, 344, 350, 352, 363, 366, 368, 369, 370, 371, 377, 378, 380, 381, 387, 391, 392, 393, 395, 397, 398, 399, 411, 412, 414, 420, 422, 423, 424, 430, 431, 437, 465, 466, 467, 468, 469, 474, 486, 494, 505, 517, 521, 522, 547, 554, 555, 557, 569, 580, 619, 620, 669, 675, 687, 688, 689, 690, 691, 692, 693, 694, 697], "where": [1, 6, 7, 13, 19, 122, 129, 160, 219, 253, 288, 295], "we": [1, 6, 7, 12, 20, 24, 136, 149, 160, 273, 274, 352, 363, 366, 429, 474, 495, 541, 696], "gener": [1, 8, 12, 13, 18, 171, 175, 208, 253, 255, 309, 323, 325, 326, 328, 387, 426, 427, 430, 431, 462, 473, 495, 496, 497, 498, 521, 539, 578, 594, 597, 694, 696, 697], "composit": 1, "function": [1, 4, 5, 9, 10, 11, 12, 15, 19, 21, 22, 24, 36, 48, 60, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 127, 132, 133, 135, 136, 138, 140, 142, 144, 148, 149, 150, 152, 153, 154, 155, 158, 159, 162, 163, 164, 165, 166, 171, 208, 219, 223, 224, 226, 227, 232, 240, 241, 242, 243, 244, 245, 246, 247, 248, 250, 252, 253, 254, 256, 260, 265, 272, 274, 277, 278, 279, 280, 282, 283, 284, 285, 287, 288, 289, 290, 291, 292, 293, 294, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 315, 316, 317, 318, 323, 324, 326, 327, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 346, 349, 350, 352, 357, 358, 359, 360, 361, 363, 364, 365, 367, 368, 369, 370, 371, 373, 375, 376, 377, 378, 380, 381, 383, 385, 386, 387, 388, 389, 390, 391, 392, 393, 395, 396, 399, 409, 411, 412, 413, 422, 423, 432, 433, 434, 437, 449, 452, 463, 465, 466, 467, 468, 469, 474, 477, 480, 483, 485, 499, 505, 508, 509, 540, 545, 556, 558, 559, 560, 561, 562, 563, 566, 568, 571, 575, 577, 578, 579, 580, 582, 584, 585, 586, 587, 588, 589, 592, 597, 598, 599, 602, 603, 606, 616, 617, 618, 628, 630, 636, 639, 642, 648, 650, 662, 672, 675, 687, 688, 689, 690, 691, 692, 693, 696], "addtoset": 1, "last": [1, 258, 259, 274, 318, 437, 494, 521, 541, 563, 669, 696], "max": [1, 13, 160, 194, 195, 196, 198, 290, 312, 317, 424, 566, 610, 615], "min": [1, 195, 196, 198, 317], "avg": 1, "push": [1, 167, 238, 241, 669], "syntax": [1, 7, 312, 317], "read": [1, 7, 12, 13, 15, 159, 160, 163, 164, 165, 166, 219, 223, 224, 227, 228, 229, 253, 254, 256, 272, 273, 279, 280, 286, 287, 288, 289, 290, 291, 292, 294, 295, 296, 311, 312, 315, 316, 317, 320, 321, 328, 329, 335, 336, 344, 345, 350, 358, 361, 363, 366, 368, 369, 370, 371, 377, 378, 380, 381, 384, 387, 388, 391, 392, 394, 395, 396, 422, 423, 424, 425, 430, 431, 433, 452, 465, 466, 467, 468, 469, 473, 499, 501, 502, 503, 504, 505, 507, 508, 509, 510, 511, 512, 513, 514, 515, 517, 518, 519, 520, 552, 555, 556, 557, 568, 580, 586, 587, 588, 602, 607, 616, 617, 630, 635, 636, 637, 665, 666], "queri": [1, 4, 5, 6, 7, 10, 12, 13, 33, 46, 57, 124, 125, 141, 143, 145, 153, 155, 163, 181, 182, 189, 198, 223, 224, 232, 251, 253, 273, 286, 288, 289, 294, 295, 296, 302, 303, 304, 311, 312, 313, 314, 317, 330, 333, 340, 341, 342, 346, 350, 354, 358, 364, 365, 366, 368, 399, 408, 409, 410, 411, 412, 413, 414, 423, 450, 465, 466, 468, 469, 473, 494, 523, 669, 696], "process": [1, 5, 10, 17, 19, 20, 22, 121, 123, 162, 255, 297, 454, 464, 485, 541, 560, 573], "4866692": 1, "sourc": [1, 11, 13, 20, 166, 253, 254, 272, 274, 288, 289, 292, 317, 328, 329, 345, 368, 371, 387, 388, 396, 430, 431, 488, 607], "pipe": 1, "equal": [1, 161, 189, 309, 512, 518, 669], "three": 1, "greatest": 1, "per": [1, 9, 351, 362, 521, 694], "avg_city_pop": 1, "sort": [1, 6, 253, 288, 296, 312, 313, 317, 405, 414, 468, 469, 473], "limit": [1, 9, 12, 24, 163, 244, 274, 290, 294, 295, 296, 302, 311, 312, 317, 330, 360, 362, 364, 369, 669], "produc": [1, 13, 20, 628], "dc": [1, 520, 521], "303450": 1, "27942": 1, "29805615551": 1, "27735": 1, "341099720412": 1, "wy": 1, "smoot": 1, "414": 1, "t": [1, 6, 10, 11, 12, 24, 250, 272, 274, 277, 282, 399, 410, 411, 414, 474, 521, 607, 696], "nest": 1, "except": [1, 12, 17, 19, 21, 24, 162, 247, 250, 251, 252, 274, 317, 485, 521, 588, 669, 694], "descend": [1, 317, 327, 412, 414], "final": [1, 3, 10, 20, 171, 358, 697], "initi": [2, 4, 13, 14, 18, 20, 106, 117, 123, 135, 162, 166, 170, 171, 178, 181, 182, 227, 232, 253, 254, 261, 274, 277, 283, 288, 289, 290, 291, 292, 295, 300, 311, 312, 313, 314, 315, 316, 317, 328, 329, 333, 338, 343, 345, 359, 360, 366, 368, 369, 370, 371, 377, 378, 387, 388, 396, 402, 405, 406, 473, 474, 477, 480, 483, 485, 487, 489, 541, 575, 628, 647, 669, 696], "cleanup": [2, 5, 12, 14, 18, 20, 24, 160, 255, 313, 429], "log": [2, 3, 14, 18, 19, 35, 47, 59, 148, 162, 235, 236, 242, 246, 247, 248, 276, 277, 278, 287, 289, 295, 298, 303, 304, 311, 325, 326, 333, 341, 342, 344, 363, 368, 395, 399, 408, 410, 411, 433, 459, 474, 485, 499, 657, 669, 672, 687, 688, 689, 690, 691, 692, 693, 696], "report": [2, 4, 6, 14, 18, 139, 141, 143, 145, 153, 155, 248, 278, 696], "object": [2, 7, 9, 14, 15, 18, 127, 129, 171, 199, 208, 238, 274, 313, 314, 361, 394, 473, 506, 521, 538, 694, 696], "lifecycl": [2, 14, 18], "gridf": [2, 13, 14, 18, 226, 419, 420, 422, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 438, 439, 441, 442, 443, 444, 445, 446, 449, 450, 451, 454, 456, 457, 462, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 586], "mongoc_auto_encryption_opts_t": [2, 7, 14, 18, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 168, 181, 182, 239], "mongoc_bulk_operation_t": [2, 6, 12, 14, 18, 21, 24, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 297, 298], "mongoc_change_stream_t": [2, 14, 18, 21, 156, 157, 158, 159, 273, 285, 287, 344, 395, 547, 554], "mongoc_client_encryption_t": [2, 7, 14, 17, 18, 21, 169, 170, 171, 178, 179, 180, 181, 182, 199, 200, 201, 202, 203, 206, 212, 213], "mongoc_client_encryption_datakey_opts_t": [2, 7, 14, 18, 170, 172, 173, 174, 175, 176], "mongoc_client_encryption_rewrap_many_datakey_result_t": [2, 14, 18, 213, 214, 215, 216], "mongoc_client_encryption_encrypt_opts_t": [2, 7, 14, 18, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 198], "mongoc_client_encryption_encrypt_range_opts_t": [2, 14, 18, 181, 190, 192, 193, 194, 195, 196, 197], "mongoc_client_encryption_opts_t": [2, 7, 14, 18, 203, 204, 205, 206, 207, 208, 209, 210], "mongoc_client_pool_t": [2, 9, 14, 17, 18, 21, 125, 167, 206, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 252, 277, 279, 280, 282, 284, 286, 474, 574, 669, 696], "mongoc_client_session_t": [2, 14, 18, 21, 147, 166, 219, 224, 253, 254, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 274, 275, 285, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 689], "mongoc_client_session_with_transaction_cb_t": [2, 14, 18, 274], "mongoc_database_t": [2, 6, 12, 14, 18, 21, 24, 171, 222, 225, 272, 274, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 395, 396, 414, 424, 429, 607, 696], "mongoc_delete_flags_t": [2, 14, 18, 302], "mongoc_find_and_modify_opts_t": [2, 14, 18, 314, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413], "mongoc_gridfs_file_list_t": [2, 14, 18, 21, 447, 448, 449, 462, 465, 469, 473], "mongoc_gridfs_file_opt_t": [2, 14, 18, 432, 433, 462, 473], "mongoc_gridfs_file_t": [2, 14, 15, 18, 21, 432, 433, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 463, 464, 466, 467, 468, 473, 586], "mongoc_gridfs_bucket_t": [2, 14, 15, 18, 21, 420, 421, 422, 423, 424, 425, 426, 427, 430, 431, 473], "mongoc_gridfs_t": [2, 14, 15, 18, 21, 226, 429, 432, 433, 434, 435, 462, 465, 466, 467, 468, 469, 470, 471, 472], "mongoc_host_list_t": [2, 14, 18, 32, 45, 56, 66, 72, 79, 83, 88, 92, 286, 353, 538, 627], "mongoc_index_opt_geo_t": [2, 14, 18, 476, 477, 481, 484], "mongoc_index_opt_t": [2, 14, 18, 299, 300, 310, 478, 479, 480, 484], "mongoc_index_opt_wt_t": [2, 14, 18, 478, 481, 482, 483], "mongoc_insert_flags_t": [2, 14, 18, 323, 324], "mongoc_iovec_t": [2, 14, 18, 452, 464, 473, 570, 588, 599], "mongoc_optional_t": [2, 14, 18, 488, 489, 490, 491, 493, 527, 528], "mongoc_query_flags_t": [2, 14, 18, 163, 289, 290, 294, 296, 312, 369], "mongoc_rand": [2, 14, 18], "mongoc_read_concern_t": [2, 14, 18, 166, 228, 253, 254, 272, 279, 288, 289, 292, 294, 295, 296, 311, 317, 320, 328, 329, 335, 368, 371, 381, 383, 387, 388, 391, 424, 499, 500, 501, 502, 503, 504, 505, 607, 611, 616, 635, 665], "mongoc_read_mode_t": [2, 14, 18, 513, 516, 519], "mongoc_read_prefs_t": [2, 3, 12, 13, 14, 18, 163, 164, 165, 166, 229, 232, 253, 254, 256, 273, 280, 286, 288, 289, 290, 291, 292, 294, 295, 296, 311, 312, 317, 321, 328, 329, 336, 338, 368, 369, 370, 371, 384, 387, 388, 392, 424, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 602, 612, 617, 637, 666], "mongoc_remove_flags_t": [2, 14, 18, 330], "mongoc_reply_flags_t": [2, 14, 18], "mongoc_server_api_t": [2, 14, 18, 249, 281, 492, 524, 525, 526, 527, 528, 529, 530, 531], "mongoc_server_api_version_t": [2, 14, 18, 529, 530, 532, 533, 535], "mongoc_server_description_t": [2, 3, 14, 18, 67, 68, 74, 94, 99, 103, 227, 230, 231, 256, 536, 537, 538, 539, 540, 541, 542, 543, 545, 546, 601], "mongoc_session_opt_t": [2, 14, 18, 21, 268, 272, 273, 285, 548, 549, 550, 551, 552, 554, 555, 556, 557, 607], "mongoc_socket_t": [2, 14, 18, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 591, 592], "mongoc_ssl_opt_t": [2, 4, 14, 18, 250, 282, 573], "mongoc_stream_buffered_t": [2, 14, 18, 575, 585, 594], "mongoc_stream_file_t": [2, 14, 18, 580, 581, 582, 594], "mongoc_stream_socket_t": [2, 14, 18, 591, 592, 594], "mongoc_stream_t": [2, 14, 15, 18, 21, 283, 286, 419, 422, 425, 426, 427, 428, 429, 430, 431, 433, 473, 487, 575, 576, 577, 578, 579, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 592, 593, 595, 596, 597, 598, 599], "mongoc_stream_tls_t": [2, 14, 18, 585, 594], "mongoc_topology_description_t": [2, 3, 14, 18, 105, 106, 108, 109, 114, 117, 600, 601, 602, 603, 604, 606], "mongoc_transaction_opt_t": [2, 14, 18, 166, 219, 224, 253, 254, 272, 274, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 551, 553, 556, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_transaction_state_t": [2, 14, 18, 270], "mongoc_update_flags_t": [2, 14, 18, 340], "version": [2, 7, 8, 12, 14, 18, 19, 20, 24, 36, 48, 60, 121, 122, 127, 132, 133, 161, 166, 171, 176, 182, 186, 189, 190, 192, 193, 194, 195, 196, 197, 198, 199, 208, 221, 223, 232, 241, 248, 249, 253, 254, 278, 281, 287, 288, 291, 292, 294, 296, 297, 299, 300, 302, 309, 310, 311, 312, 313, 315, 317, 324, 328, 329, 334, 338, 343, 344, 345, 357, 359, 360, 371, 377, 380, 387, 388, 395, 396, 397, 413, 414, 418, 465, 466, 474, 481, 505, 506, 525, 529, 530, 531, 532, 533, 535, 540, 557, 574, 636, 639, 642, 675, 687, 688, 689, 690, 691, 692, 693, 696], "mongoc_write_concern_t": [2, 6, 7, 14, 18, 137, 160, 166, 234, 253, 254, 272, 284, 286, 288, 289, 292, 297, 298, 300, 301, 302, 303, 304, 308, 309, 313, 322, 323, 324, 325, 326, 329, 330, 332, 333, 334, 337, 340, 341, 342, 345, 368, 371, 376, 384, 385, 388, 393, 396, 399, 411, 414, 424, 555, 607, 613, 618, 646, 668, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693], "execut": [3, 6, 9, 17, 18, 19, 40, 52, 64, 84, 95, 101, 124, 125, 132, 133, 135, 140, 141, 142, 143, 144, 145, 148, 150, 151, 152, 153, 154, 155, 163, 165, 166, 215, 253, 254, 272, 288, 289, 290, 291, 292, 294, 295, 296, 297, 298, 311, 312, 315, 316, 317, 318, 328, 329, 343, 345, 346, 350, 352, 354, 359, 363, 366, 368, 369, 371, 377, 378, 387, 388, 396, 411, 423, 466, 468, 469, 555, 689, 697], "event": [3, 9, 20, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 160, 246, 276, 287, 344, 395], "notif": [3, 26, 27, 40, 52, 64, 70, 74, 80, 84, 90, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 111, 114, 117, 246, 276, 287, 344, 395], "conform": [3, 15, 213, 473, 605], "spec": [3, 6, 256, 313, 429, 473, 545, 606], "server": [3, 4, 5, 6, 9, 13, 20, 24, 32, 34, 35, 36, 37, 38, 45, 47, 48, 49, 50, 56, 59, 60, 61, 62, 66, 70, 72, 74, 79, 80, 83, 84, 88, 90, 92, 94, 98, 99, 100, 101, 102, 103, 104, 105, 111, 114, 122, 129, 135, 136, 149, 153, 154, 155, 157, 160, 163, 164, 165, 166, 219, 220, 222, 223, 224, 227, 230, 231, 232, 251, 253, 254, 256, 257, 261, 266, 269, 274, 275, 277, 282, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 335, 336, 338, 340, 341, 342, 343, 344, 345, 346, 348, 350, 351, 352, 354, 358, 359, 360, 362, 363, 365, 367, 368, 369, 370, 371, 376, 377, 378, 381, 386, 387, 388, 389, 390, 391, 392, 395, 396, 399, 411, 433, 435, 452, 453, 454, 472, 474, 475, 481, 486, 494, 521, 523, 530, 532, 534, 536, 537, 538, 539, 540, 541, 543, 544, 545, 546, 557, 566, 601, 602, 603, 605, 606, 619, 620, 680, 681, 690, 691, 692, 693, 694, 696], "discoveri": [3, 545, 606], "And": [3, 227, 545, 606], "logic": [3, 13, 160, 166, 253, 254, 256, 260, 266, 274, 287, 288, 292, 328, 329, 344, 345, 371, 387, 388, 395, 396, 521], "receiv": [3, 5, 6, 8, 9, 13, 27, 28, 31, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 69, 72, 73, 78, 79, 83, 88, 89, 92, 93, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 108, 109, 110, 113, 116, 160, 231, 246, 261, 267, 274, 275, 276, 287, 317, 344, 395, 420, 422, 425, 426, 427, 428, 430, 431, 544, 568, 601, 605, 669, 694], "mongoc_apm_callbacks_t": [3, 14, 18, 25, 26, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 246, 276], "mongoc_apm_callbacks_new": [3, 14, 27], "set": [3, 4, 7, 8, 10, 11, 12, 20, 21, 27, 119, 121, 123, 124, 125, 126, 127, 135, 139, 141, 143, 145, 147, 153, 155, 157, 159, 160, 164, 165, 166, 168, 169, 170, 171, 174, 175, 176, 177, 178, 179, 181, 182, 186, 189, 190, 191, 194, 195, 196, 197, 198, 200, 201, 202, 203, 206, 207, 208, 211, 212, 213, 215, 219, 223, 224, 226, 231, 232, 239, 240, 241, 246, 247, 248, 249, 250, 253, 254, 257, 261, 272, 274, 275, 276, 277, 278, 279, 280, 281, 282, 284, 285, 286, 287, 288, 289, 291, 292, 294, 295, 296, 298, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 335, 336, 337, 338, 340, 341, 342, 343, 344, 345, 349, 350, 355, 356, 358, 359, 360, 361, 364, 365, 367, 368, 370, 371, 373, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 391, 392, 393, 395, 396, 399, 402, 403, 404, 405, 406, 414, 419, 420, 422, 423, 426, 427, 428, 430, 431, 435, 437, 448, 451, 453, 455, 456, 457, 458, 459, 460, 461, 465, 466, 467, 468, 469, 472, 473, 474, 486, 490, 491, 492, 493, 494, 502, 503, 505, 506, 517, 518, 519, 520, 523, 525, 527, 528, 531, 532, 555, 556, 557, 559, 560, 561, 565, 566, 567, 568, 569, 570, 571, 574, 577, 578, 581, 582, 584, 587, 588, 589, 597, 598, 599, 602, 607, 620, 628, 629, 630, 631, 632, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 675, 677, 678, 679, 683, 685, 687, 688, 689, 690, 691, 692, 693, 694, 696, 697], "callback": [3, 25, 26, 27, 28, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 79, 83, 88, 89, 92, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 108, 109, 127, 208, 246, 274, 275, 276, 283, 544, 605], "mongoc_client_set_apm_callback": [3, 14, 27, 29, 43, 54, 65, 71, 76, 82, 86, 91, 107, 112, 115, 286], "mongoc_client_pool_set_apm_callback": [3, 14, 27, 29, 43, 54, 65, 71, 76, 82, 86, 91, 107, 112, 115, 251], "gcc": [3, 10, 12, 20, 24, 251, 253, 272, 273, 274, 286, 288, 366, 474, 607, 696], "o": [3, 8, 10, 12, 24, 171, 251, 253, 272, 273, 274, 286, 288, 366, 474, 487, 495, 588, 602, 603, 607, 696], "pkg": [3, 10, 12, 20, 24, 251, 253, 272, 273, 274, 286, 288, 366, 607], "config": [3, 10, 12, 20, 24, 251, 253, 272, 273, 274, 286, 288, 366, 523, 607], "cflag": [3, 10, 12, 24, 251, 253, 272, 273, 274, 286, 288, 366, 474, 607, 696], "lib": [3, 10, 12, 24, 251, 253, 272, 273, 274, 286, 288, 366, 607, 696, 697], "libmongoc": [3, 4, 8, 10, 12, 13, 14, 16, 21, 24, 127, 160, 161, 168, 208, 218, 239, 251, 253, 254, 265, 272, 273, 274, 286, 288, 329, 366, 388, 415, 416, 417, 418, 427, 431, 607, 669, 695], "connection_str": [3, 251, 253, 272, 273, 274, 286, 288, 366, 607, 696], "typedef": [3, 22, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 131, 151, 160, 177, 191, 198, 208, 211, 217, 218, 251, 274, 275, 286, 301, 339, 366, 394, 397, 429, 450, 451, 462, 473, 475, 478, 481, 484, 486, 487, 494, 507, 522, 523, 544, 547, 572, 574, 576, 583, 593, 594, 596, 605, 607, 619, 620, 669], "struct": [3, 8, 21, 26, 119, 131, 151, 160, 177, 191, 198, 211, 217, 218, 231, 250, 251, 273, 274, 282, 285, 286, 293, 301, 339, 366, 372, 394, 429, 450, 451, 462, 473, 475, 478, 481, 484, 487, 492, 505, 530, 531, 544, 546, 547, 548, 554, 559, 561, 565, 572, 574, 576, 583, 593, 594, 596, 601, 605, 607, 608, 616, 617, 618, 669, 687, 688, 689, 690, 691, 692, 693, 696], "succeed": [3, 64, 90, 420, 422, 430, 431, 696], "stats_t": 3, "command_start": 3, "mongoc_apm_command_started_t": [3, 14, 18, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 96], "bson_as_relaxed_extended_json": [3, 160, 342], "mongoc_apm_command_started_get_command": [3, 14, 52], "mongoc_apm_command_started_get_command_nam": [3, 14, 52], "mongoc_apm_command_started_get_host": [3, 14, 52], "mongoc_apm_command_started_get_context": [3, 14, 52], "command_succeed": 3, "mongoc_apm_command_succeeded_t": [3, 14, 18, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 97], "mongoc_apm_command_succeeded_get_repli": [3, 14, 64], "mongoc_apm_command_succeeded_get_command_nam": [3, 14, 64], "mongoc_apm_command_succeeded_get_context": [3, 14, 64], "command_fail": 3, "mongoc_apm_command_failed_t": [3, 14, 18, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 95], "mongoc_apm_command_failed_get_error": [3, 14, 40], "mongoc_apm_command_failed_get_command_nam": [3, 14, 40], "mongoc_apm_command_failed_get_context": [3, 14, 40], "stat": [3, 5], "127": [3, 251, 253, 272, 273, 274, 286, 288, 313, 366, 473, 607, 696], "cmd": [3, 253, 288, 291], "collection_nam": [3, 12, 24, 286, 312, 317, 366], "mongoc_apm_set_command_started_cb": [3, 14, 27], "mongoc_apm_set_command_succeeded_cb": [3, 14, 27], "mongoc_apm_set_command_failed_cb": [3, 14, 27], "context": [3, 29, 36, 37, 43, 54, 65, 71, 76, 82, 86, 91, 107, 112, 115, 246, 274, 276], "pointer": [3, 29, 43, 54, 65, 71, 76, 82, 86, 91, 107, 112, 115, 127, 175, 199, 208, 221, 246, 260, 267, 276, 283, 313, 325, 350, 455, 476, 479, 482, 499, 503, 533, 594, 632, 672, 683], "mongoc_collection_drop": [3, 7, 14, 339, 342, 414], "mongoc_collection_insert_mani": [3, 14, 323, 324, 326, 339], "duplic": [3, 6, 13, 481, 694], "kei": [3, 4, 6, 7, 8, 12, 13, 17, 21, 23, 122, 124, 125, 126, 128, 129, 130, 144, 145, 152, 153, 154, 155, 169, 170, 171, 174, 175, 176, 179, 187, 188, 200, 201, 202, 206, 207, 209, 210, 212, 213, 218, 253, 288, 296, 299, 300, 301, 310, 327, 481, 517, 521, 625, 669, 694, 696], "insert": [3, 5, 7, 9, 10, 12, 13, 24, 138, 139, 145, 153, 155, 160, 170, 181, 220, 222, 253, 272, 274, 288, 298, 323, 324, 325, 326, 334, 339, 342, 345, 396, 410, 429, 486, 555, 607, 669], "mongoc_collection_insert_on": [3, 7, 13, 14, 160, 272, 274, 288, 323, 325, 334, 339, 342, 345, 396, 555, 607, 696], "mongoc_apm_callbacks_destroi": [3, 14, 26, 27], "nsucceed": 3, "nfail": 3, "program": [3, 5, 9, 12, 18, 19, 20, 21, 24, 162, 251, 279, 280, 282, 284, 289, 290, 297, 298, 312, 315, 316, 317, 327, 346, 368, 369, 378, 485, 495, 648, 650], "print": [3, 11, 13, 22, 312, 313, 317, 350, 696], "nindexeswa": 3, "ok": [3, 12, 24, 253, 288, 350, 359, 360, 408, 409, 410, 412, 413, 414, 696], "writeerror": [3, 6, 303, 304, 325, 326, 333, 341, 342], "index": [3, 6, 7, 13, 16, 18, 121, 141, 143, 145, 153, 155, 181, 182, 185, 186, 189, 197, 198, 289, 295, 299, 300, 301, 303, 304, 307, 308, 309, 310, 315, 316, 327, 333, 341, 342, 368, 399, 476, 478, 479, 481, 482, 484, 642], "code": [3, 6, 7, 12, 13, 19, 20, 22, 24, 36, 48, 60, 132, 133, 166, 219, 223, 224, 232, 253, 254, 260, 262, 272, 274, 288, 289, 292, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 308, 309, 310, 311, 312, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 332, 333, 334, 338, 341, 342, 343, 345, 350, 357, 359, 368, 371, 376, 377, 378, 380, 381, 387, 388, 396, 397, 398, 399, 424, 466, 467, 468, 481, 487, 499, 540, 547, 549, 554, 607, 628, 636, 639, 642, 672, 675, 687, 696, 697], "11000": [3, 6], "errmsg": [3, 6, 350], "output": [3, 10, 12, 20, 148, 171, 208, 254, 287, 289, 295, 298, 303, 304, 311, 313, 314, 325, 326, 329, 333, 341, 342, 344, 368, 388, 395, 399, 408, 409, 410, 412, 413, 414, 628], "been": [3, 5, 20, 21, 124, 125, 158, 227, 238, 244, 264, 265, 267, 271, 273, 285, 312, 347, 348, 358, 437, 448, 491, 498, 503, 505, 506, 511, 514, 523, 547, 554, 561, 563, 595, 619, 628, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 679, 683, 687, 688, 689, 690, 691, 692, 693, 694, 696], "edit": [3, 4, 697], "format": [3, 8, 18, 22, 128, 176, 209, 413, 418, 696], "clariti": 3, "your": [3, 4, 5, 8, 9, 11, 13, 18, 19, 20, 21, 22, 162, 286, 323, 325, 326, 473, 485, 486, 495, 521, 561, 620, 669, 691, 697], "metadata": [3, 4, 426, 427, 430, 431, 445, 451, 461, 462, 471], "databas": [3, 4, 6, 12, 24, 44, 126, 163, 164, 165, 166, 168, 171, 207, 219, 220, 222, 223, 224, 225, 226, 239, 251, 253, 254, 272, 274, 279, 284, 288, 292, 328, 329, 331, 332, 345, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 414, 424, 506, 521, 607, 626, 658, 669, 694, 696], "session": [3, 4, 11, 13, 147, 166, 219, 224, 253, 254, 255, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 285, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 547, 548, 550, 551, 552, 553, 554, 555, 556, 557, 607, 619], "id": [3, 4, 5, 33, 35, 36, 37, 38, 39, 46, 47, 48, 49, 50, 51, 57, 59, 60, 61, 62, 63, 69, 73, 93, 110, 113, 116, 135, 136, 149, 165, 166, 169, 171, 219, 224, 227, 230, 253, 254, 260, 262, 266, 269, 274, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 328, 329, 332, 345, 352, 354, 359, 360, 363, 368, 371, 376, 378, 381, 387, 388, 396, 420, 422, 425, 426, 427, 430, 431, 442, 459, 473, 539], "cluster": [3, 7, 39, 51, 63, 227, 258, 286, 517, 521, 669, 696], "shown": 3, "here": [3, 10, 12, 20, 171, 287, 317, 344, 395, 521, 572], "consid": [3, 5, 8, 12, 22, 135, 163, 164, 165, 166, 219, 223, 224, 253, 254, 287, 288, 289, 290, 291, 292, 294, 295, 296, 302, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 333, 334, 340, 341, 342, 344, 345, 368, 369, 370, 371, 377, 378, 380, 381, 387, 388, 395, 396, 422, 423, 465, 466, 467, 468, 469, 521, 576, 593, 630, 631, 669, 694, 696], "despit": [3, 272], "becaus": [3, 12, 13, 241, 358], "overal": [3, 6, 104, 111], "server_changed_ev": 3, "server_opening_ev": 3, "server_closed_ev": 3, "topology_changed_ev": 3, "topology_opening_ev": 3, "topology_closed_ev": 3, "heartbeat_started_ev": 3, "heartbeat_succeeded_ev": 3, "heartbeat_failed_ev": 3, "server_chang": 3, "mongoc_apm_server_changed_t": [3, 14, 18, 65, 66, 67, 68, 69, 98], "prev_sd": 3, "new_sd": 3, "mongoc_apm_server_changed_get_context": [3, 14, 70], "mongoc_apm_server_changed_get_previous_descript": [3, 14, 70], "mongoc_apm_server_changed_get_new_descript": [3, 14, 70], "mongoc_apm_server_changed_get_host": [3, 14, 70], "host_and_port": [3, 12, 24, 231, 475], "mongoc_server_description_typ": [3, 14, 227, 544], "server_open": 3, "mongoc_apm_server_opening_t": [3, 14, 18, 91, 92, 93, 103], "mongoc_apm_server_opening_get_context": [3, 14, 94], "open": [3, 5, 9, 10, 20, 94, 117, 160, 425, 426, 427, 429, 560, 582, 590, 697], "mongoc_apm_server_opening_get_host": [3, 14, 94], "server_clos": 3, "mongoc_apm_server_closed_t": [3, 14, 18, 71, 72, 73, 99], "mongoc_apm_server_closed_get_context": [3, 14, 74], "close": [3, 13, 21, 74, 114, 241, 273, 285, 422, 430, 431, 494, 547, 554, 560, 568, 577], "mongoc_apm_server_closed_get_host": [3, 14, 74], "topology_chang": 3, "mongoc_apm_topology_changed_t": [3, 14, 18, 104, 107, 108, 109, 110], "prev_td": 3, "new_td": 3, "size_t": [3, 7, 160, 231, 301, 325, 452, 464, 546, 568, 569, 570, 575, 587, 588, 598, 599, 601, 696], "n_prev_sd": 3, "n_new_sd": 3, "pref": [3, 7, 256, 286, 350, 366, 515, 602, 666], "mongoc_apm_topology_changed_get_context": [3, 14, 111], "mongoc_apm_topology_changed_get_previous_descript": [3, 14, 111], "mongoc_topology_description_get_serv": [3, 14, 605], "mongoc_apm_topology_changed_get_new_descript": [3, 14, 111], "topologi": [3, 9, 69, 73, 93, 104, 105, 110, 111, 113, 114, 116, 117, 230, 231, 600, 601, 602, 603, 606, 669], "mongoc_topology_description_typ": [3, 14, 605], "previou": [3, 9, 68, 109, 255, 358, 555], "mongoc_server_description_host": [3, 14, 231, 544], "new": [3, 5, 7, 8, 9, 13, 15, 26, 36, 48, 60, 67, 94, 103, 108, 119, 121, 122, 127, 132, 133, 158, 170, 171, 173, 175, 176, 182, 184, 186, 189, 190, 192, 193, 194, 195, 196, 197, 198, 203, 205, 208, 213, 216, 223, 226, 232, 235, 236, 237, 241, 242, 243, 249, 251, 258, 259, 274, 281, 283, 294, 296, 297, 298, 299, 300, 302, 310, 312, 313, 315, 317, 324, 331, 332, 333, 334, 338, 341, 342, 343, 357, 358, 359, 365, 367, 373, 377, 379, 380, 397, 409, 413, 414, 424, 426, 427, 429, 430, 431, 432, 433, 451, 481, 506, 516, 530, 540, 548, 553, 554, 567, 575, 581, 582, 586, 592, 608, 614, 636, 639, 642, 649, 655, 656, 658, 660, 661, 662, 663, 664, 667, 669, 675, 687, 696, 697], "mongoc_read_prefs_new": [3, 12, 14, 253, 273, 288, 317, 520, 521], "mongoc_read_secondari": [3, 12, 253, 273, 288, 317, 507, 520, 521], "safe": [3, 9, 11, 218, 219, 223, 224, 238, 240, 241, 244, 245, 251, 252, 253, 274, 286, 287, 289, 294, 295, 296, 309, 311, 312, 315, 316, 317, 328, 332, 344, 366, 368, 377, 378, 380, 381, 387, 395, 422, 423, 429, 454, 462, 464, 465, 466, 467, 468, 469, 473, 580, 669, 696], "unfortun": 3, "necessari": [3, 6, 7, 9, 20, 273, 283, 312, 544], "cast": 3, "awai": 3, "mongoc_topology_description_has_readable_serv": [3, 14, 605], "secondari": [3, 9, 12, 273, 494, 512, 518, 521, 669], "els": [3, 6, 9, 12, 23, 24, 160, 224, 253, 272, 274, 288, 291, 294, 295, 296, 309, 311, 381, 399, 408, 409, 410, 411, 412, 413, 414, 473, 487, 520, 550, 587, 607, 628, 696], "unavail": [3, 521, 669], "mongoc_topology_description_has_writable_serv": [3, 14, 605], "primari": [3, 9, 13, 166, 176, 253, 256, 272, 273, 280, 288, 289, 292, 317, 328, 336, 368, 371, 387, 392, 473, 521, 603, 607, 669], "mongoc_read_prefs_destroi": [3, 12, 14, 253, 273, 288, 509, 516, 520, 521], "mongoc_server_descriptions_destroy_al": [3, 14, 231, 544, 601], "topology_open": 3, "mongoc_apm_topology_opening_t": [3, 14, 18, 106, 115, 116], "mongoc_apm_topology_opening_get_context": [3, 14, 117], "topology_clos": 3, "mongoc_apm_topology_closed_t": [3, 14, 18, 105, 112, 113], "mongoc_apm_topology_closed_get_context": [3, 14, 114], "server_heartbeat_start": 3, "mongoc_apm_server_heartbeat_started_t": [3, 14, 18, 81, 82, 83, 101], "mongoc_apm_server_heartbeat_started_get_context": [3, 14, 84], "heartbeat": [3, 75, 80, 81, 84, 85, 90], "mongoc_apm_server_heartbeat_started_get_host": [3, 14, 84], "server_heartbeat_succeed": 3, "mongoc_apm_server_heartbeat_succeeded_t": [3, 14, 18, 85, 86, 87, 88, 89, 102], "mongoc_apm_server_heartbeat_succeeded_get_context": [3, 14, 90], "mongoc_apm_server_heartbeat_succeeded_get_repli": [3, 14, 90], "mongoc_apm_server_heartbeat_succeeded_get_host": [3, 14, 90], "server_heartbeat_fail": 3, "mongoc_apm_server_heartbeat_failed_t": [3, 14, 18, 75, 76, 77, 78, 79, 100], "mongoc_apm_server_heartbeat_failed_get_context": [3, 14, 80], "mongoc_apm_server_heartbeat_failed_get_error": [3, 14, 80], "mongoc_apm_server_heartbeat_failed_get_host": [3, 14, 80], "cb": [3, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 274, 275], "bson_initi": [3, 6, 7, 10, 12, 160, 251, 272, 378, 381, 399, 408, 409, 410, 411, 412, 413, 414, 520, 555, 557, 607, 659, 696], "mongoc_apm_set_server_changed_cb": [3, 14, 27], "mongoc_apm_set_server_opening_cb": [3, 14, 27], "mongoc_apm_set_server_closed_cb": [3, 14, 27], "mongoc_apm_set_topology_changed_cb": [3, 14, 27], "mongoc_apm_set_topology_opening_cb": [3, 14, 27], "mongoc_apm_set_topology_closed_cb": [3, 14, 27], "mongoc_apm_set_server_heartbeat_started_cb": [3, 14, 27], "mongoc_apm_set_server_heartbeat_succeeded_cb": [3, 14, 27], "mongoc_apm_set_server_heartbeat_failed_cb": [3, 14, 27], "demand": [3, 9, 127, 208, 696], "bson_append_int32": [3, 251, 399, 409, 410, 411, 412, 414, 473, 696], "buildinfo": 3, "mongoc_client_command_simpl": [3, 14, 166, 231, 251, 253, 254, 286, 288, 292, 371, 694, 696], "admin": [3, 4, 251, 368, 414, 669, 696], "replica": [3, 10, 12, 13, 219, 223, 224, 231, 253, 280, 286, 287, 288, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 336, 344, 368, 377, 378, 380, 381, 387, 392, 395, 422, 423, 465, 466, 467, 468, 469, 473, 494, 521, 602, 694, 696], "r": [3, 10, 160, 231, 251, 272, 273, 309, 473, 555, 557, 607, 669, 696], "27018": [3, 12, 24, 160, 650], "replicasetnoprimari": [3, 606], "rsprimari": [3, 545], "27019": [3, 160, 650], "replicasetwithprimari": [3, 606], "rssecondari": [3, 545], "were": [3, 21, 158, 171, 521, 569, 574, 625, 627, 696], "determin": [3, 4, 7, 13, 159, 361, 366, 412, 602, 603, 669], "also": [3, 4, 6, 7, 8, 9, 12, 18, 19, 20, 160, 182, 212, 247, 255, 274, 275, 332, 343, 358, 364, 473, 521, 532, 557, 574, 652, 658, 664, 667, 669, 696, 697], "discov": [3, 9, 669], "third": [3, 6], "cover": [4, 521], "ensur": [4, 5, 7, 8, 20, 231, 246, 250, 258, 259, 276, 283, 359, 360, 515, 696], "properli": [4, 312], "make": [4, 6, 13, 18, 20, 22, 253, 288, 296, 413, 414, 429, 433, 515, 521, 574, 669, 697], "secur": [4, 7, 122, 129, 175, 495], "sever": [4, 20, 160, 462, 696], "mechan": [4, 495], "By": [4, 6, 8, 21, 273, 285, 340, 547, 554, 620, 669, 694], "an": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 20, 22, 23, 24, 40, 52, 64, 70, 74, 75, 80, 81, 84, 85, 90, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 111, 114, 117, 122, 123, 124, 125, 127, 128, 129, 135, 138, 139, 141, 143, 144, 145, 147, 149, 151, 152, 153, 154, 155, 156, 157, 159, 160, 163, 164, 165, 166, 168, 169, 170, 171, 174, 176, 179, 181, 182, 186, 189, 190, 194, 195, 196, 197, 200, 201, 208, 209, 212, 213, 219, 223, 224, 226, 227, 230, 231, 232, 235, 236, 237, 239, 242, 243, 246, 247, 248, 251, 253, 254, 255, 256, 257, 258, 259, 260, 261, 272, 274, 275, 276, 277, 278, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 299, 300, 301, 302, 303, 304, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 347, 349, 350, 359, 360, 361, 363, 366, 367, 368, 369, 370, 371, 372, 373, 375, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 395, 396, 399, 402, 405, 406, 408, 410, 411, 419, 424, 426, 427, 428, 429, 430, 431, 433, 435, 437, 442, 448, 452, 453, 454, 459, 463, 464, 466, 467, 468, 472, 473, 474, 486, 488, 494, 496, 497, 499, 505, 521, 539, 544, 555, 556, 557, 558, 561, 566, 567, 569, 576, 582, 601, 605, 620, 623, 624, 625, 626, 628, 629, 630, 631, 632, 634, 638, 647, 650, 651, 652, 653, 654, 660, 661, 662, 663, 669, 670, 672, 675, 677, 680, 682, 684, 687, 688, 689, 690, 691, 692, 693, 696], "thei": [4, 5, 6, 9, 10, 12, 21, 127, 208, 241, 250, 255, 273, 282, 339, 394, 486, 487, 494, 495, 522, 523, 620, 669, 694, 696], "select": [4, 9, 20, 141, 142, 143, 144, 145, 152, 153, 154, 155, 227, 256, 412, 512, 518, 521, 697], "below": [4, 20, 22, 171, 185, 274, 312, 650, 696], "authsourc": [4, 624, 650, 656, 669], "mydb": [4, 650, 696], "current": [4, 8, 13, 20, 128, 158, 160, 189, 208, 209, 213, 232, 258, 259, 270, 287, 336, 343, 344, 347, 389, 390, 392, 395, 455, 463, 474, 502, 521, 534, 553, 560, 563, 569, 594, 602, 603, 619, 669], "authmechan": [4, 623, 628, 650, 655, 659, 669], "deprec": [4, 15, 36, 48, 60, 132, 133, 223, 232, 241, 294, 296, 297, 299, 300, 302, 310, 312, 315, 324, 334, 338, 343, 357, 359, 377, 380, 397, 465, 466, 481, 525, 532, 540, 636, 639, 642, 675, 687], "x509": 4, "introduc": [4, 13, 254, 329, 388, 695], "protocol": [4, 5, 8, 35, 47, 59, 312, 366, 486, 494, 522, 523, 567, 620, 669, 695], "hash": [4, 696], "describ": [4, 6, 7, 20, 176, 213, 227, 256, 288, 345, 396, 507, 619, 669], "7677": 4, "mean": [4, 6, 10, 13, 272, 351, 360, 361, 366, 521, 607, 696], "never": [4, 10, 287, 289, 290, 312, 315, 316, 317, 344, 350, 368, 369, 378, 395, 669], "actual": [4, 9, 136, 241, 352, 354, 358, 669, 697], "sent": [4, 5, 6, 40, 52, 64, 70, 74, 80, 84, 90, 94, 111, 114, 117, 277, 295, 312, 335, 391, 399, 474, 506, 521, 532, 557, 569, 570, 619], "over": [4, 6, 12, 20, 157, 287, 344, 395], "wire": [4, 5, 35, 47, 59, 312, 366, 486, 494, 522, 523, 620, 669], "rather": [4, 9, 20, 494, 495, 669], "comput": [4, 444], "proof": [4, 19], "know": [4, 13, 323, 325, 326, 486, 494, 620], "correct": [4, 279, 284, 337, 393, 629, 630, 631, 632], "negoti": [4, 366], "altern": [4, 8, 20, 169, 174, 176, 187, 201, 212, 669, 696], "explicitli": [4, 7, 24, 312, 317, 335, 391, 492, 506, 521, 685], "undergo": 4, "preprocess": 4, "step": [4, 12, 18, 20], "known": [4, 13, 18, 20, 223, 224, 231, 506, 601, 602, 603, 651, 652, 653, 654, 660, 661, 662, 663, 669], "saslprep": 4, "4013": 4, "perform": [4, 6, 7, 9, 10, 14, 18, 22, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 120, 138, 139, 152, 154, 168, 178, 181, 227, 239, 241, 246, 251, 253, 274, 276, 293, 294, 296, 297, 313, 324, 328, 340, 341, 342, 372, 387, 389, 390, 391, 392, 393, 424, 452, 464, 486, 494, 500, 515, 542, 544, 561, 568, 570, 576, 580, 587, 588, 598, 599, 602, 603, 604, 605, 620, 669, 671, 673, 675, 687, 696, 697], "non": [4, 8, 9, 186, 196, 197, 274, 294, 296, 303, 304, 317, 323, 325, 326, 327, 341, 342, 429, 466, 556, 588, 594, 599, 607, 630, 631, 669], "ascii": 4, "charact": [4, 199, 221, 424, 670], "libicu": 4, "link": [4, 8, 18, 20, 32, 45, 56, 66, 72, 79, 83, 88, 92, 475, 627], "enable_icu": 4, "icu_root": 4, "findicu": 4, "5802": 4, "against": [4, 6, 7, 8, 10, 122, 124, 125, 129, 275, 287, 344, 395, 671, 696], "anoth": [4, 8, 9, 11, 13, 20, 160, 244, 258, 259, 563, 669], "longer": [4, 220, 222, 230, 235, 236, 237, 242, 243, 277, 285, 287, 289, 290, 293, 297, 298, 312, 315, 316, 317, 344, 346, 368, 369, 372, 377, 378, 395, 407, 433, 449, 465, 467, 468, 469, 500, 504, 524, 542, 562, 567, 574, 575, 581, 582, 592, 604, 649, 673, 686, 695], "instead": [4, 7, 122, 129, 160, 167, 232, 241, 252, 253, 279, 280, 282, 284, 294, 296, 312, 317, 328, 334, 338, 343, 359, 387, 465, 466, 494, 505, 630, 687, 688, 689, 690, 691, 692, 693, 696, 697], "compat": [4, 8, 13, 19, 136, 149, 294, 296, 302, 330, 352, 359, 360, 363, 364, 368, 506, 521], "unix": [4, 8, 446, 558, 559, 561, 581, 583, 594, 669], "cyru": [4, 20, 669], "window": [4, 558, 559, 560, 561, 572, 696], "sspi": 4, "modifi": [4, 28, 32, 34, 39, 41, 42, 44, 45, 51, 53, 56, 58, 63, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 137, 154, 155, 158, 199, 215, 221, 228, 229, 233, 234, 313, 314, 317, 318, 319, 320, 321, 322, 347, 382, 383, 384, 385, 400, 407, 412, 413, 414, 438, 440, 441, 442, 444, 445, 454, 464, 470, 471, 477, 480, 483, 486, 494, 503, 511, 514, 538, 573, 580, 620, 623, 624, 625, 626, 627, 628, 632, 633, 634, 635, 636, 637, 638, 643, 645, 646, 679, 683, 694], "enable_sasl": 4, "enterpris": [4, 7, 168, 239, 253, 288, 697], "kinit": 4, "method": [4, 6, 7, 238, 249, 251, 255, 274, 281, 311, 473, 669, 697], "mongodbus": 4, "com": [4, 10, 20, 128, 176, 209, 628, 650, 659, 669], "klistcredenti": 4, "file": [4, 7, 8, 11, 12, 13, 20, 24, 123, 160, 225, 226, 420, 422, 423, 424, 425, 426, 427, 429, 430, 431, 432, 433, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 577, 580, 581, 582, 583, 586, 587, 696, 697], "krb5cc_1000": 4, "princip": 4, "expir": [4, 8, 13, 244, 568, 569, 669], "feb": 4, "13": 4, "48": [4, 272, 274, 607], "51": 4, "2013": [4, 20], "23": [4, 127, 208, 410, 414], "krbtgt": 4, "now": [4, 6, 7, 12, 20, 24, 136, 149, 272, 274, 352, 363, 505, 607, 687, 688, 689, 690, 691, 692, 693, 697], "extern": [4, 128, 209], "virtual": 4, "40exampl": [4, 650], "properti": [4, 7, 129, 628, 659, 697], "canonicalize_host_nam": [4, 628, 659], "differ": [4, 20, 171, 194, 195, 196, 197, 227, 312, 350, 487, 495, 521, 696, 697], "what": [4, 12, 13, 20, 22, 241, 429, 694], "fals": [4, 6, 7, 8, 11, 12, 13, 24, 122, 123, 129, 135, 139, 141, 143, 145, 153, 155, 159, 160, 163, 164, 165, 166, 168, 169, 170, 178, 179, 181, 182, 200, 201, 208, 212, 213, 219, 223, 224, 232, 239, 246, 247, 248, 249, 251, 253, 254, 257, 260, 261, 271, 272, 274, 275, 276, 277, 278, 281, 287, 288, 289, 291, 292, 294, 295, 296, 298, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 349, 350, 361, 363, 364, 367, 368, 370, 371, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 395, 396, 399, 408, 409, 410, 411, 412, 413, 414, 419, 420, 422, 423, 428, 430, 431, 435, 437, 448, 453, 454, 459, 465, 466, 467, 468, 469, 472, 474, 490, 493, 499, 505, 517, 521, 533, 550, 552, 555, 557, 628, 651, 655, 656, 657, 658, 659, 662, 664, 667, 669, 672, 696], "service_nam": [4, 628, 659], "servic": [4, 13, 39, 51, 63, 128, 130, 170, 176, 209, 210, 641, 659, 669], "authmechanismproperti": [4, 628, 659, 669], "encount": [4, 13, 287, 311, 344, 395, 587, 590], "net": [4, 176], "address": [4, 567, 669], "applic": [4, 5, 7, 9, 10, 12, 13, 14, 15, 17, 18, 20, 22, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 123, 149, 160, 227, 238, 241, 246, 247, 256, 265, 276, 277, 279, 283, 284, 311, 312, 333, 337, 341, 342, 359, 360, 362, 363, 364, 365, 393, 506, 521, 544, 602, 603, 605, 669, 694, 696, 697], "behind": [4, 13, 39, 51, 63, 669], "nat": 4, "network": [4, 5, 6, 10, 13, 22, 34, 153, 155, 164, 165, 166, 219, 223, 224, 232, 253, 254, 257, 261, 272, 287, 288, 289, 291, 292, 294, 295, 296, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 350, 366, 367, 368, 370, 371, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 395, 396, 422, 423, 433, 435, 453, 465, 466, 467, 468, 469, 472, 567, 590, 595, 607, 669, 694], "translat": 4, "firewal": 4, "ticket": 4, "forward": [4, 24, 135], "addressless": 4, "done": [4, 10, 24, 272, 273, 274, 607, 696], "f": [4, 11, 12, 171, 226, 424, 473], "deleg": 4, "ldap": [4, 20], "veri": 4, "similar": [4, 20, 157, 159, 287, 294, 296, 344, 395, 566, 694, 696], "challeng": 4, "respons": [4, 8, 9, 12, 13, 19, 36, 37, 48, 49, 60, 61, 160, 162, 163, 164, 165, 227, 246, 274, 276, 283, 291, 350, 359, 369, 370, 485, 521, 537, 540, 669, 694], "clear": [4, 7, 127, 208, 255, 276, 386, 563, 657], "text": [4, 457], "strongli": 4, "tl": [4, 5, 13, 14, 16, 18, 20, 130, 210, 250, 282, 283, 367, 574, 590, 594, 596, 642, 644, 650, 651, 697], "valid": [4, 7, 8, 28, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 129, 135, 139, 141, 143, 145, 146, 151, 153, 155, 158, 159, 171, 185, 199, 221, 246, 250, 264, 266, 268, 276, 277, 282, 283, 289, 294, 296, 302, 303, 304, 325, 326, 330, 333, 341, 342, 343, 361, 368, 399, 408, 409, 412, 413, 414, 474, 486, 515, 517, 533, 551, 574, 586, 611, 612, 613, 620, 632, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 664, 667, 669], "onc": [4, 7, 9, 12, 17, 19, 20, 21, 135, 151, 160, 162, 219, 223, 224, 238, 246, 247, 248, 249, 250, 253, 281, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 474, 485, 491, 521, 574, 669], "deriv": [4, 15, 21, 147, 429], "distinguish": 4, "dure": [4, 5, 22, 124, 125, 206, 324, 474, 522, 557], "ssl_opt": 4, "pem_fil": [4, 8, 250, 282, 574], "mycert": 4, "pem_pwd": [4, 8, 250, 282, 574], "mycertpassword": 4, "ca_fil": [4, 8, 250, 282, 574], "myca": 4, "ca_dir": [4, 8, 250, 282, 574], "trust_dir": 4, "weak_cert_valid": [4, 8, 574], "x509_derived_usernam": 4, "mongoc_client_set_ssl_opt": [4, 8, 14, 250, 286, 574, 669], "none": [4, 13, 145, 153, 155, 225, 317, 502, 669], "ident": [4, 247, 250, 252, 588], "access": [4, 5, 7, 28, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 150, 160, 217, 274, 286, 339, 359, 360, 366, 367, 389, 394, 454, 464, 495, 521, 696], "manag": [4, 5, 14, 16, 17, 18, 128, 130, 170, 176, 209, 210, 274, 286, 291, 299, 300, 301, 308, 310, 316, 327, 370, 481, 642, 696], "amazon": [4, 176], "resourc": [4, 19, 162, 167, 172, 176, 180, 183, 192, 204, 214, 238, 255, 262, 305, 348, 374, 400, 434, 436, 447, 485, 501, 510, 536, 562, 579, 600, 622, 674], "arn": [4, 176], "sinc": [4, 6, 9, 36, 48, 60, 132, 133, 160, 223, 232, 241, 251, 273, 294, 296, 297, 299, 300, 302, 310, 312, 315, 324, 334, 338, 343, 357, 358, 359, 377, 380, 397, 446, 465, 466, 481, 540, 541, 636, 639, 642, 669, 675, 687], "alwai": [4, 13, 15, 19, 21, 135, 164, 166, 170, 178, 181, 182, 232, 253, 254, 261, 288, 289, 290, 292, 300, 305, 312, 313, 314, 315, 316, 317, 328, 329, 338, 343, 345, 368, 369, 371, 378, 387, 388, 396, 442, 473, 491], "secret": 4, "token": [4, 13, 158, 160], "obtain": [4, 7, 12, 20, 23, 24, 122, 129, 160, 166, 167, 199, 206, 219, 221, 224, 227, 238, 253, 254, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 328, 329, 332, 345, 368, 371, 376, 378, 381, 387, 388, 396, 696], "wai": [4, 9, 10, 13, 20, 171, 521, 620, 696], "aws_session_token": 4, "variabl": [4, 5, 7, 11, 563], "aws_access_key_id": 4, "aws_secret_access_kei": 4, "aws_container_credentials_relative_uri": 4, "retriev": [4, 7, 10, 124, 125, 136, 163, 228, 229, 234, 244, 247, 250, 251, 286, 287, 294, 296, 338, 344, 351, 352, 354, 356, 364, 366, 383, 385, 395, 425, 426, 427, 428, 448, 452, 454, 464, 471, 494, 560, 565, 569, 591, 696], "temporari": [4, 272, 544, 605, 607], "task": [4, 14, 16, 18], "machin": [4, 8, 12, 24], "mongoc_uri_get_auth_mechan": [4, 14, 624, 628, 655, 656, 659, 669], "mongoc_uri_get_auth_sourc": [4, 14, 623, 628, 655, 656, 659, 669], "mongoc_uri_get_mechanism_properti": [4, 14, 623, 624, 655, 656, 659, 669], "mongoc_uri_set_auth_mechan": [4, 14, 623, 624, 628, 656, 659, 669], "mongoc_uri_set_auth_sourc": [4, 14, 623, 624, 628, 655, 659, 669], "mongoc_uri_set_mechanism_properti": [4, 14, 623, 624, 628, 655, 656, 669], "short": [5, 696], "thing": [5, 12, 24], "have": [5, 6, 9, 11, 12, 13, 20, 124, 125, 145, 153, 155, 168, 219, 227, 238, 239, 250, 277, 282, 312, 315, 316, 324, 325, 360, 377, 378, 399, 408, 409, 412, 413, 427, 431, 442, 474, 503, 514, 541, 555, 628, 661, 669, 683, 688, 689, 690, 696, 697], "problem": [5, 473], "did": [5, 273], "call": [5, 6, 7, 9, 10, 12, 13, 19, 21, 22, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 127, 132, 133, 135, 136, 138, 139, 140, 141, 142, 143, 144, 145, 148, 149, 150, 151, 152, 153, 154, 155, 158, 159, 162, 163, 166, 167, 170, 171, 178, 181, 182, 208, 215, 219, 224, 232, 238, 240, 241, 244, 245, 246, 247, 248, 250, 251, 252, 253, 254, 255, 264, 272, 273, 274, 277, 279, 280, 282, 284, 285, 287, 288, 289, 290, 292, 293, 294, 295, 296, 297, 298, 301, 308, 309, 311, 312, 315, 316, 317, 327, 328, 329, 332, 344, 345, 346, 352, 361, 362, 363, 364, 365, 366, 367, 368, 369, 371, 372, 376, 377, 378, 381, 387, 388, 391, 392, 393, 395, 396, 399, 401, 409, 412, 413, 422, 426, 427, 430, 431, 456, 457, 458, 460, 461, 474, 477, 480, 483, 485, 491, 503, 505, 521, 547, 554, 555, 556, 562, 563, 565, 567, 579, 616, 617, 618, 648, 669, 683, 687, 688, 689, 690, 691, 692, 693, 696], "segfault": 5, "leak": [5, 10], "pid": 5, "deliv": 5, "egress": 5, "byte": [5, 7, 128, 175, 209, 223, 224, 380, 381, 443, 452, 464, 495, 496, 497, 568, 569, 570, 575, 578, 584, 587, 588, 597, 598, 599], "asan": 5, "show": [5, 7, 11, 160, 312, 350], "linger": 5, "alloc": [5, 11, 19, 135, 156, 162, 220, 222, 225, 231, 235, 236, 237, 242, 243, 274, 285, 287, 289, 290, 293, 297, 298, 312, 315, 316, 317, 344, 346, 348, 368, 369, 372, 373, 377, 378, 379, 395, 407, 423, 424, 432, 433, 449, 465, 466, 467, 468, 469, 474, 485, 500, 504, 509, 516, 524, 542, 558, 564, 575, 581, 582, 586, 592, 601, 604, 621, 628, 648, 649, 650, 670, 673, 686, 696], "own": [5, 9, 12, 22, 24, 160, 429, 470, 471, 473, 537, 538, 540, 635, 637, 646, 696], "copi": [5, 12, 20, 22, 24, 28, 31, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 78, 79, 83, 88, 89, 92, 108, 109, 158, 159, 246, 250, 258, 259, 272, 274, 276, 277, 282, 293, 346, 361, 372, 402, 405, 406, 474, 488, 500, 509, 524, 542, 548, 556, 574, 604, 608, 616, 617, 618, 621, 673], "denable_trac": [5, 22], "ON": [5, 11, 17, 20, 22], "trace": [5, 19, 162, 485], "hex": [5, 7, 22], "dump": [5, 22], "stdout": [5, 10, 22, 273, 286, 366, 473, 696], "come": [5, 6, 22, 296, 350, 521, 594], "uniqu": [5, 6, 7, 13, 174, 481, 521, 697], "featur": [5, 6, 7, 17, 20, 168, 185, 239, 250, 282, 296, 317, 584, 671, 695, 696], "help": [5, 20, 696, 697], "develop": [5, 7, 22, 241], "sysadmin": 5, "product": [5, 20], "outsid": [5, 630], "via": [5, 18, 21, 132, 133, 135, 138, 139, 140, 141, 142, 143, 144, 145, 152, 153, 155, 164, 166, 170, 218, 223, 224, 226, 232, 253, 254, 288, 291, 292, 294, 295, 296, 300, 301, 302, 303, 304, 308, 309, 310, 311, 313, 314, 315, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 345, 349, 350, 371, 373, 376, 377, 380, 381, 386, 387, 388, 389, 390, 396, 435, 437, 448, 453, 466, 467, 468, 472, 696], "memori": [5, 10, 19, 162, 274, 291, 370, 474, 485], "segment": 5, "graph": 5, "statist": [5, 338], "about": [5, 21, 34, 230, 273, 285, 312, 317, 338, 350, 473, 474, 506, 531, 532, 544, 547, 554, 669, 695, 696], "easili": [5, 160, 594], "tool": [5, 7, 20], "munin": 5, "nagio": 5, "watch": [5, 158, 160], "interv": [5, 9, 669], "5": [5, 6, 20, 160, 254, 272, 295, 311, 312, 317, 329, 388, 429, 465, 466, 474, 494, 557, 607, 652, 669], "monitor": [5, 9, 14, 18, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 227, 246, 276, 474, 544, 545, 602, 603, 605, 606], "linux": [5, 8, 20, 572], "platform": [5, 8, 18, 19, 474, 487, 558, 559, 561, 582, 696, 697], "maco": 5, "arm64": [5, 20], "denable_shm_count": 5, "off": [5, 8, 17, 19, 20, 160, 287, 344, 395], "addition": [5, 20, 160, 291, 521], "alreadi": [5, 13, 20, 208, 227, 272, 277, 486, 620, 655, 656, 660, 661, 662, 663], "disabl": [5, 7, 8, 21, 121, 273, 285, 311, 521, 547, 554, 555, 669], "runtim": [5, 11, 495], "environ": [5, 7, 18, 495, 697], "mongoc_disable_shm": 5, "track": [5, 354, 492, 696], "activ": [5, 9, 11, 227], "dispos": 5, "pool": [5, 14, 16, 18, 125, 167, 168, 238, 239, 240, 241, 244, 245, 246, 247, 248, 249, 250, 251, 252, 255, 262, 273, 278, 279, 280, 282, 284, 285, 286, 537, 539, 540, 547, 554, 574, 696], "socket": [5, 9, 286, 367, 389, 390, 487, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 572, 578, 589, 592, 593, 597, 669, 690, 692, 693, 697], "stream": [5, 13, 33, 46, 57, 156, 157, 158, 159, 160, 283, 287, 344, 395, 419, 422, 425, 426, 427, 428, 429, 430, 431, 433, 473, 494, 568, 576, 577, 578, 579, 580, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 595, 596, 597, 598, 599], "transfer": [5, 586, 592], "correspond": [5, 13, 188, 213, 219, 226, 315, 316, 377, 378, 486, 494, 522, 523, 620, 641], "written": [5, 20, 171, 312, 426, 427, 464, 598, 599, 678], "regardless": [5, 6, 253, 328, 387, 560], "whether": [5, 13, 75, 81, 85, 256, 265, 271, 309, 398, 490, 492, 521, 525, 527, 528, 531, 669, 685], "entir": [5, 8, 272, 274, 435, 607, 621], "ultim": 5, "handshak": [5, 227, 277, 474], "given": [5, 12, 123, 171, 179, 199, 200, 201, 213, 221, 251, 255, 274, 283, 286, 302, 303, 304, 313, 327, 330, 359, 360, 373, 389, 441, 455, 474, 533, 602, 669, 696], "22203": 5, "total": [5, 9, 12, 244, 669], "13247": 5, "ingress": 5, "13246": 5, "getmor": [5, 33, 46, 57, 160, 253, 328, 365, 387], "delet": [5, 132, 133, 141, 150, 179, 288, 302, 303, 304, 330, 339, 345, 396, 397, 420, 429, 522, 669], "updat": [5, 6, 9, 10, 13, 127, 150, 152, 153, 154, 155, 158, 208, 273, 274, 287, 288, 313, 314, 332, 333, 334, 339, 340, 341, 342, 344, 345, 395, 396, 399, 406, 408, 409, 410, 411, 412, 414, 537, 540, 541, 620, 655, 656, 660, 661, 662, 663, 669, 697], "killcursor": [5, 255], "msg": 5, "794931": 5, "589694": 5, "timeout": [5, 9, 10, 13, 21, 135, 159, 163, 164, 165, 166, 244, 254, 273, 274, 285, 288, 291, 292, 302, 313, 314, 323, 324, 325, 326, 329, 333, 334, 340, 341, 342, 345, 350, 365, 369, 370, 371, 388, 396, 547, 554, 558, 561, 569, 570, 586, 587, 588, 595, 598, 599, 615, 630, 631, 669, 680, 681, 690, 692, 693, 694], "auth": 5, "request": [5, 8, 20, 35, 47, 59, 176, 208, 251, 287, 289, 300, 308, 309, 317, 344, 362, 368, 395, 435, 520, 669, 696], "think": 5, "ve": [5, 10, 366], "pleas": [5, 20, 36, 48, 60, 132, 133, 223, 280, 297, 302, 315, 324, 334, 336, 357, 359, 377, 380, 392, 397, 507, 540, 636, 639, 642, 675, 687, 696], "case": [5, 6, 10, 12, 13, 20, 136, 232, 272, 274, 277, 309, 377, 386, 473, 607, 629, 630, 631, 632, 647, 651, 652, 653, 654, 660, 661, 662, 663, 669], "jira": 5, "account": [5, 253, 254, 288, 328, 329, 345, 387, 388, 396], "login": [5, 128, 209], "navig": 5, "cdriver": 5, "project": [5, 14, 16, 18, 20, 317], "click": [5, 697], "reproduc": 5, "e": [5, 6, 8, 10, 12, 15, 20, 170, 206, 274, 339, 359, 368, 491, 494, 521, 657, 669], "csharp": 5, "java": 5, "core": [5, 7], "explain": [6, 697], "take": [6, 8, 9, 253, 254, 260, 274, 288, 312, 328, 329, 345, 387, 388, 396, 399, 411, 414, 499, 532, 588, 669, 672], "advantag": [6, 20], "batch": [6, 151, 160, 290, 297, 298, 312, 317, 351, 358, 359, 362, 369], "reduc": [6, 12, 22, 168, 239], "round": [6, 351, 358, 362, 543, 669], "trip": [6, 351, 358, 362, 543, 669], "increas": 6, "throughput": 6, "fetch": [6, 137, 219, 231, 233, 315, 316, 319, 320, 321, 322, 347, 353, 354, 358, 377, 378, 380, 381, 382, 384, 413, 414, 438, 439, 440, 441, 442, 443, 444, 445, 446, 448, 511, 513, 514, 529, 570, 585, 601, 623, 624, 626, 627, 628, 633, 634, 635, 636, 637, 638, 642, 643, 644, 645, 646, 675, 676, 677, 678, 696], "handl": [6, 13, 19, 160, 162, 274, 289, 290, 297, 298, 312, 315, 316, 317, 339, 346, 368, 369, 378, 394, 424, 473, 485, 520, 572, 648, 650, 669, 694, 696], "mongoc_collection_create_bulk_operation_with_opt": [6, 12, 14, 24, 135, 297, 339], "until": [6, 9, 13, 136, 138, 139, 159, 231, 244, 274, 352, 354, 361, 366, 430, 431, 433, 632, 669, 694], "coalesc": 6, "singl": [6, 12, 124, 125, 133, 138, 139, 142, 143, 144, 145, 151, 154, 155, 167, 168, 206, 231, 286, 302, 325, 330, 340, 361, 474, 606, 620, 669, 696], "consecut": 6, "mongoc_bulk_operation_insert": [6, 12, 14, 24, 145, 151, 297, 298], "effect": [6, 8, 149, 171, 258, 259, 363, 364], "mongoc_bulk_operation_execut": [6, 12, 13, 14, 24, 132, 133, 136, 138, 139, 140, 141, 142, 143, 144, 145, 149, 151, 152, 153, 154, 155, 297, 298], "bulk1": 6, "assert": [6, 225, 473], "bool": [6, 7, 11, 12, 24, 75, 81, 85, 120, 121, 139, 141, 143, 144, 145, 146, 152, 153, 154, 155, 157, 159, 160, 161, 164, 165, 166, 168, 169, 170, 178, 179, 181, 182, 200, 201, 208, 212, 213, 231, 232, 239, 246, 247, 248, 249, 251, 253, 254, 256, 257, 260, 261, 265, 271, 272, 273, 274, 275, 276, 277, 278, 281, 288, 291, 292, 297, 299, 300, 301, 302, 303, 304, 306, 307, 308, 309, 310, 313, 314, 317, 323, 324, 325, 326, 328, 329, 330, 331, 332, 333, 334, 338, 340, 341, 342, 343, 345, 349, 350, 357, 358, 361, 363, 364, 367, 370, 371, 375, 376, 386, 387, 388, 389, 390, 396, 398, 399, 401, 408, 409, 410, 411, 412, 413, 414, 419, 420, 422, 428, 429, 430, 431, 435, 437, 448, 453, 454, 459, 472, 474, 481, 490, 493, 499, 503, 505, 515, 525, 531, 533, 550, 552, 555, 557, 574, 590, 595, 602, 603, 607, 628, 629, 642, 644, 647, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 667, 672, 675, 676, 678, 682, 683, 684, 685, 687, 688, 696], "ret": [6, 7, 12, 24, 251, 696], "10000": [6, 160, 253, 288], "mongoc_bulk_operation_destroi": [6, 12, 14, 24, 151, 297, 298], "ninsert": [6, 253, 288], "nmatch": 6, "nmodifi": 6, "nremov": 6, "nupsert": 6, "writeconcernerror": [6, 303, 304, 325, 326, 333, 341, 342], "remov": [6, 9, 22, 74, 99, 140, 141, 142, 143, 144, 145, 152, 153, 154, 155, 212, 303, 304, 313, 317, 330, 389, 390, 410, 453, 472, 522, 669, 694, 696, 697], "togeth": [6, 424, 486, 494, 522, 523, 620], "serial": 6, "bulk2": 6, "opt": [6, 7, 10, 23, 118, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 135, 139, 141, 143, 145, 153, 155, 160, 166, 168, 170, 171, 172, 174, 175, 176, 181, 182, 183, 185, 186, 187, 188, 189, 190, 203, 204, 206, 207, 208, 209, 210, 219, 224, 227, 239, 250, 253, 254, 260, 272, 273, 274, 282, 285, 287, 288, 289, 292, 295, 296, 298, 299, 300, 301, 303, 304, 308, 309, 310, 311, 314, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 344, 345, 359, 360, 368, 371, 373, 376, 378, 381, 387, 388, 395, 396, 399, 401, 402, 403, 404, 405, 406, 408, 409, 410, 411, 412, 413, 414, 423, 424, 426, 427, 430, 431, 432, 433, 468, 469, 473, 477, 480, 481, 483, 489, 490, 491, 493, 499, 548, 549, 550, 551, 552, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 615, 616, 617, 618, 669], "bson_new": [6, 7, 130, 210, 253, 272, 273, 274, 288, 607, 696], "mongoc_bulk_operation_remov": [6, 14, 132, 141, 151], "few": 6, "foo": [6, 11, 289, 312, 317, 520], "bar": [6, 289, 312, 317], "bcon_utf8": [6, 12, 24, 253, 288, 289, 296, 312, 317, 410, 414, 520, 696], "mongoc_bulk_operation_update_many_with_opt": [6, 14, 151, 152, 155], "inc": [6, 12, 24, 273, 399, 408, 409, 411, 414], "j": [6, 11, 669], "upsert": [6, 144, 145, 152, 153, 154, 155, 313, 333, 334, 341, 342, 410, 414, 620], "bcon_bool": [6, 7, 289, 317, 412, 413, 414, 696], "replac": [6, 123, 144, 145, 150, 171, 283, 286, 295, 333, 659, 697], "mongoc_bulk_operation_replace_one_with_opt": [6, 14, 144, 151], "base": [6, 13, 20, 171, 225, 286, 484, 504, 521, 585, 594, 635, 637, 646, 649, 669, 671, 686, 696], "sixth": 6, "its": [6, 8, 9, 12, 13, 15, 20, 21, 22, 24, 74, 99, 105, 114, 158, 160, 166, 219, 224, 226, 241, 251, 253, 254, 255, 262, 273, 285, 288, 289, 292, 293, 295, 296, 301, 305, 308, 309, 311, 316, 317, 328, 329, 332, 345, 358, 368, 371, 372, 376, 378, 381, 387, 388, 396, 420, 453, 473, 537, 540, 547, 554, 628, 659, 669, 696], "arbitrari": [6, 127, 208, 296, 317, 399, 473, 696], "occur": [6, 10, 13, 20, 22, 145, 153, 155, 157, 171, 208, 253, 287, 289, 290, 312, 313, 315, 316, 317, 328, 332, 344, 349, 350, 366, 368, 369, 378, 387, 395, 428, 448, 454, 459, 495, 669], "after": [6, 10, 13, 19, 21, 28, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 148, 150, 151, 158, 160, 162, 238, 246, 250, 253, 255, 272, 273, 276, 277, 282, 285, 287, 288, 297, 298, 325, 332, 342, 344, 350, 354, 364, 365, 391, 392, 393, 395, 399, 409, 412, 413, 422, 426, 427, 430, 431, 450, 473, 474, 485, 491, 494, 505, 547, 554, 555, 556, 557, 563, 574, 579, 582, 616, 617, 618, 626, 628, 633, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 687, 688, 689, 690, 691, 692, 693, 696], "next": [6, 8, 9, 12, 18, 159, 358, 361, 449, 475, 669, 694], "due": [6, 21, 219, 223, 224, 253, 273, 285, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 547, 554, 669], "constraint": [6, 661], "fourth": 6, "bulk3": 6, "indic": [6, 8, 75, 81, 85, 157, 160, 171, 208, 265, 358, 430, 431, 455, 463, 527, 528, 587, 588, 599, 642, 644, 669, 676, 678, 680, 681, 687, 688, 690, 691, 692, 693, 696], "bson_append_bool": [6, 10], "mongoc_bulk_operation_remove_on": [6, 14, 133, 140, 143, 151], "mongoc_bulk_operation_replace_on": [6, 14, 151], "e11000": 6, "_id_": [6, 296], "dup": 6, "domain": [6, 10, 13, 22, 309, 350, 466, 467, 468, 567, 639, 640, 669], "mongoc_error_command": [6, 13], "later": [6, 7, 12, 24, 141, 143, 145, 153, 155, 160, 166, 253, 254, 288, 289, 292, 295, 296, 298, 301, 303, 304, 308, 309, 311, 312, 325, 326, 328, 329, 333, 341, 342, 345, 365, 366, 368, 371, 376, 387, 388, 396, 399, 408, 424, 494, 517, 521, 557], "schema": [6, 7, 122, 129, 171, 289, 325, 326, 333, 341, 342, 368, 408], "defin": [6, 7, 10, 11, 12, 13, 22, 150, 185, 189, 265, 274, 362, 486, 545, 606, 620, 627, 669, 671, 697], "bulk5": 6, "bulk5_fail": 6, "31": [6, 486, 620], "32": [6, 439, 478, 630, 662, 680, 697], "compli": 6, "rule": [6, 19, 129, 408], "previous": [6, 359, 401, 505, 597, 657, 687, 688, 689, 690, 691, 692, 693], "bulk5_success": 6, "either": [6, 8, 12, 24, 158, 160, 206, 248, 278, 289, 303, 304, 313, 326, 333, 341, 342, 350, 368, 386, 408, 669], "dbadmin": [6, 408], "restor": [6, 22, 408], "role": [6, 367, 408], "mongoc_bulk_operation_set_bypass_document_valid": [6, 14, 151], "mongoc_client_get_databas": [6, 12, 14, 24, 272, 274, 286, 368, 394, 414, 429, 607, 696], "testasdf": 6, "mongoc_database_create_collect": [6, 14, 171, 272, 274, 394, 414, 607], "collnam": [6, 520], "couldn": [6, 12], "mongoc_database_destroi": [6, 12, 14, 24, 222, 225, 272, 274, 368, 372, 394, 414, 429, 607, 696], "121": 6, "write_concern": [6, 253, 272, 284, 288, 289, 297, 302, 318, 323, 324, 330, 334, 337, 340, 393, 607, 618, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 687, 688, 689, 690, 691, 692, 693], "custom": [6, 19, 160, 162, 175, 176, 256, 283, 286, 485, 521], "g": [6, 8, 12, 15, 20, 170, 359, 368, 521, 657, 669], "wtimeout": [6, 272, 607, 690], "bulk4": 6, "wc": [6, 7, 160, 399, 411, 414, 668], "mongoc_write_concern_new": [6, 7, 14, 160, 253, 272, 288, 289, 399, 411, 414, 607, 694], "mongoc_write_concern_set_w": [6, 14, 289, 399, 411, 414, 555, 694], "mongoc_write_concern_set_wtimeout_int64": [6, 14, 681, 690, 692, 694], "100": [6, 244, 290, 312, 399, 411, 414, 653, 669], "millisecond": [6, 159, 365, 411, 446, 543, 558, 561, 587, 588, 598, 599, 610, 615, 669, 680, 681, 690, 692, 693], "mongoc_write_concern_append": [6, 7, 14, 160, 166, 253, 254, 288, 289, 292, 298, 300, 301, 303, 304, 308, 309, 325, 326, 329, 332, 333, 341, 342, 345, 368, 371, 376, 388, 396, 399, 411, 414, 424, 694], "11": [6, 20, 294, 296, 359, 696], "mongoc_write_concern_destroi": [6, 7, 14, 160, 253, 272, 288, 399, 411, 414, 607, 673, 686, 694], "64": [6, 20, 443, 463, 652, 653, 662, 681, 697], "wait": [6, 9, 273, 287, 317, 344, 365, 395, 495, 587, 598, 669, 680, 681, 690, 692, 693], "replic": [6, 521, 669], "out": [6, 9, 12, 13, 20, 139, 141, 143, 145, 153, 155, 208, 227, 256, 260, 273, 274, 289, 290, 303, 304, 312, 315, 316, 317, 325, 326, 341, 342, 353, 368, 369, 378, 466, 467, 468, 494, 533, 628, 669], "mongoc_error_write_concern": [6, 13], "preced": [6, 8], "mere": 6, "satisfi": [6, 317, 365, 515, 691], "yet": [6, 358], "bulk_col": 6, "selector": [6, 132, 133, 140, 141, 142, 143, 144, 145, 152, 153, 154, 155, 273, 296, 302, 303, 304, 330, 333, 340, 341, 342, 522], "uint32_t": [6, 7, 10, 38, 50, 62, 135, 136, 149, 163, 165, 174, 175, 227, 230, 240, 241, 259, 267, 269, 290, 312, 324, 351, 352, 356, 359, 362, 363, 365, 369, 404, 411, 451, 452, 464, 539, 696], "One": [6, 8, 20, 253, 288, 296, 455, 669], "normal": [6, 9, 20, 253, 272, 274, 288, 296, 317, 494, 607], "en_u": [6, 253, 288, 296, 317], "casefirst": [6, 253, 288, 296, 317], "lower": [6, 253, 288, 296, 317, 496], "x": [6, 8, 12, 18, 23, 24, 160, 253, 273, 288, 342, 350, 671], "bcon_int64": [6, 160, 253, 288, 295, 311, 317, 350], "gt": [6, 10, 12, 182, 253, 288, 296, 342], "mongoc_bulk_operation_update_one_with_opt": [6, 14, 151, 152, 153, 154], "w": [6, 7, 160, 399, 411, 414, 669, 677, 683, 689], "zero": [6, 136, 213, 290, 294, 296, 351, 352, 354, 362, 630, 631, 669, 689, 690, 692, 693], "legaci": [6, 18, 36, 37, 48, 49, 60, 61, 317], "opcod": 6, "op_insert": 6, "op_upd": 6, "op_delet": 6, "bulk6": 6, "empti": [6, 12, 13, 22, 34, 123, 157, 160, 169, 200, 201, 208, 212, 213, 287, 300, 314, 315, 316, 317, 335, 344, 350, 358, 391, 395, 402, 405, 406, 488, 521, 537, 540, 625, 669, 696], "refer": [7, 14, 18, 123, 127, 208, 268, 294, 296, 317, 537, 538, 540, 544, 605, 669, 696], "csfle": [7, 17], "administr": 7, "data": [7, 11, 12, 13, 18, 24, 28, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 126, 128, 129, 156, 158, 159, 171, 174, 175, 176, 187, 188, 207, 208, 209, 213, 251, 273, 274, 287, 344, 358, 367, 395, 422, 430, 431, 433, 453, 472, 474, 494, 496, 498, 584, 590, 628, 659, 669, 694, 696], "addit": [7, 9, 10, 18, 123, 139, 141, 143, 145, 153, 155, 160, 166, 169, 219, 224, 253, 254, 286, 287, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 312, 316, 325, 326, 328, 329, 332, 333, 341, 342, 344, 345, 350, 358, 359, 360, 366, 368, 371, 376, 378, 381, 387, 388, 395, 396, 399, 424, 426, 427, 430, 431, 661, 669, 697], "With": [7, 312, 317, 694], "direct": [7, 24, 287, 344, 395, 521], "workload": 7, "guarante": [7, 273, 294, 295, 296, 311, 495, 669, 696, 697], "unauthor": 7, "parti": 7, "cannot": [7, 13, 22, 247, 255, 274, 324, 350, 365, 491, 557, 655, 656, 657, 658, 659, 664, 667], "sensit": 7, "analysi": [7, 121, 181, 182], "manual": [7, 17, 123, 141, 143, 145, 153, 155, 160, 166, 168, 218, 219, 220, 222, 224, 239, 253, 254, 273, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 312, 313, 314, 316, 317, 328, 329, 333, 341, 342, 345, 351, 362, 368, 371, 373, 376, 378, 381, 387, 388, 396, 424, 481, 495, 506, 555, 669, 695], "mongoc_client_enable_auto_encrypt": [7, 14, 17, 21, 119, 120, 121, 122, 123, 124, 126, 128, 129, 130, 170, 178, 181, 182, 218, 239, 286], "atla": 7, "commun": [7, 13, 353], "well": [7, 9, 10, 13, 348, 359, 495, 669], "map": [7, 12, 122, 129, 130, 210, 587, 598, 599], "mongoc_auto_encryption_opts_set_schema_map": [7, 14, 17, 119, 122, 131], "express": [7, 12, 20, 24, 150, 182, 259, 267, 289, 298, 303, 304, 333, 341, 342, 368, 399], "strict": [7, 311, 528, 531, 532], "subset": [7, 409, 567], "suppli": [7, 13, 122, 129, 186, 261, 283], "reli": [7, 20, 122, 129, 312, 669], "protect": [7, 122, 129], "malici": [7, 122, 129], "advertis": [7, 122, 129], "could": [7, 20, 22, 129, 231, 272, 273, 274, 390, 466, 473, 607], "trick": [7, 129], "unencrypt": [7, 129], "appli": [7, 17, 122, 124, 125, 129, 153, 155, 163, 164, 168, 186, 189, 190, 194, 195, 196, 197, 219, 223, 224, 239, 253, 254, 287, 288, 289, 291, 294, 295, 296, 311, 312, 315, 316, 317, 328, 329, 341, 342, 344, 345, 365, 368, 369, 370, 377, 378, 380, 381, 387, 388, 395, 396, 422, 423, 465, 466, 467, 468, 469, 494, 521, 669, 694, 695], "stdlib": [7, 10, 253, 274, 286, 288, 366, 429, 473], "helper": [7, 11, 12, 13, 22, 24, 253, 287, 328, 332, 338, 343, 344, 387, 395, 564, 571, 696], "vault": [7, 21, 124, 125, 126, 170, 176, 179, 200, 201, 202, 207, 213, 218], "write": [7, 12, 13, 14, 16, 18, 21, 24, 135, 137, 138, 147, 148, 149, 151, 160, 163, 164, 165, 166, 170, 208, 215, 227, 234, 251, 253, 254, 256, 260, 272, 273, 284, 285, 289, 291, 292, 297, 298, 300, 301, 302, 303, 304, 308, 309, 313, 314, 317, 318, 322, 323, 324, 325, 326, 328, 329, 332, 333, 334, 337, 340, 341, 342, 359, 360, 363, 368, 369, 370, 371, 373, 376, 387, 388, 393, 394, 399, 411, 414, 422, 424, 426, 427, 430, 431, 432, 433, 464, 473, 487, 521, 547, 554, 555, 556, 557, 570, 578, 580, 584, 586, 598, 599, 607, 618, 631, 646, 668, 672, 674, 675, 676, 677, 678, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 696], "create_schema_fil": 7, "kms_provid": [7, 128, 170, 171, 209], "keyvault_db": 7, "keyvault_col": 7, "keyvault_cli": [7, 206], "client_encrypt": [7, 169, 170, 178, 179, 180, 181, 182, 200, 201, 202, 212, 213], "client_encryption_opt": 7, "datakey_opt": 7, "bson_value_t": [7, 148, 160, 169, 170, 178, 179, 181, 188, 194, 195, 200, 201, 212, 287, 289, 295, 298, 303, 304, 311, 325, 326, 333, 341, 342, 344, 368, 395, 399, 420, 422, 425, 426, 427, 429, 430, 431, 442, 459, 473], "datakey_id": 7, "keyaltnam": [7, 169, 174, 187, 201, 212], "mongoc_encryption_example_1": 7, "schema_str": 7, "schema_string_len": 7, "outfil": 7, "mongoc_client_encryption_opts_new": [7, 14, 204, 210, 211], "mongoc_client_encryption_opts_set_kms_provid": [7, 14, 211], "mongoc_client_encryption_opts_set_keyvault_namespac": [7, 14, 170, 211], "mongoc_client_encryption_opts_set_keyvault_cli": [7, 14, 21, 211, 218], "mongoc_client_encryption_new": [7, 14, 206, 207, 209, 211, 218], "goto": [7, 12, 24, 160, 272, 273, 274, 607, 696], "encryptedfield": [7, 122, 171, 194, 195, 196, 197, 198, 309, 373, 376], "http": [7, 12, 13, 20, 24, 251, 696], "dochub": 7, "org": [7, 12, 20, 24], "mongoc_client_encryption_datakey_opts_new": [7, 14, 172, 177], "mongoc_client_encryption_datakey_opts_set_keyaltnam": [7, 14, 177, 187], "mongoc_client_encryption_create_datakei": [7, 14, 171, 177, 179, 218], "newli": [7, 170, 220, 222, 225, 231, 235, 236, 237, 242, 243, 274, 285, 287, 289, 290, 293, 297, 298, 312, 315, 316, 317, 344, 346, 368, 369, 372, 373, 377, 378, 379, 395, 407, 423, 424, 432, 433, 449, 465, 466, 467, 468, 469, 500, 504, 509, 516, 524, 542, 558, 564, 575, 581, 582, 586, 592, 601, 604, 621, 648, 649, 650, 670, 673, 686], "determinist": [7, 129, 185], "keyid": [7, 129, 169, 170, 171, 176, 179, 188, 200, 212, 696], "bcon_bin": 7, "v_binari": 7, "subtyp": [7, 128, 129, 169, 170, 178, 179, 181, 188, 200, 209, 212, 696], "data_len": 7, "bsontyp": [7, 129], "mongoc_aead_aes_256_cbc_hmac_sha_512_determinist": [7, 185], "canon": [7, 327, 669], "abl": [7, 414], "extend": [7, 9, 158, 159], "fopen": [7, 160], "jsonschema": 7, "fwrite": [7, 160, 473], "sizeof": [7, 160, 473, 696], "mongoc_client_encryption_destroi": [7, 14, 203, 218], "mongoc_client_encryption_datakey_opts_destroi": [7, 14, 173, 177], "mongoc_client_encryption_opts_destroi": [7, 14, 205, 211], "bson_value_destroi": [7, 160, 170, 178, 181, 201, 212], "fclose": [7, 160], "demonstr": [7, 10, 12, 13, 253, 272, 288, 398, 696], "__libmongoctestkeyvault": 7, "encrypted_db": 7, "encrypted_col": 7, "coll": [7, 23, 126, 129, 160, 207, 342, 344], "exit_statu": 7, "uint8_t": [7, 175, 478, 696], "local_masterkei": 7, "local_masterkey_len": 7, "index_kei": 7, "index_opt": [7, 300], "mongoc_index_model_t": [7, 23], "index_model": 7, "bson_json_reader_t": [7, 160, 696], "reader": [7, 160, 473], "schema_map": [7, 129], "mongocli": 7, "keyvault_namespac": 7, "auto_encryption_opt": 7, "to_insert": [7, 160, 342], "unencrypted_cli": 7, "unencrypted_col": 7, "master": [7, 128, 176, 209, 213], "hex_to_bin": 7, "getenv": 7, "96": [7, 128, 132, 133, 209], "random": [7, 175, 185, 495, 496, 497, 498], "keyvault": 7, "bson_assert": [7, 10, 12, 24, 342], "partialfilterexpress": 7, "exist": [7, 10, 13, 22, 160, 169, 200, 201, 212, 226, 309, 315, 316, 331, 332, 386, 410, 414, 428, 473, 657], "mongoc_index_model_new": [7, 23, 301], "mongoc_collection_create_indexes_with_opt": [7, 14, 23, 339], "save": [7, 334, 454, 473, 486], "construct": [7, 12, 139, 145, 153, 155, 166, 219, 224, 227, 250, 253, 254, 282, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 414, 424, 630, 631, 696], "bson_json_reader_new_from_fil": [7, 160], "bson_json_reader_read": [7, 160], "namespac": [7, 24, 122, 129, 226, 424], "bcon_docu": 7, "mongoc_auto_encryption_opts_new": [7, 14, 118, 130, 131], "mongoc_auto_encryption_opts_set_keyvault_cli": [7, 14, 21, 119, 125, 131], "mongoc_auto_encryption_opts_set_keyvault_namespac": [7, 14, 119, 131], "mongoc_auto_encryption_opts_set_kms_provid": [7, 14, 119, 131], "old": [7, 13, 136, 149, 312, 317, 352, 363, 408, 414], "123456789": 7, "print_one_docu": 7, "mongoc_index_model_destroi": [7, 301], "bson_json_reader_destroi": [7, 160], "mongoc_auto_encryption_opts_destroi": [7, 14, 119, 131], "prevent": [7, 123, 255, 494, 578], "mark": [7, 8, 265, 505, 687, 688, 689, 690, 691, 692, 693], "keyword": 7, "caller": [7, 119, 135, 170, 171, 178, 181, 182, 580], "create_schema": 7, "mongoc_encryption_example_2": 7, "create_cmd": 7, "create_cmd_opt": 7, "mongoc_write_concern_set_wmajor": [7, 14, 160, 253, 272, 288, 607, 694], "mongoc_client_command_with_opt": [7, 13, 14, 163, 253, 286], "expect": [7, 241, 301, 313, 314, 327], "memset": 7, "mongocryptd": [7, 17, 121, 123], "crypt_shar": [7, 17, 121, 123, 199, 221], "class": 7, "mongoc_encryption_example_3": 7, "encrypted_field": 7, "to_encrypt": 7, "encrypt_opt": 7, "mongoc_client_encryption_encrypt_opts_new": [7, 14, 183, 191], "mongoc_client_encryption_encrypt_opts_set_algorithm": [7, 14, 17, 186, 189, 190, 191, 194, 195, 196, 197], "mongoc_client_encryption_encrypt_opts_set_keyid": [7, 14, 187, 191], "value_typ": [7, 160, 473], "bson_type_utf8": 7, "v_utf8": 7, "len": [7, 11, 175], "strlen": 7, "bson_in_range_unsign": 7, "mongoc_client_encryption_encrypt": [7, 14, 170, 178, 191, 198, 218], "bson_append_valu": [7, 160], "mongoc_client_encryption_decrypt": [7, 178], "mongoc_client_encryption_encrypt_opts_destroi": [7, 14, 184, 191], "although": [7, 364, 365, 411], "bypass_auto_encrypt": [7, 120], "auto": [7, 8, 11, 17, 119, 123, 221], "mongoc_encryption_example_4": 7, "spawn": [7, 17, 123], "mongoc_auto_encryption_opts_set_bypass_auto_encrypt": [7, 14, 119, 131, 168, 181, 182, 239], "fact": 7, "look": [7, 8, 11, 20, 473, 474, 669, 696], "u": 7, "mongoc_client_encryption_encrypt_opts_set_keyaltnam": [7, 14, 174, 188, 191], "mongoc_uri_set_option_as_bool": [8, 14, 669], "mongoc_uri_tl": [8, 669], "further": [8, 274], "privat": [8, 594, 669, 696], "concaten": [8, 669], "mongoc_uri_tlscertificatekeyfilepassword": [8, 130, 210, 669], "tlscertificatekeypassword": [8, 669], "unlock": [8, 669], "mongoc_uri_tlscafil": [8, 130, 210, 669], "bundl": [8, 20, 669], "whom": [8, 669], "mongoc_uri_tlsallowinvalidcertif": [8, 669], "tlsallowinvalidcertif": [8, 669], "accept": [8, 160, 171, 241, 351, 558, 630, 631, 659, 669], "untrust": [8, 669], "issuer": [8, 669], "etc": [8, 20, 219, 223, 224, 253, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 339, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 669], "mongoc_uri_tlsallowinvalidhostnam": [8, 669], "tlsallowinvalidhostnam": [8, 669], "man": [8, 13, 669], "middl": [8, 669], "mongoc_uri_tlsinsecur": [8, 669], "tlsinsecur": [8, 669], "insecur": [8, 669], "impli": [8, 12, 24, 669], "mongoc_uri_tlsdisablecertificaterevocationcheck": [8, 669], "tlsdisablecertificaterevocationcheck": [8, 669], "revoc": [8, 669], "crl": [8, 669], "ocsp": [8, 669], "mongoc_uri_tlsdisableocspendpointcheck": [8, 669], "tlsdisableocspendpointcheck": [8, 669], "respond": [8, 9, 13, 309, 669], "endpoint": [8, 128, 176, 209, 669], "stapl": [8, 669], "mongoc_client_pool_set_ssl_opt": [8, 14, 251, 282, 574, 669], "most": [8, 20, 247, 277, 287, 303, 304, 312, 339, 341, 342, 344, 395, 521, 532, 537, 540, 697], "tlsclientcertificatekeyfil": 8, "tlsclientcertificatekeypassword": 8, "allow_invalid_hostnam": [8, 574], "exclus": [8, 160, 187, 188, 287, 312, 344, 395, 555, 557], "crl_file": [8, 250, 282, 574], "those": [8, 10, 12, 20, 253, 288, 328, 345, 387, 396, 512, 518], "armor": 8, "overwrit": [8, 657], "control": [8, 20, 495, 669], "respect": [8, 241, 669, 696], "expos": [8, 669], "attack": 8, "potenti": [8, 20, 135, 253, 328, 358, 387, 452, 669], "revok": 8, "find": [8, 12, 20, 24, 33, 46, 57, 124, 125, 202, 213, 313, 314, 317, 339, 350, 352, 359, 360, 363, 378, 399, 400, 407, 408, 409, 410, 411, 412, 413, 414, 423, 465, 467, 468, 469, 494, 557, 669], "flag": [8, 20, 163, 289, 290, 294, 296, 302, 312, 323, 324, 330, 340, 369, 397, 403, 414, 474, 492, 527, 528, 568, 582], "enable_ssl": 8, "libssl": [8, 20], "openssl_root": 8, "besid": [8, 289], "industri": 8, "best": [8, 433, 521], "regul": 8, "newer": [8, 11, 15, 20, 317, 671, 695], "least": [8, 128, 209, 241, 318, 521, 694], "recent": [8, 20, 241, 537, 540], "dopenssl_root_dir": 8, "absolut": [8, 123, 561, 569, 570], "distribut": [8, 12, 20, 24, 669], "overridden": [8, 166, 253, 254, 288, 289, 292, 317, 328, 329, 339, 345, 368, 371, 387, 388, 394, 396, 556, 607], "onlin": 8, "statu": [8, 13, 70, 80, 84, 90, 98, 100, 101, 102, 232, 498, 605], "6960": 8, "fulli": [8, 495], "even": [8, 10, 135, 170, 178, 181, 182, 232, 274, 289, 290, 291, 297, 312, 315, 316, 317, 358, 368, 369, 370, 378, 408, 414, 486, 574, 689], "partial": [8, 494], "extens": [8, 20, 473, 594], "7633": 8, "continu": [8, 10, 20, 272, 297, 298, 325, 332, 486, 607], "down": [8, 238, 494, 560, 669], "schannel": 8, "crypto": [8, 285], "cryptographi": 8, "cng": 8, "them": [8, 20, 231, 473, 474, 499, 574, 672, 696, 697], "root": 8, "confirm": [8, 9, 20, 669], "io": [8, 20, 594], "cc": [8, 474], "keychain": 8, "thread": [9, 18, 19, 21, 22, 124, 125, 162, 167, 168, 206, 238, 251, 273, 285, 454, 464, 474, 485, 547, 554, 563, 669], "optim": [9, 20, 160], "embed": [9, 291], "languag": [9, 12, 18, 24, 149, 150, 227, 256, 289, 298, 303, 304, 333, 341, 342, 359, 360, 363, 368, 399, 594, 696], "php": 9, "multi": [9, 13, 21, 167, 206, 251, 257, 261, 262, 271, 272, 273, 285, 286, 547, 554, 607, 614, 669], "minim": 9, "background": [9, 481, 669], "block": [9, 159, 160, 244, 252, 273, 284, 287, 337, 344, 361, 393, 395, 449, 452, 494, 587, 588, 598, 599, 602, 603, 669, 671, 694], "scan": [9, 669], "hosta": 9, "hostb": 9, "my_r": [9, 654], "begin": [9, 13, 19, 27, 52, 84, 96, 101, 162, 166, 219, 224, 253, 254, 288, 289, 292, 295, 296, 297, 298, 300, 301, 303, 304, 308, 309, 311, 312, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 346, 368, 371, 376, 378, 381, 387, 388, 396, 399, 474, 485, 505, 574, 669, 687, 688, 689, 690, 691, 692, 693], "concurr": [9, 473], "asynchron": 9, "poll": 9, "put": 9, "fan": 9, "re": [9, 12, 24, 273, 287, 344, 346, 395, 429, 696], "roughli": [9, 669], "elaps": 9, "heartbeatfrequencym": [9, 669], "mongoc_client_pool_new": [9, 14, 21, 251, 696], "mongoc_client_pool_pop": [9, 14, 21, 238, 246, 247, 248, 250, 251, 252, 474, 669, 696], "launch": [9, 24], "independ": [9, 21, 556, 607], "hello": [9, 36, 37, 48, 49, 60, 61, 75, 80, 81, 84, 85, 90, 100, 101, 102, 277, 474, 521, 537, 540, 541, 543, 669, 696], "view": [9, 168, 239, 537, 540], "termin": [9, 199, 221, 223, 224, 380, 381], "mongoc_client_pool_push": [9, 14, 21, 167, 238, 241, 244, 251, 696], "unblock": 9, "usabl": 9, "everi": [9, 669], "waitqueuetimeoutm": [9, 244, 669], "1000": [9, 10, 160, 272, 607, 696], "appropri": [9, 20, 294, 296, 302, 330, 359, 360, 455, 517, 521, 696], "action": [9, 168, 239, 274, 339, 394], "size": [9, 13, 168, 239, 241, 253, 288, 312, 351, 362, 424, 426, 427, 430, 431, 439, 565, 566, 575], "structur": [10, 11, 13, 134, 167, 180, 238, 251, 374, 379, 394, 400, 407, 434, 451, 462, 477, 478, 480, 481, 483, 484, 487, 501, 567, 572, 574, 579, 627, 674, 696], "give": [10, 12, 13, 669, 696], "iter": [10, 12, 13, 157, 158, 159, 160, 349, 350, 358, 361, 366, 378, 449, 450, 465, 469, 696], "partit": 10, "robust": 10, "robustli": 10, "print_all_docu": [10, 312], "mongoc_collection_find_with_opt": [10, 12, 13, 14, 273, 286, 312, 339, 342, 350, 360, 365, 366, 411, 423, 450, 468, 469, 520, 557, 696], "consum": [10, 487, 495], "extra": [10, 20, 123, 296, 338, 367, 399, 411, 414, 669], "becom": [10, 252, 628, 669, 670], "cap": 10, "tail": 10, "oplog": 10, "ifdef": [10, 250, 282, 487], "_win32": [10, 487], "sleep": [10, 251, 696], "_n": 10, "endif": [10, 250, 282, 487, 671], "print_bson": 10, "b": [10, 231], "query_collect": 10, "last_tim": 10, "bson_init": [10, 160, 286, 296, 366, 429, 473, 481], "bson_append_document_begin": [10, 378, 473, 696], "bson_append_timestamp": 10, "bson_append_document_end": [10, 378, 473, 696], "awaitdata": [10, 317, 359, 360, 365], "tail_collect": 10, "bson_iter_t": [10, 12, 160, 378], "mongoc_cursor_mor": [10, 14, 357, 366], "bson_iter_init_find": [10, 12, 160, 378], "bson_iter_holds_timestamp": 10, "bson_iter_timestamp": 10, "mongoc_error_serv": [10, 13, 309], "exit": [10, 19, 21, 160, 473, 696], "usag": [10, 12, 24, 327, 429, 473], "mongo_uri": 10, "made": [10, 11, 473, 563], "wall": [10, 12, 24, 474, 521, 669], "8458503739429355503": 10, "oid": [10, 408, 409, 410, 412, 413, 414, 696], "5372ab0a25164be923d10d50": 10, "op": 10, "timestamp": [10, 11, 22, 160, 258, 259, 267, 287, 344, 395, 696], "1400023818": 10, "v": [10, 481], "line": [10, 11, 20, 274, 399, 408, 409, 410, 411, 412, 413, 414, 669, 696], "sampl": [10, 12, 20, 24, 696], "mongoc_cursor_set_max_await_time_m": [10, 14, 219, 315, 316, 356, 366, 377, 378], "repositori": 11, "gdbinit": 11, "directori": [11, 20, 123, 696, 697], "prompt": [11, 20], "haven": 11, "printbson": 11, "content": [11, 186, 293, 420, 422, 433, 440, 457, 621, 628], "prefix": [11, 226, 424, 473, 669], "0x555556cd7310": 11, "475": 11, "int32": [11, 166, 219, 224, 253, 254, 287, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 328, 329, 332, 344, 345, 368, 371, 376, 378, 381, 387, 388, 395, 396, 424, 426, 427, 430, 431, 661, 662], "numberint": 11, "42": [11, 12, 399, 411, 414], "int64": [11, 287, 317, 344, 395, 446, 630, 661, 662], "numberlong": [11, 696], "3000000042": 11, "st\u0155\u00ec\u00f1g": 11, "objectid": [11, 442, 696, 697], "5a1442f3122d331c3c6757e1": 11, "utcdatetim": 11, "1511277299031": 11, "arrayofint": 11, "embeddeddocu": 11, "arrayofstr": 11, "doubl": [11, 12, 194, 195, 196, 198, 478, 495, 496], "718280": 11, "notherdoc": 11, "binari": [11, 128, 129, 169, 170, 178, 179, 181, 188, 200, 209, 212, 696], "02": 11, "3031343532333637": 11, "regex": 11, "z": [11, 12, 671], "im": [11, 23], "javascript": 11, "jsw": 11, "scope": [11, 20, 28, 32, 34, 41, 42, 44, 45, 53, 56, 58, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109], "141593": 11, "718282": 11, "4294967295": 11, "script": 11, "lldb_bson": 11, "py": [11, 20], "rich": 11, "inspect": 11, "modul": [11, 20], "python": [11, 20], "8": [11, 20, 287, 299, 300, 310, 311, 344, 395, 424, 458, 467, 472, 474, 481, 484, 655, 656, 657, 658, 664, 667, 670, 671, 695], "upon": [11, 135, 171, 219, 220, 222, 223, 224, 226, 253, 274, 280, 287, 289, 291, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 370, 373, 377, 378, 380, 381, 387, 395, 422, 423, 437, 465, 466, 467, 468, 469, 558, 581, 582, 587, 593, 598, 599], "readi": 11, "consol": [11, 697], "lldbinit": 11, "docstr": 11, "top": [11, 450, 521, 594, 669], "denable_debug_assert": 11, "ll": [12, 24], "don": [12, 24, 250, 282, 474], "try": [12, 13, 17, 24, 272, 448, 607, 662, 669], "meant": [12, 24, 274, 275, 566], "insert_data": [12, 24], "bulk": [12, 14, 16, 18, 24, 33, 46, 57, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 215, 288, 297, 298, 318, 324, 325, 345, 396], "enum": [12, 22, 24, 397, 486, 494, 507, 522, 523, 534, 619, 620], "ndoc": [12, 24], "bcon_doubl": [12, 24], "tag": [12, 20, 24, 508, 514, 520, 636, 669, 691], "dog": [12, 24], "cat": [12, 24], "mous": [12, 24], "lot": [12, 24, 494], "print_r": [12, 24], "array_it": 12, "val": 12, "mongoc_database_command_simpl": [12, 14, 387, 388, 394, 396, 694], "bson_iter_holds_arrai": 12, "bson_iter_recurs": 12, "extract": [12, 20, 669], "bson_iter_next": 12, "bson_iter_holds_doubl": 12, "bson_iter_doubl": 12, "framework": [12, 14, 16, 18], "occurr": 12, "just": [12, 473, 506, 520, 669], "emit": [12, 630, 662], "pair": [12, 521, 669, 696], "mapper": 12, "foreach": 12, "var": 12, "length": [12, 175, 231, 247, 277, 325, 424, 443, 462, 571, 601, 696], "mongoc_database_read_command_with_opt": [12, 14, 369, 394], "retryabl": [12, 163, 164, 165, 166, 219, 223, 224, 253, 287, 289, 290, 291, 292, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 369, 370, 371, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 590], "retri": [12, 219, 223, 224, 253, 272, 274, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 607, 669], "undesir": 12, "map_reduce_bas": 12, "query_don": 12, "out_collection_nam": 12, "outcollect": 12, "out_collect": 12, "find_queri": 12, "argument": [12, 13, 123, 139, 141, 143, 145, 153, 155, 164, 165, 166, 171, 213, 232, 246, 253, 254, 257, 260, 261, 272, 274, 276, 278, 288, 291, 292, 300, 301, 302, 303, 304, 308, 309, 313, 314, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 345, 359, 363, 364, 365, 367, 370, 371, 376, 386, 387, 388, 389, 390, 396, 399, 408, 409, 411, 412, 413, 414, 435, 453, 455, 459, 472, 499, 556, 616, 617, 618, 672, 696], "bcon_cod": 12, "doesn": [12, 277, 399, 410, 411, 414], "mongoc_database_get_collect": [12, 14, 24, 272, 274, 391, 392, 393, 394, 607], "contact": [12, 358], "inlin": 12, "immedi": [12, 123, 252, 350], "advanc": [12, 14, 16, 18, 24, 258, 259, 696], "map_reduce_advanc": 12, "read_pref": [12, 163, 164, 165, 166, 232, 253, 254, 280, 288, 289, 290, 291, 292, 294, 295, 296, 311, 312, 317, 328, 329, 336, 368, 369, 370, 371, 387, 388, 392, 424, 508, 509, 510, 511, 512, 513, 514, 515, 517, 518, 519, 520, 602, 617], "mongoc_database_command": [12, 14, 370, 394, 694], "aggreg": [12, 14, 16, 18, 150, 160, 182, 287, 289, 295, 298, 303, 304, 333, 338, 341, 342, 344, 359, 360, 368, 395, 399, 557], "copyright": [12, 24], "2016": [12, 20, 24], "licens": [12, 24], "under": [12, 24], "apach": [12, 24], "complianc": [12, 24], "www": [12, 24], "law": [12, 24], "agre": [12, 24], "softwar": [12, 24], "AS": [12, 24], "basi": [12, 24, 251], "warranti": [12, 24], "OR": [12, 24], "condit": [12, 24, 671], "OF": [12, 24], "kind": [12, 24, 473], "govern": [12, 24, 669], "permiss": [12, 24], "exit_cod": [12, 160, 272, 273, 274, 607], "tlocal": [12, 24], "strncmp": [12, 24], "bson_strdup": [12, 24], "bson_strdup_printf": [12, 24, 630, 631], "otherwis": [12, 21, 22, 141, 143, 145, 153, 155, 159, 163, 164, 166, 169, 170, 178, 179, 181, 182, 200, 201, 202, 203, 212, 213, 215, 239, 252, 253, 254, 256, 264, 271, 274, 277, 288, 289, 290, 291, 292, 294, 295, 296, 301, 303, 304, 308, 309, 311, 313, 328, 329, 333, 334, 336, 341, 342, 345, 349, 350, 361, 368, 369, 370, 371, 376, 387, 388, 392, 396, 408, 409, 410, 411, 412, 413, 419, 420, 422, 424, 428, 430, 431, 437, 448, 454, 455, 474, 490, 498, 505, 521, 553, 563, 565, 567, 575, 577, 581, 582, 584, 586, 589, 602, 624, 633, 634, 635, 636, 637, 641, 645, 646, 648, 650, 655, 656, 660, 661, 662, 663, 669, 679], "cd": [12, 17, 20, 24], "basic_aggreg": 12, "agg": 12, "000000": [12, 696], "timemilli": 12, "155": 12, "input": [12, 13, 697], "84": [12, 410, 414], "126": 12, "63": 12, "21": [12, 639], "14": [12, 20, 410, 414], "fill": [13, 227, 256, 260, 289, 290, 303, 304, 312, 315, 316, 317, 325, 326, 341, 342, 368, 369, 378, 433, 466, 467, 468], "subsystem": [13, 487], "human": 13, "readabl": [13, 602], "libbson": [13, 14, 18, 696, 697], "mongoc_error_cli": 13, "mongoc_error_client_too_big": 13, "larger": 13, "mongoc_error_client_authent": 13, "wrong": [13, 474], "credenti": [13, 127, 208, 658, 669], "mongoc_error_client_no_acceptable_p": 13, "mongoc_error_client_in_exhaust": 13, "began": 13, "exhaust": [13, 317, 361, 669], "mongoc_error_client_session_failur": 13, "mongoc_error_client_invalid_encryption_arg": 13, "mongoc_error_client_invalid_encryption_st": 13, "mongoc_error_client_invalid_load_balanc": 13, "balanc": [13, 39, 51, 63, 227, 669], "advert": 13, "mongoc_error_stream": 13, "mongoc_error_stream_name_resolut": 13, "mongoc_error_stream_socket": 13, "mongoc_error_stream_connect": 13, "mongoc_error_protocol": 13, "mongoc_error_protocol_invalid_repli": 13, "corrupt": 13, "mongoc_error_protocol_bad_wire_vers": 13, "too": [13, 247, 317, 399, 411, 414], "mongoc_error_cursor": 13, "mongoc_error_cursor_invalid_cursor": 13, "bad": 13, "mongoc_error_change_stream_no_resume_token": 13, "resum": [13, 158, 287, 344, 395, 494], "mongoc_change_stream_next": [13, 14, 158, 160, 287, 344, 395], "mongoc_error_queri": 13, "mongoc_error_query_failur": [13, 309], "mongoc_error_sasl": 13, "sasl": [13, 18, 20, 669], "sasl_error": 13, "mongoc_error_bson": 13, "mongoc_error_bson_invalid": 13, "overs": 13, "mongoc_collection_create_index": [13, 14, 339, 481], "mongoc_error_namespac": 13, "mongoc_error_namespace_invalid": 13, "mongoc_error_command_invalid_arg": 13, "detail": [13, 19, 34, 152, 153, 154, 155, 162, 163, 277, 294, 296, 358, 398, 452, 464, 485, 505, 521, 669, 696], "mongoc_error_duplicate_kei": 13, "violat": 13, "mongoc_error_max_time_ms_expir": 13, "maxtimem": [13, 273, 317, 365, 404], "mongoc_error_server_selection_invalid_id": 13, "serverid": [13, 166, 219, 224, 253, 254, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 328, 329, 332, 345, 360, 368, 371, 376, 378, 381, 387, 388, 396], "conflict": 13, "pin": [13, 269], "denot": 13, "sessionid": [13, 166, 219, 224, 253, 254, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 360, 368, 371, 376, 378, 381, 387, 388, 396, 399, 423], "mongoc_error_collect": 13, "mongoc_error_collection_insert_fail": 13, "mongoc_error_collection_update_fail": 13, "mongoc_error_collection_delete_fail": 13, "mongoc_collection_insert_bulk": [13, 14, 339], "mongoc_collection_update_on": [13, 14, 273, 333, 339, 340, 341, 696], "mongoc_collection_update_mani": [13, 14, 333, 339, 340, 342], "mongoc_collection_replace_on": [13, 14, 334, 339, 340, 342], "mongoc_collection_delete_on": [13, 14, 302, 303, 330, 339, 397, 696], "mongoc_collection_delete_mani": [13, 14, 302, 304, 330, 339, 397], "mongoc_error_gridf": 13, "mongoc_error_gridfs_chunk_miss": 13, "miss": [13, 160, 253, 328, 387], "chunk": [13, 226, 424, 426, 427, 430, 431, 439, 453, 470, 472], "mongoc_error_gridfs_corrupt": 13, "inconsist": [13, 19, 572], "mongoc_error_gridfs_invalid_filenam": 13, "filenam": [13, 426, 427, 430, 431, 441, 451, 458, 462, 467, 472, 473], "mongoc_gridfs_remove_by_filenam": [13, 14, 473], "mongoc_error_gridfs_protocol_error": 13, "mongoc_gridfs_file_set_id": [13, 14, 462, 473], "mongoc_gridfs_file_sav": [13, 14, 456, 457, 458, 460, 461, 462, 473], "mongoc_error_gridfs_bucket_file_not_found": 13, "mongoc_error_gridfs_bucket_stream": 13, "mongoc_gridfs_bucket_upload_from_stream": [13, 14, 429, 431], "mongoc_error_scram": 13, "mongoc_error_scram_protocol_error": 13, "scram": [13, 18, 655], "sha": [13, 18, 655], "mongoc_error_server_select": [13, 669], "mongoc_error_server_selection_failur": 13, "No": [13, 123, 253, 317, 328, 335, 350, 387, 391, 523, 620, 628], "prefer": [13, 15, 163, 164, 166, 227, 229, 253, 254, 256, 272, 280, 287, 289, 291, 292, 294, 296, 312, 317, 321, 328, 329, 336, 344, 363, 368, 369, 370, 371, 384, 387, 388, 392, 394, 395, 424, 473, 504, 507, 508, 509, 510, 511, 513, 514, 517, 518, 519, 520, 521, 530, 556, 602, 607, 617, 636, 637, 666, 686, 697], "There": [13, 15, 20, 220, 222, 473, 556, 594, 619, 696], "concern": [13, 135, 137, 163, 164, 165, 166, 170, 228, 234, 253, 254, 272, 279, 284, 287, 288, 289, 291, 292, 295, 296, 297, 298, 300, 301, 302, 303, 304, 308, 309, 311, 313, 314, 317, 320, 322, 323, 324, 325, 326, 328, 329, 332, 333, 334, 335, 337, 340, 341, 342, 344, 345, 368, 369, 370, 371, 373, 376, 387, 388, 391, 393, 394, 395, 396, 399, 411, 414, 424, 499, 501, 502, 503, 504, 505, 521, 556, 557, 607, 616, 618, 631, 635, 637, 646, 665, 668, 672, 674, 675, 677, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693], "mongoc_error_transact": 13, "mongoc_error_transaction_invalid": 13, "transact": [13, 21, 166, 219, 224, 253, 254, 257, 261, 262, 270, 271, 272, 273, 274, 275, 285, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 547, 551, 553, 554, 556, 557, 607, 608, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619], "progress": [13, 135, 257, 261, 262, 271, 272, 590, 619], "commit": [13, 261, 271, 272, 274, 275, 287, 344, 395, 607, 610, 615, 619, 669], "abort": [13, 257, 262, 271, 272, 274, 399, 411, 414, 419, 555, 557, 619], "mongoc_error_client_side_encrypt": 13, "libmongocrypt": [13, 17, 123, 695], "librari": [13, 14, 17, 18, 19, 121, 123, 199, 221, 671, 696, 697], "mongoc_error_azur": 13, "mongoc_error_kms_server_http": 13, "azur": [13, 128, 130, 176, 209, 210], "mongoc_error_kms_server_bad_json": 13, "mongoc_error_gcp": 13, "gcp": [13, 128, 130, 176, 209, 210], "decis": 13, "categori": 13, "perfectli": 13, "reliabl": [13, 272], "errorlabel": [13, 272, 607], "mongoc_error_has_label": [13, 14, 272, 607], "mongoc_client_session_start_transact": [13, 14, 166, 219, 224, 253, 254, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 273, 285, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 398, 399, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "leav": [13, 149, 363, 364], "state": [13, 19, 20, 162, 270, 485, 602, 603, 619], "stepdown": 13, "sequenc": [13, 21, 273, 274, 275, 285, 547, 554, 670, 696], "again": [13, 272, 556, 607, 669], "mongoc_client_session_commit_transact": [13, 14, 257, 258, 259, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "choos": [13, 20, 149, 225, 256, 312, 363, 409, 506, 521, 669, 697], "design": [13, 126, 199, 207, 221], "flaw": 13, "origin": [13, 123, 320, 322], "therefor": [13, 19, 346, 474, 487, 574, 586, 669], "tell": [13, 462, 694, 696], "24": [13, 20, 36, 48, 60, 171, 182, 190, 192, 193, 194, 195, 196, 197, 198, 671, 695], "locktimeout": 13, "fix": 13, "preserv": [13, 158, 293, 372], "backward": [13, 19, 136, 149, 352, 363, 364, 695], "maintain": [13, 286], "mongoc_database_command_with_opt": [13, 14, 369, 387, 394], "mongoc_collection_count_with_opt": [13, 14, 295, 339], "mongoc_client_get_database_names_with_opt": [13, 14, 223, 286], "mongoc_error_api_version_legaci": [13, 248, 278], "mongoc_error_api_version_2": [13, 248, 278, 557], "mongoc_client_pool_set_error_api": [13, 14, 251, 278, 696], "basic": [14, 18, 284, 296, 337, 393, 450, 473, 669], "troubleshoot": [14, 18, 696], "distinct": [14, 16, 18, 36, 37, 48, 49, 60, 61, 166, 227, 253, 254, 288, 289, 292, 317, 328, 329, 345, 368, 371, 387, 388, 396, 557], "mapreduc": [14, 16, 18, 253, 254, 328, 329, 387, 388], "microsoft": [14, 16, 18, 20, 558, 559, 561], "visual": [14, 16, 18], "studio": [14, 16, 18], "aid": [14, 16, 18], "debug": [14, 16, 18, 20, 22, 697], "side": [14, 17, 35, 47, 59, 122, 129, 139, 145, 153, 155, 157, 168, 185, 213, 218, 239, 266, 289, 290, 303, 304, 312, 315, 316, 317, 325, 326, 333, 341, 342, 348, 350, 358, 366, 367, 368, 369, 378, 411, 620], "level": [14, 17, 18, 22, 122, 129, 168, 185, 218, 227, 239, 256, 359, 360, 495, 505, 557, 571, 589, 669], "mongoc_auto_encryption_opts_set_keyvault_client_pool": [14, 21, 124, 131], "mongoc_auto_encryption_opts_set_kms_credential_provider_callback": [14, 131, 208], "mongoc_auto_encryption_opts_set_extra": [14, 17, 119, 131], "mongoc_auto_encryption_opts_set_tls_opt": [14, 131], "mongoc_auto_encryption_opts_set_encrypted_fields_map": [14, 17, 129, 131], "mongoc_auto_encryption_opts_set_bypass_query_analysi": [14, 131, 181, 182], "mongoc_bulk_operation_delet": [14, 151], "mongoc_bulk_operation_delete_on": [14, 151], "mongoc_bulk_operation_get_hint": [14, 135, 151], "mongoc_bulk_operation_get_write_concern": [14, 151], "mongoc_bulk_operation_insert_with_opt": [14, 138, 151], "mongoc_bulk_operation_remove_many_with_opt": [14, 132, 133, 140, 142, 143, 145, 151], "mongoc_bulk_operation_remove_one_with_opt": [14, 132, 133, 140, 141, 142, 151], "mongoc_bulk_operation_set_client_sess": [14, 151], "mongoc_bulk_operation_set_com": [14, 151], "mongoc_bulk_operation_set_hint": [14, 151], "mongoc_bulk_operation_set_let": [14, 151], "mongoc_bulk_operation_upd": [14, 151, 154, 297, 298], "mongoc_bulk_operation_update_on": [14, 151], "mongoc_client_watch": [14, 160, 286, 344, 395], "mongoc_database_watch": [14, 160, 287, 344, 394], "mongoc_collection_watch": [14, 160, 287, 395], "mongoc_change_stream_get_resume_token": [14, 160, 287, 344, 395], "mongoc_change_stream_error_docu": [14, 159, 160, 287, 344, 395], "mongoc_change_stream_destroi": [14, 160, 287, 344, 395], "mongoc_client_encryption_create_encrypted_collect": [14, 218], "mongoc_client_encryption_rewrap_many_datakei": [14, 215, 217, 218], "mongoc_client_encryption_delete_kei": [14, 218], "mongoc_client_encryption_get_crypt_shared_vers": [14, 218, 221], "mongoc_client_encryption_get_kei": [14, 218], "mongoc_client_encryption_add_key_alt_nam": [14, 218], "mongoc_client_encryption_remove_key_alt_nam": [14, 218], "mongoc_client_encryption_get_key_by_alt_nam": [14, 218], "mongoc_client_encryption_encrypt_express": [14, 181, 218], "mongoc_client_decryption_decrypt": [14, 181, 182, 218], "mongoc_client_encryption_datakey_opts_set_masterkei": [14, 171, 177], "mongoc_client_encryption_datakey_opts_set_keymateri": [14, 177], "mongoc_client_encryption_rewrap_many_datakey_result_new": [14, 214, 217], "mongoc_client_encryption_rewrap_many_datakey_result_destroi": [14, 216, 217], "mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result": [14, 217], "mongoc_client_encryption_encrypt_opts_set_contention_factor": [14, 191], "mongoc_client_encryption_encrypt_opts_set_query_typ": [14, 191], "mongoc_client_encryption_encrypt_opts_set_range_opt": [14, 191, 198], "mongoc_client_encryption_encrypt_range_opts_new": [14, 190, 192, 198], "mongoc_client_encryption_encrypt_range_opts_destroi": [14, 193, 198], "mongoc_client_encryption_encrypt_range_opts_set_spars": [14, 198], "mongoc_client_encryption_encrypt_range_opts_set_min": [14, 194, 196, 198], "mongoc_client_encryption_encrypt_range_opts_set_max": [14, 195, 196, 198], "mongoc_client_encryption_encrypt_range_opts_set_precis": [14, 194, 195, 198], "mongoc_client_encryption_opts_set_kms_credential_provider_callback": [14, 127, 211], "mongoc_client_encryption_opts_set_tls_opt": [14, 211], "mongoc_client_pool_destroi": [14, 21, 242, 243, 251, 696], "mongoc_client_pool_enable_auto_encrypt": [14, 17, 21, 125, 168, 170, 218, 251], "mongoc_client_pool_max_s": [14, 251], "mongoc_client_pool_min_s": [14, 251], "mongoc_client_pool_new_with_error": [14, 242, 251], "mongoc_client_pool_set_appnam": [14, 251], "mongoc_client_pool_set_server_api": [14, 251], "mongoc_client_pool_try_pop": [14, 250, 251], "mongoc_client_session_in_transact": [14, 273, 553], "mongoc_client_session_get_transaction_st": [14, 273], "mongoc_client_session_abort_transact": [14, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_advance_cluster_tim": [14, 257, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_advance_operation_tim": [14, 257, 258, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_with_transact": [14, 273, 275], "mongoc_client_session_append": [14, 166, 219, 224, 253, 254, 272, 273, 274, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 555, 557, 607], "mongoc_client_session_get_cli": [14, 257, 258, 259, 261, 262, 264, 265, 266, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_get_cluster_tim": [14, 257, 258, 259, 261, 262, 263, 265, 266, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_get_dirti": [14, 273], "mongoc_client_session_get_operation_tim": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_get_opt": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_get_lsid": [14, 257, 258, 259, 261, 262, 263, 264, 265, 267, 268, 269, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_get_server_id": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 272, 273, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_session_destroi": [14, 21, 257, 258, 259, 261, 263, 264, 265, 266, 267, 268, 269, 272, 273, 274, 285, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_command": [14, 164, 286, 694], "mongoc_client_command_simple_with_server_id": [14, 286], "mongoc_client_find_databases_with_opt": [14, 286, 362, 364, 365], "mongoc_client_get_crypt_shared_vers": [14, 199, 286], "mongoc_client_get_database_nam": [14, 286], "mongoc_client_get_default_databas": [14, 286, 658], "mongoc_client_get_gridf": [14, 286, 473], "mongoc_client_get_handshake_descript": [14, 286], "mongoc_client_get_read_concern": [14, 286, 503], "mongoc_client_get_read_pref": [14, 286], "mongoc_client_get_server_descript": [14, 227, 286, 537, 540, 544, 546], "mongoc_client_get_server_statu": [14, 286], "mongoc_client_get_uri": [14, 286], "mongoc_client_get_write_concern": [14, 286, 683], "mongoc_client_new_from_uri_with_error": [14, 236, 286], "mongoc_client_read_command_with_opt": [14, 163, 166, 232, 254, 286, 288, 289, 292, 295, 296, 311, 328, 329, 343, 345, 368, 371, 387, 388, 396, 424, 499], "mongoc_client_read_write_command_with_opt": [14, 163, 286], "mongoc_client_reset": [14, 286], "mongoc_client_select_serv": [14, 166, 219, 224, 227, 253, 254, 286, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 328, 329, 332, 345, 368, 371, 376, 378, 381, 387, 388, 396], "mongoc_client_set_appnam": [14, 247, 286, 696], "mongoc_client_set_read_concern": [14, 286, 503], "mongoc_client_set_read_pref": [14, 286], "mongoc_client_set_server_api": [14, 286], "mongoc_client_set_stream_initi": [14, 286], "mongoc_client_set_write_concern": [14, 286, 683], "mongoc_client_start_sess": [14, 21, 147, 166, 219, 224, 253, 254, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 274, 286, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_client_write_command_with_opt": [14, 163, 166, 253, 254, 260, 286, 289, 292, 298, 300, 301, 303, 304, 308, 309, 325, 326, 329, 332, 333, 341, 342, 345, 368, 371, 376, 388, 396, 399, 424, 672], "mongoc_handshake_data_append": [14, 286], "mongoc_collection_command": [14, 291, 339, 694], "mongoc_collection_command_simpl": [14, 24, 312, 317, 328, 329, 339, 345, 694], "mongoc_collection_command_with_opt": [14, 290, 328, 339], "mongoc_collection_copi": [14, 339], "mongoc_collection_count_docu": [14, 294, 296, 311, 339], "mongoc_collection_estimated_document_count": [14, 294, 295, 296, 339], "mongoc_collection_count": [14, 295, 296, 339, 696], "mongoc_collection_create_bulk_oper": [14, 339], "mongoc_collection_create_index_with_opt": [14, 339], "mongoc_collection_delet": [14, 339], "mongoc_collection_drop_index": [14, 339, 694], "mongoc_collection_drop_index_with_opt": [14, 23, 339], "mongoc_collection_drop_with_opt": [14, 306, 307, 339], "mongoc_collection_ensure_index": [14, 339], "mongoc_collection_find": [14, 339, 355, 364, 494], "mongoc_collection_find_and_modifi": [14, 339], "mongoc_collection_find_and_modify_with_opt": [14, 313, 339, 399, 408, 409, 410, 411, 412, 413, 414], "mongoc_collection_find_index": [14, 339], "mongoc_collection_find_indexes_with_opt": [14, 23, 315, 339, 362, 364, 365], "mongoc_collection_get_last_error": [14, 339], "mongoc_collection_get_nam": [14, 339], "mongoc_collection_get_read_concern": [14, 339], "mongoc_collection_get_read_pref": [14, 339], "mongoc_collection_get_write_concern": [14, 339], "mongoc_collection_insert": [14, 339], "mongoc_collection_keys_to_index_str": [14, 23, 339], "mongoc_collection_read_command_with_opt": [14, 290, 339], "mongoc_collection_read_write_command_with_opt": [14, 290, 339], "mongoc_collection_remov": [14, 339], "mongoc_collection_renam": [14, 339], "mongoc_collection_rename_with_opt": [14, 331, 339], "mongoc_collection_sav": [14, 339], "mongoc_collection_set_read_concern": [14, 293, 339], "mongoc_collection_set_read_pref": [14, 293, 339], "mongoc_collection_set_write_concern": [14, 293, 339], "mongoc_collection_stat": [14, 339], "mongoc_collection_upd": [14, 339, 413], "mongoc_collection_valid": [14, 339], "mongoc_collection_write_command_with_opt": [14, 160, 290, 339], "mongoc_cursor_clon": [14, 366], "mongoc_cursor_curr": [14, 366], "mongoc_cursor_error_docu": [14, 157, 163, 289, 290, 312, 315, 316, 317, 349, 366, 368, 369, 378], "mongoc_cursor_get_batch_s": [14, 366], "mongoc_cursor_get_hint": [14, 366], "mongoc_cursor_get_host": [14, 366, 475], "mongoc_cursor_get_id": [14, 366], "mongoc_cursor_get_limit": [14, 366], "mongoc_cursor_get_max_await_time_m": [14, 366], "mongoc_cursor_is_al": [14, 366], "mongoc_cursor_new_from_command_repli": [14, 366], "mongoc_cursor_new_from_command_reply_with_opt": [14, 359, 366], "mongoc_cursor_set_batch_s": [14, 219, 315, 316, 365, 366, 377, 378], "mongoc_cursor_set_hint": [14, 352, 366], "mongoc_cursor_set_limit": [14, 219, 315, 316, 355, 366, 377, 378], "mongoc_database_add_us": [14, 394], "mongoc_database_aggreg": [14, 394], "mongoc_database_copi": [14, 394], "mongoc_database_drop": [14, 394], "mongoc_database_drop_with_opt": [14, 375, 394], "mongoc_database_find_collect": [14, 394], "mongoc_database_find_collections_with_opt": [14, 362, 364, 365, 377, 394], "mongoc_database_get_collection_nam": [14, 394], "mongoc_database_get_collection_names_with_opt": [14, 378, 380, 394], "mongoc_database_get_nam": [14, 225, 394], "mongoc_database_get_read_concern": [14, 394], "mongoc_database_get_read_pref": [14, 394], "mongoc_database_get_write_concern": [14, 394], "mongoc_database_has_collect": [14, 394], "mongoc_database_read_write_command_with_opt": [14, 369, 394], "mongoc_database_remove_all_us": [14, 394], "mongoc_database_remove_us": [14, 394], "mongoc_database_set_read_concern": [14, 372, 394], "mongoc_database_set_read_pref": [14, 372, 394], "mongoc_database_set_write_concern": [14, 372, 394], "mongoc_database_write_command_with_opt": [14, 369, 394], "mongoc_find_and_modify_opts_append": [14, 314, 411, 414], "mongoc_find_and_modify_opts_destroi": [14, 399, 407, 408, 409, 410, 411, 412, 413, 414], "mongoc_find_and_modify_opts_get_bypass_document_valid": [14, 414], "mongoc_find_and_modify_opts_get_field": [14, 414], "mongoc_find_and_modify_opts_get_flag": [14, 414], "mongoc_find_and_modify_opts_get_max_time_m": [14, 414], "mongoc_find_and_modify_opts_get_sort": [14, 414], "mongoc_find_and_modify_opts_get_upd": [14, 414], "mongoc_find_and_modify_opts_new": [14, 399, 408, 409, 410, 411, 412, 413, 414], "mongoc_find_and_modify_opts_set_bypass_document_valid": [14, 401, 414], "mongoc_find_and_modify_opts_set_field": [14, 402, 414], "mongoc_find_and_modify_opts_set_flag": [14, 403, 409, 413, 414], "mongoc_find_and_modify_opts_set_max_time_m": [14, 399, 404, 414], "mongoc_find_and_modify_opts_set_sort": [14, 405, 414], "mongoc_find_and_modify_opts_set_upd": [14, 399, 406, 408, 409, 410, 411, 412, 414], "mongoc_gridfs_file_list_destroi": [14, 450, 465, 469, 473], "mongoc_gridfs_file_list_error": [14, 450], "mongoc_gridfs_file_list_next": [14, 450, 473], "mongoc_gridfs_file_destroi": [14, 432, 433, 449, 450, 462, 466, 467, 468, 473], "mongoc_gridfs_file_error": [14, 452, 454, 462, 464, 473], "mongoc_gridfs_file_get_alias": [14, 462], "mongoc_gridfs_file_get_chunk_s": [14, 462], "mongoc_gridfs_file_get_content_typ": [14, 462], "mongoc_gridfs_file_get_filenam": [14, 462, 473], "mongoc_gridfs_file_get_id": [14, 462], "mongoc_gridfs_file_get_length": [14, 462], "mongoc_gridfs_file_get_md5": [14, 462], "mongoc_gridfs_file_get_metadata": [14, 462], "mongoc_gridfs_file_get_upload_d": [14, 462], "mongoc_gridfs_file_readv": [14, 462], "mongoc_gridfs_file_remov": [14, 462], "mongoc_gridfs_file_seek": [14, 462], "mongoc_gridfs_file_set_alias": [14, 462], "mongoc_gridfs_file_set_content_typ": [14, 462], "mongoc_gridfs_file_set_filenam": [14, 462], "mongoc_gridfs_file_set_md5": [14, 462], "mongoc_gridfs_file_set_metadata": [14, 462], "mongoc_gridfs_file_tel": [14, 462], "mongoc_gridfs_file_writev": [14, 432, 462], "mongoc_stream_gridfs_new": [14, 462, 473], "mongoc_gridfs_bucket_abort_upload": [14, 429], "mongoc_gridfs_bucket_delete_by_id": [14, 429], "mongoc_gridfs_bucket_destroi": [14, 424, 429], "mongoc_gridfs_bucket_download_to_stream": [14, 429], "mongoc_gridfs_bucket_find": [14, 429], "mongoc_gridfs_bucket_new": [14, 429], "mongoc_gridfs_bucket_open_download_stream": [14, 428, 429], "mongoc_gridfs_bucket_open_upload_stream": [14, 419, 427, 428, 429], "mongoc_gridfs_bucket_open_upload_stream_with_id": [14, 419, 426, 428, 429], "mongoc_gridfs_bucket_stream_error": [14, 425, 426, 427, 429], "mongoc_gridfs_bucket_upload_from_stream_with_id": [14, 429, 430], "mongoc_gridfs_create_fil": [14, 473, 586], "mongoc_gridfs_create_file_from_stream": [14, 473, 586], "mongoc_gridfs_destroi": [14, 226, 473], "mongoc_gridfs_drop": [14, 473], "mongoc_gridfs_find": [14, 450, 473], "mongoc_gridfs_find_on": [14, 473], "mongoc_gridfs_find_one_by_filenam": [14, 473], "mongoc_gridfs_find_one_with_opt": [14, 466, 473], "mongoc_gridfs_find_with_opt": [14, 465, 473], "mongoc_gridfs_get_chunk": [14, 473], "mongoc_gridfs_get_fil": [14, 473], "mongoc_index_opt_geo_get_default": [14, 478], "mongoc_index_opt_geo_init": [14, 478, 481], "mongoc_index_opt_get_default": [14, 481], "mongoc_index_opt_init": [14, 481], "mongoc_index_opt_wt_get_default": [14, 484], "mongoc_index_opt_wt_init": [14, 484], "mongoc_optional_copi": [14, 492], "mongoc_optional_init": [14, 492], "mongoc_optional_is_set": [14, 491, 492], "mongoc_optional_set_valu": [14, 492], "mongoc_optional_valu": [14, 492], "mongoc_rand_add": [14, 495], "mongoc_rand_se": [14, 495], "mongoc_rand_statu": [14, 495], "mongoc_read_concern_append": [14, 166, 253, 254, 288, 289, 292, 295, 296, 311, 317, 328, 329, 368, 371, 381, 387, 388, 424, 506], "mongoc_read_concern_copi": [14, 506], "mongoc_read_concern_destroi": [14, 253, 272, 288, 381, 500, 504, 506, 607], "mongoc_read_concern_get_level": [14, 506], "mongoc_read_concern_is_default": [14, 506], "mongoc_read_concern_new": [14, 253, 272, 288, 317, 381, 506, 607], "mongoc_read_concern_set_level": [14, 253, 272, 288, 317, 381, 506, 607], "mongoc_read_prefs_add_tag": [14, 521], "mongoc_read_prefs_copi": [14, 521], "mongoc_read_prefs_get_hedg": [14, 521], "mongoc_read_prefs_get_max_staleness_second": [14, 521], "mongoc_read_prefs_get_mod": [14, 521], "mongoc_read_prefs_get_tag": [14, 521], "mongoc_read_prefs_is_valid": [14, 521], "mongoc_read_prefs_set_hedg": [14, 521], "mongoc_read_prefs_set_max_staleness_second": [14, 521], "mongoc_read_prefs_set_mod": [14, 521], "mongoc_read_prefs_set_tag": [14, 521], "mongoc_server_api_copi": [14, 532], "mongoc_server_api_deprecation_error": [14, 532], "mongoc_server_api_destroi": [14, 524, 530, 532], "mongoc_server_api_get_deprecation_error": [14, 532], "mongoc_server_api_get_strict": [14, 532], "mongoc_server_api_get_vers": [14, 532], "mongoc_server_api_new": [14, 532], "mongoc_server_api_strict": [14, 311, 532], "mongoc_server_api_version_from_str": [14, 534], "mongoc_server_api_version_to_str": [14, 534], "mongoc_server_description_destroi": [14, 227, 230, 256, 542, 544], "mongoc_server_description_hello_respons": [14, 540, 544], "mongoc_server_description_id": [14, 166, 219, 224, 253, 254, 288, 289, 292, 295, 296, 301, 308, 309, 311, 316, 317, 328, 329, 332, 345, 368, 371, 376, 378, 381, 387, 388, 396, 544], "mongoc_server_description_ismast": [14, 544], "mongoc_server_description_last_update_tim": [14, 544], "mongoc_server_description_new_copi": [14, 544], "mongoc_server_description_round_trip_tim": [14, 544], "mongoc_session_opts_new": [14, 21, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 547, 548, 549, 550, 551, 552, 553, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_get_causal_consist": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 547, 548, 549, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_set_causal_consist": [14, 21, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 547, 548, 549, 550, 551, 552, 553, 554, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_get_default_transaction_opt": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 547, 548, 549, 550, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_set_default_transaction_opt": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 547, 548, 549, 550, 551, 552, 553, 554, 555, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_get_snapshot": [14, 547], "mongoc_session_opts_set_snapshot": [14, 547, 552, 555], "mongoc_session_opts_get_transaction_opt": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 547, 548, 549, 550, 551, 552, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_clon": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 547, 549, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_session_opts_destroi": [14, 21, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 273, 285, 547, 548, 550, 551, 552, 553, 554, 555, 556, 557, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_socket_accept": [14, 572], "mongoc_socket_bind": [14, 572], "mongoc_socket_clos": [14, 572], "mongoc_socket_connect": [14, 572], "mongoc_socket_destroi": [14, 558, 567, 572], "mongoc_socket_errno": [14, 560, 572], "mongoc_socket_getnameinfo": [14, 572], "mongoc_socket_getsocknam": [14, 572], "mongoc_socket_listen": [14, 572], "mongoc_socket_new": [14, 572], "mongoc_socket_recv": [14, 572], "mongoc_socket_send": [14, 572], "mongoc_socket_sendv": [14, 572], "mongoc_socket_setsockopt": [14, 572], "mongoc_ssl_opt_get_default": [14, 574], "mongoc_stream_file_get_fd": [14, 583], "mongoc_stream_file_new": [14, 422, 430, 431, 583], "mongoc_stream_file_new_for_path": [14, 422, 429, 430, 431, 473, 583], "mongoc_stream_socket_get_socket": [14, 593], "mongoc_stream_socket_new": [14, 593], "mongoc_stream_buffered_new": [14, 576, 578, 594, 597], "mongoc_stream_clos": [14, 422, 426, 427, 429, 430, 431, 594], "mongoc_stream_cork": [14, 594, 597], "mongoc_stream_destroi": [14, 429, 473, 575, 576, 577, 581, 582, 592, 594], "mongoc_stream_flush": [14, 594], "mongoc_stream_get_base_stream": [14, 594], "mongoc_stream_read": [14, 430, 431, 588, 594, 598], "mongoc_stream_readv": [14, 473, 586, 587, 594, 598], "mongoc_stream_setsockopt": [14, 594], "mongoc_stream_should_retri": [14, 594], "mongoc_stream_timed_out": [14, 594], "mongoc_stream_uncork": [14, 578, 594], "mongoc_stream_writ": [14, 587, 588, 594], "mongoc_stream_writev": [14, 586, 587, 588, 594, 598], "mongoc_topology_description_destroi": [14, 604, 605], "mongoc_topology_description_new_copi": [14, 605], "mongoc_transaction_opts_new": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 615, 616, 617, 618], "mongoc_transaction_opts_get_read_concern": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 612, 613, 614, 615, 616, 617, 618], "mongoc_transaction_opts_set_read_concern": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 617, 618], "mongoc_transaction_opts_get_write_concern": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 614, 615, 616, 617, 618], "mongoc_transaction_opts_set_write_concern": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617], "mongoc_transaction_opts_get_read_pref": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 613, 614, 615, 616, 617, 618], "mongoc_transaction_opts_set_read_pref": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 618], "mongoc_transaction_opts_get_max_commit_time_m": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_transaction_opts_set_max_commit_time_m": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 609, 610, 611, 612, 613, 614, 616, 617, 618], "mongoc_transaction_opts_clon": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_transaction_opts_destroi": [14, 257, 258, 259, 261, 262, 263, 264, 265, 266, 267, 268, 269, 272, 285, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 607, 608, 610, 611, 612, 613, 614, 615, 616, 617, 618], "mongoc_uri_copi": [14, 669], "mongoc_uri_get_compressor": [14, 669], "mongoc_uri_get_databas": [14, 669], "mongoc_uri_get_host": [14, 475, 669], "mongoc_uri_get_option_as_bool": [14, 669], "mongoc_uri_get_option_as_int32": [14, 631, 669], "mongoc_uri_get_option_as_int64": [14, 630, 669], "mongoc_uri_get_option_as_utf8": [14, 669], "mongoc_uri_get_opt": [14, 669], "mongoc_uri_get_password": [14, 669], "mongoc_uri_get_read_concern": [14, 669], "mongoc_uri_get_read_pref": [14, 669], "mongoc_uri_get_read_prefs_t": [14, 636, 669], "mongoc_uri_get_replica_set": [14, 669], "mongoc_uri_get_servic": [14, 669], "mongoc_uri_get_ssl": [14, 669], "mongoc_uri_get_str": [14, 669], "mongoc_uri_get_srv_hostnam": [14, 639, 669], "mongoc_uri_get_srv_service_nam": [14, 669], "mongoc_uri_get_tl": [14, 642, 669], "mongoc_uri_get_usernam": [14, 669], "mongoc_uri_get_write_concern": [14, 669], "mongoc_uri_has_opt": [14, 669], "mongoc_uri_new_for_host_port": [14, 669], "mongoc_uri_option_is_bool": [14, 669], "mongoc_uri_option_is_int32": [14, 653, 669], "mongoc_uri_option_is_int64": [14, 652, 662, 669], "mongoc_uri_option_is_utf8": [14, 669], "mongoc_uri_set_compressor": [14, 669], "mongoc_uri_set_databas": [14, 669], "mongoc_uri_set_option_as_int32": [14, 662, 669], "mongoc_uri_set_option_as_int64": [14, 661, 669], "mongoc_uri_set_password": [14, 669], "mongoc_uri_set_read_concern": [14, 669], "mongoc_uri_set_read_prefs_t": [14, 669], "mongoc_uri_set_usernam": [14, 669], "mongoc_uri_set_write_concern": [14, 669], "mongoc_uri_unescap": [14, 669], "mongoc_check_vers": [14, 671], "mongoc_get_major_vers": [14, 671], "mongoc_get_micro_vers": [14, 671], "mongoc_get_minor_vers": [14, 671], "mongoc_get_vers": [14, 671], "mongoc_write_concern_copi": [14, 694], "mongoc_write_concern_get_fsync": [14, 694], "mongoc_write_concern_get_journ": [14, 675, 694], "mongoc_write_concern_get_w": [14, 694], "mongoc_write_concern_get_wmajor": [14, 694], "mongoc_write_concern_get_wtag": [14, 694], "mongoc_write_concern_get_wtimeout": [14, 692, 694], "mongoc_write_concern_get_wtimeout_int64": [14, 680, 693, 694], "mongoc_write_concern_is_acknowledg": [14, 694], "mongoc_write_concern_is_default": [14, 694], "mongoc_write_concern_is_valid": [14, 694], "mongoc_write_concern_journal_is_set": [14, 694], "mongoc_write_concern_set_fsync": [14, 694], "mongoc_write_concern_set_journ": [14, 687, 694], "mongoc_write_concern_set_wtag": [14, 694], "mongoc_write_concern_set_wtimeout": [14, 680, 694], "apm": [14, 18], "mongoc_apm_command_failed_get_dur": [14, 40], "mongoc_apm_command_failed_get_host": [14, 40], "mongoc_apm_command_failed_get_operation_id": [14, 40], "mongoc_apm_command_failed_get_repli": [14, 40], "mongoc_apm_command_failed_get_request_id": [14, 40], "mongoc_apm_command_failed_get_server_id": [14, 36, 37, 40], "mongoc_apm_command_failed_get_service_id": [14, 40], "mongoc_apm_command_failed_get_server_connection_id": [14, 40], "mongoc_apm_command_failed_get_server_connection_id_int64": [14, 36, 40], "mongoc_apm_command_started_get_database_nam": [14, 52], "mongoc_apm_command_started_get_operation_id": [14, 52], "mongoc_apm_command_started_get_request_id": [14, 52], "mongoc_apm_command_started_get_server_id": [14, 48, 49, 52], "mongoc_apm_command_started_get_service_id": [14, 52], "mongoc_apm_command_started_get_server_connection_id": [14, 52], "mongoc_apm_command_started_get_server_connection_id_int64": [14, 48, 52], "mongoc_apm_command_succeeded_get_dur": [14, 64], "mongoc_apm_command_succeeded_get_host": [14, 64], "mongoc_apm_command_succeeded_get_operation_id": [14, 64], "mongoc_apm_command_succeeded_get_request_id": [14, 64], "mongoc_apm_command_succeeded_get_server_id": [14, 60, 61, 64], "mongoc_apm_command_succeeded_get_service_id": [14, 64], "mongoc_apm_command_succeeded_get_server_connection_id": [14, 64], "mongoc_apm_command_succeeded_get_server_connection_id_int64": [14, 60, 64], "mongoc_apm_server_changed_get_topology_id": [14, 70], "mongoc_apm_server_closed_get_topology_id": [14, 74], "mongoc_apm_server_heartbeat_failed_get_await": [14, 80], "mongoc_apm_server_heartbeat_failed_get_dur": [14, 80], "mongoc_apm_server_heartbeat_started_get_await": [14, 84], "mongoc_apm_server_heartbeat_succeeded_get_await": [14, 90], "mongoc_apm_server_heartbeat_succeeded_get_dur": [14, 90], "mongoc_apm_server_opening_get_topology_id": [14, 94], "mongoc_apm_topology_changed_get_topology_id": [14, 111], "mongoc_apm_topology_closed_get_topology_id": [14, 114], "mongoc_apm_topology_opening_get_topology_id": [14, 117], "older": [15, 309, 317], "consist": [15, 17, 21, 150, 258, 259, 273, 274, 285, 289, 298, 303, 304, 333, 341, 342, 368, 399, 515, 547, 550, 554, 555, 557, 657, 689], "upload": [15, 419, 429, 430, 431, 446], "download": [15, 20, 422, 425, 429, 697], "straightforward": 15, "upgrad": [15, 311], "seek": [15, 462], "But": [15, 21, 669], "encourag": 15, "denable_client_side_encrypt": 17, "mkdir": [17, 20, 24], "denable_automatic_init_and_cleanup": [17, 19, 20], "target": [17, 20, 166, 219, 224, 253, 254, 288, 289, 292, 295, 296, 301, 308, 309, 311, 313, 314, 316, 317, 328, 329, 332, 345, 368, 371, 376, 378, 381, 387, 388, 396, 521, 582, 696], "explicit": [17, 121, 147, 170, 178, 181, 186, 189, 190, 194, 195, 196, 197, 199, 426, 430], "cross": 18, "packag": [18, 696], "integr": [18, 22, 473], "crud": [18, 288, 339, 345, 396], "256": 18, "cr": 18, "gssapi": [18, 628, 650, 655, 659], "kerbero": [18, 20, 669, 697], "plain": [18, 457], "509": 18, "aw": [18, 128, 130, 170, 176, 209, 210], "iam": 18, "checklist": 18, "counter": [18, 19, 162, 255, 485], "submit": [18, 151, 313], "bug": [18, 696], "exactli": [19, 162, 485, 669], "global": [19, 162, 280, 297, 336, 392, 485, 521], "primit": [19, 162, 485, 495], "mongoc_log_set_handl": [19, 22, 162, 485], "would": [19, 20, 162, 212, 312, 455, 485, 505, 669, 670, 677, 687, 688, 689, 690, 691, 692, 693], "handler": [19, 162, 485], "reiniti": [19, 162, 485], "problemat": 19, "situat": [19, 521, 669], "shutdown": [19, 560], "across": 19, "meanwhil": 19, "portabl": [19, 487, 558, 559, 561, 572], "yourself": 19, "varieti": 20, "archlinux": 20, "debian": 20, "Will": [20, 146, 410, 657], "upcom": 20, "x86_64": 20, "2008": 20, "rhel": 20, "7": [20, 475, 494, 669, 695, 696], "ubuntu": 20, "16": [20, 410, 414, 671, 696], "04": [20, 129], "18": [20, 540], "20": 20, "clang": [20, 474], "2015": 20, "2017": 20, "x86": 20, "arm": 20, "aarch64": 20, "power8": 20, "ppc64le": 20, "zseri": 20, "s390x": 20, "being": [20, 213, 454, 464, 474, 669], "suffici": [20, 495], "apt": 20, "dev": 20, "header": 20, "polici": 20, "fedora": 20, "dnf": 20, "devel": 20, "fedoraproject": 20, "red": [20, 696], "hat": 20, "cento": 20, "epel": 20, "yum": 20, "homebrew": 20, "brew": 20, "openssl": 20, "redhat": 20, "sudo": 20, "libsasl2": 20, "freebsd": 20, "su": 20, "adjust": [20, 455], "xcode": 20, "util": [20, 218], "accord": [20, 166, 256, 292, 371], "vista": 20, "beyond": [20, 361, 669], "github": 20, "i686": 20, "minggw": 20, "msys64": 20, "ming64": 20, "ex": [20, 696], "msys2_shel": 20, "pacman": 20, "noconfirm": 20, "syu": 20, "tar": 20, "mingw64": 20, "artifact": 20, "throughout": 20, "assum": [20, 287, 344, 395, 696], "subsequ": [20, 241, 258, 259, 287, 344, 395, 557], "section": [20, 627, 696], "snippet": [20, 696], "wget": 20, "gz": 20, "xzf": 20, "dcmake_build_typ": 20, "l": 20, "consider": 20, "amount": [20, 160, 287, 317, 344, 365, 395, 455], "home": 20, "conclud": 20, "anyth": [20, 410, 506], "denable_mongoc": 20, "though": [20, 300, 408, 414, 587, 598, 599], "fewer": 20, "entri": [20, 141, 143, 145, 153, 155, 160, 166, 219, 224, 253, 254, 273, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 316, 328, 329, 333, 341, 342, 345, 368, 371, 373, 376, 378, 381, 387, 388, 396, 555], "item": [20, 588, 599], "branch": 20, "particular": [20, 289, 394, 473, 495, 696], "checkout": 20, "calc_release_vers": 20, "version_curr": 20, "especi": [20, 22], "cygwin": 20, "certainti": 20, "toolchain": 20, "happen": [20, 274, 287, 344, 395, 486], "bit": [20, 439, 443, 463, 495, 630, 652, 653, 662, 680, 681, 697], "freeli": 20, "win64": 20, "dcmake_install_prefix": 20, "dcmake_prefix_path": 20, "lh": 20, "fine": 20, "grain": 20, "ninja": 20, "makefil": 20, "mode": [20, 163, 164, 290, 291, 311, 369, 370, 507, 513, 516, 519, 582, 636, 669], "relwithdebinfo": 20, "info": [20, 22, 31, 78], "cmake_install_prefix": [20, 697], "2019": 20, "examin": 20, "glob": 20, "vcxproj": 20, "sphinx": 20, "denable_man_pag": 20, "denable_html_doc": 20, "invok": 20, "usr": [20, 696], "sh": 20, "bat": 20, "exact": 20, "approach": 20, "readm": 20, "assist": 20, "emb": 20, "wish": [20, 361], "collis": 20, "standard": [20, 296, 327, 583, 669], "bson_output_basenam": 20, "mongoc_output_basenam": 20, "dbson_output_basenam": 20, "custom_bson": 20, "dmongoc_output_basenam": 20, "custom_mongoc": 20, "libcustom_bson": 20, "libcustom_mongoc": 20, "place": [20, 312, 655, 656, 660, 661, 662, 663, 669, 696], "lcustom_mongoc": 20, "lcustom_bson": 20, "linker": [20, 697], "possibli": [20, 283], "creation": [21, 206, 300, 473, 476, 479, 482, 495], "destruct": 21, "acquir": [21, 273, 285, 547, 554], "finish": [21, 358, 696], "destroi": [21, 105, 114, 118, 119, 134, 135, 151, 156, 171, 241, 246, 255, 273, 274, 276, 285, 300, 305, 343, 359, 360, 421, 434, 436, 544, 547, 554, 605, 628, 696], "lifetim": [21, 158, 159, 199, 221, 246, 264, 266, 268, 276, 283, 361, 551, 586, 611, 612, 613], "revers": [21, 696], "sole": [21, 32, 45, 56, 66, 72, 79, 83, 88, 92], "outliv": [21, 124, 125, 206, 218, 429], "came": [21, 75, 81, 85, 273, 285, 547, 554], "causal": [21, 258, 259, 273, 274, 285, 547, 550, 554, 555, 557, 689], "unacknowledg": [21, 147, 215, 260, 273, 285, 314, 547, 554, 555, 682, 689, 694], "prohibit": [21, 148, 150, 166, 176, 253, 254, 273, 285, 288, 289, 292, 317, 328, 329, 345, 368, 371, 387, 388, 396, 547, 554], "refresh": [21, 273, 285, 547, 554], "abstract": [22, 151, 366, 394, 414, 450, 462, 473, 487, 506, 521, 572, 594, 669, 694], "mongoc_log_level_error": 22, "mongoc_log_level_crit": 22, "mongoc_log_level_warn": 22, "mongoc_log_level_messag": 22, "mongoc_log_level_info": 22, "mongoc_log_level_debug": 22, "mongoc_log_level_trac": 22, "mongoc_log_level_t": 22, "mongoc_error": [22, 231, 272, 274, 473, 607], "mongoc_crit": 22, "mongoc_warn": [22, 648, 657], "mongoc_messag": 22, "mongoc_info": 22, "mongoc_debug": 22, "mongoc_log_func_t": 22, "log_level": 22, "log_domain": 22, "user_data": [22, 283, 286], "log_func": 22, "mongoc_log": 22, "bson_gnuc_printf": 22, "mongoc_log_level_str": 22, "mongoc_log_default_handl": 22, "mongoc_log_trace_en": 22, "mongoc_log_trace_dis": 22, "littl": 22, "less": [22, 512, 518, 669, 696], "pain": 22, "undef": 22, "mongoc_log_domain": 22, "my": [22, 429], "strerror": 22, "errno": [22, 455, 559, 560, 561, 563, 565, 566, 567, 568, 569, 570, 571, 577, 578, 581, 582, 584, 587, 588, 589, 597, 598, 599], "warn": [22, 235, 272, 607, 630, 657, 662, 687, 688, 689, 690, 691, 692, 693], "critic": 22, "overrid": [22, 166, 219, 224, 250, 253, 254, 272, 282, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 396, 399, 426, 427, 430, 431, 556, 607, 669], "mutex": [22, 251, 696], "safeti": [22, 696], "regist": [22, 246, 276, 437, 448, 511, 514, 696], "suppress": 22, "my_logg": 22, "smaller": 22, "go": 22, "intern": [22, 202, 255, 274, 277, 332, 494, 574, 628, 632, 696], "affect": [22, 279, 284], "significantli": 22, "overhead": 22, "repres": [23, 126, 270, 287, 289, 301, 344, 368, 395, 424, 426, 427, 430, 431, 520, 521, 533, 605, 696], "ascend": [23, 327], "handle_error": 23, "got": [23, 160, 291, 399, 408, 409, 410, 411, 412, 413, 414], "got_str": 23, "index_nam": [23, 307, 308], "filter": [24, 153, 155, 213, 295, 312, 317, 341, 342, 377, 378, 423, 429, 468, 469, 473, 520, 557, 602], "db2": [24, 669], "dbpath": 24, "common_oper": 24, "executionstat": 24, "allplansexecut": 24, "executionstag": 24, "19": 24, "docsexamin": 24, "76": 24, "executiontimemillisestim": 24, "eq": 24, "iseof": 24, "nreturn": 24, "needtim": 24, "58": 24, "needyield": 24, "restorest": 24, "savest": 24, "stage": [24, 160, 289, 338, 368], "collscan": 24, "78": 24, "executionsuccess": 24, "executiontimemilli": 24, "totaldocsexamin": 24, "totalkeysexamin": 24, "queryplann": 24, "indexfilterset": 24, "parsedqueri": 24, "plannervers": 24, "rejectedplan": 24, "winningplan": 24, "serverinfo": 24, "gitvers": 24, "05552b562c7a0b3143a729aaa0838e558dc49b25": 24, "macbook": 24, "pro": 24, "57": [24, 410, 414], "noth": [25, 134, 167, 172, 180, 183, 192, 204, 214, 262, 305, 348, 374, 400, 421, 434, 436, 447, 501, 510, 526, 536, 549, 562, 579, 600, 609, 622, 674], "introduct": [25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 246, 276, 544, 602, 603, 605, 696], "bson_gnuc_warn_unused_result": [26, 119, 163, 171, 173, 184, 199, 203, 205, 215, 216, 219, 220, 221, 222, 223, 224, 225, 226, 227, 230, 231, 235, 236, 237, 242, 243, 244, 252, 256, 287, 289, 290, 293, 297, 298, 312, 315, 316, 317, 327, 344, 346, 368, 369, 372, 373, 377, 378, 379, 380, 381, 395, 407, 423, 424, 425, 426, 427, 432, 433, 449, 465, 466, 467, 468, 469, 500, 504, 509, 516, 524, 530, 542, 548, 553, 558, 564, 567, 575, 581, 582, 586, 592, 601, 604, 608, 621, 648, 650, 670, 673, 686], "freed": [28, 32, 34, 39, 41, 42, 44, 45, 51, 53, 56, 58, 63, 66, 67, 68, 72, 79, 83, 88, 89, 92, 108, 109, 137, 158, 163, 166, 169, 170, 171, 173, 179, 184, 193, 199, 200, 201, 203, 205, 212, 215, 216, 220, 221, 222, 223, 224, 225, 227, 228, 229, 230, 231, 233, 234, 235, 236, 237, 242, 243, 253, 254, 256, 261, 263, 272, 285, 287, 288, 289, 290, 292, 293, 297, 298, 303, 304, 312, 313, 314, 315, 316, 317, 319, 320, 321, 322, 325, 326, 327, 328, 329, 333, 338, 341, 342, 344, 345, 346, 347, 350, 368, 369, 371, 372, 377, 378, 379, 380, 381, 382, 383, 384, 385, 387, 388, 395, 396, 407, 423, 424, 432, 433, 438, 440, 441, 442, 444, 445, 449, 465, 469, 470, 471, 474, 500, 504, 509, 511, 514, 516, 524, 535, 542, 548, 553, 554, 556, 564, 567, 573, 575, 581, 582, 592, 601, 604, 608, 614, 616, 617, 618, 621, 623, 624, 625, 626, 627, 632, 633, 634, 635, 636, 637, 638, 643, 645, 646, 649, 670, 673, 679, 686, 696], "int64_t": [30, 33, 35, 37, 46, 47, 49, 55, 57, 59, 61, 77, 87, 186, 197, 272, 294, 295, 296, 311, 354, 355, 364, 443, 446, 455, 512, 518, 541, 543, 558, 561, 568, 569, 570, 607, 610, 615, 631, 662, 681, 690, 693, 696], "durat": [30, 55, 77, 87, 543], "microsecond": [30, 55, 77, 87, 541, 568, 569, 570], "correl": [33, 35, 46, 47, 57, 59], "larg": [33, 46, 57, 297, 298], "why": 34, "int32_t": [36, 48, 60, 196, 248, 272, 278, 439, 481, 587, 588, 598, 599, 607, 630, 661, 662, 677, 680, 689, 690, 692], "bson_gnuc_deprecated_for": [36, 48, 60, 132, 133, 223, 294, 296, 297, 302, 312, 315, 324, 334, 357, 359, 377, 380, 465, 466, 639, 642], "connectionid": [36, 37, 48, 49, 60, 61], "posit": [36, 37, 48, 49, 60, 61, 244, 408, 410, 412, 413, 414, 455, 463, 518, 521, 689, 690, 692, 693], "integ": [36, 37, 48, 49, 60, 61, 317, 439, 443, 463, 518, 521, 630, 631, 652, 653, 661, 662, 677, 680, 681], "bson_oid_t": [39, 51, 63, 69, 73, 93, 110, 113, 116, 323, 325, 326, 696], "identifi": [39, 51, 63, 123, 149, 170, 174, 176, 185, 187, 188, 363, 533, 539], "topology_id": [69, 73, 93, 110, 113, 116], "observ": [70, 98, 104, 111], "stop": [74, 99, 105, 114, 135, 297], "await": [75, 81, 85, 284, 337, 393, 694], "mongoc_apm_command_failed_cb_t": 95, "whenev": [95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 669], "mongoc_apm_command_started_cb_t": 96, "mongoc_apm_command_succeeded_cb_t": 97, "mongoc_apm_server_changed_cb_t": 98, "mongoc_apm_server_closed_cb_t": 99, "mongoc_apm_server_heartbeat_failed_cb_t": 100, "mongoc_apm_server_heartbeat_started_cb_t": 101, "mongoc_apm_server_heartbeat_succeeded_cb_t": 102, "mongoc_apm_server_opening_cb_t": 103, "mongoc_apm_topology_changed_cb_t": 104, "mongoc_apm_topology_closed_cb_t": 105, "mongoc_apm_topology_opening_cb_t": 106, "boolean": [120, 121, 146, 157, 265, 317, 343, 492, 642, 644, 651, 687, 688, 696], "decrypt": [120, 124, 125, 128, 131, 175, 178, 206, 209], "bypass_query_analysi": 121, "22": [121, 122, 186, 189], "outgo": 121, "encrypted_fields_map": 122, "mongocryptduri": 123, "27020": 123, "mongocryptdbypassspawn": 123, "mongocryptdspawnpath": 123, "trail": 123, "slash": 123, "search": [123, 669], "mongocryptdspawnarg": 123, "idleshutdowntimeoutsec": 123, "60": [123, 669], "cryptsharedlibpath": 123, "filepath": 123, "unset": [123, 149, 194, 195, 196, 198, 287, 344, 363, 395, 491, 492, 630, 631, 659], "dynam": [123, 697], "itself": 123, "rel": [123, 455], "compon": [123, 259, 267], "rpath": 123, "runpath": 123, "style": [123, 450, 581, 583, 650], "substitut": 123, "cryptsharedlibrequir": 123, "proce": [123, 697], "fall": [123, 669], "back": [123, 167, 227, 238, 245, 433, 669, 696], "lookup": [124, 125, 206, 287, 344, 395], "special": [126, 207, 288, 345, 396, 669], "mongoc_kms_credentials_provider_callback_fn": [127, 208], "fn": [127, 208], "userdata": [127, 208], "km": [127, 128, 130, 170, 171, 176, 208, 209, 210, 213], "along": [127, 208, 250, 274, 277, 282, 294, 296, 302, 330, 474], "kmip": [128, 130, 176, 209, 210], "At": [128, 209, 696], "accesskeyid": [128, 209], "secretaccesskei": [128, 209], "base64": [128, 129, 209, 696], "tenantid": [128, 209], "clientid": [128, 209], "clientsecret": [128, 209], "identityplatformendpoint": [128, 209], "microsoftonlin": [128, 209], "email": [128, 209], "privatekei": [128, 209], "oauth2": [128, 209], "googleapi": [128, 176, 209], "enforc": 129, "encrypted_str": 129, "aaaaaaaaaaaaaaaaaaaaaa": 129, "aead_aes_256_cbc_hmac_sha_512": [129, 185], "tls_opt": [130, 210], "tlscertificatekeyfilepassword": [130, 210], "ae_opt": 130, "bcon_append": [130, 210], "ca1": [130, 210], "ca2": [130, 210], "_mongoc_auto_encryption_opts_t": 131, "queue": [132, 133, 138, 139, 140, 141, 142, 143, 144, 145, 152, 153, 154, 155], "propag": [132, 133, 135, 138, 139, 140, 141, 142, 143, 144, 145, 152, 153, 155, 164, 166, 223, 224, 226, 232, 253, 254, 288, 291, 292, 294, 295, 296, 297, 298, 300, 301, 302, 303, 304, 308, 309, 310, 311, 313, 314, 315, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 345, 349, 350, 370, 371, 373, 376, 377, 380, 381, 386, 387, 388, 389, 390, 396, 435, 437, 448, 453, 466, 467, 468, 472, 690, 694], "queu": 135, "afterward": [135, 151, 359, 360], "uniniti": [135, 169, 170, 179, 200, 201, 212, 261, 274, 295, 303, 304, 311, 313, 325, 326, 333, 338, 341, 342, 402, 405, 406, 628], "opaqu": [136, 149, 151, 165, 230, 286, 352, 359, 363, 539, 605], "term": [136, 149, 352, 363], "hint": [136, 141, 143, 145, 149, 153, 155, 289, 295, 296, 303, 304, 317, 333, 341, 342, 352, 363, 368, 399, 521], "sake": [136, 149, 272, 352, 363, 506, 607], "mainli": 136, "supersed": [138, 140, 142, 144, 152, 154, 163, 290, 323, 330, 340, 369, 429], "bitwis": [139, 145, 153, 155, 303, 304, 324, 325, 326, 333, 340, 341, 342, 486, 494, 522, 523, 620], "desir": [139, 145, 153, 155, 303, 304, 325, 326, 333, 339, 341, 342, 561, 575], "bson_validate_flags_t": [139, 145, 153, 155, 303, 304, 325, 326, 333, 341, 342], "skip": [139, 145, 153, 155, 160, 163, 289, 290, 294, 295, 296, 303, 304, 311, 312, 317, 325, 326, 333, 341, 342, 360, 368, 369], "collat": [141, 143, 145, 153, 155, 166, 253, 254, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 317, 328, 329, 333, 341, 342, 345, 368, 371, 376, 387, 388, 396, 481], "textual": [141, 143, 145, 153, 155, 166, 253, 254, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 328, 329, 333, 341, 342, 345, 368, 371, 376, 387, 388, 396], "comparison": [141, 143, 145, 153, 155, 166, 253, 254, 288, 289, 292, 295, 296, 301, 303, 304, 308, 309, 311, 328, 329, 333, 341, 342, 345, 368, 371, 376, 387, 388, 396], "predic": [141, 143, 145, 153, 155, 289, 295, 303, 304, 333, 341, 342, 368, 399], "bypass": [146, 168, 181, 182, 239, 408, 414], "client_sess": [147, 260, 273, 555, 557], "comment": [148, 287, 289, 295, 298, 303, 304, 311, 317, 325, 326, 333, 341, 342, 344, 368, 395, 399], "assign": 148, "attach": [148, 287, 289, 295, 298, 303, 304, 311, 325, 326, 333, 341, 342, 344, 368, 395, 399], "appear": [148, 287, 289, 295, 298, 303, 304, 311, 325, 326, 333, 341, 342, 344, 368, 395, 399], "profil": [148, 287, 289, 295, 298, 303, 304, 311, 325, 326, 333, 341, 342, 344, 368, 395, 399, 669, 696], "currentop": [148, 287, 289, 295, 298, 303, 304, 311, 325, 326, 333, 341, 342, 344, 368, 395, 399], "server_id": [149, 165, 227, 230, 359, 363], "suitabl": [149, 227, 256, 350, 363, 520, 669], "definit": [150, 289, 298, 303, 304, 333, 341, 342, 368, 399], "mql": [150, 289, 298, 303, 304, 333, 341, 342, 368, 399], "_mongoc_bulk_operation_t": 151, "entireti": [152, 153, 154, 155], "whose": [152, 153, 154, 155, 512, 518, 669], "arrayfilt": [153, 155, 341, 342], "element": [153, 155, 171, 323, 326, 341, 342, 452, 464, 546, 570], "err": [157, 272, 274, 607], "resumeaft": [158, 160, 287, 344, 395], "startaft": [158, 160, 287, 344, 395], "point": [158, 160, 171, 199, 208, 221, 250, 282, 287, 344, 366, 395, 541, 557, 628], "neither": 158, "nor": 158, "underli": [159, 253, 286, 289, 294, 296, 312, 328, 361, 368, 387, 439, 440, 444, 449, 455, 464, 466, 474, 568, 575, 576, 577, 578, 580, 582, 584, 585, 591, 597], "maximum": [159, 168, 194, 239, 240, 241, 287, 295, 311, 317, 344, 351, 362, 364, 365, 369, 395, 411, 521, 669], "maxawaittimem": [159, 160, 287, 317, 344, 360, 395], "_mongoc_change_stream_t": 160, "raw": [160, 166, 253, 254, 287, 288, 292, 328, 329, 344, 345, 371, 387, 388, 395, 396], "changestream": 160, "err_doc": 160, "rs0": 160, "as_json": 160, "bson_empti": 160, "startatoperationtim": [160, 287, 344, 395], "recreat": 160, "left": [160, 669], "operationtim": [160, 258, 259, 267, 696], "mutual": [160, 187, 188, 287, 344, 395, 555, 557], "implement": [160, 286, 288, 311, 345, 396, 429, 466, 473, 578, 584, 585, 597, 669], "persist": [160, 456, 457, 458, 460, 461], "wide": 160, "restart": 160, "unistd": 160, "resume_token_path": 160, "_save_resume_token": 160, "file_stream": [160, 429], "resume_token_doc": 160, "as_json_len": 160, "ssize_t": [160, 452, 464, 473, 568, 569, 570, 587, 588, 598, 599], "n_written": 160, "resume_token": 160, "bson_iter_valu": 160, "append": [160, 260, 274, 287, 301, 344, 395, 409, 474, 499, 655, 656, 660, 661, 662, 663, 672], "_load_resume_token": 160, "r_ok": 160, "bson_concat": 160, "max_tim": 160, "30": [160, 481, 669], "bson_append_int64": 160, "synchron": 160, "cached_operation_tim": 160, "five": 160, "insert_cmd": 160, "bson_value_copi": 160, "required_major": 161, "required_minor": 161, "required_micro": 161, "minimum": [161, 195, 241, 452, 587, 588, 696], "major": [161, 170, 253, 279, 284, 287, 288, 337, 344, 393, 395, 506, 669, 671, 678, 690, 694, 696], "minor": [161, 671], "micro": [161, 671], "db_name": [163, 164, 165, 166, 225, 253, 254, 288, 396, 696], "batch_siz": [163, 290, 312, 362, 369], "unus": [163, 227, 254, 329, 388, 452, 464], "mongoc_read_primari": [163, 164, 290, 291, 336, 369, 370, 392, 507, 521], "simplifi": [164, 274, 291, 370], "interfac": [164, 370, 414, 450, 487, 521, 558, 559, 561, 594], "interpret": [166, 292, 371, 455, 669], "highest": [166, 253, 254, 288, 289, 292, 317, 328, 329, 345, 368, 371, 387, 388, 396], "readconcern": [166, 253, 254, 288, 289, 292, 295, 296, 311, 317, 328, 329, 335, 368, 371, 387, 388, 391, 424, 502, 503, 505, 506, 669], "writeconcern": [166, 253, 254, 288, 289, 292, 298, 300, 301, 303, 304, 308, 309, 325, 326, 329, 332, 333, 341, 342, 345, 368, 371, 376, 388, 396, 399, 424], "inherit": [166, 219, 224, 253, 254, 272, 279, 284, 288, 289, 292, 295, 296, 298, 300, 301, 303, 304, 308, 309, 311, 316, 317, 325, 326, 328, 329, 332, 333, 339, 341, 342, 345, 368, 371, 376, 378, 381, 387, 388, 391, 392, 393, 394, 396, 399, 424, 556, 607], "consult": [166, 253, 254, 288, 292, 328, 329, 345, 371, 387, 388, 396, 696], "onto": [167, 238, 251, 696], "listcollect": [168, 239, 359, 360, 378, 381], "privileg": [168, 239], "neg": [168, 186, 196, 197, 239, 317, 364, 455, 587, 588, 598, 599], "impact": [168, 239], "key_doc": [169, 200, 201, 212], "uuid": [169, 170, 179, 188, 200, 212], "0x04": [169, 170, 179, 188, 200, 212], "datakei": 170, "enc": [171, 199], "in_opt": 171, "out_opt": 171, "opt_masterkei": 171, "conveni": [171, 312, 399, 411, 414, 473, 669, 696], "storag": 171, "masterkei": [171, 176], "reason": [171, 297, 298, 364, 669], "behav": 171, "similarli": 171, "unlik": [171, 287, 344, 395], "k_f": 171, "relev": 171, "keyaltnames_count": 174, "materi": 175, "constitut": 175, "cryptograph": [175, 495], "devic": 175, "region": 176, "cmk": 176, "amazonaw": 176, "keyvaultendpoint": 176, "keynam": 176, "keyvers": 176, "projectid": 176, "keyr": 176, "cloudkm": 176, "_mongoc_client_encryption_datakey_opts_t": 177, "ciphertext": [178, 181], "rangepreview": [181, 182, 185, 186, 189, 190, 194, 195, 196, 197, 198, 695], "payload": [181, 182], "expr": [182, 295], "expr_out": 182, "lt": 182, "lte": [182, 414], "value1": [182, 669], "value2": [182, 669], "fieldpath": 182, "mongoc_aead_aes_256_cbc_hmac_sha_512_random": 185, "mongoc_encrypt_algorithm_index": 185, "mongoc_encrypt_algorithm_unindex": 185, "unindex": 185, "mongoc_encrypt_algorithm_rangepreview": 185, "contention_factor": 186, "factor": 186, "mongoc_encrypt_query_type_equ": 189, "mongoc_encrypt_query_type_rangepreview": 189, "mongoc_export": 189, "query_typ": 189, "range_opt": [190, 192, 194, 195, 196, 197], "_mongoc_client_encryption_encrypt_opts_t": 191, "destin": [194, 195, 196, 197, 198, 422, 569, 570], "decimal128": [194, 195, 196, 198], "precis": [194, 195, 196, 198], "sparsiti": [197, 198], "_mongoc_client_encryption_encrypt_range_opts_t": 198, "rangeopt": 198, "live": [199, 221], "param": [208, 274], "popul": [208, 237, 243, 303, 304, 325, 326, 333, 341, 342, 533, 650], "ce_opt": 210, "_mongoc_client_encryption_opts_t": 211, "master_kei": 213, "rewrap": 213, "equival": [213, 533, 560, 582, 669], "_mongoc_client_encryption_rewrap_many_datakey_result_t": 217, "_mongoc_client_encryption_t": 218, "NOT": [218, 238, 286, 366, 429, 454, 455, 462, 464, 473], "transient": [219, 223, 224, 253, 272, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 607], "retryread": [219, 223, 224, 253, 287, 289, 294, 295, 296, 311, 312, 315, 316, 317, 328, 344, 368, 377, 378, 380, 381, 387, 395, 422, 423, 465, 466, 467, 468, 469, 669], "listdatabas": [219, 224], "represent": [219, 315, 316, 377, 378, 418, 534, 535, 669], "vector": [223, 224, 570, 588, 599], "bson_strfreev": [223, 224, 380, 381], "strv": [224, 381], "unsign": [224, 251, 381, 463, 566, 696], "strcmp": [225, 473], "shall": [226, 240, 283, 294, 296, 297, 298, 302, 305, 312, 323, 326, 330, 333, 334, 340, 346, 358, 361, 367, 432, 433, 434, 449, 466, 508, 509, 575, 577, 578, 579, 580, 582, 584, 585, 586, 587, 597, 598, 599], "thu": 226, "notabl": 227, "loadbalanc": [227, 545, 606, 669], "show_serv": 231, "ping": [231, 251, 291, 696], "sd": [231, 546], "serverstatu": 232, "bson_gnuc_deprec": [232, 241, 299, 300, 310, 338, 343], "prior": [238, 287, 289, 295, 317, 344, 368, 395], "shut": [238, 560], "join": 238, "max_pool_s": 240, "hurt": [241, 669], "min_pool_s": 241, "kept": 241, "excess": 241, "exceed": 241, "maxpools": [244, 669], "mongoc_handshake_appname_max": [247, 277], "caus": [249, 255, 281, 350, 669], "mongoc_enable_ssl": [250, 282], "denable_ssl": [250, 282], "_mongoc_client_pool_t": 251, "destructor": 251, "pthread": [251, 696], "pthread_mutex_t": [251, 696], "in_shutdown": [251, 696], "worker": [251, 696], "probabl": [251, 696], "portion": [251, 626, 634, 645, 696], "pthread_mutex_lock": [251, 696], "pthread_mutex_unlock": [251, 696], "pthread_t": [251, 696], "pthread_mutex_init": [251, 696], "pthread_creat": [251, 696], "pthread_join": [251, 696], "tabl": [253, 254, 288, 289, 317, 328, 329, 345, 368, 387, 388, 396], "degrad": [253, 328, 387], "prepar": [253, 288], "clonecollectionascap": [253, 288], "enablemajorityreadconcern": [253, 288], "replset": [253, 288], "my_collect": [253, 288], "y": [253, 288, 671], "writeresult": [253, 288], "read_concern": [253, 272, 279, 288, 335, 391, 499, 500, 501, 502, 503, 505, 607, 616], "tocollect": [253, 288], "my_capped_collect": [253, 288], "1024": [253, 288], "wtimeoutm": [253, 288, 631, 653, 669], "mongoc_read_concern_level_major": [253, 288, 381, 506], "mistak": [254, 329, 388], "obei": [254, 329, 388], "child": [255, 473, 696], "fork": 255, "interf": 255, "parent": [255, 339, 394], "endsess": 255, "increment": [255, 259, 267], "for_writ": 256, "cluster_tim": 258, "clustertim": [258, 259, 264, 696], "dirti": 265, "label": [272, 398], "session_opt": [272, 555, 557, 607], "default_txn_opt": [272, 607], "txn_opt": [272, 556, 607], "insert_opt": [272, 274, 555, 607], "reply_json": [272, 607], "nonexist": [272, 274, 607], "namespaceexist": [272, 274, 607], "error_cod": [272, 274, 607], "snapshot": [272, 317, 506, 552, 555, 557, 607], "retry_transact": [272, 607], "whole": [272, 473, 607], "transienttransactionerror": [272, 398, 607], "bson_as_json": [272, 273, 274, 350, 607, 696], "bson_get_monotonic_tim": [272, 607], "unknowntransactioncommitresult": [272, 398, 607], "unrecover": [272, 607], "update_opt": 273, "find_opt": [273, 557], "2000": 273, "reflect": 273, "catch": [273, 694], "m": [273, 669], "ctx": [274, 275], "reach": [274, 561, 570, 669], "insid": [274, 312], "stack": [274, 291, 628], "with_transact": 274, "ctx_t": 274, "create_and_insert_doc": 274, "local_repli": 274, "retval": [274, 696], "bson_copi": 274, "txn": 274, "mongoc_read_concern_level_loc": [279, 506], "great": [279, 284, 337, 393, 506, 521, 694], "websit": [280, 294, 296, 336, 392, 506, 507, 519, 669, 694], "mongoc_stream_initiator_t": [283, 286], "transport": [283, 286, 584], "fulfil": [283, 286], "contract": 283, "whatev": 283, "mongoc_write_concern_w_default": [284, 297, 318, 337, 393, 694], "misconfigur": 285, "_mongoc_client_t": 286, "shard": [286, 494, 517, 521, 523, 606, 669, 696], "rout": [286, 473], "individu": [286, 481, 506, 660, 661, 662, 663], "scenario": 286, "batchsiz": [287, 289, 317, 344, 359, 360, 368, 395], "fulldocu": [287, 344, 395], "utf": [287, 344, 395, 424, 458, 467, 472, 655, 656, 657, 658, 664, 667, 670], "updatelookup": [287, 344, 395], "whenavail": [287, 344, 395], "fulldocumentbeforechang": [287, 344, 395], "showexpandedev": [287, 344, 395], "expand": [287, 344, 395, 697], "avaiabl": [287, 344, 395], "createrol": [288, 345, 396], "Not": [289, 290, 578, 584, 597, 669], "mongoc_query_exhaust": [289, 494], "bypassdocumentvalid": [289, 325, 326, 333, 341, 342, 368], "merg": [289, 368], "pipeline_queri": 289, "collection2": 289, "collection1": 289, "unwrap": 291, "do_p": 291, "deep": [293, 372, 488, 500, 509, 524, 542, 604, 673], "unalt": [293, 372], "accur": [294, 295, 296, 311, 324], "migrat": [294, 296, 359], "print_query_count": [294, 296], "prid64": [294, 295, 296, 311, 631, 696], "contrast": [295, 311], "print_count": [295, 311], "geowithin": 295, "center": 295, "nearspher": 295, "centerspher": 295, "bson_append_utf8": [296, 399, 408, 409, 410, 411, 412, 413, 414, 481, 659, 696], "command_opt": 300, "createindex": [300, 301, 327, 481], "obsolet": 300, "_mongoc_index_model_t": 301, "model": [301, 473, 587, 598, 599], "n_model": 301, "sibl": 301, "around": [301, 313, 558, 559, 560, 561, 564, 589], "mongoc_delete_single_remov": [302, 397], "deletedcount": [303, 304], "subdocu": [303, 304, 326, 333, 341, 342, 696], "thin": [306, 307, 313, 331, 375], "wrapper": [306, 307, 313, 331, 375, 558, 559, 560, 561, 564, 589, 594], "26": 309, "unrecogn": 309, "oversight": 311, "stabl": 311, "symbol": [311, 459, 474, 697], "orderbi": 312, "histor": [312, 669], "op_queri": [312, 317], "convert": [312, 317, 533], "typic": [312, 567, 694], "invis": 312, "tradit": 312, "showdiskloc": 312, "showrecordid": [312, 317], "plan": [312, 317], "_remov": 313, "_new": 313, "findandmodifi": [313, 314, 407, 411, 412, 414], "cmpxchg": 313, "find_and_modifi": [313, 410, 414], "listindex": 316, "ten": 317, "print_ten_docu": 317, "field_name_on": 317, "field_name_two": 317, "tailabl": [317, 358, 359, 360, 365], "nocursortimeout": 317, "oplogreplai": 317, "allowpartialresult": 317, "returnkei": 317, "singlebatch": 317, "allowdiskus": 317, "Then": [317, 696], "unmodifi": 317, "maxscan": 317, "transpar": [317, 696], "n_document": [324, 325], "insertedcount": [325, 326], "stringif": 327, "straight": 327, "mongoc_remove_single_remov": [330, 522], "new_db": [331, 332], "new_nam": [331, 332], "drop_target_before_renam": [331, 332], "renam": [331, 332], "matchedcount": [333, 341, 342], "modifiedcount": [333, 341, 342], "upsertedcount": 333, "upsertedid": [333, 341, 342], "collstat": 338, "_mongoc_collection_t": 339, "set_": 339, "mongoc_update_multi_upd": [340, 620], "next_doc": 342, "to_str": 342, "example_col": 342, "scandata": 343, "clone": [346, 366], "reset": 346, "hand": 350, "run_queri": 350, "loop": [350, 669], "nrepli": 350, "good_queri": 350, "bad_queri": 350, "serverselectiontryonc": [350, 669], "fake": 350, "badoper": 350, "codenam": 350, "badvalu": 350, "regular": [358, 450], "unreli": 358, "begun": 358, "told": 358, "1234": [359, 360], "firstbatch": [359, 360], "low": [359, 360, 495], "synthes": [359, 452], "ephemer": 361, "good": 361, "retain": 361, "sign": [364, 439, 443, 446, 680, 681], "unchang": 364, "max_await_time_m": 365, "uint64_t": [365, 411, 463], "_mongoc_cursor_t": 366, "repeat": [366, 669], "lazi": 366, "traffic": 366, "custom_data": 367, "cleartext": 367, "listlocalsess": 368, "current_op_queri": 368, "matcher": 377, "name_filt": 378, "abbbbc": 378, "bson_append_regex": 378, "ab": 378, "bson_iter_utf8": 378, "rc": [381, 665, 666, 668], "_mongoc_database_t": 394, "mongoc_delete_non": 397, "fam_opt": [399, 411, 414], "zlatan": [399, 408, 409, 410, 411, 412, 413, 414], "ibrahimov": [399, 408, 409, 410, 411, 412, 413, 414], "striker": [399, 408, 410, 411, 412, 413, 414], "firstnam": [399, 408, 409, 410, 411, 412, 413, 414], "lastnam": [399, 408, 409, 410, 411, 412, 413, 414], "profess": [399, 408, 410, 411, 412, 413, 414], "footbal": [399, 408, 410, 411, 412, 413, 414], "player": [399, 408, 410, 411, 412, 413, 414], "bump": [399, 408, 409, 411, 412, 414], "hi": [399, 408, 409, 410, 411, 412, 414], "ag": [399, 408, 410, 411, 412, 413, 414], "futureopt": [399, 411, 414], "__line__": [399, 408, 409, 410, 411, 412, 413, 414], "find_and_modify_opt": 400, "builder": [400, 407, 408, 409, 410, 411, 412, 413, 414], "mongoc_find_and_modify_flags_t": [403, 410], "talk": 408, "fam_bypass": [408, 414], "he": [408, 414], "plai": [408, 414], "pretti": [408, 414], "lasterrorobject": [408, 409, 410, 412, 413, 414], "updatedexist": [408, 409, 410, 412, 413, 414], "56562a99d13e6d86239c7b00": [408, 409, 410, 412, 413, 414], "34": [408, 410, 414], "goal": [408, 409, 410, 412, 413, 414], "342": [408, 410, 413, 414], "fieldnam": 409, "exclud": [409, 423], "fam_field": [409, 414], "talli": [409, 412, 414], "mongoc_find_and_modify_return_new": [409, 410, 413, 414], "343": [409, 412, 414], "mongoc_find_and_modify_non": 410, "mongoc_find_and_modify_remov": 410, "mongoc_find_and_modify_upsert": [410, 414], "fam_flag": [410, 414], "35": [410, 412, 413, 414], "28": [410, 414], "62": [410, 414], "didn": [410, 414], "max_time_m": 411, "permit": 411, "fam_sort": [412, 414], "oldest": [412, 414], "fam_upd": [413, 414], "him": [413, 414], "book": [413, 414], "_previous_": [413, 414], "accommod": 414, "fam": 414, "databasenam": 414, "validationact": 414, "validationlevel": 414, "moder": 414, "collectionnam": 414, "mongoc_major_vers": [415, 671], "mongoc_micro_vers": [416, 671], "mongoc_minor_vers": [417, 671], "pre": [418, 444], "bucket": [420, 421, 422, 423, 424, 425, 426, 427, 429, 430, 431], "file_id": [420, 422, 425, 426, 427, 429, 430, 431, 473], "bucketnam": 424, "exce": [424, 662], "chunksizebyt": [424, 426, 427, 430, 431], "255kb": 424, "_mongoc_gridfs_bucket_t": 429, "compliant": [429, 473], "source_file_path": 429, "file_copy_path": 429, "o_rdonli": [429, 473], "o_creat": 429, "o_rdwr": 429, "perror": 429, "suit": 433, "alias": [438, 451, 456, 462], "md5": [444, 451, 460, 462], "date": 446, "epoch": 446, "_mongoc_gridfs_file_list_t": 450, "marshal": 450, "do_someth": [450, 671], "content_typ": [451, 457, 462], "chunk_siz": [451, 462], "iov": [452, 464, 473, 570, 588, 599], "iovcnt": [452, 464, 570, 588, 599], "min_byt": [452, 587, 588], "timeout_msec": [452, 464, 587, 588, 598, 599], "scatter": [452, 487], "modif": 454, "delta": 455, "whenc": 455, "move": 455, "seek_set": 455, "seek_cur": 455, "seek_end": 455, "fseek": 455, "einval": 455, "checksum": 460, "_mongoc_gridfs_file_t": 462, "readv": 462, "writev": [462, 599], "upload_d": 462, "gather": [464, 487, 570, 588], "_mongoc_gridfs_t": 473, "gridfs_fil": 473, "gridfs_file_list": 473, "essenti": 473, "caveat": [473, 521], "quit": 473, "expens": [473, 486], "said": 473, "caution": [473, 474], "mongoc_gridf": 473, "tightli": 473, "worth": 473, "fit": [473, 662], "fcntl": 473, "buf": [473, 495, 496, 497, 568, 569, 587, 598, 696], "4096": 473, "iov_bas": [473, 487], "iov_len": [473, 487], "grab": 473, "input_fil": 473, "bson_type_int32": 473, "v_int32": 473, "driver_nam": 474, "driver_vers": 474, "truncat": 474, "conjunct": [474, 580], "bson_mem_set_vt": 474, "bson_mem_restore_vt": 474, "pedant": 474, "phongo": 474, "bson_host_name_max": 475, "uint16_t": [475, 649], "famili": [475, 495, 567], "pad": [475, 478, 481, 484, 574], "bson_gnuc_pur": [476, 479, 482, 573], "geo": [476, 478, 481], "twod_sphere_vers": 478, "twod_bits_precis": [478, 481], "twod_location_min": [478, 481], "twod_location_max": [478, 481], "haystack_bucket_s": 478, "tune": [478, 481, 484], "is_initi": 481, "drop_dup": 481, "spars": 481, "expire_after_second": 481, "weight": 481, "default_languag": 481, "language_overrid": 481, "geo_opt": 481, "mongoc_index_opt_storage_t": [481, 484], "storage_opt": 481, "partial_filter_express": 481, "dropdup": 481, "silent": 481, "2d": 481, "123": 481, "geo_test": 481, "wiredtig": [482, 484], "config_str": 484, "mongoc_insert_non": 486, "mongoc_insert_continue_on_error": 486, "mongoc_insert_no_valid": 486, "1u": [486, 620], "u_long": 487, "iovec": 487, "bewar": 487, "overwritten": 488, "mongoc_query_tailable_cursor": 494, "mongoc_query_secondary_ok": 494, "mongoc_query_oplog_replai": 494, "mongoc_query_no_cursor_timeout": 494, "mongoc_query_await_data": [494, 523], "mongoc_query_parti": 494, "inact": 494, "period": [494, 537, 540], "blast": 494, "faster": 494, "pull": [494, 495], "throw": [494, 669], "num": [495, 496, 497], "strong": 495, "pseudo": 495, "usual": [495, 697], "enough": [495, 498], "prng": [495, 498], "hardwar": 495, "insofar": 495, "degre": [495, 696], "startup": 495, "entropi": [496, 497], "mix": 496, "bound": 496, "estim": [496, 512, 518, 521], "alter": [505, 533, 687, 688, 689, 690, 691, 692, 693], "frozen": [505, 687, 688, 689, 690, 691, 692, 693], "isol": [506, 669], "right": [506, 694, 697], "macro": [506, 657, 671, 696], "mongoc_read_concern_level_lineariz": 506, "lineariz": 506, "mongoc_read_concern_level_avail": 506, "mongoc_read_concern_level_snapshot": 506, "mongoc_read_primary_pref": [507, 521], "mongoc_read_secondary_pref": [507, 521], "mongoc_read_nearest": [507, 521], "dispatch": [507, 517], "hedg": [511, 517], "stale": [512, 518, 523], "maxstalenesssecond": [512, 518, 669], "mongoc_no_max_stal": [512, 518, 521], "sens": [515, 521], "read_mod": 516, "fastest": [517, 669], "unfinish": 517, "max_staleness_second": 518, "run_query_with_read_prefs_tag": 520, "tagset": 520, "rack": [520, 521], "rack1": 520, "datacent": 520, "rack2": 520, "rp_tag": 520, "dbname": 520, "stick": 521, "won": 521, "among": [521, 669, 696], "nearest": [521, 669], "irrespect": 521, "evalu": 521, "primarypref": [521, 669], "secondarypref": [521, 669], "combin": [521, 684], "colon": 521, "readpreferencetag": [521, 669], "resort": 521, "matter": 521, "choic": [521, 697], "lastwrited": 521, "lag": [521, 669], "clock": [521, 561, 568, 569, 570, 669], "suffer": [521, 669], "elig": [521, 669], "mongoc_smallest_max_staleness_second": 521, "90": [521, 669], "outstand": 521, "mongoc_remove_non": 522, "mongoc_reply_non": 523, "mongoc_reply_cursor_not_found": 523, "mongoc_reply_query_failur": 523, "mongoc_reply_shard_config_stal": 523, "mongoc_reply_await_cap": 523, "deprecation_error": [525, 527], "declar": 529, "mongoc_server_api_v1": 534, "deploy": [537, 540], "measur": 543, "_mongoc_server_description_t": 544, "sdam": [544, 605], "possibleprimari": 545, "rsarbit": 545, "rsother": 545, "rsghost": 545, "_mongoc_session_opt_t": 547, "causal_consist": 555, "particip": [555, 689], "setter": [556, 607], "opportun": 556, "offici": [557, 696], "query_opt": 557, "expire_at": [558, 561, 568, 569, 570], "bsd": [558, 559, 560, 561, 566, 572], "sockaddr": [559, 561, 565], "addr": [559, 561, 565], "mongoc_socklen_t": [559, 561, 565, 571, 589], "addrlen": [559, 561, 565], "bind": 559, "better": [559, 561, 578, 597], "monoton": [561, 568, 569, 570], "mind": 561, "captur": 563, "getpeernam": 564, "getnameinfo": 564, "backlog": 566, "af_inet": 567, "sock_stream": 567, "underneath": 567, "buflen": [568, 569], "recv": 568, "sendmsg": 570, "iov_max": 570, "fallback": [570, 629, 630, 631, 632], "optnam": [571, 589], "optval": [571, 589], "optlen": [571, 589], "sockopt": 571, "setsockopt": [571, 589], "_mongoc_socket_t": 572, "friendlier": 572, "solari": 572, "shallow": 574, "sure": 574, "base_stream": 575, "buffer_s": 575, "grow": 575, "past": 575, "_mongoc_stream_buffered_t": 576, "subclass": [576, 583, 593, 596], "descriptor": [577, 580, 581, 583], "fd": 581, "_mongoc_stream_file_t": 583, "flush": 584, "physic": 584, "mimic": 584, "semant": [584, 587, 598, 599], "fflush": 584, "forc": 584, "space": 584, "Such": 585, "ownership": [586, 592], "sockettimeoutm": [586, 669], "connecttimeoutm": [586, 630, 669], "loos": [587, 598, 599], "eagain": 590, "exchang": 590, "_mongoc_stream_socket_t": 593, "_mongoc_stream_t": 594, "idea": 594, "perhap": 594, "shim": 594, "turn": 594, "_mongoc_stream_tls_t": 596, "cork": 597, "td": [601, 602, 603, 606], "knowledg": [602, 603, 605], "writabl": 603, "_mongoc_topology_description_t": 605, "Its": 605, "_mongoc_transaction_opt_t": 607, "max_commit_time_m": 615, "committransact": 615, "mongoc_transaction_non": 619, "mongoc_transaction_start": 619, "mongoc_transaction_in_progress": 619, "mongoc_transaction_commit": 619, "mongoc_transaction_abort": 619, "mongoc_update_non": 620, "mongoc_update_upsert": 620, "mongoc_update_no_valid": 620, "bson_has_field": 625, "scheme": [627, 639, 640], "srv": [627, 639, 640, 641], "bson_init_stat": 628, "prop": [628, 659], "40domain": [628, 659], "insensit": [629, 630, 631, 632, 647, 651, 652, 653, 654, 660, 661, 662, 663, 669], "myvalu": [630, 631], "srvservicenam": 641, "15": 642, "seen": 650, "myuser": 650, "mypass": 650, "kerberosus": 650, "zlibcompressionlevel": [652, 669], "my_servic": 659, "minheartbeatfrequencym": 661, "correctli": 662, "utf8": [663, 670], "_mongoc_uri_t": 669, "host1": 669, "port1": 669, "host2": 669, "port2": 669, "hostn": 669, "portn": 669, "enclos": 669, "unexpect": 669, "easier": 669, "mongoc_uri_appnam": 669, "applicationnam": 669, "db1": 669, "2500": 669, "resembl": 669, "_mongodb": 669, "_tcp": 669, "txt": [669, 696], "libresolv": 669, "lack": 669, "res_nsearch": 669, "res_search": 669, "mongoc_uri_retryread": 669, "mongoc_uri_retrywrit": 669, "retrywrit": 669, "slow": 669, "mongoc_uri_compressor": 669, "compress": 669, "mongoc_uri_connecttimeoutm": 669, "000": 669, "mongoc_uri_sockettimeoutm": 669, "300": 669, "mongoc_uri_replicaset": 669, "mongoc_uri_zlibcompressionlevel": 669, "mongoc_uri_loadbalanc": 669, "mongoc_uri_srvmaxhost": 669, "srvmaxhost": 669, "unlimit": 669, "timeoutm": 669, "mongoc_uri_authmechan": 669, "mongoc_uri_authmechanismproperti": 669, "option_kei": 669, "option_valu": 669, "undefin": 669, "mongoc_uri_authsourc": 669, "unnecessari": 669, "mongoc_uri_canonicalizehostnam": 669, "canonicalizehostnam": 669, "alia": 669, "mongoc_uri_gssapiservicenam": 669, "gssapiservicenam": 669, "verif": 669, "mongoc_uri_ssl": 669, "mongoc_uri_sslclientcertificatekeyfil": 669, "sslclientcertificatekeyfil": 669, "mongoc_uri_sslclientcertificatekeypassword": 669, "sslclientcertificatekeypassword": 669, "mongoc_uri_sslcertificateauthorityfil": 669, "sslcertificateauthorityfil": 669, "mongoc_uri_sslallowinvalidcertif": 669, "sslallowinvalidcertif": 669, "mongoc_uri_sslallowinvalidhostnam": 669, "sslallowinvalidhostnam": 669, "scanner": 669, "wake": 669, "rescan": 669, "half": 669, "serverselectiontimeoutm": 669, "technic": [669, 695], "longest": 669, "slowest": 669, "mongoc_uri_heartbeatfrequencym": 669, "000m": 669, "mongoc_uri_serverselectiontimeoutm": 669, "0000m": 669, "mongoc_uri_serverselectiontryonc": 669, "repeatedli": 669, "paus": 669, "signal": 669, "mongoc_uri_socketcheckintervalm": 669, "socketcheckintervalm": 669, "quick": 669, "mongoc_uri_directconnect": 669, "directconnect": 669, "presenc": 669, "mongoc_uri_maxpools": 669, "mongoc_uri_minpools": 669, "minpools": 669, "mongoc_uri_maxidletimem": 669, "maxidletimem": 669, "mongoc_uri_waitqueuemultipl": 669, "waitqueuemultipl": 669, "mongoc_uri_waitqueuetimeoutm": 669, "mongoc_uri_w": 669, "getlasterror": 669, "indefinit": 669, "mongoc_uri_wtimeoutm": 669, "mongoc_uri_journ": 669, "journal": [669, 676, 685, 688], "disk": 669, "mongoc_uri_readconcernlevel": 669, "readconcernlevel": 669, "unspecifi": 669, "readprefer": 669, "chosen": 669, "randomli": 669, "localthresholdm": 669, "slower": 669, "mongoc_uri_readprefer": 669, "secondaryok": 669, "mongoc_uri_readpreferencetag": 669, "mongoc_uri_localthresholdm": 669, "far": 669, "15m": 669, "mongoc_uri_maxstalenesssecond": 669, "smallest": 669, "threshold": 669, "localthreshold": 669, "mongoc_uri_saf": 669, "escaped_str": 670, "unescap": 670, "40": 670, "escap": 670, "preprocessor": [671, 697], "mongoc_version_": 671, "mongoc_version_hex": 671, "fsync": [675, 687], "wmajor": [677, 678], "mongoc_write_concern_w_major": [677, 694], "wtag": 679, "word": 682, "fsync_": 687, "wtimeout_msec": [690, 692, 693], "preset": 691, "principl": 694, "mongoc_write_concern_w_unacknowledg": 694, "receipt": 694, "mongoc_write_concern_w_errors_ignor": 694, "synonym": 694, "preview": 695, "incompat": 695, "offer": 696, "brief": 696, "find_packag": 696, "cmakelist": 696, "hello_mongoc": 696, "four": 696, "add_execut": 696, "target_link_librari": 696, "mongoc_shar": 696, "mongoc_stat": [696, 697], "Or": 696, "aren": 696, "lmongoc": 696, "lbson": 696, "cl": 696, "ic": 696, "coll_nam": 696, "world": 696, "born": 696, "isod": 696, "1906": 696, "09": 696, "di": 696, "1992": 696, "01": 696, "grace": 696, "hopper": 696, "math": 696, "matic": 696, "flow": 696, "cobol": 696, "ba": 696, "school": 696, "vassar": 696, "phd": 696, "yale": 696, "tm": 696, "lang_nam": 696, "keylen": 696, "child2": 696, "calcul": 696, "tm_year": 696, "year": 696, "1900": 696, "tm_mon": 696, "month": 696, "tm_mdai": 696, "bson_append_date_tim": 696, "mktime": 696, "92": 696, "bson_append_array_begin": 696, "bson_uint32_to_str": 696, "bson_append_array_end": 696, "notat": 696, "manner": 696, "closer": 696, "bcon_date_tim": 696, "notic": 696, "bson_new_from_json": 696, "interact": 696, "mycol": 696, "bson_oid_init": 696, "bson_append_oid": 696, "switch": [696, 697], "55ef43766cb5f36a3bae6ee4": 696, "color": 696, "bcon_oid": 696, "old_valu": 696, "new_valu": 696, "55ef549236fe322f9490e17b": 696, "illustr": 696, "prove": 696, "_simpl": 696, "variant": 696, "numberdoubl": 696, "1682609211": 696, "signatur": 696, "aaaaaaaaaaaaaaaaaaaaaaaaaaa": 696, "00": 696, "unawar": 696, "vast": 696, "programm": 696, "topic": 696, "brows": 696, "rest": 696, "win32": 697, "rememb": 697, "solut": 697, "explor": 697, "chose": 697, "ran": 697, "dialog": 697, "dll": 697, "bin": 697, "stdafx": 697, "ws2_32": 697, "secur32": 697, "crypt32": 697, "bcrypt": 697, "purpos": 697, "archiv": 697, "routin": 697, "gethostnam": 697, "bson_stat": 697, "peopl": 697, "learn": 697}, "objects": {"": [[208, 0, 1, "c.mongoc_kms_credentials_provider_callback_fn", "mongoc_kms_credentials_provider_callback_fn"]]}, "objtypes": {"0": "c:type"}, "objnames": {"0": ["c", "type", "C type"]}, "titleterms": {"advanc": 0, "connect": [0, 9, 669, 696], "replica": [0, 669], "set": [0, 1, 6, 13, 408, 409, 410, 411, 412, 413, 521, 669], "shard": 0, "cluster": 0, "an": 0, "ipv6": [0, 669], "address": 0, "ipv4": [0, 669], "unix": [0, 20], "domain": 0, "socket": 0, "server": [0, 7, 8, 10, 669, 695], "over": [0, 1], "tl": [0, 8, 669], "compress": 0, "data": [0, 1], "from": [0, 20, 295, 696], "mongodb": [0, 4, 20, 695, 696], "addit": [0, 20], "option": [0, 8, 20, 171, 317, 399, 669], "aggreg": 1, "framework": 1, "exampl": [1, 3, 12, 24, 160, 166, 224, 225, 251, 253, 254, 260, 272, 273, 274, 286, 288, 289, 291, 292, 294, 295, 296, 311, 312, 313, 314, 317, 328, 329, 342, 345, 350, 366, 368, 371, 378, 381, 387, 388, 394, 396, 414, 429, 450, 473, 481, 499, 520, 549, 555, 557, 607, 625, 628, 650, 657, 659, 669, 672], "requir": 1, "us": [1, 17, 696, 697], "zip": 1, "code": 1, "state": 1, "popul": 1, "10": 1, "million": 1, "averag": 1, "citi": 1, "api": [2, 13, 17, 534], "refer": 2, "applic": 3, "perform": [3, 5], "monitor": [3, 669], "apm": 3, "command": [3, 12, 24, 312, 317, 696], "sdam": 3, "function": [3, 13, 27, 40, 52, 64, 70, 74, 80, 84, 90, 94, 111, 114, 117, 131, 151, 160, 177, 191, 198, 211, 217, 218, 251, 273, 286, 295, 339, 366, 394, 414, 429, 450, 451, 462, 473, 478, 481, 484, 492, 495, 506, 521, 532, 534, 544, 547, 572, 574, 583, 593, 594, 605, 607, 669, 694], "authent": [4, 8, 669], "basic": [4, 5, 12, 288, 345, 396, 696], "scram": 4, "sha": 4, "256": 4, "1": 4, "legaci": [4, 669], "cr": 4, "gssapi": 4, "kerbero": 4, "sasl": 4, "plain": 4, "x": 4, "509": 4, "certif": [4, 8], "via": 4, "aw": 4, "iam": 4, "credenti": 4, "uri": [4, 8], "environ": [4, 20], "ec": 4, "ec2": 4, "troubleshoot": 5, "checklist": 5, "counter": 5, "submit": 5, "bug": 5, "report": [5, 13], "bulk": 6, "write": [6, 288, 339, 345, 396, 669, 694], "oper": [6, 288, 345, 396, 696], "insert": [6, 696], "mix": 6, "order": 6, "unord": 6, "bypass": 6, "document": [6, 20, 696], "valid": 6, "concern": [6, 339, 506, 669, 694], "collat": 6, "unacknowledg": 6, "further": 6, "read": [6, 339, 506, 521, 669], "client": [7, 8, 21, 227], "side": [7, 10, 21], "field": [7, 409], "level": [7, 506, 694], "encrypt": [7, 17, 21, 695], "automat": [7, 19], "provid": 7, "local": 7, "rule": 7, "enforc": 7, "explicit": 7, "decrypt": 7, "configur": [8, 20], "mongoc_ssl_opt_t": [8, 574], "verif": 8, "support": [8, 20, 534], "librari": [8, 20], "openssl": 8, "libressl": 8, "libtl": 8, "nativ": 8, "window": [8, 20], "secur": 8, "channel": 8, "maco": [8, 20], "darwin": 8, "transport": 8, "pool": [9, 21, 669], "singl": [9, 227], "mode": [9, 521], "cursor": 10, "handl": 10, "failur": [10, 20], "destroi": 10, "tailabl": 10, "aid": 11, "debug": 11, "gdb": 11, "lldb": 11, "assert": 11, "distinct": 12, "mapreduc": 12, "setup": [12, 24], "more": 12, "complic": 12, "run": [12, 24, 671], "error": [13, 132, 133, 135, 138, 139, 140, 141, 142, 143, 144, 145, 152, 153, 155, 164, 166, 219, 223, 224, 226, 232, 253, 254, 285, 288, 291, 292, 294, 295, 296, 297, 298, 300, 301, 302, 303, 304, 308, 309, 310, 311, 313, 314, 315, 316, 323, 324, 325, 326, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 345, 349, 350, 367, 370, 371, 373, 376, 377, 378, 380, 381, 386, 387, 388, 389, 390, 396, 435, 437, 448, 453, 455, 466, 467, 468, 472], "descript": [13, 136, 137, 146, 148, 149, 150, 162, 163, 175, 176, 223, 227, 255, 260, 265, 289, 291, 293, 294, 295, 296, 297, 298, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 311, 312, 313, 314, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 330, 331, 332, 333, 334, 335, 336, 337, 338, 340, 341, 342, 343, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 358, 359, 360, 361, 362, 363, 364, 365, 368, 369, 372, 373, 375, 376, 377, 380, 399, 400, 402, 405, 406, 408, 409, 410, 411, 412, 413, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 477, 478, 480, 481, 483, 484, 485, 486, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 505, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 522, 523, 536, 537, 538, 539, 540, 541, 542, 543, 545, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 574, 576, 600, 604, 606, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 671, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 687, 688, 689, 690, 691, 692, 693], "label": 13, "transienttransactionerror": 13, "unknowntransactioncommitresult": 13, "version": [13, 534, 671, 695], "index": [14, 23], "gridf": [15, 21], "guid": 16, "In": 17, "instal": [17, 20, 696], "queri": 17, "analysi": 17, "libmongoc": [18, 20, 696, 697], "introduct": 18, "initi": 19, "cleanup": 19, "synopsi": [19, 22, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 286, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 339, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 366, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 394, 395, 396, 397, 398, 399, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 429, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 450, 451, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 462, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 473, 474, 475, 476, 477, 478, 479, 480, 481, 482, 483, 484, 485, 486, 487, 488, 489, 490, 491, 492, 493, 494, 495, 496, 497, 498, 499, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 521, 522, 523, 524, 525, 526, 527, 528, 529, 530, 531, 532, 533, 534, 535, 536, 537, 538, 539, 540, 541, 542, 543, 544, 545, 546, 547, 548, 549, 550, 551, 552, 553, 554, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 572, 573, 574, 575, 576, 577, 578, 579, 580, 581, 582, 583, 584, 585, 586, 587, 588, 589, 590, 591, 592, 593, 594, 595, 596, 597, 598, 599, 600, 601, 602, 603, 604, 605, 606, 607, 608, 609, 610, 611, 612, 613, 614, 615, 616, 617, 618, 619, 620, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 669, 670, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 686, 687, 688, 689, 690, 691, 692, 693, 694], "deprec": [19, 295, 317, 669, 694], "featur": 19, "c": [20, 696], "driver": 20, "bson": [20, 696], "libbson": 20, "platform": 20, "packag": 20, "manag": [20, 23], "build": 20, "prerequisit": 20, "visual": [20, 696, 697], "studio": [20, 696, 697], "mingw": 20, "w64": 20, "msys2": 20, "prepar": 20, "releas": 20, "tarbal": 20, "git": 20, "repositori": 20, "clone": 20, "execut": [20, 696], "gener": 20, "uninstal": 20, "compon": 20, "deal": 20, "integr": 20, "object": 21, "lifecycl": [21, 158, 159, 218, 361, 429, 473, 544], "databas": 21, "collect": [21, 23], "relat": [21, 462], "bucket": 21, "session": 21, "log": 22, "macro": 22, "custom": 22, "handler": 22, "disabl": 22, "trace": 22, "common": 24, "task": 24, "explain": [24, 312, 317], "mongoc_apm_callbacks_destroi": 25, "mongoc_apm_callbacks_new": 26, "return": [26, 28, 29, 30, 32, 33, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 67, 68, 69, 71, 72, 73, 75, 76, 77, 79, 81, 82, 83, 85, 86, 87, 88, 89, 91, 92, 93, 107, 108, 109, 110, 112, 113, 115, 116, 119, 135, 137, 139, 141, 143, 145, 153, 155, 157, 158, 159, 161, 163, 164, 165, 166, 168, 169, 170, 171, 173, 178, 179, 181, 182, 184, 193, 199, 200, 201, 202, 203, 205, 212, 213, 215, 216, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 239, 242, 243, 244, 246, 247, 248, 249, 252, 253, 254, 256, 257, 260, 261, 263, 264, 265, 266, 268, 269, 270, 271, 272, 274, 275, 276, 277, 278, 281, 285, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 300, 301, 302, 303, 304, 308, 309, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 332, 333, 334, 338, 340, 341, 342, 343, 344, 345, 346, 347, 349, 350, 357, 358, 359, 360, 361, 363, 364, 367, 368, 369, 370, 371, 372, 373, 376, 377, 378, 379, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 395, 396, 398, 399, 401, 403, 404, 407, 408, 409, 410, 411, 412, 413, 415, 416, 417, 418, 419, 420, 422, 423, 424, 425, 426, 427, 428, 430, 431, 432, 433, 435, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 448, 449, 452, 453, 454, 455, 459, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 474, 476, 479, 482, 490, 493, 498, 499, 500, 502, 504, 505, 509, 511, 513, 514, 515, 516, 524, 527, 528, 529, 530, 533, 535, 537, 538, 540, 541, 542, 548, 551, 553, 554, 558, 559, 560, 561, 563, 564, 565, 566, 567, 568, 569, 570, 571, 573, 575, 577, 578, 580, 581, 582, 584, 585, 586, 587, 588, 589, 590, 591, 592, 595, 597, 598, 599, 601, 602, 603, 604, 608, 611, 612, 613, 614, 621, 623, 624, 625, 626, 627, 628, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 648, 649, 650, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 667, 670, 672, 673, 675, 676, 677, 678, 679, 680, 681, 686], "mongoc_apm_callbacks_t": 27, "mongoc_apm_command_failed_get_command_nam": 28, "paramet": [28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 67, 68, 69, 71, 72, 73, 75, 76, 77, 78, 79, 81, 82, 83, 85, 86, 87, 88, 89, 91, 92, 93, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 112, 113, 115, 116, 118, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 152, 153, 154, 155, 156, 157, 158, 159, 161, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 174, 175, 176, 178, 179, 180, 181, 182, 183, 185, 186, 187, 188, 189, 190, 192, 194, 195, 196, 197, 199, 200, 201, 202, 203, 204, 206, 207, 208, 209, 210, 212, 213, 214, 215, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 252, 253, 254, 255, 256, 257, 258, 259, 260, 261, 262, 263, 264, 265, 266, 267, 268, 269, 270, 271, 272, 274, 275, 276, 277, 278, 279, 280, 281, 282, 283, 284, 285, 287, 288, 289, 290, 291, 292, 293, 294, 295, 296, 297, 298, 299, 300, 301, 302, 303, 304, 305, 306, 307, 308, 309, 310, 311, 312, 313, 314, 315, 316, 317, 318, 319, 320, 321, 322, 323, 324, 325, 326, 327, 328, 329, 330, 331, 332, 333, 334, 335, 336, 337, 338, 340, 341, 342, 343, 344, 345, 346, 347, 348, 349, 350, 351, 352, 353, 354, 355, 356, 357, 358, 359, 360, 361, 362, 363, 364, 365, 367, 368, 369, 370, 371, 372, 373, 374, 375, 376, 377, 378, 380, 381, 382, 383, 384, 385, 386, 387, 388, 389, 390, 391, 392, 393, 395, 396, 398, 399, 400, 401, 402, 403, 404, 405, 406, 408, 409, 410, 411, 412, 413, 419, 420, 421, 422, 423, 424, 425, 426, 427, 428, 430, 431, 432, 433, 434, 435, 436, 437, 438, 439, 440, 441, 442, 443, 444, 445, 446, 447, 448, 449, 452, 453, 454, 455, 456, 457, 458, 459, 460, 461, 463, 464, 465, 466, 467, 468, 469, 470, 471, 472, 474, 477, 480, 483, 488, 489, 490, 491, 493, 496, 497, 499, 500, 501, 502, 503, 505, 508, 509, 510, 511, 512, 513, 514, 515, 516, 517, 518, 519, 520, 524, 525, 527, 528, 529, 531, 533, 535, 536, 537, 538, 539, 540, 541, 542, 543, 545, 546, 548, 549, 550, 551, 552, 553, 555, 556, 557, 558, 559, 560, 561, 562, 563, 564, 565, 566, 567, 568, 569, 570, 571, 575, 577, 578, 579, 580, 581, 582, 584, 585, 586, 587, 588, 589, 590, 591, 592, 595, 597, 598, 599, 600, 601, 602, 603, 604, 606, 608, 609, 610, 611, 612, 613, 615, 616, 617, 618, 621, 622, 623, 624, 625, 626, 627, 628, 629, 630, 631, 632, 633, 634, 635, 636, 637, 638, 639, 640, 641, 642, 643, 644, 645, 646, 647, 648, 649, 650, 651, 652, 653, 654, 655, 656, 657, 658, 659, 660, 661, 662, 663, 664, 665, 666, 667, 668, 670, 672, 673, 674, 675, 676, 677, 678, 679, 680, 681, 682, 683, 684, 685, 687, 688, 689, 690, 691, 692, 693], "mongoc_apm_command_failed_get_context": 29, "mongoc_apm_command_failed_get_dur": 30, "mongoc_apm_command_failed_get_error": 31, "mongoc_apm_command_failed_get_host": 32, "mongoc_apm_command_failed_get_operation_id": 33, "mongoc_apm_command_failed_get_repli": 34, "mongoc_apm_command_failed_get_request_id": 35, "mongoc_apm_command_failed_get_server_connection_id": 36, "mongoc_apm_command_failed_get_server_connection_id_int64": 37, "mongoc_apm_command_failed_get_server_id": 38, "mongoc_apm_command_failed_get_service_id": 39, "mongoc_apm_command_failed_t": 40, "mongoc_apm_command_started_get_command": 41, "mongoc_apm_command_started_get_command_nam": 42, "mongoc_apm_command_started_get_context": 43, "mongoc_apm_command_started_get_database_nam": 44, "mongoc_apm_command_started_get_host": 45, "mongoc_apm_command_started_get_operation_id": 46, "mongoc_apm_command_started_get_request_id": 47, "mongoc_apm_command_started_get_server_connection_id": 48, "mongoc_apm_command_started_get_server_connection_id_int64": 49, "mongoc_apm_command_started_get_server_id": 50, "mongoc_apm_command_started_get_service_id": 51, "mongoc_apm_command_started_t": 52, "mongoc_apm_command_succeeded_get_command_nam": 53, "mongoc_apm_command_succeeded_get_context": 54, "mongoc_apm_command_succeeded_get_dur": 55, "mongoc_apm_command_succeeded_get_host": 56, "mongoc_apm_command_succeeded_get_operation_id": 57, "mongoc_apm_command_succeeded_get_repli": 58, "mongoc_apm_command_succeeded_get_request_id": 59, "mongoc_apm_command_succeeded_get_server_connection_id": 60, "mongoc_apm_command_succeeded_get_server_connection_id_int64": 61, "mongoc_apm_command_succeeded_get_server_id": 62, "mongoc_apm_command_succeeded_get_service_id": 63, "mongoc_apm_command_succeeded_t": 64, "mongoc_apm_server_changed_get_context": 65, "mongoc_apm_server_changed_get_host": 66, "mongoc_apm_server_changed_get_new_descript": 67, "mongoc_apm_server_changed_get_previous_descript": 68, "mongoc_apm_server_changed_get_topology_id": 69, "mongoc_apm_server_changed_t": 70, "mongoc_apm_server_closed_get_context": 71, "mongoc_apm_server_closed_get_host": 72, "mongoc_apm_server_closed_get_topology_id": 73, "mongoc_apm_server_closed_t": 74, "mongoc_apm_server_heartbeat_failed_get_await": 75, "mongoc_apm_server_heartbeat_failed_get_context": 76, "mongoc_apm_server_heartbeat_failed_get_dur": 77, "mongoc_apm_server_heartbeat_failed_get_error": 78, "mongoc_apm_server_heartbeat_failed_get_host": 79, "mongoc_apm_server_heartbeat_failed_t": 80, "mongoc_apm_server_heartbeat_started_get_await": 81, "mongoc_apm_server_heartbeat_started_get_context": 82, "mongoc_apm_server_heartbeat_started_get_host": 83, "mongoc_apm_server_heartbeat_started_t": 84, "mongoc_apm_server_heartbeat_succeeded_get_await": 85, "mongoc_apm_server_heartbeat_succeeded_get_context": 86, "mongoc_apm_server_heartbeat_succeeded_get_dur": 87, "mongoc_apm_server_heartbeat_succeeded_get_host": 88, "mongoc_apm_server_heartbeat_succeeded_get_repli": 89, "mongoc_apm_server_heartbeat_succeeded_t": 90, "mongoc_apm_server_opening_get_context": 91, "mongoc_apm_server_opening_get_host": 92, "mongoc_apm_server_opening_get_topology_id": 93, "mongoc_apm_server_opening_t": 94, "mongoc_apm_set_command_failed_cb": 95, "mongoc_apm_set_command_started_cb": 96, "mongoc_apm_set_command_succeeded_cb": 97, "mongoc_apm_set_server_changed_cb": 98, "mongoc_apm_set_server_closed_cb": 99, "mongoc_apm_set_server_heartbeat_failed_cb": 100, "mongoc_apm_set_server_heartbeat_started_cb": 101, "mongoc_apm_set_server_heartbeat_succeeded_cb": 102, "mongoc_apm_set_server_opening_cb": 103, "mongoc_apm_set_topology_changed_cb": 104, "mongoc_apm_set_topology_closed_cb": 105, "mongoc_apm_set_topology_opening_cb": 106, "mongoc_apm_topology_changed_get_context": 107, "mongoc_apm_topology_changed_get_new_descript": 108, "mongoc_apm_topology_changed_get_previous_descript": 109, "mongoc_apm_topology_changed_get_topology_id": 110, "mongoc_apm_topology_changed_t": 111, "mongoc_apm_topology_closed_get_context": 112, "mongoc_apm_topology_closed_get_topology_id": 113, "mongoc_apm_topology_closed_t": 114, "mongoc_apm_topology_opening_get_context": 115, "mongoc_apm_topology_opening_get_topology_id": 116, "mongoc_apm_topology_opening_t": 117, "mongoc_auto_encryption_opts_destroi": 118, "mongoc_auto_encryption_opts_new": 119, "mongoc_auto_encryption_opts_set_bypass_auto_encrypt": 120, "mongoc_auto_encryption_opts_set_bypass_query_analysi": 121, "mongoc_auto_encryption_opts_set_encrypted_fields_map": 122, "mongoc_auto_encryption_opts_set_extra": 123, "mongoc_auto_encryption_opts_set_keyvault_cli": 124, "mongoc_auto_encryption_opts_set_keyvault_client_pool": 125, "mongoc_auto_encryption_opts_set_keyvault_namespac": 126, "mongoc_auto_encryption_opts_set_kms_credential_provider_callback": 127, "mongoc_auto_encryption_opts_set_kms_provid": 128, "mongoc_auto_encryption_opts_set_schema_map": 129, "mongoc_auto_encryption_opts_set_tls_opt": 130, "mongoc_auto_encryption_opts_t": 131, "mongoc_bulk_operation_delet": 132, "mongoc_bulk_operation_delete_on": 133, "mongoc_bulk_operation_destroi": 134, "mongoc_bulk_operation_execut": 135, "mongoc_bulk_operation_get_hint": 136, "mongoc_bulk_operation_get_write_concern": 137, "mongoc_bulk_operation_insert": 138, "mongoc_bulk_operation_insert_with_opt": 139, "mongoc_bulk_operation_remov": 140, "mongoc_bulk_operation_remove_many_with_opt": 141, "mongoc_bulk_operation_remove_on": 142, "mongoc_bulk_operation_remove_one_with_opt": 143, "mongoc_bulk_operation_replace_on": 144, "mongoc_bulk_operation_replace_one_with_opt": 145, "mongoc_bulk_operation_set_bypass_document_valid": 146, "mongoc_bulk_operation_set_client_sess": 147, "mongoc_bulk_operation_set_com": 148, "mongoc_bulk_operation_set_hint": 149, "mongoc_bulk_operation_set_let": 150, "mongoc_bulk_operation_t": 151, "mongoc_bulk_operation_upd": 152, "mongoc_bulk_operation_update_many_with_opt": 153, "mongoc_bulk_operation_update_on": 154, "mongoc_bulk_operation_update_one_with_opt": 155, "mongoc_change_stream_destroi": 156, "mongoc_change_stream_error_docu": 157, "mongoc_change_stream_get_resume_token": 158, "mongoc_change_stream_next": 159, "mongoc_change_stream_t": 160, "start": [160, 696], "resum": 160, "mongoc_check_vers": 161, "mongoc_cleanup": 162, "mongoc_client_command": 163, "mongoc_client_command_simpl": 164, "mongoc_client_command_simple_with_server_id": 165, "mongoc_client_command_with_opt": 166, "mongoc_client_destroi": 167, "mongoc_client_enable_auto_encrypt": 168, "mongoc_client_encryption_add_key_alt_nam": 169, "mongoc_client_encryption_create_datakei": 170, "mongoc_client_encryption_create_encrypted_collect": 171, "creation": 171, "mongoc_client_encryption_datakey_opts_destroi": 172, "mongoc_client_encryption_datakey_opts_new": 173, "mongoc_client_encryption_datakey_opts_set_keyaltnam": 174, "mongoc_client_encryption_datakey_opts_set_keymateri": 175, "mongoc_client_encryption_datakey_opts_set_masterkei": 176, "mongoc_client_encryption_datakey_opts_t": 177, "mongoc_client_decryption_decrypt": 178, "mongoc_client_encryption_delete_kei": 179, "mongoc_client_encryption_destroi": 180, "mongoc_client_encryption_encrypt": 181, "mongoc_client_encryption_encrypt_express": 182, "mongoc_client_encryption_encrypt_opts_destroi": 183, "mongoc_client_encryption_encrypt_opts_new": 184, "mongoc_client_encryption_encrypt_opts_set_algorithm": 185, "mongoc_client_encryption_encrypt_opts_set_contention_factor": 186, "mongoc_client_encryption_encrypt_opts_set_keyaltnam": 187, "mongoc_client_encryption_encrypt_opts_set_keyid": 188, "mongoc_client_encryption_encrypt_opts_set_query_typ": 189, "mongoc_client_encryption_encrypt_opts_set_range_opt": 190, "mongoc_client_encryption_encrypt_opts_t": 191, "mongoc_client_encryption_encrypt_range_opts_destroi": 192, "mongoc_client_encryption_encrypt_range_opts_new": 193, "mongoc_client_encryption_encrypt_range_opts_set_max": 194, "mongoc_client_encryption_encrypt_range_opts_set_min": 195, "mongoc_client_encryption_encrypt_range_opts_set_precis": 196, "mongoc_client_encryption_encrypt_range_opts_set_spars": 197, "mongoc_client_encryption_encrypt_range_opts_t": 198, "mongoc_client_encryption_get_crypt_shared_vers": 199, "mongoc_client_encryption_get_kei": [200, 202], "mongoc_client_encryption_get_key_by_alt_nam": 201, "mongoc_client_encryption_new": 203, "mongoc_client_encryption_opts_destroi": 204, "mongoc_client_encryption_opts_new": 205, "mongoc_client_encryption_opts_set_keyvault_cli": 206, "mongoc_client_encryption_opts_set_keyvault_namespac": 207, "mongoc_client_encryption_opts_set_kms_credential_provider_callback": 208, "mongoc_client_encryption_opts_set_kms_provid": 209, "mongoc_client_encryption_opts_set_tls_opt": 210, "mongoc_client_encryption_opts_t": 211, "mongoc_client_encryption_remove_key_alt_nam": 212, "mongoc_client_encryption_rewrap_many_datakei": 213, "mongoc_client_encryption_rewrap_many_datakey_result_destroi": 214, "mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result": 215, "mongoc_client_encryption_rewrap_many_datakey_result_new": 216, "mongoc_client_encryption_rewrap_many_datakey_result_t": 217, "mongoc_client_encryption_t": 218, "thread": [218, 227, 240, 241, 244, 245, 246, 247, 248, 250, 252, 286, 366, 429, 462, 473, 696], "safeti": [218, 240, 241, 244, 245, 246, 247, 248, 250, 252, 286, 366, 429, 462, 473], "mongoc_client_find_databases_with_opt": 219, "mongoc_client_get_collect": 220, "mongoc_client_get_crypt_shared_vers": 221, "mongoc_client_get_databas": 222, "mongoc_client_get_database_nam": 223, "mongoc_client_get_database_names_with_opt": 224, "mongoc_client_get_default_databas": 225, "mongoc_client_get_gridf": 226, "mongoc_client_get_handshake_descript": 227, "behavior": [227, 311], "see": 227, "also": 227, "mongoc_client_get_read_concern": 228, "mongoc_client_get_read_pref": 229, "mongoc_client_get_server_descript": [230, 231], "mongoc_client_get_server_statu": 232, "mongoc_client_get_uri": 233, "mongoc_client_get_write_concern": 234, "mongoc_client_new": 235, "mongoc_client_new_from_uri": 236, "mongoc_client_new_from_uri_with_error": 237, "mongoc_client_pool_destroi": 238, "mongoc_client_pool_enable_auto_encrypt": 239, "mongoc_client_pool_max_s": 240, "mongoc_client_pool_min_s": 241, "mongoc_client_pool_new": 242, "mongoc_client_pool_new_with_error": 243, "mongoc_client_pool_pop": 244, "mongoc_client_pool_push": 245, "mongoc_client_pool_set_apm_callback": 246, "mongoc_client_pool_set_appnam": 247, "mongoc_client_pool_set_error_api": 248, "mongoc_client_pool_set_server_api": 249, "mongoc_client_pool_set_ssl_opt": 250, "avail": [250, 282], "mongoc_client_pool_t": 251, "mongoc_client_pool_try_pop": 252, "mongoc_client_read_command_with_opt": 253, "mongoc_client_read_write_command_with_opt": 254, "mongoc_client_reset": 255, "mongoc_client_select_serv": 256, "mongoc_client_session_abort_transact": 257, "mongoc_client_session_advance_cluster_tim": 258, "mongoc_client_session_advance_operation_tim": 259, "mongoc_client_session_append": 260, "mongoc_client_session_commit_transact": 261, "mongoc_client_session_destroi": 262, "mongoc_client_session_get_cli": 263, "mongoc_client_session_get_cluster_tim": 264, "mongoc_client_session_get_dirti": 265, "mongoc_client_session_get_lsid": 266, "mongoc_client_session_get_operation_tim": 267, "mongoc_client_session_get_opt": 268, "mongoc_client_session_get_server_id": 269, "mongoc_client_session_get_transaction_st": 270, "mongoc_client_session_in_transact": 271, "mongoc_client_session_start_transact": 272, "mongoc_client_session_t": 273, "mongoc_client_session_with_transact": 274, "mongoc_client_session_with_transaction_cb_t": 275, "mongoc_client_set_apm_callback": 276, "mongoc_client_set_appnam": 277, "mongoc_client_set_error_api": 278, "mongoc_client_set_read_concern": 279, "mongoc_client_set_read_pref": 280, "mongoc_client_set_server_api": 281, "mongoc_client_set_ssl_opt": 282, "mongoc_client_set_stream_initi": 283, "mongoc_client_set_write_concern": 284, "mongoc_client_start_sess": 285, "mongoc_client_t": 286, "stream": [286, 594], "mongoc_client_watch": 287, "mongoc_client_write_command_with_opt": 288, "mongoc_collection_aggreg": 289, "other": 289, "mongoc_collection_command": 290, "mongoc_collection_command_simpl": 291, "mongoc_collection_command_with_opt": 292, "mongoc_collection_copi": 293, "mongoc_collection_count": 294, "mongoc_collection_count_docu": 295, "migrat": 295, "count": [295, 696], "mongoc_collection_count_with_opt": 296, "mongoc_collection_create_bulk_oper": 297, "mongoc_collection_create_bulk_operation_with_opt": 298, "mongoc_collection_create_index": 299, "mongoc_collection_create_index_with_opt": 300, "mongoc_collection_create_indexes_with_opt": 301, "mongoc_index_model_t": 301, "mongoc_collection_delet": 302, "mongoc_collection_delete_mani": 303, "mongoc_collection_delete_on": 304, "mongoc_collection_destroi": 305, "mongoc_collection_drop": 306, "mongoc_collection_drop_index": 307, "mongoc_collection_drop_index_with_opt": 308, "mongoc_collection_drop_with_opt": 309, "mongoc_collection_ensure_index": 310, "mongoc_collection_estimated_document_count": 311, "mongoc_collection_find": 312, "The": [312, 317], "find": [312, 696], "mongoc_collection_find_and_modifi": 313, "mongoc_collection_find_and_modify_with_opt": 314, "mongoc_collection_find_index": 315, "mongoc_collection_find_indexes_with_opt": 316, "mongoc_collection_find_with_opt": 317, "mongoc_collection_get_last_error": 318, "mongoc_collection_get_nam": 319, "mongoc_collection_get_read_concern": 320, "mongoc_collection_get_read_pref": 321, "mongoc_collection_get_write_concern": 322, "mongoc_collection_insert": 323, "mongoc_collection_insert_bulk": 324, "mongoc_collection_insert_mani": 325, "mongoc_collection_insert_on": 326, "mongoc_collection_keys_to_index_str": 327, "mongoc_collection_read_command_with_opt": 328, "mongoc_collection_read_write_command_with_opt": 329, "mongoc_collection_remov": 330, "mongoc_collection_renam": 331, "mongoc_collection_rename_with_opt": 332, "mongoc_collection_replace_on": 333, "mongoc_collection_sav": 334, "mongoc_collection_set_read_concern": 335, "mongoc_collection_set_read_pref": 336, "mongoc_collection_set_write_concern": 337, "mongoc_collection_stat": 338, "mongoc_collection_t": 339, "prefer": [339, 669], "mongoc_collection_upd": 340, "mongoc_collection_update_mani": 341, "mongoc_collection_update_on": 342, "mongoc_collection_valid": 343, "mongoc_collection_watch": 344, "mongoc_collection_write_command_with_opt": 345, "mongoc_cursor_clon": 346, "mongoc_cursor_curr": 347, "mongoc_cursor_destroi": 348, "mongoc_cursor_error": 349, "mongoc_cursor_error_docu": 350, "mongoc_cursor_get_batch_s": 351, "mongoc_cursor_get_hint": 352, "mongoc_cursor_get_host": 353, "mongoc_cursor_get_id": 354, "mongoc_cursor_get_limit": 355, "mongoc_cursor_get_max_await_time_m": 356, "mongoc_cursor_is_al": 357, "mongoc_cursor_mor": 358, "mongoc_cursor_new_from_command_repli": 359, "mongoc_cursor_new_from_command_reply_with_opt": 360, "mongoc_cursor_next": 361, "mongoc_cursor_set_batch_s": 362, "mongoc_cursor_set_hint": 363, "mongoc_cursor_set_limit": 364, "mongoc_cursor_set_max_await_time_m": 365, "mongoc_cursor_t": 366, "mongoc_database_add_us": 367, "mongoc_database_aggreg": 368, "mongoc_database_command": 369, "mongoc_database_command_simpl": 370, "mongoc_database_command_with_opt": 371, "mongoc_database_copi": 372, "mongoc_database_create_collect": 373, "mongoc_database_destroi": 374, "mongoc_database_drop": 375, "mongoc_database_drop_with_opt": 376, "mongoc_database_find_collect": 377, "mongoc_database_find_collections_with_opt": 378, "mongoc_database_get_collect": 379, "mongoc_database_get_collection_nam": 380, "mongoc_database_get_collection_names_with_opt": 381, "mongoc_database_get_nam": 382, "mongoc_database_get_read_concern": 383, "mongoc_database_get_read_pref": 384, "mongoc_database_get_write_concern": 385, "mongoc_database_has_collect": 386, "mongoc_database_read_command_with_opt": 387, "mongoc_database_read_write_command_with_opt": 388, "mongoc_database_remove_all_us": 389, "mongoc_database_remove_us": 390, "mongoc_database_set_read_concern": 391, "mongoc_database_set_read_pref": 392, "mongoc_database_set_write_concern": 393, "mongoc_database_t": 394, "mongoc_database_watch": 395, "mongoc_database_write_command_with_opt": 396, "mongoc_delete_flags_t": 397, "mongoc_error_has_label": 398, "mongoc_find_and_modify_opts_append": 399, "append": [399, 696], "findandmodifi": 399, "mongoc_find_and_modify_opts_destroi": 400, "mongoc_find_and_modify_opts_get_bypass_document_valid": 401, "mongoc_find_and_modify_opts_get_field": 402, "mongoc_find_and_modify_opts_get_flag": 403, "mongoc_find_and_modify_opts_get_max_time_m": 404, "mongoc_find_and_modify_opts_get_sort": 405, "mongoc_find_and_modify_opts_get_upd": 406, "mongoc_find_and_modify_opts_new": 407, "mongoc_find_and_modify_opts_set_bypass_document_valid": 408, "bypassdocumentvalid": 408, "mongoc_find_and_modify_opts_set_field": 409, "mongoc_find_and_modify_opts_set_flag": 410, "flag": [410, 486, 494, 522, 523, 619, 620], "mongoc_find_and_modify_opts_set_max_time_m": 411, "maxtimem": 411, "mongoc_find_and_modify_opts_set_sort": 412, "sort": 412, "mongoc_find_and_modify_opts_set_upd": 413, "updat": [413, 696], "mongoc_find_and_modify_opts_t": 414, "mongoc_get_major_vers": 415, "mongoc_get_micro_vers": 416, "mongoc_get_minor_vers": 417, "mongoc_get_vers": 418, "mongoc_gridfs_bucket_abort_upload": 419, "mongoc_gridfs_bucket_delete_by_id": 420, "mongoc_gridfs_bucket_destroi": 421, "mongoc_gridfs_bucket_download_to_stream": 422, "mongoc_gridfs_bucket_find": 423, "mongoc_gridfs_bucket_new": 424, "mongoc_gridfs_bucket_open_download_stream": 425, "mongoc_gridfs_bucket_open_upload_stream": 426, "mongoc_gridfs_bucket_open_upload_stream_with_id": 427, "mongoc_gridfs_bucket_stream_error": 428, "mongoc_gridfs_bucket_t": 429, "mongoc_gridfs_bucket_upload_from_stream": 430, "mongoc_gridfs_bucket_upload_from_stream_with_id": 431, "mongoc_gridfs_create_fil": 432, "mongoc_gridfs_create_file_from_stream": 433, "mongoc_gridfs_destroi": 434, "mongoc_gridfs_drop": 435, "mongoc_gridfs_file_destroi": 436, "mongoc_gridfs_file_error": 437, "mongoc_gridfs_file_get_alias": 438, "mongoc_gridfs_file_get_chunk_s": 439, "mongoc_gridfs_file_get_content_typ": 440, "mongoc_gridfs_file_get_filenam": 441, "mongoc_gridfs_file_get_id": 442, "mongoc_gridfs_file_get_length": 443, "mongoc_gridfs_file_get_md5": 444, "mongoc_gridfs_file_get_metadata": 445, "mongoc_gridfs_file_get_upload_d": 446, "mongoc_gridfs_file_list_destroi": 447, "mongoc_gridfs_file_list_error": 448, "mongoc_gridfs_file_list_next": 449, "mongoc_gridfs_file_list_t": 450, "mongoc_gridfs_file_opt_t": 451, "mongoc_gridfs_file_readv": 452, "mongoc_gridfs_file_remov": 453, "mongoc_gridfs_file_sav": 454, "mongoc_gridfs_file_seek": 455, "mongoc_gridfs_file_set_alias": 456, "mongoc_gridfs_file_set_content_typ": 457, "mongoc_gridfs_file_set_filenam": 458, "mongoc_gridfs_file_set_id": 459, "mongoc_gridfs_file_set_md5": 460, "mongoc_gridfs_file_set_metadata": 461, "mongoc_gridfs_file_t": 462, "mongoc_gridfs_file_tel": 463, "mongoc_gridfs_file_writev": 464, "mongoc_gridfs_find": 465, "mongoc_gridfs_find_on": 466, "mongoc_gridfs_find_one_by_filenam": 467, "mongoc_gridfs_find_one_with_opt": 468, "mongoc_gridfs_find_with_opt": 469, "mongoc_gridfs_get_chunk": 470, "mongoc_gridfs_get_fil": 471, "mongoc_gridfs_remove_by_filenam": 472, "mongoc_gridfs_t": 473, "mongoc_handshake_data_append": 474, "mongoc_host_list_t": 475, "mongoc_index_opt_geo_get_default": 476, "mongoc_index_opt_geo_init": 477, "mongoc_index_opt_geo_t": 478, "mongoc_index_opt_get_default": 479, "mongoc_index_opt_init": 480, "mongoc_index_opt_t": 481, "mongoc_index_opt_wt_get_default": 482, "mongoc_index_opt_wt_init": 483, "mongoc_index_opt_wt_t": 484, "mongoc_init": 485, "mongoc_insert_flags_t": 486, "valu": [486, 494, 522, 523, 619, 620], "mongoc_iovec_t": 487, "mongoc_optional_copi": 488, "mongoc_optional_init": 489, "mongoc_optional_is_set": 490, "mongoc_optional_set_valu": 491, "mongoc_optional_t": 492, "mongoc_optional_valu": 493, "mongoc_query_flags_t": 494, "mongoc_rand": 495, "entropi": 495, "statu": 495, "mongoc_rand_add": 496, "mongoc_rand_se": 497, "mongoc_rand_statu": 498, "mongoc_read_concern_append": 499, "mongoc_read_concern_copi": 500, "mongoc_read_concern_destroi": 501, "mongoc_read_concern_get_level": 502, "mongoc_read_concern_is_default": 503, "mongoc_read_concern_new": 504, "mongoc_read_concern_set_level": 505, "mongoc_read_concern_t": 506, "mongoc_read_mode_t": 507, "mongoc_read_prefs_add_tag": 508, "mongoc_read_prefs_copi": 509, "mongoc_read_prefs_destroi": 510, "mongoc_read_prefs_get_hedg": 511, "mongoc_read_prefs_get_max_staleness_second": 512, "mongoc_read_prefs_get_mod": 513, "mongoc_read_prefs_get_tag": 514, "mongoc_read_prefs_is_valid": 515, "mongoc_read_prefs_new": 516, "mongoc_read_prefs_set_hedg": 517, "mongoc_read_prefs_set_max_staleness_second": 518, "mongoc_read_prefs_set_mod": 519, "mongoc_read_prefs_set_tag": 520, "mongoc_read_prefs_t": 521, "tag": 521, "max": 521, "stale": 521, "hedg": 521, "mongoc_remove_flags_t": 522, "mongoc_reply_flags_t": 523, "mongoc_server_api_copi": 524, "mongoc_server_api_deprecation_error": 525, "mongoc_server_api_destroi": 526, "mongoc_server_api_get_deprecation_error": 527, "mongoc_server_api_get_strict": 528, "mongoc_server_api_get_vers": 529, "mongoc_server_api_new": 530, "mongoc_server_api_strict": 531, "mongoc_server_api_t": 532, "mongoc_server_api_version_from_str": 533, "mongoc_server_api_version_t": 534, "mongoc_server_api_version_to_str": 535, "mongoc_server_description_destroi": 536, "mongoc_server_description_hello_respons": 537, "mongoc_server_description_host": 538, "mongoc_server_description_id": 539, "mongoc_server_description_ismast": 540, "mongoc_server_description_last_update_tim": 541, "mongoc_server_description_new_copi": 542, "mongoc_server_description_round_trip_tim": 543, "mongoc_server_description_t": 544, "mongoc_server_description_typ": 545, "mongoc_server_descriptions_destroy_al": 546, "mongoc_session_opt_t": 547, "mongoc_session_opts_clon": 548, "mongoc_session_opts_destroi": 549, "mongoc_session_opts_get_causal_consist": 550, "mongoc_session_opts_get_default_transaction_opt": 551, "mongoc_session_opts_get_snapshot": 552, "mongoc_session_opts_get_transaction_opt": 553, "mongoc_session_opts_new": 554, "mongoc_session_opts_set_causal_consist": 555, "mongoc_session_opts_set_default_transaction_opt": 556, "mongoc_session_opts_set_snapshot": 557, "mongoc_socket_accept": 558, "mongoc_socket_bind": 559, "mongoc_socket_clos": 560, "mongoc_socket_connect": 561, "mongoc_socket_destroi": 562, "mongoc_socket_errno": 563, "mongoc_socket_getnameinfo": 564, "mongoc_socket_getsocknam": 565, "mongoc_socket_listen": 566, "mongoc_socket_new": 567, "mongoc_socket_recv": 568, "mongoc_socket_send": 569, "mongoc_socket_sendv": 570, "mongoc_socket_setsockopt": 571, "mongoc_socket_t": 572, "mongoc_ssl_opt_get_default": 573, "mongoc_stream_buffered_new": 575, "mongoc_stream_buffered_t": 576, "mongoc_stream_clos": 577, "mongoc_stream_cork": 578, "mongoc_stream_destroi": 579, "mongoc_stream_file_get_fd": 580, "mongoc_stream_file_new": 581, "mongoc_stream_file_new_for_path": 582, "mongoc_stream_file_t": 583, "mongoc_stream_flush": 584, "mongoc_stream_get_base_stream": 585, "mongoc_stream_gridfs_new": 586, "mongoc_stream_read": 587, "mongoc_stream_readv": 588, "mongoc_stream_setsockopt": 589, "mongoc_stream_should_retri": 590, "mongoc_stream_socket_get_socket": 591, "mongoc_stream_socket_new": 592, "mongoc_stream_socket_t": 593, "mongoc_stream_t": 594, "type": 594, "mongoc_stream_timed_out": 595, "mongoc_stream_tls_t": 596, "mongoc_stream_uncork": 597, "mongoc_stream_writ": 598, "mongoc_stream_writev": 599, "mongoc_topology_description_destroi": 600, "mongoc_topology_description_get_serv": 601, "mongoc_topology_description_has_readable_serv": 602, "mongoc_topology_description_has_writable_serv": 603, "mongoc_topology_description_new_copi": 604, "mongoc_topology_description_t": 605, "mongoc_topology_description_typ": 606, "mongoc_transaction_opt_t": 607, "mongoc_transaction_opts_clon": 608, "mongoc_transaction_opts_destroi": 609, "mongoc_transaction_opts_get_max_commit_time_m": 610, "mongoc_transaction_opts_get_read_concern": 611, "mongoc_transaction_opts_get_read_pref": 612, "mongoc_transaction_opts_get_write_concern": 613, "mongoc_transaction_opts_new": 614, "mongoc_transaction_opts_set_max_commit_time_m": 615, "mongoc_transaction_opts_set_read_concern": 616, "mongoc_transaction_opts_set_read_pref": 617, "mongoc_transaction_opts_set_write_concern": 618, "mongoc_transaction_state_t": 619, "mongoc_update_flags_t": 620, "mongoc_uri_copi": 621, "mongoc_uri_destroi": 622, "mongoc_uri_get_auth_mechan": 623, "mongoc_uri_get_auth_sourc": 624, "mongoc_uri_get_compressor": 625, "mongoc_uri_get_databas": 626, "mongoc_uri_get_host": 627, "mongoc_uri_get_mechanism_properti": 628, "mongoc_uri_get_option_as_bool": 629, "mongoc_uri_get_option_as_int32": 630, "mongoc_uri_get_option_as_int64": 631, "mongoc_uri_get_option_as_utf8": 632, "mongoc_uri_get_opt": 633, "mongoc_uri_get_password": 634, "mongoc_uri_get_read_concern": 635, "mongoc_uri_get_read_pref": 636, "mongoc_uri_get_read_prefs_t": 637, "mongoc_uri_get_replica_set": 638, "mongoc_uri_get_servic": 639, "mongoc_uri_get_srv_hostnam": 640, "mongoc_uri_get_srv_service_nam": 641, "mongoc_uri_get_ssl": 642, "mongoc_uri_get_str": 643, "mongoc_uri_get_tl": 644, "mongoc_uri_get_usernam": 645, "mongoc_uri_get_write_concern": 646, "mongoc_uri_has_opt": 647, "mongoc_uri_new": 648, "mongoc_uri_new_for_host_port": 649, "mongoc_uri_new_with_error": 650, "mongoc_uri_option_is_bool": 651, "mongoc_uri_option_is_int32": 652, "mongoc_uri_option_is_int64": 653, "mongoc_uri_option_is_utf8": 654, "mongoc_uri_set_auth_mechan": 655, "mongoc_uri_set_auth_sourc": 656, "mongoc_uri_set_compressor": 657, "mongoc_uri_set_databas": 658, "mongoc_uri_set_mechanism_properti": 659, "mongoc_uri_set_option_as_bool": 660, "mongoc_uri_set_option_as_int32": 661, "mongoc_uri_set_option_as_int64": 662, "mongoc_uri_set_option_as_utf8": 663, "mongoc_uri_set_password": 664, "mongoc_uri_set_read_concern": 665, "mongoc_uri_set_read_prefs_t": 666, "mongoc_uri_set_usernam": 667, "mongoc_uri_set_write_concern": 668, "mongoc_uri_t": 669, "format": 669, "srv": 669, "mechan": 669, "properti": 669, "ssl": 669, "discoveri": 669, "select": 669, "mongoc_uri_unescap": 670, "check": 671, "time": 671, "mongoc_write_concern_append": 672, "mongoc_write_concern_copi": 673, "mongoc_write_concern_destroi": 674, "mongoc_write_concern_get_fsync": 675, "mongoc_write_concern_get_journ": 676, "mongoc_write_concern_get_w": 677, "mongoc_write_concern_get_wmajor": 678, "mongoc_write_concern_get_wtag": 679, "mongoc_write_concern_get_wtimeout": 680, "mongoc_write_concern_get_wtimeout_int64": 681, "mongoc_write_concern_is_acknowledg": 682, "mongoc_write_concern_is_default": 683, "mongoc_write_concern_is_valid": 684, "mongoc_write_concern_journal_is_set": 685, "mongoc_write_concern_new": 686, "mongoc_write_concern_set_fsync": 687, "mongoc_write_concern_set_journ": 688, "mongoc_write_concern_set_w": 689, "mongoc_write_concern_set_wmajor": 690, "mongoc_write_concern_set_wtag": 691, "mongoc_write_concern_set_wtimeout": 692, "mongoc_write_concern_set_wtimeout_int64": 693, "mongoc_write_concern_t": 694, "queryabl": 695, "older": 695, "tutori": 696, "content": 696, "includ": 696, "link": [696, 697], "your": 696, "program": 696, "mongoc": 696, "h": 696, "cmake": 696, "pkg": 696, "config": 696, "specifi": 696, "header": 696, "path": 696, "manual": 696, "microsoft": [696, 697], "project": [696, 697], "make": 696, "creat": 696, "bcon": 696, "json": 696, "crud": 696, "delet": 696, "next": [696, 697], "step": [696, 697], "static": 697}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "sphinx": 57}, "alltitles": {"Advanced Connections": [[0, "advanced-connections"]], "Connecting to a Replica Set": [[0, "connecting-to-a-replica-set"]], "Connecting to a Sharded Cluster": [[0, "connecting-to-a-sharded-cluster"]], "Connecting to an IPv6 Address": [[0, "connecting-to-an-ipv6-address"]], "Connecting with IPv4 and IPv6": [[0, "connecting-with-ipv4-and-ipv6"]], "Connecting to a UNIX Domain Socket": [[0, "connecting-to-a-unix-domain-socket"]], "Connecting to a server over TLS": [[0, "connecting-to-a-server-over-tls"]], "Compressing data to and from MongoDB": [[0, "compressing-data-to-and-from-mongodb"]], "Additional Connection Options": [[0, "additional-connection-options"]], "Aggregation Framework Examples": [[1, "aggregation-framework-examples"]], "Requirements": [[1, "requirements"]], "Aggregations using the Zip Codes Data Set": [[1, "id1"]], "States with Populations Over 10 Million": [[1, "states-with-populations-over-10-million"]], "Average City Population by State": [[1, "average-city-population-by-state"]], "API Reference": [[2, "api-reference"]], "Application Performance Monitoring (APM)": [[3, "application-performance-monitoring-apm"]], "Command-Monitoring Example": [[3, "command-monitoring-example"]], "SDAM Monitoring Example": [[3, "sdam-monitoring-example"]], "Functions": [[3, "functions"], [13, "functions"], [27, "functions"], [40, "functions"], [52, "functions"], [64, "functions"], [70, "functions"], [74, "functions"], [80, "functions"], [84, "functions"], [90, "functions"], [94, "functions"], [111, "functions"], [114, "functions"], [117, "functions"], [131, "functions"], [151, "functions"], [160, "functions"], [177, "functions"], [191, "functions"], [198, "functions"], [211, "functions"], [217, "functions"], [218, "functions"], [251, "functions"], [273, "functions"], [286, "functions"], [339, "functions"], [366, "functions"], [394, "functions"], [414, "functions"], [429, "functions"], [450, "functions"], [451, "functions"], [462, "functions"], [473, "functions"], [478, "functions"], [481, "functions"], [484, "functions"], [492, "functions"], [495, "functions"], [506, "functions"], [521, "functions"], [532, "functions"], [534, "functions"], [544, "functions"], [547, "functions"], [572, "functions"], [574, "functions"], [583, "functions"], [593, "functions"], [594, "functions"], [605, "functions"], [607, "functions"], [669, "functions"], [694, "functions"]], "Authentication": [[4, "authentication"]], "Basic Authentication (SCRAM-SHA-256)": [[4, "basic-authentication-scram-sha-256"]], "Basic Authentication (SCRAM-SHA-1)": [[4, "basic-authentication-scram-sha-1"]], "Legacy Authentication (MONGODB-CR)": [[4, "legacy-authentication-mongodb-cr"]], "GSSAPI (Kerberos) Authentication": [[4, "gssapi-kerberos-authentication"]], "SASL Plain Authentication": [[4, "sasl-plain-authentication"]], "X.509 Certificate Authentication": [[4, "x-509-certificate-authentication"]], "Authentication via AWS IAM": [[4, "authentication-via-aws-iam"]], "AWS credentials via URI": [[4, "aws-credentials-via-uri"]], "AWS credentials via environment": [[4, "aws-credentials-via-environment"]], "AWS Credentials via ECS": [[4, "aws-credentials-via-ecs"]], "AWS Credentials via EC2": [[4, "aws-credentials-via-ec2"]], "Basic Troubleshooting": [[5, "basic-troubleshooting"]], "Troubleshooting Checklist": [[5, "troubleshooting-checklist"]], "Performance Counters": [[5, "performance-counters"]], "Submitting a Bug Report": [[5, "submitting-a-bug-report"]], "Bulk Write Operations": [[6, "bulk-write-operations"]], "Bulk Insert": [[6, "bulk-insert"]], "Mixed Bulk Write Operations": [[6, "mixed-bulk-write-operations"]], "Ordered Bulk Write Operations": [[6, "ordered-bulk-write-operations"]], "Unordered Bulk Write Operations": [[6, "unordered-bulk-write-operations"]], "Bulk Operation Bypassing Document Validation": [[6, "bulk-operation-bypassing-document-validation"]], "Bulk Operation Write Concerns": [[6, "bulk-operation-write-concerns"]], "Setting Collation Order": [[6, "setting-collation-order"]], "Unacknowledged Bulk Writes": [[6, "unacknowledged-bulk-writes"]], "Further Reading": [[6, "further-reading"]], "Client-Side Field Level Encryption": [[7, "client-side-field-level-encryption"]], "Automatic Client-Side Field Level Encryption": [[7, "automatic-client-side-field-level-encryption"]], "Providing Local Automatic Encryption Rules": [[7, "providing-local-automatic-encryption-rules"]], "Server-Side Field Level Encryption Enforcement": [[7, "server-side-field-level-encryption-enforcement"]], "Explicit Encryption": [[7, "explicit-encryption"]], "Explicit Encryption with Automatic Decryption": [[7, "explicit-encryption-with-automatic-decryption"]], "Configuring TLS": [[8, "configuring-tls"]], "Configuration with URI options": [[8, "configuration-with-uri-options"]], "Configuration with mongoc_ssl_opt_t": [[8, "configuration-with-mongoc-ssl-opt-t"]], "Client Authentication": [[8, "client-authentication"]], "Server Certificate Verification": [[8, "server-certificate-verification"]], "Supported Libraries": [[8, "supported-libraries"]], "OpenSSL": [[8, "openssl"]], "LibreSSL / libtls": [[8, "libressl-libtls"]], "Native TLS Support on Windows (Secure Channel)": [[8, "native-tls-support-on-windows-secure-channel"]], "Native TLS Support on macOS / Darwin (Secure Transport)": [[8, "native-tls-support-on-macos-darwin-secure-transport"]], "Connection Pooling": [[9, "connection-pooling"]], "Single Mode": [[9, "single-mode"]], "Pooled Mode": [[9, "pooled-mode"]], "Cursors": [[10, "cursors"]], "Handling Cursor Failures": [[10, "handling-cursor-failures"]], "Destroying Server-Side Cursors": [[10, "destroying-server-side-cursors"]], "Tailable Cursors": [[10, "tailable-cursors"]], "Aids for Debugging": [[11, "aids-for-debugging"]], "GDB": [[11, "gdb"]], "LLDB": [[11, "lldb"]], "Debug assertions": [[11, "debug-assertions"]], "\u201cdistinct\u201d and \u201cmapReduce\u201d": [[12, "distinct-and-mapreduce"]], "Setup": [[12, "setup"], [24, "setup"]], "\u201cdistinct\u201d command": [[12, "distinct-command"]], "\u201cmapReduce\u201d - basic example": [[12, "mapreduce-basic-example"]], "\u201cmapReduce\u201d - more complicated example": [[12, "mapreduce-more-complicated-example"]], "Running the Examples": [[12, "running-the-examples"], [24, "running-the-examples"]], "Error Reporting": [[13, "error-reporting"]], "Description": [[13, "description"], [136, "description"], [137, "description"], [146, "description"], [148, "description"], [149, "description"], [150, "description"], [162, "description"], [163, "description"], [175, "description"], [176, "description"], [223, "description"], [227, "description"], [255, "description"], [260, "description"], [265, "description"], [289, "description"], [291, "description"], [293, "description"], [294, "description"], [295, "description"], [296, "description"], [297, "description"], [298, "description"], [300, "description"], [301, "description"], [302, "description"], [303, "description"], [304, "description"], [305, "description"], [306, "description"], [307, "description"], [308, "description"], [309, "description"], [311, "description"], [312, "description"], [313, "description"], [314, "description"], [317, "description"], [318, "description"], [319, "description"], [320, "description"], [321, "description"], [322, "description"], [323, "description"], [324, "description"], [325, "description"], [326, "description"], [327, "description"], [330, "description"], [331, "description"], [332, "description"], [333, "description"], [334, "description"], [335, "description"], [336, "description"], [337, "description"], [338, "description"], [340, "description"], [341, "description"], [342, "description"], [343, "description"], [346, "description"], [347, "description"], [348, "description"], [349, "description"], [350, "description"], [351, "description"], [352, "description"], [353, "description"], [354, "description"], [355, "description"], [356, "description"], [358, "description"], [359, "description"], [360, "description"], [361, "description"], [362, "description"], [363, "description"], [364, "description"], [365, "description"], [368, "description"], [369, "description"], [372, "description"], [373, "description"], [375, "description"], [376, "description"], [377, "description"], [380, "description"], [399, "description"], [400, "description"], [402, "description"], [405, "description"], [406, "description"], [408, "description"], [409, "description"], [410, "description"], [411, "description"], [412, "description"], [413, "description"], [419, "description"], [420, "description"], [421, "description"], [422, "description"], [423, "description"], [424, "description"], [425, "description"], [426, "description"], [427, "description"], [428, "description"], [429, "description"], [430, "description"], [431, "description"], [432, "description"], [433, "description"], [434, "description"], [435, "description"], [436, "description"], [437, "description"], [438, "description"], [439, "description"], [440, "description"], [441, "description"], [442, "description"], [443, "description"], [444, "description"], [445, "description"], [446, "description"], [447, "description"], [448, "description"], [449, "description"], [450, "description"], [451, "description"], [452, "description"], [453, "description"], [454, "description"], [455, "description"], [456, "description"], [457, "description"], [458, "description"], [459, "description"], [460, "description"], [461, "description"], [462, "description"], [463, "description"], [464, "description"], [465, "description"], [466, "description"], [467, "description"], [468, "description"], [469, "description"], [470, "description"], [471, "description"], [472, "description"], [473, "description"], [474, "description"], [475, "description"], [477, "description"], [478, "description"], [480, "description"], [481, "description"], [483, "description"], [484, "description"], [485, "description"], [486, "description"], [494, "description"], [495, "description"], [496, "description"], [497, "description"], [498, "description"], [499, "description"], [500, "description"], [501, "description"], [502, "description"], [503, "description"], [505, "description"], [507, "description"], [508, "description"], [509, "description"], [510, "description"], [511, "description"], [512, "description"], [513, "description"], [514, "description"], [515, "description"], [516, "description"], [517, "description"], [518, "description"], [519, "description"], [520, "description"], [522, "description"], [523, "description"], [536, "description"], [537, "description"], [538, "description"], [539, "description"], [540, "description"], [541, "description"], [542, "description"], [543, "description"], [545, "description"], [558, "description"], [559, "description"], [560, "description"], [561, "description"], [562, "description"], [563, "description"], [564, "description"], [565, "description"], [566, "description"], [567, "description"], [568, "description"], [569, "description"], [570, "description"], [571, "description"], [574, "description"], [576, "description"], [600, "description"], [604, "description"], [606, "description"], [619, "description"], [620, "description"], [621, "description"], [622, "description"], [623, "description"], [624, "description"], [625, "description"], [626, "description"], [627, "description"], [628, "description"], [629, "description"], [630, "description"], [631, "description"], [632, "description"], [633, "description"], [634, "description"], [635, "description"], [636, "description"], [637, "description"], [638, "description"], [640, "description"], [641, "description"], [642, "description"], [643, "description"], [644, "description"], [645, "description"], [646, "description"], [647, "description"], [648, "description"], [649, "description"], [650, "description"], [651, "description"], [652, "description"], [653, "description"], [654, "description"], [655, "description"], [656, "description"], [657, "description"], [658, "description"], [659, "description"], [660, "description"], [661, "description"], [662, "description"], [663, "description"], [664, "description"], [665, "description"], [666, "description"], [667, "description"], [668, "description"], [669, "description"], [670, "description"], [671, "description"], [672, "description"], [673, "description"], [674, "description"], [675, "description"], [676, "description"], [677, "description"], [678, "description"], [679, "description"], [680, "description"], [681, "description"], [682, "description"], [683, "description"], [684, "description"], [685, "description"], [687, "description"], [688, "description"], [689, "description"], [690, "description"], [691, "description"], [692, "description"], [693, "description"]], "Error Labels": [[13, "error-labels"]], "TransientTransactionError": [[13, "transienttransactionerror"]], "UnknownTransactionCommitResult": [[13, "unknowntransactioncommitresult"]], "Setting the Error API Version": [[13, "setting-the-error-api-version"]], "Index": [[14, "index"]], "GridFS": [[15, "gridfs"]], "Guides": [[16, "guides"]], "In-Use Encryption": [[17, "in-use-encryption"]], "Installation": [[17, "installation"]], "API": [[17, "api"]], "Query Analysis": [[17, "query-analysis"]], "libmongoc": [[18, "libmongoc"]], "Introduction": [[18, "introduction"]], "Initialization and cleanup": [[19, "initialization-and-cleanup"]], "Synopsis": [[19, "synopsis"], [22, "synopsis"], [25, "synopsis"], [26, "synopsis"], [27, "synopsis"], [28, "synopsis"], [29, "synopsis"], [30, "synopsis"], [31, "synopsis"], [32, "synopsis"], [33, "synopsis"], [34, "synopsis"], [35, "synopsis"], [36, "synopsis"], [37, "synopsis"], [38, "synopsis"], [39, "synopsis"], [40, "synopsis"], [41, "synopsis"], [42, "synopsis"], [43, "synopsis"], [44, "synopsis"], [45, "synopsis"], [46, "synopsis"], [47, "synopsis"], [48, "synopsis"], [49, "synopsis"], [50, "synopsis"], [51, "synopsis"], [52, "synopsis"], [53, "synopsis"], [54, "synopsis"], [55, "synopsis"], [56, "synopsis"], [57, "synopsis"], [58, "synopsis"], [59, "synopsis"], [60, "synopsis"], [61, "synopsis"], [62, "synopsis"], [63, "synopsis"], [64, "synopsis"], [65, "synopsis"], [66, "synopsis"], [67, "synopsis"], [68, "synopsis"], [69, "synopsis"], [70, "synopsis"], [71, "synopsis"], [72, "synopsis"], [73, "synopsis"], [74, "synopsis"], [75, "synopsis"], [76, "synopsis"], [77, "synopsis"], [78, "synopsis"], [79, "synopsis"], [80, "synopsis"], [81, "synopsis"], [82, "synopsis"], [83, "synopsis"], [84, "synopsis"], [85, "synopsis"], [86, "synopsis"], [87, "synopsis"], [88, "synopsis"], [89, "synopsis"], [90, "synopsis"], [91, "synopsis"], [92, "synopsis"], [93, "synopsis"], [94, "synopsis"], [95, "synopsis"], [96, "synopsis"], [97, "synopsis"], [98, "synopsis"], [99, "synopsis"], [100, "synopsis"], [101, "synopsis"], [102, "synopsis"], [103, "synopsis"], [104, "synopsis"], [105, "synopsis"], [106, "synopsis"], [107, "synopsis"], [108, "synopsis"], [109, "synopsis"], [110, "synopsis"], [111, "synopsis"], [112, "synopsis"], [113, "synopsis"], [114, "synopsis"], [115, "synopsis"], [116, "synopsis"], [117, "synopsis"], [118, "synopsis"], [119, "synopsis"], [120, "synopsis"], [121, "synopsis"], [122, "synopsis"], [123, "synopsis"], [124, "synopsis"], [125, "synopsis"], [126, "synopsis"], [127, "synopsis"], [128, "synopsis"], [129, "synopsis"], [130, "synopsis"], [131, "synopsis"], [132, "synopsis"], [133, "synopsis"], [134, "synopsis"], [135, "synopsis"], [136, "synopsis"], [137, "synopsis"], [138, "synopsis"], [139, "synopsis"], [140, "synopsis"], [141, "synopsis"], [142, "synopsis"], [143, "synopsis"], [144, "synopsis"], [145, "synopsis"], [146, "synopsis"], [147, "synopsis"], [148, "synopsis"], [149, "synopsis"], [150, "synopsis"], [151, "synopsis"], [152, "synopsis"], [153, "synopsis"], [154, "synopsis"], [155, "synopsis"], [156, "synopsis"], [157, "synopsis"], [158, "synopsis"], [159, "synopsis"], [160, "synopsis"], [161, "synopsis"], [162, "synopsis"], [163, "synopsis"], [164, "synopsis"], [165, "synopsis"], [166, "synopsis"], [167, "synopsis"], [168, "synopsis"], [169, "synopsis"], [170, "synopsis"], [171, "synopsis"], [172, "synopsis"], [173, "synopsis"], [174, "synopsis"], [175, "synopsis"], [176, "synopsis"], [177, "synopsis"], [178, "synopsis"], [179, "synopsis"], [180, "synopsis"], [181, "synopsis"], [182, "synopsis"], [183, "synopsis"], [184, "synopsis"], [185, "synopsis"], [186, "synopsis"], [187, "synopsis"], [188, "synopsis"], [189, "synopsis"], [190, "synopsis"], [191, "synopsis"], [192, "synopsis"], [193, "synopsis"], [194, "synopsis"], [195, "synopsis"], [196, "synopsis"], [197, "synopsis"], [198, "synopsis"], [199, "synopsis"], [200, "synopsis"], [201, "synopsis"], [202, "synopsis"], [203, "synopsis"], [204, "synopsis"], [205, "synopsis"], [206, "synopsis"], [207, "synopsis"], [208, "synopsis"], [209, "synopsis"], [210, "synopsis"], [211, "synopsis"], [212, "synopsis"], [213, "synopsis"], [214, "synopsis"], [215, "synopsis"], [216, "synopsis"], [217, "synopsis"], [218, "synopsis"], [219, "synopsis"], [220, "synopsis"], [221, "synopsis"], [222, "synopsis"], [223, "synopsis"], [224, "synopsis"], [225, "synopsis"], [226, "synopsis"], [227, "synopsis"], [228, "synopsis"], [229, "synopsis"], [230, "synopsis"], [231, "synopsis"], [232, "synopsis"], [233, "synopsis"], [234, "synopsis"], [235, "synopsis"], [236, "synopsis"], [237, "synopsis"], [238, "synopsis"], [239, "synopsis"], [240, "synopsis"], [241, "synopsis"], [242, "synopsis"], [243, "synopsis"], [244, "synopsis"], [245, "synopsis"], [246, "synopsis"], [247, "synopsis"], [248, "synopsis"], [249, "synopsis"], [250, "synopsis"], [251, "synopsis"], [252, "synopsis"], [253, "synopsis"], [254, "synopsis"], [255, "synopsis"], [256, "synopsis"], [257, "synopsis"], [258, "synopsis"], [259, "synopsis"], [260, "synopsis"], [261, "synopsis"], [262, "synopsis"], [263, "synopsis"], [264, "synopsis"], [265, "synopsis"], [266, "synopsis"], [267, "synopsis"], [268, "synopsis"], [269, "synopsis"], [270, "synopsis"], [271, "synopsis"], [272, "synopsis"], [273, "synopsis"], [274, "synopsis"], [275, "synopsis"], [276, "synopsis"], [277, "synopsis"], [278, "synopsis"], [279, "synopsis"], [280, "synopsis"], [281, "synopsis"], [282, "synopsis"], [283, "synopsis"], [284, "synopsis"], [285, "synopsis"], [286, "synopsis"], [287, "synopsis"], [288, "synopsis"], [289, "synopsis"], [290, "synopsis"], [291, "synopsis"], [292, "synopsis"], [293, "synopsis"], [294, "synopsis"], [295, "synopsis"], [296, "synopsis"], [297, "synopsis"], [298, "synopsis"], [299, "synopsis"], [300, "synopsis"], [301, "synopsis"], [302, "synopsis"], [303, "synopsis"], [304, "synopsis"], [305, "synopsis"], [306, "synopsis"], [307, "synopsis"], [308, "synopsis"], [309, "synopsis"], [310, "synopsis"], [311, "synopsis"], [312, "synopsis"], [313, "synopsis"], [314, "synopsis"], [315, "synopsis"], [316, "synopsis"], [317, "synopsis"], [318, "synopsis"], [319, "synopsis"], [320, "synopsis"], [321, "synopsis"], [322, "synopsis"], [323, "synopsis"], [324, "synopsis"], [325, "synopsis"], [326, "synopsis"], [327, "synopsis"], [328, "synopsis"], [329, "synopsis"], [330, "synopsis"], [331, "synopsis"], [332, "synopsis"], [333, "synopsis"], [334, "synopsis"], [335, "synopsis"], [336, "synopsis"], [337, "synopsis"], [338, "synopsis"], [339, "synopsis"], [340, "synopsis"], [341, "synopsis"], [342, "synopsis"], [343, "synopsis"], [344, "synopsis"], [345, "synopsis"], [346, "synopsis"], [347, "synopsis"], [348, "synopsis"], [349, "synopsis"], [350, "synopsis"], [351, "synopsis"], [352, "synopsis"], [353, "synopsis"], [354, "synopsis"], [355, "synopsis"], [356, "synopsis"], [357, "synopsis"], [358, "synopsis"], [359, "synopsis"], [360, "synopsis"], [361, "synopsis"], [362, "synopsis"], [363, "synopsis"], [364, "synopsis"], [365, "synopsis"], [366, "synopsis"], [367, "synopsis"], [368, "synopsis"], [369, "synopsis"], [370, "synopsis"], [371, "synopsis"], [372, "synopsis"], [373, "synopsis"], [374, "synopsis"], [375, "synopsis"], [376, "synopsis"], [377, "synopsis"], [378, "synopsis"], [379, "synopsis"], [380, "synopsis"], [381, "synopsis"], [382, "synopsis"], [383, "synopsis"], [384, "synopsis"], [385, "synopsis"], [386, "synopsis"], [387, "synopsis"], [388, "synopsis"], [389, "synopsis"], [390, "synopsis"], [391, "synopsis"], [392, "synopsis"], [393, "synopsis"], [394, "synopsis"], [395, "synopsis"], [396, "synopsis"], [397, "synopsis"], [398, "synopsis"], [399, "synopsis"], [400, "synopsis"], [401, "synopsis"], [402, "synopsis"], [403, "synopsis"], [404, "synopsis"], [405, "synopsis"], [406, "synopsis"], [407, "synopsis"], [408, "synopsis"], [409, "synopsis"], [410, "synopsis"], [411, "synopsis"], [412, "synopsis"], [413, "synopsis"], [414, "synopsis"], [415, "synopsis"], [416, "synopsis"], [417, "synopsis"], [418, "synopsis"], [419, "synopsis"], [420, "synopsis"], [421, "synopsis"], [422, "synopsis"], [423, "synopsis"], [424, "synopsis"], [425, "synopsis"], [426, "synopsis"], [427, "synopsis"], [428, "synopsis"], [429, "synopsis"], [430, "synopsis"], [431, "synopsis"], [432, "synopsis"], [433, "synopsis"], [434, "synopsis"], [435, "synopsis"], [436, "synopsis"], [437, "synopsis"], [438, "synopsis"], [439, "synopsis"], [440, "synopsis"], [441, "synopsis"], [442, "synopsis"], [443, "synopsis"], [444, "synopsis"], [445, "synopsis"], [446, "synopsis"], [447, "synopsis"], [448, "synopsis"], [449, "synopsis"], [450, "synopsis"], [451, "synopsis"], [452, "synopsis"], [453, "synopsis"], [454, "synopsis"], [455, "synopsis"], [456, "synopsis"], [457, "synopsis"], [458, "synopsis"], [459, "synopsis"], [460, "synopsis"], [461, "synopsis"], [462, "synopsis"], [463, "synopsis"], [464, "synopsis"], [465, "synopsis"], [466, "synopsis"], [467, "synopsis"], [468, "synopsis"], [469, "synopsis"], [470, "synopsis"], [471, "synopsis"], [472, "synopsis"], [473, "synopsis"], [474, "synopsis"], [475, "synopsis"], [476, "synopsis"], [477, "synopsis"], [478, "synopsis"], [479, "synopsis"], [480, "synopsis"], [481, "synopsis"], [482, "synopsis"], [483, "synopsis"], [484, "synopsis"], [485, "synopsis"], [486, "synopsis"], [487, "synopsis"], [487, "id1"], [488, "synopsis"], [489, "synopsis"], [490, "synopsis"], [491, "synopsis"], [492, "synopsis"], [493, "synopsis"], [494, "synopsis"], [495, "synopsis"], [496, "synopsis"], [497, "synopsis"], [498, "synopsis"], [499, "synopsis"], [500, "synopsis"], [501, "synopsis"], [502, "synopsis"], [503, "synopsis"], [504, "synopsis"], [505, "synopsis"], [506, "synopsis"], [507, "synopsis"], [508, "synopsis"], [509, "synopsis"], [510, "synopsis"], [511, "synopsis"], [512, "synopsis"], [513, "synopsis"], [514, "synopsis"], [515, "synopsis"], [516, "synopsis"], [517, "synopsis"], [518, "synopsis"], [519, "synopsis"], [520, "synopsis"], [521, "synopsis"], [522, "synopsis"], [523, "synopsis"], [524, "synopsis"], [525, "synopsis"], [526, "synopsis"], [527, "synopsis"], [528, "synopsis"], [529, "synopsis"], [530, "synopsis"], [531, "synopsis"], [532, "synopsis"], [533, "synopsis"], [534, "synopsis"], [535, "synopsis"], [536, "synopsis"], [537, "synopsis"], [538, "synopsis"], [539, "synopsis"], [540, "synopsis"], [541, "synopsis"], [542, "synopsis"], [543, "synopsis"], [544, "synopsis"], [545, "synopsis"], [546, "synopsis"], [547, "synopsis"], [548, "synopsis"], [549, "synopsis"], [550, "synopsis"], [551, "synopsis"], [552, "synopsis"], [553, "synopsis"], [554, "synopsis"], [555, "synopsis"], [556, "synopsis"], [557, "synopsis"], [558, "synopsis"], [559, "synopsis"], [560, "synopsis"], [561, "synopsis"], [562, "synopsis"], [563, "synopsis"], [564, "synopsis"], [565, "synopsis"], [566, "synopsis"], [567, "synopsis"], [568, "synopsis"], [569, "synopsis"], [570, "synopsis"], [571, "synopsis"], [572, "synopsis"], [572, "id1"], [573, "synopsis"], [574, "synopsis"], [575, "synopsis"], [576, "synopsis"], [577, "synopsis"], [578, "synopsis"], [579, "synopsis"], [580, "synopsis"], [581, "synopsis"], [582, "synopsis"], [583, "synopsis"], [584, "synopsis"], [585, "synopsis"], [586, "synopsis"], [587, "synopsis"], [588, "synopsis"], [589, "synopsis"], [590, "synopsis"], [591, "synopsis"], [592, "synopsis"], [593, "synopsis"], [594, "synopsis"], [595, "synopsis"], [596, "synopsis"], [597, "synopsis"], [598, "synopsis"], [599, "synopsis"], [600, "synopsis"], [601, "synopsis"], [602, "synopsis"], [603, "synopsis"], [604, "synopsis"], [605, "synopsis"], [606, "synopsis"], [607, "synopsis"], [608, "synopsis"], [609, "synopsis"], [610, "synopsis"], [611, "synopsis"], [612, "synopsis"], [613, "synopsis"], [614, "synopsis"], [615, "synopsis"], [616, "synopsis"], [617, "synopsis"], [618, "synopsis"], [619, "synopsis"], [620, "synopsis"], [621, "synopsis"], [622, "synopsis"], [623, "synopsis"], [624, "synopsis"], [625, "synopsis"], [626, "synopsis"], [627, "synopsis"], [628, "synopsis"], [629, "synopsis"], [630, "synopsis"], [631, "synopsis"], [632, "synopsis"], [633, "synopsis"], [634, "synopsis"], [635, "synopsis"], [636, "synopsis"], [637, "synopsis"], [638, "synopsis"], [639, "synopsis"], [640, "synopsis"], [641, "synopsis"], [642, "synopsis"], [643, "synopsis"], [644, "synopsis"], [645, "synopsis"], [646, "synopsis"], [647, "synopsis"], [648, "synopsis"], [649, "synopsis"], [650, "synopsis"], [651, "synopsis"], [652, "synopsis"], [653, "synopsis"], [654, "synopsis"], [655, "synopsis"], [656, "synopsis"], [657, "synopsis"], [658, "synopsis"], [659, "synopsis"], [660, "synopsis"], [661, "synopsis"], [662, "synopsis"], [663, "synopsis"], [664, "synopsis"], [665, "synopsis"], [666, "synopsis"], [667, "synopsis"], [668, "synopsis"], [669, "synopsis"], [670, "synopsis"], [672, "synopsis"], [673, "synopsis"], [674, "synopsis"], [675, "synopsis"], [676, "synopsis"], [677, "synopsis"], [678, "synopsis"], [679, "synopsis"], [680, "synopsis"], [681, "synopsis"], [682, "synopsis"], [683, "synopsis"], [684, "synopsis"], [685, "synopsis"], [686, "synopsis"], [687, "synopsis"], [688, "synopsis"], [689, "synopsis"], [690, "synopsis"], [691, "synopsis"], [692, "synopsis"], [693, "synopsis"], [694, "synopsis"]], "Deprecated feature: automatic initialization and cleanup": [[19, "deprecated-feature-automatic-initialization-and-cleanup"]], "Installing the MongoDB C Driver (libmongoc) and BSON library (libbson)": [[20, "installing-the-mongodb-c-driver-libmongoc-and-bson-library-libbson"]], "Supported Platforms": [[20, "supported-platforms"]], "Install libmongoc with a Package Manager": [[20, "install-libmongoc-with-a-package-manager"]], "Install libbson with a Package Manager": [[20, "install-libbson-with-a-package-manager"]], "Build environment": [[20, "build-environment"]], "Build environment on Unix": [[20, "build-environment-on-unix"]], "Prerequisites for libmongoc": [[20, "prerequisites-for-libmongoc"]], "Prerequisites for libbson": [[20, "prerequisites-for-libbson"]], "Build environment on macOS": [[20, "build-environment-on-macos"]], "Build environment on Windows with Visual Studio": [[20, "build-environment-on-windows-with-visual-studio"]], "Build environment on Windows with MinGW-W64 and MSYS2": [[20, "build-environment-on-windows-with-mingw-w64-and-msys2"]], "Configuring the build": [[20, "configuring-the-build"]], "Preparing a build from a release tarball": [[20, "preparing-a-build-from-a-release-tarball"]], "Preparing a build from a git repository clone": [[20, "preparing-a-build-from-a-git-repository-clone"]], "Preparing a build on Windows with Visual Studio": [[20, "preparing-a-build-on-windows-with-visual-studio"]], "Executing a build": [[20, "executing-a-build"]], "Building on Unix, macOS, and Windows (MinGW-W64 and MSYS2)": [[20, "building-on-unix-macos-and-windows-mingw-w64-and-msys2"]], "Building on Windows with Visual Studio": [[20, "building-on-windows-with-visual-studio"]], "Generating the documentation": [[20, "generating-the-documentation"]], "Uninstalling the installed components": [[20, "uninstalling-the-installed-components"]], "Dealing with Build Failures": [[20, "dealing-with-build-failures"]], "Additional Options for Integrators": [[20, "additional-options-for-integrators"]], "Object Lifecycle": [[21, "object-lifecycle"]], "Clients and pools": [[21, "clients-and-pools"]], "Databases, collections, and related objects": [[21, "databases-collections-and-related-objects"]], "GridFS objects": [[21, "gridfs-objects"]], "GridFS bucket objects": [[21, "gridfs-bucket-objects"]], "Sessions": [[21, "sessions"]], "Client Side Encryption": [[21, "client-side-encryption"]], "Logging": [[22, "logging"]], "Macros": [[22, "macros"]], "Custom Log Handlers": [[22, "custom-log-handlers"]], "Disable logging": [[22, "disable-logging"]], "Tracing": [[22, "tracing"]], "Manage Collection Indexes": [[23, "manage-collection-indexes"]], "Common Tasks": [[24, "common-tasks"]], "\u201cexplain\u201d Command": [[24, "explain-command"]], "mongoc_apm_callbacks_destroy()": [[25, "mongoc-apm-callbacks-destroy"]], "mongoc_apm_callbacks_new()": [[26, "mongoc-apm-callbacks-new"]], "Returns": [[26, "returns"], [28, "returns"], [29, "returns"], [30, "returns"], [32, "returns"], [33, "returns"], [34, "returns"], [35, "returns"], [36, "returns"], [37, "returns"], [38, "returns"], [39, "returns"], [41, "returns"], [42, "returns"], [43, "returns"], [44, "returns"], [45, "returns"], [46, "returns"], [47, "returns"], [48, "returns"], [49, "returns"], [50, "returns"], [51, "returns"], [53, "returns"], [54, "returns"], [55, "returns"], [56, "returns"], [57, "returns"], [58, "returns"], [59, "returns"], [60, "returns"], [61, "returns"], [62, "returns"], [63, "returns"], [65, "returns"], [66, "returns"], [67, "returns"], [68, "returns"], [69, "returns"], [71, "returns"], [72, "returns"], [73, "returns"], [75, "returns"], [76, "returns"], [77, "returns"], [79, "returns"], [81, "returns"], [82, "returns"], [83, "returns"], [85, "returns"], [86, "returns"], [87, "returns"], [88, "returns"], [89, "returns"], [91, "returns"], [92, "returns"], [93, "returns"], [107, "returns"], [108, "returns"], [109, "returns"], [110, "returns"], [112, "returns"], [113, "returns"], [115, "returns"], [116, "returns"], [119, "returns"], [135, "returns"], [137, "returns"], [139, "returns"], [141, "returns"], [143, "returns"], [145, "returns"], [153, "returns"], [155, "returns"], [157, "returns"], [158, "returns"], [159, "returns"], [161, "returns"], [163, "returns"], [164, "returns"], [165, "returns"], [166, "returns"], [168, "returns"], [169, "returns"], [170, "returns"], [171, "returns"], [173, "returns"], [178, "returns"], [179, "returns"], [181, "returns"], [182, "returns"], [184, "returns"], [193, "returns"], [199, "returns"], [200, "returns"], [201, "returns"], [202, "returns"], [203, "returns"], [205, "returns"], [212, "returns"], [213, "returns"], [215, "returns"], [216, "returns"], [219, "returns"], [220, "returns"], [221, "returns"], [222, "returns"], [223, "returns"], [224, "returns"], [225, "returns"], [226, "returns"], [227, "returns"], [228, "returns"], [229, "returns"], [230, "returns"], [231, "returns"], [232, "returns"], [233, "returns"], [234, "returns"], [235, "returns"], [236, "returns"], [237, "returns"], [239, "returns"], [242, "returns"], [243, "returns"], [244, "returns"], [246, "returns"], [247, "returns"], [248, "returns"], [249, "returns"], [252, "returns"], [253, "returns"], [254, "returns"], [256, "returns"], [260, "returns"], [263, "returns"], [264, "returns"], [265, "returns"], [266, "returns"], [268, "returns"], [269, "returns"], [276, "returns"], [277, "returns"], [278, "returns"], [281, "returns"], [285, "returns"], [287, "returns"], [288, "returns"], [289, "returns"], [290, "returns"], [291, "returns"], [292, "returns"], [293, "returns"], [294, "returns"], [295, "returns"], [296, "returns"], [297, "returns"], [298, "returns"], [300, "returns"], [301, "returns"], [302, "returns"], [303, "returns"], [304, "returns"], [308, "returns"], [309, "returns"], [311, "returns"], [312, "returns"], [313, "returns"], [314, "returns"], [315, "returns"], [316, "returns"], [317, "returns"], [318, "returns"], [319, "returns"], [320, "returns"], [321, "returns"], [322, "returns"], [323, "returns"], [324, "returns"], [325, "returns"], [326, "returns"], [327, "returns"], [328, "returns"], [329, "returns"], [330, "returns"], [332, "returns"], [333, "returns"], [334, "returns"], [338, "returns"], [340, "returns"], [341, "returns"], [342, "returns"], [343, "returns"], [344, "returns"], [345, "returns"], [346, "returns"], [347, "returns"], [349, "returns"], [350, "returns"], [357, "returns"], [358, "returns"], [359, "returns"], [360, "returns"], [361, "returns"], [363, "returns"], [364, "returns"], [367, "returns"], [368, "returns"], [369, "returns"], [370, "returns"], [371, "returns"], [372, "returns"], [373, "returns"], [376, "returns"], [377, "returns"], [378, "returns"], [379, "returns"], [380, "returns"], [381, "returns"], [382, "returns"], [383, "returns"], [384, "returns"], [385, "returns"], [386, "returns"], [387, "returns"], [388, "returns"], [389, "returns"], [390, "returns"], [395, "returns"], [396, "returns"], [398, "returns"], [399, "returns"], [401, "returns"], [403, "returns"], [404, "returns"], [407, "returns"], [408, "returns"], [409, "returns"], [410, "returns"], [411, "returns"], [412, "returns"], [413, "returns"], [415, "returns"], [416, "returns"], [417, "returns"], [418, "returns"], [419, "returns"], [420, "returns"], [422, "returns"], [423, "returns"], [424, "returns"], [425, "returns"], [426, "returns"], [427, "returns"], [428, "returns"], [430, "returns"], [431, "returns"], [432, "returns"], [433, "returns"], [435, "returns"], [437, "returns"], [438, "returns"], [439, "returns"], [440, "returns"], [441, "returns"], [442, "returns"], [443, "returns"], [444, "returns"], [445, "returns"], [446, "returns"], [448, "returns"], [449, "returns"], [452, "returns"], [453, "returns"], [454, "returns"], [455, "returns"], [459, "returns"], [463, "returns"], [464, "returns"], [465, "returns"], [466, "returns"], [467, "returns"], [468, "returns"], [469, "returns"], [470, "returns"], [471, "returns"], [472, "returns"], [474, "returns"], [476, "returns"], [479, "returns"], [482, "returns"], [490, "returns"], [493, "returns"], [498, "returns"], [499, "returns"], [500, "returns"], [502, "returns"], [504, "returns"], [505, "returns"], [509, "returns"], [511, "returns"], [513, "returns"], [514, "returns"], [515, "returns"], [516, "returns"], [524, "returns"], [527, "returns"], [528, "returns"], [529, "returns"], [530, "returns"], [533, "returns"], [535, "returns"], [537, "returns"], [538, "returns"], [540, "returns"], [541, "returns"], [542, "returns"], [548, "returns"], [551, "returns"], [553, "returns"], [554, "returns"], [558, "returns"], [559, "returns"], [560, "returns"], [561, "returns"], [563, "returns"], [564, "returns"], [565, "returns"], [566, "returns"], [567, "returns"], [568, "returns"], [569, "returns"], [570, "returns"], [571, "returns"], [573, "returns"], [575, "returns"], [577, "returns"], [578, "returns"], [580, "returns"], [581, "returns"], [582, "returns"], [584, "returns"], [585, "returns"], [586, "returns"], [587, "returns"], [588, "returns"], [589, "returns"], [590, "returns"], [591, "returns"], [592, "returns"], [595, "returns"], [597, "returns"], [598, "returns"], [599, "returns"], [601, "returns"], [602, "returns"], [603, "returns"], [604, "returns"], [608, "returns"], [611, "returns"], [612, "returns"], [613, "returns"], [614, "returns"], [621, "returns"], [623, "returns"], [624, "returns"], [625, "returns"], [626, "returns"], [627, "returns"], [628, "returns"], [633, "returns"], [634, "returns"], [635, "returns"], [636, "returns"], [637, "returns"], [638, "returns"], [639, "returns"], [640, "returns"], [641, "returns"], [642, "returns"], [643, "returns"], [644, "returns"], [645, "returns"], [646, "returns"], [648, "returns"], [649, "returns"], [650, "returns"], [655, "returns"], [656, "returns"], [657, "returns"], [658, "returns"], [659, "returns"], [660, "returns"], [661, "returns"], [662, "returns"], [663, "returns"], [664, "returns"], [667, "returns"], [670, "returns"], [672, "returns"], [673, "returns"], [675, "returns"], [676, "returns"], [677, "returns"], [678, "returns"], [679, "returns"], [680, "returns"], [681, "returns"], [686, "returns"]], "mongoc_apm_callbacks_t": [[27, "mongoc-apm-callbacks-t"]], "mongoc_apm_command_failed_get_command_name()": [[28, "mongoc-apm-command-failed-get-command-name"]], "Parameters": [[28, "parameters"], [29, "parameters"], [30, "parameters"], [31, "parameters"], [32, "parameters"], [33, "parameters"], [34, "parameters"], [35, "parameters"], [36, "parameters"], [37, "parameters"], [38, "parameters"], [39, "parameters"], [41, "parameters"], [42, "parameters"], [43, "parameters"], [44, "parameters"], [45, "parameters"], [46, "parameters"], [47, "parameters"], [48, "parameters"], [49, "parameters"], [50, "parameters"], [51, "parameters"], [53, "parameters"], [54, "parameters"], [55, "parameters"], [56, "parameters"], [57, "parameters"], [58, "parameters"], [59, "parameters"], [60, "parameters"], [61, "parameters"], [62, "parameters"], [63, "parameters"], [65, "parameters"], [66, "parameters"], [67, "parameters"], [68, "parameters"], [69, "parameters"], [71, "parameters"], [72, "parameters"], [73, "parameters"], [75, "parameters"], [76, "parameters"], [77, "parameters"], [78, "parameters"], [79, "parameters"], [81, "parameters"], [82, "parameters"], [83, "parameters"], [85, "parameters"], [86, "parameters"], [87, "parameters"], [88, "parameters"], [89, "parameters"], [91, "parameters"], [92, "parameters"], [93, "parameters"], [95, "parameters"], [96, "parameters"], [97, "parameters"], [98, "parameters"], [99, "parameters"], [100, "parameters"], [101, "parameters"], [102, "parameters"], [103, "parameters"], [104, "parameters"], [105, "parameters"], [106, "parameters"], [107, "parameters"], [108, "parameters"], [109, "parameters"], [110, "parameters"], [112, "parameters"], [113, "parameters"], [115, "parameters"], [116, "parameters"], [118, "parameters"], [120, "parameters"], [121, "parameters"], [122, "parameters"], [123, "parameters"], [124, "parameters"], [125, "parameters"], [126, "parameters"], [127, "parameters"], [128, "parameters"], [129, "parameters"], [130, "parameters"], [132, "parameters"], [133, "parameters"], [134, "parameters"], [135, "parameters"], [136, "parameters"], [137, "parameters"], [138, "parameters"], [139, "parameters"], [140, "parameters"], [141, "parameters"], [142, "parameters"], [143, "parameters"], [144, "parameters"], [145, "parameters"], [146, "parameters"], [147, "parameters"], [148, "parameters"], [149, "parameters"], [150, "parameters"], [152, "parameters"], [153, "parameters"], [154, "parameters"], [155, "parameters"], [156, "parameters"], [157, "parameters"], [158, "parameters"], [159, "parameters"], [161, "parameters"], [163, "parameters"], [164, "parameters"], [165, "parameters"], [166, "parameters"], [167, "parameters"], [168, "parameters"], [169, "parameters"], [170, "parameters"], [171, "parameters"], [172, "parameters"], [174, "parameters"], [175, "parameters"], [176, "parameters"], [178, "parameters"], [179, "parameters"], [180, "parameters"], [181, "parameters"], [182, "parameters"], [183, "parameters"], [185, "parameters"], [186, "parameters"], [187, "parameters"], [188, "parameters"], [189, "parameters"], [190, "parameters"], [192, "parameters"], [194, "parameters"], [195, "parameters"], [196, "parameters"], [197, "parameters"], [199, "parameters"], [200, "parameters"], [201, "parameters"], [202, "parameters"], [203, "parameters"], [204, "parameters"], [206, "parameters"], [207, "parameters"], [208, "parameters"], [209, "parameters"], [210, "parameters"], [212, "parameters"], [213, "parameters"], [214, "parameters"], [215, "parameters"], [219, "parameters"], [220, "parameters"], [221, "parameters"], [222, "parameters"], [223, "parameters"], [224, "parameters"], [225, "parameters"], [226, "parameters"], [227, "parameters"], [228, "parameters"], [229, "parameters"], [230, "parameters"], [231, "parameters"], [232, "parameters"], [233, "parameters"], [234, "parameters"], [235, "parameters"], [236, "parameters"], [237, "parameters"], [238, "parameters"], [239, "parameters"], [240, "parameters"], [241, "parameters"], [242, "parameters"], [243, "parameters"], [244, "parameters"], [245, "parameters"], [246, "parameters"], [247, "parameters"], [248, "parameters"], [249, "parameters"], [250, "parameters"], [252, "parameters"], [253, "parameters"], [254, "parameters"], [255, "parameters"], [256, "parameters"], [257, "parameters"], [258, "parameters"], [259, "parameters"], [260, "parameters"], [261, "parameters"], [262, "parameters"], [263, "parameters"], [264, "parameters"], [265, "parameters"], [266, "parameters"], [267, "parameters"], [268, "parameters"], [269, "parameters"], [270, "parameters"], [271, "parameters"], [272, "parameters"], [274, "parameters"], [275, "parameters"], [276, "parameters"], [277, "parameters"], [278, "parameters"], [279, "parameters"], [280, "parameters"], [281, "parameters"], [282, "parameters"], [283, "parameters"], [284, "parameters"], [285, "parameters"], [287, "parameters"], [288, "parameters"], [289, "parameters"], [290, "parameters"], [291, "parameters"], [292, "parameters"], [293, "parameters"], [294, "parameters"], [295, "parameters"], [296, "parameters"], [297, "parameters"], [298, "parameters"], [299, "parameters"], [300, "parameters"], [301, "parameters"], [302, "parameters"], [303, "parameters"], [304, "parameters"], [305, "parameters"], [306, "parameters"], [307, "parameters"], [308, "parameters"], [309, "parameters"], [310, "parameters"], [311, "parameters"], [312, "parameters"], [313, "parameters"], [314, "parameters"], [315, "parameters"], [316, "parameters"], [317, "parameters"], [318, "parameters"], [319, "parameters"], [320, "parameters"], [321, "parameters"], [322, "parameters"], [323, "parameters"], [324, "parameters"], [325, "parameters"], [326, "parameters"], [327, "parameters"], [328, "parameters"], [329, "parameters"], [330, "parameters"], [331, "parameters"], [332, "parameters"], [333, "parameters"], [334, "parameters"], [335, "parameters"], [336, "parameters"], [337, "parameters"], [338, "parameters"], [340, "parameters"], [341, "parameters"], [342, "parameters"], [343, "parameters"], [344, "parameters"], [345, "parameters"], [346, "parameters"], [347, "parameters"], [348, "parameters"], [349, "parameters"], [350, "parameters"], [351, "parameters"], [352, "parameters"], [353, "parameters"], [354, "parameters"], [355, "parameters"], [356, "parameters"], [357, "parameters"], [358, "parameters"], [359, "parameters"], [360, "parameters"], [361, "parameters"], [362, "parameters"], [363, "parameters"], [364, "parameters"], [365, "parameters"], [367, "parameters"], [368, "parameters"], [369, "parameters"], [370, "parameters"], [371, "parameters"], [372, "parameters"], [373, "parameters"], [374, "parameters"], [375, "parameters"], [376, "parameters"], [377, "parameters"], [378, "parameters"], [380, "parameters"], [381, "parameters"], [382, "parameters"], [383, "parameters"], [384, "parameters"], [385, "parameters"], [386, "parameters"], [387, "parameters"], [388, "parameters"], [389, "parameters"], [390, "parameters"], [391, "parameters"], [392, "parameters"], [393, "parameters"], [395, "parameters"], [396, "parameters"], [398, "parameters"], [399, "parameters"], [400, "parameters"], [401, "parameters"], [402, "parameters"], [403, "parameters"], [404, "parameters"], [405, "parameters"], [406, "parameters"], [408, "parameters"], [409, "parameters"], [410, "parameters"], [411, "parameters"], [412, "parameters"], [413, "parameters"], [419, "parameters"], [420, "parameters"], [421, "parameters"], [422, "parameters"], [423, "parameters"], [424, "parameters"], [425, "parameters"], [426, "parameters"], [427, "parameters"], [428, "parameters"], [430, "parameters"], [431, "parameters"], [432, "parameters"], [433, "parameters"], [434, "parameters"], [435, "parameters"], [436, "parameters"], [437, "parameters"], [438, "parameters"], [439, "parameters"], [440, "parameters"], [441, "parameters"], [442, "parameters"], [443, "parameters"], [444, "parameters"], [445, "parameters"], [446, "parameters"], [447, "parameters"], [448, "parameters"], [449, "parameters"], [452, "parameters"], [453, "parameters"], [454, "parameters"], [455, "parameters"], [456, "parameters"], [457, "parameters"], [458, "parameters"], [459, "parameters"], [460, "parameters"], [461, "parameters"], [463, "parameters"], [464, "parameters"], [465, "parameters"], [466, "parameters"], [467, "parameters"], [468, "parameters"], [469, "parameters"], [470, "parameters"], [471, "parameters"], [472, "parameters"], [474, "parameters"], [477, "parameters"], [480, "parameters"], [483, "parameters"], [488, "parameters"], [489, "parameters"], [490, "parameters"], [491, "parameters"], [493, "parameters"], [496, "parameters"], [497, "parameters"], [499, "parameters"], [500, "parameters"], [501, "parameters"], [502, "parameters"], [503, "parameters"], [505, "parameters"], [508, "parameters"], [509, "parameters"], [510, "parameters"], [511, "parameters"], [512, "parameters"], [513, "parameters"], [514, "parameters"], [515, "parameters"], [516, "parameters"], [517, "parameters"], [518, "parameters"], [519, "parameters"], [520, "parameters"], [524, "parameters"], [525, "parameters"], [527, "parameters"], [528, "parameters"], [529, "parameters"], [531, "parameters"], [533, "parameters"], [535, "parameters"], [536, "parameters"], [537, "parameters"], [538, "parameters"], [539, "parameters"], [540, "parameters"], [541, "parameters"], [542, "parameters"], [543, "parameters"], [545, "parameters"], [546, "parameters"], [548, "parameters"], [549, "parameters"], [550, "parameters"], [551, "parameters"], [552, "parameters"], [553, "parameters"], [555, "parameters"], [556, "parameters"], [557, "parameters"], [558, "parameters"], [559, "parameters"], [560, "parameters"], [561, "parameters"], [562, "parameters"], [563, "parameters"], [564, "parameters"], [565, "parameters"], [566, "parameters"], [567, "parameters"], [568, "parameters"], [569, "parameters"], [570, "parameters"], [571, "parameters"], [575, "parameters"], [577, "parameters"], [578, "parameters"], [579, "parameters"], [580, "parameters"], [581, "parameters"], [582, "parameters"], [584, "parameters"], [585, "parameters"], [586, "parameters"], [587, "parameters"], [588, "parameters"], [589, "parameters"], [590, "parameters"], [591, "parameters"], [592, "parameters"], [595, "parameters"], [597, "parameters"], [598, "parameters"], [599, "parameters"], [600, "parameters"], [601, "parameters"], [602, "parameters"], [603, "parameters"], [604, "parameters"], [606, "parameters"], [608, "parameters"], [609, "parameters"], [610, "parameters"], [611, "parameters"], [612, "parameters"], [613, "parameters"], [615, "parameters"], [616, "parameters"], [617, "parameters"], [618, "parameters"], [621, "parameters"], [622, "parameters"], [623, "parameters"], [624, "parameters"], [625, "parameters"], [626, "parameters"], [627, "parameters"], [628, "parameters"], [629, "parameters"], [630, "parameters"], [631, "parameters"], [632, "parameters"], [633, "parameters"], [634, "parameters"], [635, "parameters"], [636, "parameters"], [637, "parameters"], [638, "parameters"], [639, "parameters"], [640, "parameters"], [641, "parameters"], [642, "parameters"], [643, "parameters"], [644, "parameters"], [645, "parameters"], [646, "parameters"], [647, "parameters"], [648, "parameters"], [649, "parameters"], [650, "parameters"], [651, "parameters"], [652, "parameters"], [653, "parameters"], [654, "parameters"], [655, "parameters"], [656, "parameters"], [657, "parameters"], [658, "parameters"], [659, "parameters"], [660, "parameters"], [661, "parameters"], [662, "parameters"], [663, "parameters"], [664, "parameters"], [665, "parameters"], [666, "parameters"], [667, "parameters"], [668, "parameters"], [670, "parameters"], [672, "parameters"], [673, "parameters"], [674, "parameters"], [675, "parameters"], [676, "parameters"], [677, "parameters"], [678, "parameters"], [679, "parameters"], [680, "parameters"], [681, "parameters"], [682, "parameters"], [683, "parameters"], [684, "parameters"], [685, "parameters"], [687, "parameters"], [688, "parameters"], [689, "parameters"], [690, "parameters"], [691, "parameters"], [692, "parameters"], [693, "parameters"]], "mongoc_apm_command_failed_get_context()": [[29, "mongoc-apm-command-failed-get-context"]], "mongoc_apm_command_failed_get_duration()": [[30, "mongoc-apm-command-failed-get-duration"]], "mongoc_apm_command_failed_get_error()": [[31, "mongoc-apm-command-failed-get-error"]], "mongoc_apm_command_failed_get_host()": [[32, "mongoc-apm-command-failed-get-host"]], "mongoc_apm_command_failed_get_operation_id()": [[33, "mongoc-apm-command-failed-get-operation-id"]], "mongoc_apm_command_failed_get_reply()": [[34, "mongoc-apm-command-failed-get-reply"]], "mongoc_apm_command_failed_get_request_id()": [[35, "mongoc-apm-command-failed-get-request-id"]], "mongoc_apm_command_failed_get_server_connection_id()": [[36, "mongoc-apm-command-failed-get-server-connection-id"]], "mongoc_apm_command_failed_get_server_connection_id_int64()": [[37, "mongoc-apm-command-failed-get-server-connection-id-int64"]], "mongoc_apm_command_failed_get_server_id()": [[38, "mongoc-apm-command-failed-get-server-id"]], "mongoc_apm_command_failed_get_service_id()": [[39, "mongoc-apm-command-failed-get-service-id"]], "mongoc_apm_command_failed_t": [[40, "mongoc-apm-command-failed-t"]], "mongoc_apm_command_started_get_command()": [[41, "mongoc-apm-command-started-get-command"]], "mongoc_apm_command_started_get_command_name()": [[42, "mongoc-apm-command-started-get-command-name"]], "mongoc_apm_command_started_get_context()": [[43, "mongoc-apm-command-started-get-context"]], "mongoc_apm_command_started_get_database_name()": [[44, "mongoc-apm-command-started-get-database-name"]], "mongoc_apm_command_started_get_host()": [[45, "mongoc-apm-command-started-get-host"]], "mongoc_apm_command_started_get_operation_id()": [[46, "mongoc-apm-command-started-get-operation-id"]], "mongoc_apm_command_started_get_request_id()": [[47, "mongoc-apm-command-started-get-request-id"]], "mongoc_apm_command_started_get_server_connection_id()": [[48, "mongoc-apm-command-started-get-server-connection-id"]], "mongoc_apm_command_started_get_server_connection_id_int64()": [[49, "mongoc-apm-command-started-get-server-connection-id-int64"]], "mongoc_apm_command_started_get_server_id()": [[50, "mongoc-apm-command-started-get-server-id"]], "mongoc_apm_command_started_get_service_id()": [[51, "mongoc-apm-command-started-get-service-id"]], "mongoc_apm_command_started_t": [[52, "mongoc-apm-command-started-t"]], "mongoc_apm_command_succeeded_get_command_name()": [[53, "mongoc-apm-command-succeeded-get-command-name"]], "mongoc_apm_command_succeeded_get_context()": [[54, "mongoc-apm-command-succeeded-get-context"]], "mongoc_apm_command_succeeded_get_duration()": [[55, "mongoc-apm-command-succeeded-get-duration"]], "mongoc_apm_command_succeeded_get_host()": [[56, "mongoc-apm-command-succeeded-get-host"]], "mongoc_apm_command_succeeded_get_operation_id()": [[57, "mongoc-apm-command-succeeded-get-operation-id"]], "mongoc_apm_command_succeeded_get_reply()": [[58, "mongoc-apm-command-succeeded-get-reply"]], "mongoc_apm_command_succeeded_get_request_id()": [[59, "mongoc-apm-command-succeeded-get-request-id"]], "mongoc_apm_command_succeeded_get_server_connection_id()": [[60, "mongoc-apm-command-succeeded-get-server-connection-id"]], "mongoc_apm_command_succeeded_get_server_connection_id_int64()": [[61, "mongoc-apm-command-succeeded-get-server-connection-id-int64"]], "mongoc_apm_command_succeeded_get_server_id()": [[62, "mongoc-apm-command-succeeded-get-server-id"]], "mongoc_apm_command_succeeded_get_service_id()": [[63, "mongoc-apm-command-succeeded-get-service-id"]], "mongoc_apm_command_succeeded_t": [[64, "mongoc-apm-command-succeeded-t"]], "mongoc_apm_server_changed_get_context()": [[65, "mongoc-apm-server-changed-get-context"]], "mongoc_apm_server_changed_get_host()": [[66, "mongoc-apm-server-changed-get-host"]], "mongoc_apm_server_changed_get_new_description()": [[67, "mongoc-apm-server-changed-get-new-description"]], "mongoc_apm_server_changed_get_previous_description()": [[68, "mongoc-apm-server-changed-get-previous-description"]], "mongoc_apm_server_changed_get_topology_id()": [[69, "mongoc-apm-server-changed-get-topology-id"]], "mongoc_apm_server_changed_t": [[70, "mongoc-apm-server-changed-t"]], "mongoc_apm_server_closed_get_context()": [[71, "mongoc-apm-server-closed-get-context"]], "mongoc_apm_server_closed_get_host()": [[72, "mongoc-apm-server-closed-get-host"]], "mongoc_apm_server_closed_get_topology_id()": [[73, "mongoc-apm-server-closed-get-topology-id"]], "mongoc_apm_server_closed_t": [[74, "mongoc-apm-server-closed-t"]], "mongoc_apm_server_heartbeat_failed_get_awaited()": [[75, "mongoc-apm-server-heartbeat-failed-get-awaited"]], "mongoc_apm_server_heartbeat_failed_get_context()": [[76, "mongoc-apm-server-heartbeat-failed-get-context"]], "mongoc_apm_server_heartbeat_failed_get_duration()": [[77, "mongoc-apm-server-heartbeat-failed-get-duration"]], "mongoc_apm_server_heartbeat_failed_get_error()": [[78, "mongoc-apm-server-heartbeat-failed-get-error"]], "mongoc_apm_server_heartbeat_failed_get_host()": [[79, "mongoc-apm-server-heartbeat-failed-get-host"]], "mongoc_apm_server_heartbeat_failed_t": [[80, "mongoc-apm-server-heartbeat-failed-t"]], "mongoc_apm_server_heartbeat_started_get_awaited()": [[81, "mongoc-apm-server-heartbeat-started-get-awaited"]], "mongoc_apm_server_heartbeat_started_get_context()": [[82, "mongoc-apm-server-heartbeat-started-get-context"]], "mongoc_apm_server_heartbeat_started_get_host()": [[83, "mongoc-apm-server-heartbeat-started-get-host"]], "mongoc_apm_server_heartbeat_started_t": [[84, "mongoc-apm-server-heartbeat-started-t"]], "mongoc_apm_server_heartbeat_succeeded_get_awaited()": [[85, "mongoc-apm-server-heartbeat-succeeded-get-awaited"]], "mongoc_apm_server_heartbeat_succeeded_get_context()": [[86, "mongoc-apm-server-heartbeat-succeeded-get-context"]], "mongoc_apm_server_heartbeat_succeeded_get_duration()": [[87, "mongoc-apm-server-heartbeat-succeeded-get-duration"]], "mongoc_apm_server_heartbeat_succeeded_get_host()": [[88, "mongoc-apm-server-heartbeat-succeeded-get-host"]], "mongoc_apm_server_heartbeat_succeeded_get_reply()": [[89, "mongoc-apm-server-heartbeat-succeeded-get-reply"]], "mongoc_apm_server_heartbeat_succeeded_t": [[90, "mongoc-apm-server-heartbeat-succeeded-t"]], "mongoc_apm_server_opening_get_context()": [[91, "mongoc-apm-server-opening-get-context"]], "mongoc_apm_server_opening_get_host()": [[92, "mongoc-apm-server-opening-get-host"]], "mongoc_apm_server_opening_get_topology_id()": [[93, "mongoc-apm-server-opening-get-topology-id"]], "mongoc_apm_server_opening_t": [[94, "mongoc-apm-server-opening-t"]], "mongoc_apm_set_command_failed_cb()": [[95, "mongoc-apm-set-command-failed-cb"]], "mongoc_apm_set_command_started_cb()": [[96, "mongoc-apm-set-command-started-cb"]], "mongoc_apm_set_command_succeeded_cb()": [[97, "mongoc-apm-set-command-succeeded-cb"]], "mongoc_apm_set_server_changed_cb()": [[98, "mongoc-apm-set-server-changed-cb"]], "mongoc_apm_set_server_closed_cb()": [[99, "mongoc-apm-set-server-closed-cb"]], "mongoc_apm_set_server_heartbeat_failed_cb()": [[100, "mongoc-apm-set-server-heartbeat-failed-cb"]], "mongoc_apm_set_server_heartbeat_started_cb()": [[101, "mongoc-apm-set-server-heartbeat-started-cb"]], "mongoc_apm_set_server_heartbeat_succeeded_cb()": [[102, "mongoc-apm-set-server-heartbeat-succeeded-cb"]], "mongoc_apm_set_server_opening_cb()": [[103, "mongoc-apm-set-server-opening-cb"]], "mongoc_apm_set_topology_changed_cb()": [[104, "mongoc-apm-set-topology-changed-cb"]], "mongoc_apm_set_topology_closed_cb()": [[105, "mongoc-apm-set-topology-closed-cb"]], "mongoc_apm_set_topology_opening_cb()": [[106, "mongoc-apm-set-topology-opening-cb"]], "mongoc_apm_topology_changed_get_context()": [[107, "mongoc-apm-topology-changed-get-context"]], "mongoc_apm_topology_changed_get_new_description()": [[108, "mongoc-apm-topology-changed-get-new-description"]], "mongoc_apm_topology_changed_get_previous_description()": [[109, "mongoc-apm-topology-changed-get-previous-description"]], "mongoc_apm_topology_changed_get_topology_id()": [[110, "mongoc-apm-topology-changed-get-topology-id"]], "mongoc_apm_topology_changed_t": [[111, "mongoc-apm-topology-changed-t"]], "mongoc_apm_topology_closed_get_context()": [[112, "mongoc-apm-topology-closed-get-context"]], "mongoc_apm_topology_closed_get_topology_id()": [[113, "mongoc-apm-topology-closed-get-topology-id"]], "mongoc_apm_topology_closed_t": [[114, "mongoc-apm-topology-closed-t"]], "mongoc_apm_topology_opening_get_context()": [[115, "mongoc-apm-topology-opening-get-context"]], "mongoc_apm_topology_opening_get_topology_id()": [[116, "mongoc-apm-topology-opening-get-topology-id"]], "mongoc_apm_topology_opening_t": [[117, "mongoc-apm-topology-opening-t"]], "mongoc_auto_encryption_opts_destroy()": [[118, "mongoc-auto-encryption-opts-destroy"]], "mongoc_auto_encryption_opts_new()": [[119, "mongoc-auto-encryption-opts-new"]], "mongoc_auto_encryption_opts_set_bypass_auto_encryption()": [[120, "mongoc-auto-encryption-opts-set-bypass-auto-encryption"]], "mongoc_auto_encryption_opts_set_bypass_query_analysis()": [[121, "mongoc-auto-encryption-opts-set-bypass-query-analysis"]], "mongoc_auto_encryption_opts_set_encrypted_fields_map()": [[122, "mongoc-auto-encryption-opts-set-encrypted-fields-map"]], "mongoc_auto_encryption_opts_set_extra()": [[123, "mongoc-auto-encryption-opts-set-extra"]], "mongoc_auto_encryption_opts_set_keyvault_client()": [[124, "mongoc-auto-encryption-opts-set-keyvault-client"]], "mongoc_auto_encryption_opts_set_keyvault_client_pool()": [[125, "mongoc-auto-encryption-opts-set-keyvault-client-pool"]], "mongoc_auto_encryption_opts_set_keyvault_namespace()": [[126, "mongoc-auto-encryption-opts-set-keyvault-namespace"]], "mongoc_auto_encryption_opts_set_kms_credential_provider_callback()": [[127, "mongoc-auto-encryption-opts-set-kms-credential-provider-callback"]], "mongoc_auto_encryption_opts_set_kms_providers()": [[128, "mongoc-auto-encryption-opts-set-kms-providers"]], "mongoc_auto_encryption_opts_set_schema_map()": [[129, "mongoc-auto-encryption-opts-set-schema-map"]], "mongoc_auto_encryption_opts_set_tls_opts()": [[130, "mongoc-auto-encryption-opts-set-tls-opts"]], "mongoc_auto_encryption_opts_t": [[131, "mongoc-auto-encryption-opts-t"]], "mongoc_bulk_operation_delete()": [[132, "mongoc-bulk-operation-delete"]], "Errors": [[132, "errors"], [133, "errors"], [135, "errors"], [138, "errors"], [139, "errors"], [140, "errors"], [141, "errors"], [142, "errors"], [143, "errors"], [144, "errors"], [145, "errors"], [152, "errors"], [153, "errors"], [155, "errors"], [164, "errors"], [166, "errors"], [219, "errors"], [223, "errors"], [224, "errors"], [226, "errors"], [232, "errors"], [253, "errors"], [254, "errors"], [285, "errors"], [288, "errors"], [291, "errors"], [292, "errors"], [294, "errors"], [295, "errors"], [296, "errors"], [297, "errors"], [298, "errors"], [300, "errors"], [301, "errors"], [302, "errors"], [303, "errors"], [304, "errors"], [308, "errors"], [309, "errors"], [310, "errors"], [311, "errors"], [313, "errors"], [314, "errors"], [315, "errors"], [316, "errors"], [323, "errors"], [324, "errors"], [325, "errors"], [326, "errors"], [328, "errors"], [329, "errors"], [330, "errors"], [332, "errors"], [333, "errors"], [334, "errors"], [338, "errors"], [340, "errors"], [341, "errors"], [342, "errors"], [343, "errors"], [345, "errors"], [349, "errors"], [350, "errors"], [367, "errors"], [370, "errors"], [371, "errors"], [373, "errors"], [376, "errors"], [377, "errors"], [378, "errors"], [380, "errors"], [381, "errors"], [386, "errors"], [387, "errors"], [388, "errors"], [389, "errors"], [390, "errors"], [396, "errors"], [435, "errors"], [437, "errors"], [448, "errors"], [453, "errors"], [455, "errors"], [466, "errors"], [467, "errors"], [468, "errors"], [472, "errors"]], "mongoc_bulk_operation_delete_one()": [[133, "mongoc-bulk-operation-delete-one"]], "mongoc_bulk_operation_destroy()": [[134, "mongoc-bulk-operation-destroy"]], "mongoc_bulk_operation_execute()": [[135, "mongoc-bulk-operation-execute"]], "mongoc_bulk_operation_get_hint()": [[136, "mongoc-bulk-operation-get-hint"]], "mongoc_bulk_operation_get_write_concern()": [[137, "mongoc-bulk-operation-get-write-concern"]], "mongoc_bulk_operation_insert()": [[138, "mongoc-bulk-operation-insert"]], "mongoc_bulk_operation_insert_with_opts()": [[139, "mongoc-bulk-operation-insert-with-opts"]], "mongoc_bulk_operation_remove()": [[140, "mongoc-bulk-operation-remove"]], "mongoc_bulk_operation_remove_many_with_opts()": [[141, "mongoc-bulk-operation-remove-many-with-opts"]], "mongoc_bulk_operation_remove_one()": [[142, "mongoc-bulk-operation-remove-one"]], "mongoc_bulk_operation_remove_one_with_opts()": [[143, "mongoc-bulk-operation-remove-one-with-opts"]], "mongoc_bulk_operation_replace_one()": [[144, "mongoc-bulk-operation-replace-one"]], "mongoc_bulk_operation_replace_one_with_opts()": [[145, "mongoc-bulk-operation-replace-one-with-opts"]], "mongoc_bulk_operation_set_bypass_document_validation()": [[146, "mongoc-bulk-operation-set-bypass-document-validation"]], "mongoc_bulk_operation_set_client_session()": [[147, "mongoc-bulk-operation-set-client-session"]], "mongoc_bulk_operation_set_comment()": [[148, "mongoc-bulk-operation-set-comment"]], "mongoc_bulk_operation_set_hint()": [[149, "mongoc-bulk-operation-set-hint"]], "mongoc_bulk_operation_set_let()": [[150, "mongoc-bulk-operation-set-let"]], "mongoc_bulk_operation_t": [[151, "mongoc-bulk-operation-t"]], "mongoc_bulk_operation_update()": [[152, "mongoc-bulk-operation-update"]], "mongoc_bulk_operation_update_many_with_opts()": [[153, "mongoc-bulk-operation-update-many-with-opts"]], "mongoc_bulk_operation_update_one()": [[154, "mongoc-bulk-operation-update-one"]], "mongoc_bulk_operation_update_one_with_opts()": [[155, "mongoc-bulk-operation-update-one-with-opts"]], "mongoc_change_stream_destroy()": [[156, "mongoc-change-stream-destroy"]], "mongoc_change_stream_error_document()": [[157, "mongoc-change-stream-error-document"]], "mongoc_change_stream_get_resume_token()": [[158, "mongoc-change-stream-get-resume-token"]], "Lifecycle": [[158, "lifecycle"], [159, "lifecycle"], [218, "lifecycle"], [361, "lifecycle"], [429, "lifecycle"], [473, "lifecycle"], [544, "lifecycle"]], "mongoc_change_stream_next()": [[159, "mongoc-change-stream-next"]], "mongoc_change_stream_t": [[160, "mongoc-change-stream-t"]], "Example": [[160, "example"], [166, "example"], [225, "example"], [251, "example"], [253, "example"], [254, "example"], [260, "example"], [272, "example"], [273, "example"], [274, "example"], [286, "example"], [288, "example"], [289, "example"], [291, "example"], [292, "example"], [294, "example"], [295, "example"], [311, "example"], [312, "example"], [313, "example"], [314, "example"], [328, "example"], [329, "example"], [342, "example"], [345, "example"], [350, "example"], [366, "example"], [368, "example"], [371, "example"], [387, "example"], [388, "example"], [396, "example"], [414, "example"], [429, "example"], [450, "example"], [473, "example"], [481, "example"], [499, "example"], [549, "example"], [555, "example"], [557, "example"], [607, "example"], [625, "example"], [628, "example"], [657, "example"], [659, "example"], [672, "example"]], "Starting and Resuming": [[160, "starting-and-resuming"]], "mongoc_check_version()": [[161, "mongoc-check-version"]], "mongoc_cleanup()": [[162, "mongoc-cleanup"]], "mongoc_client_command()": [[163, "mongoc-client-command"]], "mongoc_client_command_simple()": [[164, "mongoc-client-command-simple"]], "mongoc_client_command_simple_with_server_id()": [[165, "mongoc-client-command-simple-with-server-id"]], "mongoc_client_command_with_opts()": [[166, "mongoc-client-command-with-opts"]], "mongoc_client_destroy()": [[167, "mongoc-client-destroy"]], "mongoc_client_enable_auto_encryption()": [[168, "mongoc-client-enable-auto-encryption"]], "mongoc_client_encryption_add_key_alt_name()": [[169, "mongoc-client-encryption-add-key-alt-name"]], "mongoc_client_encryption_create_datakey()": [[170, "mongoc-client-encryption-create-datakey"]], "mongoc_client_encryption_create_encrypted_collection()": [[171, "mongoc-client-encryption-create-encrypted-collection"]], "Creation Options": [[171, "creation-options"]], "mongoc_client_encryption_datakey_opts_destroy()": [[172, "mongoc-client-encryption-datakey-opts-destroy"]], "mongoc_client_encryption_datakey_opts_new()": [[173, "mongoc-client-encryption-datakey-opts-new"]], "mongoc_client_encryption_datakey_opts_set_keyaltnames()": [[174, "mongoc-client-encryption-datakey-opts-set-keyaltnames"]], "mongoc_client_encryption_datakey_opts_set_keymaterial()": [[175, "mongoc-client-encryption-datakey-opts-set-keymaterial"]], "mongoc_client_encryption_datakey_opts_set_masterkey()": [[176, "mongoc-client-encryption-datakey-opts-set-masterkey"]], "mongoc_client_encryption_datakey_opts_t": [[177, "mongoc-client-encryption-datakey-opts-t"]], "mongoc_client_decryption_decrypt()": [[178, "mongoc-client-decryption-decrypt"]], "mongoc_client_encryption_delete_key()": [[179, "mongoc-client-encryption-delete-key"]], "mongoc_client_encryption_destroy()": [[180, "mongoc-client-encryption-destroy"]], "mongoc_client_encryption_encrypt()": [[181, "mongoc-client-encryption-encrypt"]], "mongoc_client_encryption_encrypt_expression()": [[182, "mongoc-client-encryption-encrypt-expression"]], "mongoc_client_encryption_encrypt_opts_destroy()": [[183, "mongoc-client-encryption-encrypt-opts-destroy"]], "mongoc_client_encryption_encrypt_opts_new()": [[184, "mongoc-client-encryption-encrypt-opts-new"]], "mongoc_client_encryption_encrypt_opts_set_algorithm()": [[185, "mongoc-client-encryption-encrypt-opts-set-algorithm"]], "mongoc_client_encryption_encrypt_opts_set_contention_factor()": [[186, "mongoc-client-encryption-encrypt-opts-set-contention-factor"]], "mongoc_client_encryption_encrypt_opts_set_keyaltname()": [[187, "mongoc-client-encryption-encrypt-opts-set-keyaltname"]], "mongoc_client_encryption_encrypt_opts_set_keyid()": [[188, "mongoc-client-encryption-encrypt-opts-set-keyid"]], "mongoc_client_encryption_encrypt_opts_set_query_type()": [[189, "mongoc-client-encryption-encrypt-opts-set-query-type"]], "mongoc_client_encryption_encrypt_opts_set_range_opts()": [[190, "mongoc-client-encryption-encrypt-opts-set-range-opts"]], "mongoc_client_encryption_encrypt_opts_t": [[191, "mongoc-client-encryption-encrypt-opts-t"]], "mongoc_client_encryption_encrypt_range_opts_destroy()": [[192, "mongoc-client-encryption-encrypt-range-opts-destroy"]], "mongoc_client_encryption_encrypt_range_opts_new()": [[193, "mongoc-client-encryption-encrypt-range-opts-new"]], "mongoc_client_encryption_encrypt_range_opts_set_max()": [[194, "mongoc-client-encryption-encrypt-range-opts-set-max"]], "mongoc_client_encryption_encrypt_range_opts_set_min()": [[195, "mongoc-client-encryption-encrypt-range-opts-set-min"]], "mongoc_client_encryption_encrypt_range_opts_set_precision()": [[196, "mongoc-client-encryption-encrypt-range-opts-set-precision"]], "mongoc_client_encryption_encrypt_range_opts_set_sparsity()": [[197, "mongoc-client-encryption-encrypt-range-opts-set-sparsity"]], "mongoc_client_encryption_encrypt_range_opts_t": [[198, "mongoc-client-encryption-encrypt-range-opts-t"]], "mongoc_client_encryption_get_crypt_shared_version()": [[199, "mongoc-client-encryption-get-crypt-shared-version"]], "mongoc_client_encryption_get_key()": [[200, "mongoc-client-encryption-get-key"]], "mongoc_client_encryption_get_key_by_alt_name()": [[201, "mongoc-client-encryption-get-key-by-alt-name"]], "mongoc_client_encryption_get_keys()": [[202, "mongoc-client-encryption-get-keys"]], "mongoc_client_encryption_new()": [[203, "mongoc-client-encryption-new"]], "mongoc_client_encryption_opts_destroy()": [[204, "mongoc-client-encryption-opts-destroy"]], "mongoc_client_encryption_opts_new()": [[205, "mongoc-client-encryption-opts-new"]], "mongoc_client_encryption_opts_set_keyvault_client()": [[206, "mongoc-client-encryption-opts-set-keyvault-client"]], "mongoc_client_encryption_opts_set_keyvault_namespace()": [[207, "mongoc-client-encryption-opts-set-keyvault-namespace"]], "mongoc_client_encryption_opts_set_kms_credential_provider_callback ()": [[208, "mongoc-client-encryption-opts-set-kms-credential-provider-callback"]], "mongoc_client_encryption_opts_set_kms_providers()": [[209, "mongoc-client-encryption-opts-set-kms-providers"]], "mongoc_client_encryption_opts_set_tls_opts()": [[210, "mongoc-client-encryption-opts-set-tls-opts"]], "mongoc_client_encryption_opts_t": [[211, "mongoc-client-encryption-opts-t"]], "mongoc_client_encryption_remove_key_alt_name()": [[212, "mongoc-client-encryption-remove-key-alt-name"]], "mongoc_client_encryption_rewrap_many_datakey()": [[213, "mongoc-client-encryption-rewrap-many-datakey"]], "mongoc_client_encryption_rewrap_many_datakey_result_destroy()": [[214, "mongoc-client-encryption-rewrap-many-datakey-result-destroy"]], "mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result()": [[215, "mongoc-client-encryption-rewrap-many-datakey-result-get-bulk-write-result"]], "mongoc_client_encryption_rewrap_many_datakey_result_new()": [[216, "mongoc-client-encryption-rewrap-many-datakey-result-new"]], "mongoc_client_encryption_rewrap_many_datakey_result_t": [[217, "mongoc-client-encryption-rewrap-many-datakey-result-t"]], "mongoc_client_encryption_t": [[218, "mongoc-client-encryption-t"]], "Thread Safety": [[218, "thread-safety"], [240, "thread-safety"], [241, "thread-safety"], [244, "thread-safety"], [245, "thread-safety"], [246, "thread-safety"], [247, "thread-safety"], [248, "thread-safety"], [250, "thread-safety"], [252, "thread-safety"], [286, "thread-safety"], [366, "thread-safety"], [429, "thread-safety"], [462, "thread-safety"], [473, "thread-safety"]], "mongoc_client_find_databases_with_opts()": [[219, "mongoc-client-find-databases-with-opts"]], "mongoc_client_get_collection()": [[220, "mongoc-client-get-collection"]], "mongoc_client_get_crypt_shared_version()": [[221, "mongoc-client-get-crypt-shared-version"]], "mongoc_client_get_database()": [[222, "mongoc-client-get-database"]], "mongoc_client_get_database_names()": [[223, "mongoc-client-get-database-names"]], "mongoc_client_get_database_names_with_opts()": [[224, "mongoc-client-get-database-names-with-opts"]], "Examples": [[224, "examples"], [296, "examples"], [317, "examples"], [378, "examples"], [381, "examples"], [394, "examples"], [520, "examples"], [650, "examples"]], "mongoc_client_get_default_database()": [[225, "mongoc-client-get-default-database"]], "mongoc_client_get_gridfs()": [[226, "mongoc-client-get-gridfs"]], "mongoc_client_get_handshake_description()": [[227, "mongoc-client-get-handshake-description"]], "Single-threaded client behavior": [[227, "single-threaded-client-behavior"]], "See Also": [[227, "see-also"]], "mongoc_client_get_read_concern()": [[228, "mongoc-client-get-read-concern"]], "mongoc_client_get_read_prefs()": [[229, "mongoc-client-get-read-prefs"]], "mongoc_client_get_server_description()": [[230, "mongoc-client-get-server-description"]], "mongoc_client_get_server_descriptions()": [[231, "mongoc-client-get-server-descriptions"]], "mongoc_client_get_server_status()": [[232, "mongoc-client-get-server-status"]], "mongoc_client_get_uri()": [[233, "mongoc-client-get-uri"]], "mongoc_client_get_write_concern()": [[234, "mongoc-client-get-write-concern"]], "mongoc_client_new()": [[235, "mongoc-client-new"]], "mongoc_client_new_from_uri()": [[236, "mongoc-client-new-from-uri"]], "mongoc_client_new_from_uri_with_error()": [[237, "mongoc-client-new-from-uri-with-error"]], "mongoc_client_pool_destroy()": [[238, "mongoc-client-pool-destroy"]], "mongoc_client_pool_enable_auto_encryption()": [[239, "mongoc-client-pool-enable-auto-encryption"]], "mongoc_client_pool_max_size()": [[240, "mongoc-client-pool-max-size"]], "mongoc_client_pool_min_size()": [[241, "mongoc-client-pool-min-size"]], "mongoc_client_pool_new()": [[242, "mongoc-client-pool-new"]], "mongoc_client_pool_new_with_error()": [[243, "mongoc-client-pool-new-with-error"]], "mongoc_client_pool_pop()": [[244, "mongoc-client-pool-pop"]], "mongoc_client_pool_push()": [[245, "mongoc-client-pool-push"]], "mongoc_client_pool_set_apm_callbacks()": [[246, "mongoc-client-pool-set-apm-callbacks"]], "mongoc_client_pool_set_appname()": [[247, "mongoc-client-pool-set-appname"]], "mongoc_client_pool_set_error_api()": [[248, "mongoc-client-pool-set-error-api"]], "mongoc_client_pool_set_server_api()": [[249, "mongoc-client-pool-set-server-api"]], "mongoc_client_pool_set_ssl_opts()": [[250, "mongoc-client-pool-set-ssl-opts"]], "Availability": [[250, "availability"], [282, "availability"]], "mongoc_client_pool_t": [[251, "mongoc-client-pool-t"]], "mongoc_client_pool_try_pop()": [[252, "mongoc-client-pool-try-pop"]], "mongoc_client_read_command_with_opts()": [[253, "mongoc-client-read-command-with-opts"]], "mongoc_client_read_write_command_with_opts()": [[254, "mongoc-client-read-write-command-with-opts"]], "mongoc_client_reset()": [[255, "mongoc-client-reset"]], "mongoc_client_select_server()": [[256, "mongoc-client-select-server"]], "mongoc_client_session_abort_transaction()": [[257, "mongoc-client-session-abort-transaction"]], "Return": [[257, "return"], [261, "return"], [270, "return"], [271, "return"], [272, "return"], [274, "return"], [275, "return"]], "mongoc_client_session_advance_cluster_time()": [[258, "mongoc-client-session-advance-cluster-time"]], "mongoc_client_session_advance_operation_time()": [[259, "mongoc-client-session-advance-operation-time"]], "mongoc_client_session_append()": [[260, "mongoc-client-session-append"]], "mongoc_client_session_commit_transaction()": [[261, "mongoc-client-session-commit-transaction"]], "mongoc_client_session_destroy()": [[262, "mongoc-client-session-destroy"]], "mongoc_client_session_get_client()": [[263, "mongoc-client-session-get-client"]], "mongoc_client_session_get_cluster_time()": [[264, "mongoc-client-session-get-cluster-time"]], "mongoc_client_session_get_dirty()": [[265, "mongoc-client-session-get-dirty"]], "mongoc_client_session_get_lsid()": [[266, "mongoc-client-session-get-lsid"]], "mongoc_client_session_get_operation_time()": [[267, "mongoc-client-session-get-operation-time"]], "mongoc_client_session_get_opts()": [[268, "mongoc-client-session-get-opts"]], "mongoc_client_session_get_server_id()": [[269, "mongoc-client-session-get-server-id"]], "mongoc_client_session_get_transaction_state()": [[270, "mongoc-client-session-get-transaction-state"]], "mongoc_client_session_in_transaction()": [[271, "mongoc-client-session-in-transaction"]], "mongoc_client_session_start_transaction()": [[272, "mongoc-client-session-start-transaction"]], "mongoc_client_session_t": [[273, "mongoc-client-session-t"]], "mongoc_client_session_with_transaction()": [[274, "mongoc-client-session-with-transaction"]], "mongoc_client_session_with_transaction_cb_t": [[275, "mongoc-client-session-with-transaction-cb-t"]], "mongoc_client_set_apm_callbacks()": [[276, "mongoc-client-set-apm-callbacks"]], "mongoc_client_set_appname()": [[277, "mongoc-client-set-appname"]], "mongoc_client_set_error_api()": [[278, "mongoc-client-set-error-api"]], "mongoc_client_set_read_concern()": [[279, "mongoc-client-set-read-concern"]], "mongoc_client_set_read_prefs()": [[280, "mongoc-client-set-read-prefs"]], "mongoc_client_set_server_api()": [[281, "mongoc-client-set-server-api"]], "mongoc_client_set_ssl_opts()": [[282, "mongoc-client-set-ssl-opts"]], "mongoc_client_set_stream_initiator()": [[283, "mongoc-client-set-stream-initiator"]], "mongoc_client_set_write_concern()": [[284, "mongoc-client-set-write-concern"]], "mongoc_client_start_session()": [[285, "mongoc-client-start-session"]], "mongoc_client_t": [[286, "mongoc-client-t"]], "Streams": [[286, "streams"]], "mongoc_client_watch()": [[287, "mongoc-client-watch"]], "mongoc_client_write_command_with_opts()": [[288, "mongoc-client-write-command-with-opts"]], "Basic Write Operations": [[288, "basic-write-operations"], [345, "basic-write-operations"], [396, "basic-write-operations"]], "mongoc_collection_aggregate()": [[289, "mongoc-collection-aggregate"]], "Other Parameters": [[289, "other-parameters"]], "mongoc_collection_command()": [[290, "mongoc-collection-command"]], "mongoc_collection_command_simple()": [[291, "mongoc-collection-command-simple"]], "mongoc_collection_command_with_opts()": [[292, "mongoc-collection-command-with-opts"]], "mongoc_collection_copy()": [[293, "mongoc-collection-copy"]], "mongoc_collection_count()": [[294, "mongoc-collection-count"]], "mongoc_collection_count_documents()": [[295, "mongoc-collection-count-documents"]], "Migrating from deprecated count functions": [[295, "migrating-from-deprecated-count-functions"]], "mongoc_collection_count_with_opts()": [[296, "mongoc-collection-count-with-opts"]], "mongoc_collection_create_bulk_operation()": [[297, "mongoc-collection-create-bulk-operation"]], "mongoc_collection_create_bulk_operation_with_opts()": [[298, "mongoc-collection-create-bulk-operation-with-opts"]], "mongoc_collection_create_index()": [[299, "mongoc-collection-create-index"]], "mongoc_collection_create_index_with_opts()": [[300, "mongoc-collection-create-index-with-opts"]], "mongoc_collection_create_indexes_with_opts()": [[301, "mongoc-collection-create-indexes-with-opts"]], "mongoc_index_model_t": [[301, "mongoc-index-model-t"]], "mongoc_collection_delete()": [[302, "mongoc-collection-delete"]], "mongoc_collection_delete_many()": [[303, "mongoc-collection-delete-many"]], "mongoc_collection_delete_one()": [[304, "mongoc-collection-delete-one"]], "mongoc_collection_destroy()": [[305, "mongoc-collection-destroy"]], "mongoc_collection_drop()": [[306, "mongoc-collection-drop"]], "mongoc_collection_drop_index()": [[307, "mongoc-collection-drop-index"]], "mongoc_collection_drop_index_with_opts()": [[308, "mongoc-collection-drop-index-with-opts"]], "mongoc_collection_drop_with_opts()": [[309, "mongoc-collection-drop-with-opts"]], "mongoc_collection_ensure_index()": [[310, "mongoc-collection-ensure-index"]], "mongoc_collection_estimated_document_count()": [[311, "mongoc-collection-estimated-document-count"]], "Behavior": [[311, "behavior"]], "mongoc_collection_find()": [[312, "mongoc-collection-find"]], "The \u201cfind\u201d command": [[312, "the-find-command"]], "The \u201cexplain\u201d command": [[312, "the-explain-command"], [317, "the-explain-command"]], "mongoc_collection_find_and_modify()": [[313, "mongoc-collection-find-and-modify"]], "mongoc_collection_find_and_modify_with_opts()": [[314, "mongoc-collection-find-and-modify-with-opts"]], "mongoc_collection_find_indexes()": [[315, "mongoc-collection-find-indexes"]], "mongoc_collection_find_indexes_with_opts()": [[316, "mongoc-collection-find-indexes-with-opts"]], "mongoc_collection_find_with_opts()": [[317, "mongoc-collection-find-with-opts"]], "Deprecated Options": [[317, "deprecated-options"]], "mongoc_collection_get_last_error()": [[318, "mongoc-collection-get-last-error"]], "mongoc_collection_get_name()": [[319, "mongoc-collection-get-name"]], "mongoc_collection_get_read_concern()": [[320, "mongoc-collection-get-read-concern"]], "mongoc_collection_get_read_prefs()": [[321, "mongoc-collection-get-read-prefs"]], "mongoc_collection_get_write_concern()": [[322, "mongoc-collection-get-write-concern"]], "mongoc_collection_insert()": [[323, "mongoc-collection-insert"]], "mongoc_collection_insert_bulk()": [[324, "mongoc-collection-insert-bulk"]], "mongoc_collection_insert_many()": [[325, "mongoc-collection-insert-many"]], "mongoc_collection_insert_one()": [[326, "mongoc-collection-insert-one"]], "mongoc_collection_keys_to_index_string()": [[327, "mongoc-collection-keys-to-index-string"]], "mongoc_collection_read_command_with_opts()": [[328, "mongoc-collection-read-command-with-opts"]], "mongoc_collection_read_write_command_with_opts()": [[329, "mongoc-collection-read-write-command-with-opts"]], "mongoc_collection_remove()": [[330, "mongoc-collection-remove"]], "mongoc_collection_rename()": [[331, "mongoc-collection-rename"]], "mongoc_collection_rename_with_opts()": [[332, "mongoc-collection-rename-with-opts"]], "mongoc_collection_replace_one()": [[333, "mongoc-collection-replace-one"]], "mongoc_collection_save()": [[334, "mongoc-collection-save"]], "mongoc_collection_set_read_concern()": [[335, "mongoc-collection-set-read-concern"]], "mongoc_collection_set_read_prefs()": [[336, "mongoc-collection-set-read-prefs"]], "mongoc_collection_set_write_concern()": [[337, "mongoc-collection-set-write-concern"]], "mongoc_collection_stats()": [[338, "mongoc-collection-stats"]], "mongoc_collection_t": [[339, "mongoc-collection-t"]], "Read Preferences and Write Concerns": [[339, "read-preferences-and-write-concerns"]], "mongoc_collection_update()": [[340, "mongoc-collection-update"]], "mongoc_collection_update_many()": [[341, "mongoc-collection-update-many"]], "mongoc_collection_update_one()": [[342, "mongoc-collection-update-one"]], "mongoc_collection_validate()": [[343, "mongoc-collection-validate"]], "mongoc_collection_watch()": [[344, "mongoc-collection-watch"]], "mongoc_collection_write_command_with_opts()": [[345, "mongoc-collection-write-command-with-opts"]], "mongoc_cursor_clone()": [[346, "mongoc-cursor-clone"]], "mongoc_cursor_current()": [[347, "mongoc-cursor-current"]], "mongoc_cursor_destroy()": [[348, "mongoc-cursor-destroy"]], "mongoc_cursor_error()": [[349, "mongoc-cursor-error"]], "mongoc_cursor_error_document()": [[350, "mongoc-cursor-error-document"]], "mongoc_cursor_get_batch_size()": [[351, "mongoc-cursor-get-batch-size"]], "mongoc_cursor_get_hint()": [[352, "mongoc-cursor-get-hint"]], "mongoc_cursor_get_host()": [[353, "mongoc-cursor-get-host"]], "mongoc_cursor_get_id()": [[354, "mongoc-cursor-get-id"]], "mongoc_cursor_get_limit()": [[355, "mongoc-cursor-get-limit"]], "mongoc_cursor_get_max_await_time_ms()": [[356, "mongoc-cursor-get-max-await-time-ms"]], "mongoc_cursor_is_alive()": [[357, "mongoc-cursor-is-alive"]], "mongoc_cursor_more()": [[358, "mongoc-cursor-more"]], "mongoc_cursor_new_from_command_reply()": [[359, "mongoc-cursor-new-from-command-reply"]], "mongoc_cursor_new_from_command_reply_with_opts()": [[360, "mongoc-cursor-new-from-command-reply-with-opts"]], "mongoc_cursor_next()": [[361, "mongoc-cursor-next"]], "mongoc_cursor_set_batch_size()": [[362, "mongoc-cursor-set-batch-size"]], "mongoc_cursor_set_hint()": [[363, "mongoc-cursor-set-hint"]], "mongoc_cursor_set_limit()": [[364, "mongoc-cursor-set-limit"]], "mongoc_cursor_set_max_await_time_ms()": [[365, "mongoc-cursor-set-max-await-time-ms"]], "mongoc_cursor_t": [[366, "mongoc-cursor-t"]], "mongoc_database_add_user()": [[367, "mongoc-database-add-user"]], "mongoc_database_aggregate()": [[368, "mongoc-database-aggregate"]], "mongoc_database_command()": [[369, "mongoc-database-command"]], "mongoc_database_command_simple()": [[370, "mongoc-database-command-simple"]], "mongoc_database_command_with_opts()": [[371, "mongoc-database-command-with-opts"]], "mongoc_database_copy()": [[372, "mongoc-database-copy"]], "mongoc_database_create_collection()": [[373, "mongoc-database-create-collection"]], "mongoc_database_destroy()": [[374, "mongoc-database-destroy"]], "mongoc_database_drop()": [[375, "mongoc-database-drop"]], "mongoc_database_drop_with_opts()": [[376, "mongoc-database-drop-with-opts"]], "mongoc_database_find_collections()": [[377, "mongoc-database-find-collections"]], "mongoc_database_find_collections_with_opts()": [[378, "mongoc-database-find-collections-with-opts"]], "mongoc_database_get_collection()": [[379, "mongoc-database-get-collection"]], "mongoc_database_get_collection_names()": [[380, "mongoc-database-get-collection-names"]], "mongoc_database_get_collection_names_with_opts()": [[381, "mongoc-database-get-collection-names-with-opts"]], "mongoc_database_get_name()": [[382, "mongoc-database-get-name"]], "mongoc_database_get_read_concern()": [[383, "mongoc-database-get-read-concern"]], "mongoc_database_get_read_prefs()": [[384, "mongoc-database-get-read-prefs"]], "mongoc_database_get_write_concern()": [[385, "mongoc-database-get-write-concern"]], "mongoc_database_has_collection()": [[386, "mongoc-database-has-collection"]], "mongoc_database_read_command_with_opts()": [[387, "mongoc-database-read-command-with-opts"]], "mongoc_database_read_write_command_with_opts()": [[388, "mongoc-database-read-write-command-with-opts"]], "mongoc_database_remove_all_users()": [[389, "mongoc-database-remove-all-users"]], "mongoc_database_remove_user()": [[390, "mongoc-database-remove-user"]], "mongoc_database_set_read_concern()": [[391, "mongoc-database-set-read-concern"]], "mongoc_database_set_read_prefs()": [[392, "mongoc-database-set-read-prefs"]], "mongoc_database_set_write_concern()": [[393, "mongoc-database-set-write-concern"]], "mongoc_database_t": [[394, "mongoc-database-t"]], "mongoc_database_watch()": [[395, "mongoc-database-watch"]], "mongoc_database_write_command_with_opts()": [[396, "mongoc-database-write-command-with-opts"]], "mongoc_delete_flags_t": [[397, "mongoc-delete-flags-t"]], "mongoc_error_has_label()": [[398, "mongoc-error-has-label"]], "mongoc_find_and_modify_opts_append()": [[399, "mongoc-find-and-modify-opts-append"]], "Appending options to findAndModify": [[399, "appending-options-to-findandmodify"]], "mongoc_find_and_modify_opts_destroy()": [[400, "mongoc-find-and-modify-opts-destroy"]], "mongoc_find_and_modify_opts_get_bypass_document_validation()": [[401, "mongoc-find-and-modify-opts-get-bypass-document-validation"]], "mongoc_find_and_modify_opts_get_fields()": [[402, "mongoc-find-and-modify-opts-get-fields"]], "mongoc_find_and_modify_opts_get_flags()": [[403, "mongoc-find-and-modify-opts-get-flags"]], "mongoc_find_and_modify_opts_get_max_time_ms()": [[404, "mongoc-find-and-modify-opts-get-max-time-ms"]], "mongoc_find_and_modify_opts_get_sort()": [[405, "mongoc-find-and-modify-opts-get-sort"]], "mongoc_find_and_modify_opts_get_update()": [[406, "mongoc-find-and-modify-opts-get-update"]], "mongoc_find_and_modify_opts_new()": [[407, "mongoc-find-and-modify-opts-new"]], "mongoc_find_and_modify_opts_set_bypass_document_validation()": [[408, "mongoc-find-and-modify-opts-set-bypass-document-validation"]], "Setting bypassDocumentValidation": [[408, "setting-bypassdocumentvalidation"]], "mongoc_find_and_modify_opts_set_fields()": [[409, "mongoc-find-and-modify-opts-set-fields"]], "Setting fields": [[409, "setting-fields"]], "mongoc_find_and_modify_opts_set_flags()": [[410, "mongoc-find-and-modify-opts-set-flags"]], "Setting flags": [[410, "setting-flags"]], "mongoc_find_and_modify_opts_set_max_time_ms()": [[411, "mongoc-find-and-modify-opts-set-max-time-ms"]], "Setting maxTimeMS": [[411, "setting-maxtimems"]], "mongoc_find_and_modify_opts_set_sort()": [[412, "mongoc-find-and-modify-opts-set-sort"]], "Setting sort": [[412, "setting-sort"]], "mongoc_find_and_modify_opts_set_update()": [[413, "mongoc-find-and-modify-opts-set-update"]], "Setting update": [[413, "setting-update"]], "mongoc_find_and_modify_opts_t": [[414, "mongoc-find-and-modify-opts-t"]], "mongoc_get_major_version()": [[415, "mongoc-get-major-version"]], "mongoc_get_micro_version()": [[416, "mongoc-get-micro-version"]], "mongoc_get_minor_version()": [[417, "mongoc-get-minor-version"]], "mongoc_get_version()": [[418, "mongoc-get-version"]], "mongoc_gridfs_bucket_abort_upload()": [[419, "mongoc-gridfs-bucket-abort-upload"]], "mongoc_gridfs_bucket_delete_by_id()": [[420, "mongoc-gridfs-bucket-delete-by-id"]], "mongoc_gridfs_bucket_destroy()": [[421, "mongoc-gridfs-bucket-destroy"]], "mongoc_gridfs_bucket_download_to_stream()": [[422, "mongoc-gridfs-bucket-download-to-stream"]], "mongoc_gridfs_bucket_find()": [[423, "mongoc-gridfs-bucket-find"]], "mongoc_gridfs_bucket_new()": [[424, "mongoc-gridfs-bucket-new"]], "mongoc_gridfs_bucket_open_download_stream()": [[425, "mongoc-gridfs-bucket-open-download-stream"]], "mongoc_gridfs_bucket_open_upload_stream()": [[426, "mongoc-gridfs-bucket-open-upload-stream"]], "mongoc_gridfs_bucket_open_upload_stream_with_id()": [[427, "mongoc-gridfs-bucket-open-upload-stream-with-id"]], "mongoc_gridfs_bucket_stream_error()": [[428, "mongoc-gridfs-bucket-stream-error"]], "mongoc_gridfs_bucket_t": [[429, "mongoc-gridfs-bucket-t"]], "mongoc_gridfs_bucket_upload_from_stream()": [[430, "mongoc-gridfs-bucket-upload-from-stream"]], "mongoc_gridfs_bucket_upload_from_stream_with_id()": [[431, "mongoc-gridfs-bucket-upload-from-stream-with-id"]], "mongoc_gridfs_create_file()": [[432, "mongoc-gridfs-create-file"]], "mongoc_gridfs_create_file_from_stream()": [[433, "mongoc-gridfs-create-file-from-stream"]], "mongoc_gridfs_destroy()": [[434, "mongoc-gridfs-destroy"]], "mongoc_gridfs_drop()": [[435, "mongoc-gridfs-drop"]], "mongoc_gridfs_file_destroy()": [[436, "mongoc-gridfs-file-destroy"]], "mongoc_gridfs_file_error()": [[437, "mongoc-gridfs-file-error"]], "mongoc_gridfs_file_get_aliases()": [[438, "mongoc-gridfs-file-get-aliases"]], "mongoc_gridfs_file_get_chunk_size()": [[439, "mongoc-gridfs-file-get-chunk-size"]], "mongoc_gridfs_file_get_content_type()": [[440, "mongoc-gridfs-file-get-content-type"]], "mongoc_gridfs_file_get_filename()": [[441, "mongoc-gridfs-file-get-filename"]], "mongoc_gridfs_file_get_id()": [[442, "mongoc-gridfs-file-get-id"]], "mongoc_gridfs_file_get_length()": [[443, "mongoc-gridfs-file-get-length"]], "mongoc_gridfs_file_get_md5()": [[444, "mongoc-gridfs-file-get-md5"]], "mongoc_gridfs_file_get_metadata()": [[445, "mongoc-gridfs-file-get-metadata"]], "mongoc_gridfs_file_get_upload_date()": [[446, "mongoc-gridfs-file-get-upload-date"]], "mongoc_gridfs_file_list_destroy()": [[447, "mongoc-gridfs-file-list-destroy"]], "mongoc_gridfs_file_list_error()": [[448, "mongoc-gridfs-file-list-error"]], "mongoc_gridfs_file_list_next()": [[449, "mongoc-gridfs-file-list-next"]], "mongoc_gridfs_file_list_t": [[450, "mongoc-gridfs-file-list-t"]], "mongoc_gridfs_file_opt_t": [[451, "mongoc-gridfs-file-opt-t"]], "mongoc_gridfs_file_readv()": [[452, "mongoc-gridfs-file-readv"]], "mongoc_gridfs_file_remove()": [[453, "mongoc-gridfs-file-remove"]], "mongoc_gridfs_file_save()": [[454, "mongoc-gridfs-file-save"]], "mongoc_gridfs_file_seek()": [[455, "mongoc-gridfs-file-seek"]], "mongoc_gridfs_file_set_aliases()": [[456, "mongoc-gridfs-file-set-aliases"]], "mongoc_gridfs_file_set_content_type()": [[457, "mongoc-gridfs-file-set-content-type"]], "mongoc_gridfs_file_set_filename()": [[458, "mongoc-gridfs-file-set-filename"]], "mongoc_gridfs_file_set_id()": [[459, "mongoc-gridfs-file-set-id"]], "mongoc_gridfs_file_set_md5()": [[460, "mongoc-gridfs-file-set-md5"]], "mongoc_gridfs_file_set_metadata()": [[461, "mongoc-gridfs-file-set-metadata"]], "mongoc_gridfs_file_t": [[462, "mongoc-gridfs-file-t"]], "Related": [[462, "related"]], "mongoc_gridfs_file_tell()": [[463, "mongoc-gridfs-file-tell"]], "mongoc_gridfs_file_writev()": [[464, "mongoc-gridfs-file-writev"]], "mongoc_gridfs_find()": [[465, "mongoc-gridfs-find"]], "mongoc_gridfs_find_one()": [[466, "mongoc-gridfs-find-one"]], "mongoc_gridfs_find_one_by_filename()": [[467, "mongoc-gridfs-find-one-by-filename"]], "mongoc_gridfs_find_one_with_opts()": [[468, "mongoc-gridfs-find-one-with-opts"]], "mongoc_gridfs_find_with_opts()": [[469, "mongoc-gridfs-find-with-opts"]], "mongoc_gridfs_get_chunks()": [[470, "mongoc-gridfs-get-chunks"]], "mongoc_gridfs_get_files()": [[471, "mongoc-gridfs-get-files"]], "mongoc_gridfs_remove_by_filename()": [[472, "mongoc-gridfs-remove-by-filename"]], "mongoc_gridfs_t": [[473, "mongoc-gridfs-t"]], "mongoc_handshake_data_append()": [[474, "mongoc-handshake-data-append"]], "mongoc_host_list_t": [[475, "mongoc-host-list-t"]], "mongoc_index_opt_geo_get_default()": [[476, "mongoc-index-opt-geo-get-default"]], "mongoc_index_opt_geo_init()": [[477, "mongoc-index-opt-geo-init"]], "mongoc_index_opt_geo_t": [[478, "mongoc-index-opt-geo-t"]], "mongoc_index_opt_get_default()": [[479, "mongoc-index-opt-get-default"]], "mongoc_index_opt_init()": [[480, "mongoc-index-opt-init"]], "mongoc_index_opt_t": [[481, "mongoc-index-opt-t"]], "mongoc_index_opt_wt_get_default()": [[482, "mongoc-index-opt-wt-get-default"]], "mongoc_index_opt_wt_init()": [[483, "mongoc-index-opt-wt-init"]], "mongoc_index_opt_wt_t": [[484, "mongoc-index-opt-wt-t"]], "mongoc_init()": [[485, "mongoc-init"]], "mongoc_insert_flags_t": [[486, "mongoc-insert-flags-t"]], "Flag Values": [[486, "flag-values"], [494, "flag-values"], [522, "flag-values"], [523, "flag-values"], [619, "flag-values"], [620, "flag-values"]], "mongoc_iovec_t": [[487, "mongoc-iovec-t"]], "mongoc_optional_copy()": [[488, "mongoc-optional-copy"]], "mongoc_optional_init()": [[489, "mongoc-optional-init"]], "mongoc_optional_is_set()": [[490, "mongoc-optional-is-set"]], "mongoc_optional_set_value()": [[491, "mongoc-optional-set-value"]], "mongoc_optional_t": [[492, "mongoc-optional-t"]], "mongoc_optional_value()": [[493, "mongoc-optional-value"]], "mongoc_query_flags_t": [[494, "mongoc-query-flags-t"]], "mongoc_rand": [[495, "mongoc-rand"]], "Entropy": [[495, "entropy"]], "Status": [[495, "status"]], "mongoc_rand_add()": [[496, "mongoc-rand-add"]], "mongoc_rand_seed()": [[497, "mongoc-rand-seed"]], "mongoc_rand_status()": [[498, "mongoc-rand-status"]], "mongoc_read_concern_append()": [[499, "mongoc-read-concern-append"]], "mongoc_read_concern_copy()": [[500, "mongoc-read-concern-copy"]], "mongoc_read_concern_destroy()": [[501, "mongoc-read-concern-destroy"]], "mongoc_read_concern_get_level()": [[502, "mongoc-read-concern-get-level"]], "mongoc_read_concern_is_default()": [[503, "mongoc-read-concern-is-default"]], "mongoc_read_concern_new()": [[504, "mongoc-read-concern-new"]], "mongoc_read_concern_set_level()": [[505, "mongoc-read-concern-set-level"]], "mongoc_read_concern_t": [[506, "mongoc-read-concern-t"]], "Read Concern Levels": [[506, "read-concern-levels"]], "mongoc_read_mode_t": [[507, "mongoc-read-mode-t"]], "mongoc_read_prefs_add_tag()": [[508, "mongoc-read-prefs-add-tag"]], "mongoc_read_prefs_copy()": [[509, "mongoc-read-prefs-copy"]], "mongoc_read_prefs_destroy()": [[510, "mongoc-read-prefs-destroy"]], "mongoc_read_prefs_get_hedge()": [[511, "mongoc-read-prefs-get-hedge"]], "mongoc_read_prefs_get_max_staleness_seconds()": [[512, "mongoc-read-prefs-get-max-staleness-seconds"]], "mongoc_read_prefs_get_mode()": [[513, "mongoc-read-prefs-get-mode"]], "mongoc_read_prefs_get_tags()": [[514, "mongoc-read-prefs-get-tags"]], "mongoc_read_prefs_is_valid()": [[515, "mongoc-read-prefs-is-valid"]], "mongoc_read_prefs_new()": [[516, "mongoc-read-prefs-new"]], "mongoc_read_prefs_set_hedge()": [[517, "mongoc-read-prefs-set-hedge"]], "mongoc_read_prefs_set_max_staleness_seconds()": [[518, "mongoc-read-prefs-set-max-staleness-seconds"]], "mongoc_read_prefs_set_mode()": [[519, "mongoc-read-prefs-set-mode"]], "mongoc_read_prefs_set_tags()": [[520, "mongoc-read-prefs-set-tags"]], "mongoc_read_prefs_t": [[521, "mongoc-read-prefs-t"]], "Read Modes": [[521, "read-modes"]], "Tag Sets": [[521, "tag-sets"]], "Max Staleness": [[521, "max-staleness"]], "Hedged Reads": [[521, "hedged-reads"]], "mongoc_remove_flags_t": [[522, "mongoc-remove-flags-t"]], "mongoc_reply_flags_t": [[523, "mongoc-reply-flags-t"]], "mongoc_server_api_copy()": [[524, "mongoc-server-api-copy"]], "mongoc_server_api_deprecation_errors()": [[525, "mongoc-server-api-deprecation-errors"]], "mongoc_server_api_destroy()": [[526, "mongoc-server-api-destroy"]], "mongoc_server_api_get_deprecation_errors()": [[527, "mongoc-server-api-get-deprecation-errors"]], "mongoc_server_api_get_strict()": [[528, "mongoc-server-api-get-strict"]], "mongoc_server_api_get_version()": [[529, "mongoc-server-api-get-version"]], "mongoc_server_api_new()": [[530, "mongoc-server-api-new"]], "mongoc_server_api_strict()": [[531, "mongoc-server-api-strict"]], "mongoc_server_api_t": [[532, "mongoc-server-api-t"]], "mongoc_server_api_version_from_string()": [[533, "mongoc-server-api-version-from-string"]], "mongoc_server_api_version_t": [[534, "mongoc-server-api-version-t"]], "Supported API Versions": [[534, "supported-api-versions"]], "mongoc_server_api_version_to_string()": [[535, "mongoc-server-api-version-to-string"]], "mongoc_server_description_destroy()": [[536, "mongoc-server-description-destroy"]], "mongoc_server_description_hello_response()": [[537, "mongoc-server-description-hello-response"]], "mongoc_server_description_host()": [[538, "mongoc-server-description-host"]], "mongoc_server_description_id()": [[539, "mongoc-server-description-id"]], "mongoc_server_description_ismaster()": [[540, "mongoc-server-description-ismaster"]], "mongoc_server_description_last_update_time()": [[541, "mongoc-server-description-last-update-time"]], "mongoc_server_description_new_copy()": [[542, "mongoc-server-description-new-copy"]], "mongoc_server_description_round_trip_time()": [[543, "mongoc-server-description-round-trip-time"]], "mongoc_server_description_t": [[544, "mongoc-server-description-t"]], "mongoc_server_description_type()": [[545, "mongoc-server-description-type"]], "mongoc_server_descriptions_destroy_all()": [[546, "mongoc-server-descriptions-destroy-all"]], "mongoc_session_opt_t": [[547, "mongoc-session-opt-t"]], "mongoc_session_opts_clone()": [[548, "mongoc-session-opts-clone"]], "mongoc_session_opts_destroy()": [[549, "mongoc-session-opts-destroy"]], "mongoc_session_opts_get_causal_consistency()": [[550, "mongoc-session-opts-get-causal-consistency"]], "mongoc_session_opts_get_default_transaction_opts()": [[551, "mongoc-session-opts-get-default-transaction-opts"]], "mongoc_session_opts_get_snapshot()": [[552, "mongoc-session-opts-get-snapshot"]], "mongoc_session_opts_get_transaction_opts()": [[553, "mongoc-session-opts-get-transaction-opts"]], "mongoc_session_opts_new()": [[554, "mongoc-session-opts-new"]], "mongoc_session_opts_set_causal_consistency()": [[555, "mongoc-session-opts-set-causal-consistency"]], "mongoc_session_opts_set_default_transaction_opts()": [[556, "mongoc-session-opts-set-default-transaction-opts"]], "mongoc_session_opts_set_snapshot()": [[557, "mongoc-session-opts-set-snapshot"]], "mongoc_socket_accept()": [[558, "mongoc-socket-accept"]], "mongoc_socket_bind()": [[559, "mongoc-socket-bind"]], "mongoc_socket_close()": [[560, "mongoc-socket-close"]], "mongoc_socket_connect()": [[561, "mongoc-socket-connect"]], "mongoc_socket_destroy()": [[562, "mongoc-socket-destroy"]], "mongoc_socket_errno()": [[563, "mongoc-socket-errno"]], "mongoc_socket_getnameinfo()": [[564, "mongoc-socket-getnameinfo"]], "mongoc_socket_getsockname()": [[565, "mongoc-socket-getsockname"]], "mongoc_socket_listen()": [[566, "mongoc-socket-listen"]], "mongoc_socket_new()": [[567, "mongoc-socket-new"]], "mongoc_socket_recv()": [[568, "mongoc-socket-recv"]], "mongoc_socket_send()": [[569, "mongoc-socket-send"]], "mongoc_socket_sendv()": [[570, "mongoc-socket-sendv"]], "mongoc_socket_setsockopt()": [[571, "mongoc-socket-setsockopt"]], "mongoc_socket_t": [[572, "mongoc-socket-t"]], "mongoc_ssl_opt_get_default()": [[573, "mongoc-ssl-opt-get-default"]], "mongoc_ssl_opt_t": [[574, "mongoc-ssl-opt-t"]], "mongoc_stream_buffered_new()": [[575, "mongoc-stream-buffered-new"]], "mongoc_stream_buffered_t": [[576, "mongoc-stream-buffered-t"]], "mongoc_stream_close()": [[577, "mongoc-stream-close"]], "mongoc_stream_cork()": [[578, "mongoc-stream-cork"]], "mongoc_stream_destroy()": [[579, "mongoc-stream-destroy"]], "mongoc_stream_file_get_fd()": [[580, "mongoc-stream-file-get-fd"]], "mongoc_stream_file_new()": [[581, "mongoc-stream-file-new"]], "mongoc_stream_file_new_for_path()": [[582, "mongoc-stream-file-new-for-path"]], "mongoc_stream_file_t": [[583, "mongoc-stream-file-t"]], "mongoc_stream_flush()": [[584, "mongoc-stream-flush"]], "mongoc_stream_get_base_stream()": [[585, "mongoc-stream-get-base-stream"]], "mongoc_stream_gridfs_new()": [[586, "mongoc-stream-gridfs-new"]], "mongoc_stream_read()": [[587, "mongoc-stream-read"]], "mongoc_stream_readv()": [[588, "mongoc-stream-readv"]], "mongoc_stream_setsockopt()": [[589, "mongoc-stream-setsockopt"]], "mongoc_stream_should_retry()": [[590, "mongoc-stream-should-retry"]], "mongoc_stream_socket_get_socket()": [[591, "mongoc-stream-socket-get-socket"]], "mongoc_stream_socket_new()": [[592, "mongoc-stream-socket-new"]], "mongoc_stream_socket_t": [[593, "mongoc-stream-socket-t"]], "mongoc_stream_t": [[594, "mongoc-stream-t"]], "Stream Types": [[594, "stream-types"]], "mongoc_stream_timed_out()": [[595, "mongoc-stream-timed-out"]], "mongoc_stream_tls_t": [[596, "mongoc-stream-tls-t"]], "mongoc_stream_uncork()": [[597, "mongoc-stream-uncork"]], "mongoc_stream_write()": [[598, "mongoc-stream-write"]], "mongoc_stream_writev()": [[599, "mongoc-stream-writev"]], "mongoc_topology_description_destroy()": [[600, "mongoc-topology-description-destroy"]], "mongoc_topology_description_get_servers()": [[601, "mongoc-topology-description-get-servers"]], "mongoc_topology_description_has_readable_server()": [[602, "mongoc-topology-description-has-readable-server"]], "mongoc_topology_description_has_writable_server()": [[603, "mongoc-topology-description-has-writable-server"]], "mongoc_topology_description_new_copy()": [[604, "mongoc-topology-description-new-copy"]], "mongoc_topology_description_t": [[605, "mongoc-topology-description-t"]], "mongoc_topology_description_type()": [[606, "mongoc-topology-description-type"]], "mongoc_transaction_opt_t": [[607, "mongoc-transaction-opt-t"]], "mongoc_transaction_opts_clone()": [[608, "mongoc-transaction-opts-clone"]], "mongoc_transaction_opts_destroy()": [[609, "mongoc-transaction-opts-destroy"]], "mongoc_transaction_opts_get_max_commit_time_ms()": [[610, "mongoc-transaction-opts-get-max-commit-time-ms"]], "mongoc_transaction_opts_get_read_concern()": [[611, "mongoc-transaction-opts-get-read-concern"]], "mongoc_transaction_opts_get_read_prefs()": [[612, "mongoc-transaction-opts-get-read-prefs"]], "mongoc_transaction_opts_get_write_concern()": [[613, "mongoc-transaction-opts-get-write-concern"]], "mongoc_transaction_opts_new()": [[614, "mongoc-transaction-opts-new"]], "mongoc_transaction_opts_set_max_commit_time_ms()": [[615, "mongoc-transaction-opts-set-max-commit-time-ms"]], "mongoc_transaction_opts_set_read_concern()": [[616, "mongoc-transaction-opts-set-read-concern"]], "mongoc_transaction_opts_set_read_prefs()": [[617, "mongoc-transaction-opts-set-read-prefs"]], "mongoc_transaction_opts_set_write_concern()": [[618, "mongoc-transaction-opts-set-write-concern"]], "mongoc_transaction_state_t": [[619, "mongoc-transaction-state-t"]], "mongoc_update_flags_t": [[620, "mongoc-update-flags-t"]], "mongoc_uri_copy()": [[621, "mongoc-uri-copy"]], "mongoc_uri_destroy()": [[622, "mongoc-uri-destroy"]], "mongoc_uri_get_auth_mechanism()": [[623, "mongoc-uri-get-auth-mechanism"]], "mongoc_uri_get_auth_source()": [[624, "mongoc-uri-get-auth-source"]], "mongoc_uri_get_compressors()": [[625, "mongoc-uri-get-compressors"]], "mongoc_uri_get_database()": [[626, "mongoc-uri-get-database"]], "mongoc_uri_get_hosts()": [[627, "mongoc-uri-get-hosts"]], "mongoc_uri_get_mechanism_properties()": [[628, "mongoc-uri-get-mechanism-properties"]], "mongoc_uri_get_option_as_bool()": [[629, "mongoc-uri-get-option-as-bool"]], "mongoc_uri_get_option_as_int32()": [[630, "mongoc-uri-get-option-as-int32"]], "mongoc_uri_get_option_as_int64()": [[631, "mongoc-uri-get-option-as-int64"]], "mongoc_uri_get_option_as_utf8()": [[632, "mongoc-uri-get-option-as-utf8"]], "mongoc_uri_get_options()": [[633, "mongoc-uri-get-options"]], "mongoc_uri_get_password()": [[634, "mongoc-uri-get-password"]], "mongoc_uri_get_read_concern()": [[635, "mongoc-uri-get-read-concern"]], "mongoc_uri_get_read_prefs()": [[636, "mongoc-uri-get-read-prefs"]], "mongoc_uri_get_read_prefs_t()": [[637, "mongoc-uri-get-read-prefs-t"]], "mongoc_uri_get_replica_set()": [[638, "mongoc-uri-get-replica-set"]], "mongoc_uri_get_service()": [[639, "mongoc-uri-get-service"]], "mongoc_uri_get_srv_hostname()": [[640, "mongoc-uri-get-srv-hostname"]], "mongoc_uri_get_srv_service_name()": [[641, "mongoc-uri-get-srv-service-name"]], "mongoc_uri_get_ssl()": [[642, "mongoc-uri-get-ssl"]], "mongoc_uri_get_string()": [[643, "mongoc-uri-get-string"]], "mongoc_uri_get_tls()": [[644, "mongoc-uri-get-tls"]], "mongoc_uri_get_username()": [[645, "mongoc-uri-get-username"]], "mongoc_uri_get_write_concern()": [[646, "mongoc-uri-get-write-concern"]], "mongoc_uri_has_option()": [[647, "mongoc-uri-has-option"]], "mongoc_uri_new()": [[648, "mongoc-uri-new"]], "mongoc_uri_new_for_host_port()": [[649, "mongoc-uri-new-for-host-port"]], "mongoc_uri_new_with_error()": [[650, "mongoc-uri-new-with-error"]], "mongoc_uri_option_is_bool()": [[651, "mongoc-uri-option-is-bool"]], "mongoc_uri_option_is_int32()": [[652, "mongoc-uri-option-is-int32"]], "mongoc_uri_option_is_int64()": [[653, "mongoc-uri-option-is-int64"]], "mongoc_uri_option_is_utf8()": [[654, "mongoc-uri-option-is-utf8"]], "mongoc_uri_set_auth_mechanism()": [[655, "mongoc-uri-set-auth-mechanism"]], "mongoc_uri_set_auth_source()": [[656, "mongoc-uri-set-auth-source"]], "mongoc_uri_set_compressors()": [[657, "mongoc-uri-set-compressors"]], "mongoc_uri_set_database()": [[658, "mongoc-uri-set-database"]], "mongoc_uri_set_mechanism_properties()": [[659, "mongoc-uri-set-mechanism-properties"]], "mongoc_uri_set_option_as_bool()": [[660, "mongoc-uri-set-option-as-bool"]], "mongoc_uri_set_option_as_int32()": [[661, "mongoc-uri-set-option-as-int32"]], "mongoc_uri_set_option_as_int64()": [[662, "mongoc-uri-set-option-as-int64"]], "mongoc_uri_set_option_as_utf8()": [[663, "mongoc-uri-set-option-as-utf8"]], "mongoc_uri_set_password()": [[664, "mongoc-uri-set-password"]], "mongoc_uri_set_read_concern()": [[665, "mongoc-uri-set-read-concern"]], "mongoc_uri_set_read_prefs_t()": [[666, "mongoc-uri-set-read-prefs-t"]], "mongoc_uri_set_username()": [[667, "mongoc-uri-set-username"]], "mongoc_uri_set_write_concern()": [[668, "mongoc-uri-set-write-concern"]], "mongoc_uri_t": [[669, "mongoc-uri-t"]], "Format": [[669, "format"]], "Replica Set Example": [[669, "replica-set-example"]], "SRV Example": [[669, "srv-example"]], "IPv4 and IPv6": [[669, "ipv4-and-ipv6"]], "Connection Options": [[669, "connection-options"]], "Authentication Options": [[669, "authentication-options"]], "Mechanism Properties": [[669, "mechanism-properties"]], "TLS Options": [[669, "tls-options"]], "Deprecated SSL Options": [[669, "deprecated-ssl-options"]], "Server Discovery, Monitoring, and Selection Options": [[669, "server-discovery-monitoring-and-selection-options"]], "Connection Pool Options": [[669, "connection-pool-options"]], "Write Concern Options": [[669, "write-concern-options"]], "Read Concern Options": [[669, "read-concern-options"]], "Read Preference Options": [[669, "read-preference-options"]], "Legacy Options": [[669, "legacy-options"]], "mongoc_uri_unescape()": [[670, "mongoc-uri-unescape"]], "Version Checks": [[671, "version-checks"]], "Run-Time Version Checks": [[671, "run-time-version-checks"]], "mongoc_write_concern_append()": [[672, "mongoc-write-concern-append"]], "mongoc_write_concern_copy()": [[673, "mongoc-write-concern-copy"]], "mongoc_write_concern_destroy()": [[674, "mongoc-write-concern-destroy"]], "mongoc_write_concern_get_fsync()": [[675, "mongoc-write-concern-get-fsync"]], "mongoc_write_concern_get_journal()": [[676, "mongoc-write-concern-get-journal"]], "mongoc_write_concern_get_w()": [[677, "mongoc-write-concern-get-w"]], "mongoc_write_concern_get_wmajority()": [[678, "mongoc-write-concern-get-wmajority"]], "mongoc_write_concern_get_wtag()": [[679, "mongoc-write-concern-get-wtag"]], "mongoc_write_concern_get_wtimeout()": [[680, "mongoc-write-concern-get-wtimeout"]], "mongoc_write_concern_get_wtimeout_int64()": [[681, "mongoc-write-concern-get-wtimeout-int64"]], "mongoc_write_concern_is_acknowledged()": [[682, "mongoc-write-concern-is-acknowledged"]], "mongoc_write_concern_is_default()": [[683, "mongoc-write-concern-is-default"]], "mongoc_write_concern_is_valid()": [[684, "mongoc-write-concern-is-valid"]], "mongoc_write_concern_journal_is_set()": [[685, "mongoc-write-concern-journal-is-set"]], "mongoc_write_concern_new()": [[686, "mongoc-write-concern-new"]], "mongoc_write_concern_set_fsync()": [[687, "mongoc-write-concern-set-fsync"]], "mongoc_write_concern_set_journal()": [[688, "mongoc-write-concern-set-journal"]], "mongoc_write_concern_set_w()": [[689, "mongoc-write-concern-set-w"]], "mongoc_write_concern_set_wmajority()": [[690, "mongoc-write-concern-set-wmajority"]], "mongoc_write_concern_set_wtag()": [[691, "mongoc-write-concern-set-wtag"]], "mongoc_write_concern_set_wtimeout()": [[692, "mongoc-write-concern-set-wtimeout"]], "mongoc_write_concern_set_wtimeout_int64()": [[693, "mongoc-write-concern-set-wtimeout-int64"]], "mongoc_write_concern_t": [[694, "mongoc-write-concern-t"]], "Write Concern Levels": [[694, "write-concern-levels"]], "Deprecations": [[694, "deprecations"]], "Queryable Encryption": [[695, "queryable-encryption"]], "Queryable Encryption in older MongoDB Server versions": [[695, "queryable-encryption-in-older-mongodb-server-versions"]], "Tutorial": [[696, "tutorial"]], "Contents": [[696, "contents"]], "Installing": [[696, "installing"]], "Starting MongoDB": [[696, "starting-mongodb"]], "Include and link libmongoc in your C program": [[696, "include-and-link-libmongoc-in-your-c-program"]], "Include mongoc.h": [[696, "include-mongoc-h"]], "CMake": [[696, "cmake"]], "pkg-config": [[696, "pkg-config"]], "Specifying header and include paths manually": [[696, "specifying-header-and-include-paths-manually"]], "Use libmongoc in a Microsoft Visual Studio Project": [[696, "use-libmongoc-in-a-microsoft-visual-studio-project"]], "Making a Connection": [[696, "making-a-connection"]], "Creating BSON Documents": [[696, "creating-bson-documents"]], "Appending BSON": [[696, "appending-bson"]], "Using BCON": [[696, "using-bcon"]], "Creating BSON from JSON": [[696, "creating-bson-from-json"]], "Basic CRUD Operations": [[696, "basic-crud-operations"]], "Inserting a Document": [[696, "inserting-a-document"]], "Finding a Document": [[696, "finding-a-document"]], "Updating a Document": [[696, "updating-a-document"]], "Deleting a Document": [[696, "deleting-a-document"]], "Counting Documents": [[696, "counting-documents"]], "Executing Commands": [[696, "executing-commands"]], "Threading": [[696, "threading"]], "Next Steps": [[696, "next-steps"], [697, "next-steps"]], "Using libmongoc in a Microsoft Visual Studio project": [[697, "using-libmongoc-in-a-microsoft-visual-studio-project"]], "Static linking": [[697, "static-linking"]]}, "indexentries": {"mongoc_kms_credentials_provider_callback_fn (c type)": [[208, "c.mongoc_kms_credentials_provider_callback_fn"]]}}) \ No newline at end of file diff --git a/libmongoc/1.24.0/tutorial.html b/libmongoc/1.24.0/tutorial.html new file mode 100644 index 0000000000000000000000000000000000000000..a4d69440eb02afcf5cc29107a2c645f8b1e0bffc --- /dev/null +++ b/libmongoc/1.24.0/tutorial.html @@ -0,0 +1,1109 @@ + + + + + + + + + + + + + + Tutorial — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Tutorial

    +

    This guide offers a brief introduction to the MongoDB C Driver.

    +

    For more information on the C API, please refer to the API Reference.

    + +
    +

    Installing

    +

    For detailed instructions on installing the MongoDB C Driver on a particular platform, please see the installation guide.

    +
    +
    +

    Starting MongoDB

    +

    To run the examples in this tutorial, MongoDB must be installed and running on localhost on the default port, 27017. To check if it is up and running, connect to it with the MongoDB shell.

    +
    $ mongo --host localhost --port 27017
    +MongoDB shell version: 3.0.6
    +connecting to: localhost:27017/test
    +>
    +
    +
    +
    + +
    +

    Use libmongoc in a Microsoft Visual Studio Project

    +

    See the libmongoc and Visual Studio guide.

    +
    +
    +

    Making a Connection

    +

    Access MongoDB with a mongoc_client_t. It transparently connects to standalone servers, replica sets and sharded clusters on demand. To perform operations on a database or collection, create a mongoc_database_t or mongoc_collection_t struct from the mongoc_client_t.

    +

    At the start of an application, call mongoc_init() before any other libmongoc functions. At the end, call the appropriate destroy function for each collection, database, or client handle, in reverse order from how they were constructed. Call mongoc_cleanup() before exiting.

    +

    The example below establishes a connection to a standalone server on localhost, registers the client application as “connect-example,” and performs a simple command.

    +

    More information about database operations can be found in the CRUD Operations and Executing Commands sections. Examples of connecting to replica sets and sharded clusters can be found on the Advanced Connections page.

    +
    +
    hello_mongoc.c
    +
    #include <mongoc/mongoc.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   const char *uri_string = "mongodb://localhost:27017";
    +   mongoc_uri_t *uri;
    +   mongoc_client_t *client;
    +   mongoc_database_t *database;
    +   mongoc_collection_t *collection;
    +   bson_t *command, reply, *insert;
    +   bson_error_t error;
    +   char *str;
    +   bool retval;
    +
    +   /*
    +    * Required to initialize libmongoc's internals
    +    */
    +   mongoc_init ();
    +
    +   /*
    +    * Optionally get MongoDB URI from command line
    +    */
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   /*
    +    * Safely create a MongoDB URI object from the given string
    +    */
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   /*
    +    * Create a new client instance
    +    */
    +   client = mongoc_client_new_from_uri (uri);
    +   if (!client) {
    +      return EXIT_FAILURE;
    +   }
    +
    +   /*
    +    * Register the application name so we can track it in the profile logs
    +    * on the server. This can also be done from the URI (see other examples).
    +    */
    +   mongoc_client_set_appname (client, "connect-example");
    +
    +   /*
    +    * Get a handle on the database "db_name" and collection "coll_name"
    +    */
    +   database = mongoc_client_get_database (client, "db_name");
    +   collection = mongoc_client_get_collection (client, "db_name", "coll_name");
    +
    +   /*
    +    * Do work. This example pings the database, prints the result as JSON and
    +    * performs an insert
    +    */
    +   command = BCON_NEW ("ping", BCON_INT32 (1));
    +
    +   retval = mongoc_client_command_simple (
    +      client, "admin", command, NULL, &reply, &error);
    +
    +   if (!retval) {
    +      fprintf (stderr, "%s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   str = bson_as_json (&reply, NULL);
    +   printf ("%s\n", str);
    +
    +   insert = BCON_NEW ("hello", BCON_UTF8 ("world"));
    +
    +   if (!mongoc_collection_insert_one (collection, insert, NULL, NULL, &error)) {
    +      fprintf (stderr, "%s\n", error.message);
    +   }
    +
    +   bson_destroy (insert);
    +   bson_destroy (&reply);
    +   bson_destroy (command);
    +   bson_free (str);
    +
    +   /*
    +    * Release our handles and clean up libmongoc
    +    */
    +   mongoc_collection_destroy (collection);
    +   mongoc_database_destroy (database);
    +   mongoc_uri_destroy (uri);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    +

    Creating BSON Documents

    +

    Documents are stored in MongoDB’s data format, BSON. The C driver uses libbson to create BSON documents. There are several ways to construct them: appending key-value pairs, using BCON, or parsing JSON.

    +
    +

    Appending BSON

    +

    A BSON document, represented as a bson_t in code, can be constructed one field at a time using libbson’s append functions.

    +

    For example, to create a document like this:

    +
    {
    +   born : ISODate("1906-12-09"),
    +   died : ISODate("1992-01-01"),
    +   name : {
    +      first : "Grace",
    +      last : "Hopper"
    +   },
    +   languages : [ "MATH-MATIC", "FLOW-MATIC", "COBOL" ],
    +   degrees: [ { degree: "BA", school: "Vassar" }, { degree: "PhD", school: "Yale" } ]
    +}
    +
    +
    +

    Use the following code:

    +
    #include <bson/bson.h>
    +
    +int
    +main (int   argc,
    +      char *argv[])
    +{
    +   struct tm   born = { 0 };
    +   struct tm   died = { 0 };
    +   const char *lang_names[] = {"MATH-MATIC", "FLOW-MATIC", "COBOL"};
    +   const char *schools[] = {"Vassar", "Yale"};
    +   const char *degrees[] = {"BA", "PhD"};
    +   uint32_t    i;
    +   char        buf[16];
    +   const       char *key;
    +   size_t      keylen;
    +   bson_t     *document;
    +   bson_t      child;
    +   bson_t      child2;
    +   char       *str;
    +
    +   document = bson_new ();
    +
    +   /*
    +    * Append { "born" : ISODate("1906-12-09") } to the document.
    +    * Passing -1 for the length argument tells libbson to calculate the string length.
    +    */
    +   born.tm_year = 6;  /* years are 1900-based */
    +   born.tm_mon = 11;  /* months are 0-based */
    +   born.tm_mday = 9;
    +   bson_append_date_time (document, "born", -1, mktime (&born) * 1000);
    +
    +   /*
    +    * Append { "died" : ISODate("1992-01-01") } to the document.
    +    */
    +   died.tm_year = 92;
    +   died.tm_mon = 0;
    +   died.tm_mday = 1;
    +
    +   /*
    +    * For convenience, this macro passes length -1 by default.
    +    */
    +   BSON_APPEND_DATE_TIME (document, "died", mktime (&died) * 1000);
    +
    +   /*
    +    * Append a subdocument.
    +    */
    +   BSON_APPEND_DOCUMENT_BEGIN (document, "name", &child);
    +   BSON_APPEND_UTF8 (&child, "first", "Grace");
    +   BSON_APPEND_UTF8 (&child, "last", "Hopper");
    +   bson_append_document_end (document, &child);
    +
    +   /*
    +    * Append array of strings. Generate keys "0", "1", "2".
    +    */
    +   BSON_APPEND_ARRAY_BEGIN (document, "languages", &child);
    +   for (i = 0; i < sizeof lang_names / sizeof (char *); ++i) {
    +      keylen = bson_uint32_to_string (i, &key, buf, sizeof buf);
    +      bson_append_utf8 (&child, key, (int) keylen, lang_names[i], -1);
    +   }
    +   bson_append_array_end (document, &child);
    +
    +   /*
    +    * Array of subdocuments:
    +    *    degrees: [ { degree: "BA", school: "Vassar" }, ... ]
    +    */
    +   BSON_APPEND_ARRAY_BEGIN (document, "degrees", &child);
    +   for (i = 0; i < sizeof degrees / sizeof (char *); ++i) {
    +      keylen = bson_uint32_to_string (i, &key, buf, sizeof buf);
    +      bson_append_document_begin (&child, key, (int) keylen, &child2);
    +      BSON_APPEND_UTF8 (&child2, "degree", degrees[i]);
    +      BSON_APPEND_UTF8 (&child2, "school", schools[i]);
    +      bson_append_document_end (&child, &child2);
    +   }
    +   bson_append_array_end (document, &child);
    +
    +   /*
    +    * Print the document as a JSON string.
    +    */
    +   str = bson_as_canonical_extended_json (document, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   /*
    +    * Clean up allocated bson documents.
    +    */
    +   bson_destroy (document);
    +   return 0;
    +}
    +
    +
    +

    See the libbson documentation for all of the types that can be appended to a bson_t.

    +
    +
    +

    Using BCON

    +

    BSON C Object Notation, BCON for short, is an alternative way of constructing BSON documents in a manner closer to the intended format. It has less type-safety than BSON’s append functions but results in less code.

    +
    #include <bson/bson.h>
    +
    +int
    +main (int   argc,
    +      char *argv[])
    +{
    +   struct tm born = { 0 };
    +   struct tm died = { 0 };
    +   bson_t   *document;
    +   char     *str;
    +
    +   born.tm_year = 6;
    +   born.tm_mon = 11;
    +   born.tm_mday = 9;
    +
    +   died.tm_year = 92;
    +   died.tm_mon = 0;
    +   died.tm_mday = 1;
    +
    +   document = BCON_NEW (
    +      "born", BCON_DATE_TIME (mktime (&born) * 1000),
    +      "died", BCON_DATE_TIME (mktime (&died) * 1000),
    +      "name", "{",
    +      "first", BCON_UTF8 ("Grace"),
    +      "last", BCON_UTF8 ("Hopper"),
    +      "}",
    +      "languages", "[",
    +      BCON_UTF8 ("MATH-MATIC"),
    +      BCON_UTF8 ("FLOW-MATIC"),
    +      BCON_UTF8 ("COBOL"),
    +      "]",
    +      "degrees", "[",
    +      "{", "degree", BCON_UTF8 ("BA"), "school", BCON_UTF8 ("Vassar"), "}",
    +      "{", "degree", BCON_UTF8 ("PhD"), "school", BCON_UTF8 ("Yale"), "}",
    +      "]");
    +
    +   /*
    +    * Print the document as a JSON string.
    +    */
    +   str = bson_as_canonical_extended_json (document, NULL);
    +   printf ("%s\n", str);
    +   bson_free (str);
    +
    +   /*
    +    * Clean up allocated bson documents.
    +    */
    +   bson_destroy (document);
    +   return 0;
    +}
    +
    +
    +

    Notice that BCON can create arrays, subdocuments and arbitrary fields.

    +
    +
    +

    Creating BSON from JSON

    +

    For single documents, BSON can be created from JSON strings via bson_new_from_json.

    +
    #include <bson/bson.h>
    +
    +int
    +main (int   argc,
    +      char *argv[])
    +{
    +   bson_error_t error;
    +   bson_t      *bson;
    +   char        *string;
    +
    +   const char *json = "{\"name\": {\"first\":\"Grace\", \"last\":\"Hopper\"}}";
    +   bson = bson_new_from_json ((const uint8_t *)json, -1, &error);
    +
    +   if (!bson) {
    +      fprintf (stderr, "%s\n", error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   string = bson_as_canonical_extended_json (bson, NULL);
    +   printf ("%s\n", string);
    +   bson_free (string);
    +
    +   return 0;
    +}
    +
    +
    +

    To initialize BSON from a sequence of JSON documents, use bson_json_reader_t.

    +
    +
    +
    +

    Basic CRUD Operations

    +

    This section demonstrates the basics of using the C Driver to interact with MongoDB.

    +
    +

    Inserting a Document

    +

    To insert documents into a collection, first obtain a handle to a mongoc_collection_t via a mongoc_client_t. Then, use mongoc_collection_insert_one() to add BSON documents to the collection. This example inserts into the database “mydb” and collection “mycoll”.

    +

    When finished, ensure that allocated structures are freed by using their respective destroy functions.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int   argc,
    +      char *argv[])
    +{
    +    mongoc_client_t *client;
    +    mongoc_collection_t *collection;
    +    bson_error_t error;
    +    bson_oid_t oid;
    +    bson_t *doc;
    +
    +    mongoc_init ();
    +
    +    client = mongoc_client_new ("mongodb://localhost:27017/?appname=insert-example");
    +    collection = mongoc_client_get_collection (client, "mydb", "mycoll");
    +
    +    doc = bson_new ();
    +    bson_oid_init (&oid, NULL);
    +    BSON_APPEND_OID (doc, "_id", &oid);
    +    BSON_APPEND_UTF8 (doc, "hello", "world");
    +
    +    if (!mongoc_collection_insert_one (
    +           collection, doc, NULL, NULL, &error)) {
    +        fprintf (stderr, "%s\n", error.message);
    +    }
    +
    +    bson_destroy (doc);
    +    mongoc_collection_destroy (collection);
    +    mongoc_client_destroy (client);
    +    mongoc_cleanup ();
    +
    +    return 0;
    +}
    +
    +
    +

    Compile the code and run it:

    +
    $ gcc -o insert insert.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./insert
    +
    +
    +

    On Windows:

    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 insert.c
    +C:\> insert
    +
    +
    +

    To verify that the insert succeeded, connect with the MongoDB shell.

    +
    $ mongo
    +MongoDB shell version: 3.0.6
    +connecting to: test
    +> use mydb
    +switched to db mydb
    +> db.mycoll.find()
    +{ "_id" : ObjectId("55ef43766cb5f36a3bae6ee4"), "hello" : "world" }
    +>
    +
    +
    +
    +
    +

    Finding a Document

    +

    To query a MongoDB collection with the C driver, use the function mongoc_collection_find_with_opts(). This returns a cursor to the matching documents. The following examples iterate through the result cursors and print the matches to stdout as JSON strings.

    +

    Use a document as a query specifier; for example,

    +
    { "color" : "red" }
    +
    +
    +

    will match any document with a field named “color” with value “red”. An empty document {} can be used to match all documents.

    +

    This first example uses an empty query specifier to find all documents in the database “mydb” and collection “mycoll”.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   mongoc_cursor_t *cursor;
    +   const bson_t *doc;
    +   bson_t *query;
    +   char *str;
    +
    +   mongoc_init ();
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost:27017/?appname=find-example");
    +   collection = mongoc_client_get_collection (client, "mydb", "mycoll");
    +   query = bson_new ();
    +   cursor = mongoc_collection_find_with_opts (collection, query, NULL, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   bson_destroy (query);
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +

    Compile the code and run it:

    +
    $ gcc -o find find.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./find
    +{ "_id" : { "$oid" : "55ef43766cb5f36a3bae6ee4" }, "hello" : "world" }
    +
    +
    +

    On Windows:

    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 find.c
    +C:\> find
    +{ "_id" : { "$oid" : "55ef43766cb5f36a3bae6ee4" }, "hello" : "world" }
    +
    +
    +

    To look for a specific document, add a specifier to query. This example adds a call to BSON_APPEND_UTF8() to look for all documents matching {"hello" : "world"}.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   mongoc_cursor_t *cursor;
    +   const bson_t *doc;
    +   bson_t *query;
    +   char *str;
    +
    +   mongoc_init ();
    +
    +   client = mongoc_client_new (
    +      "mongodb://localhost:27017/?appname=find-specific-example");
    +   collection = mongoc_client_get_collection (client, "mydb", "mycoll");
    +   query = bson_new ();
    +   BSON_APPEND_UTF8 (query, "hello", "world");
    +
    +   cursor = mongoc_collection_find_with_opts (collection, query, NULL, NULL);
    +
    +   while (mongoc_cursor_next (cursor, &doc)) {
    +      str = bson_as_canonical_extended_json (doc, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   }
    +
    +   bson_destroy (query);
    +   mongoc_cursor_destroy (cursor);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +
    $ gcc -o find-specific find-specific.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./find-specific
    +{ "_id" : { "$oid" : "55ef43766cb5f36a3bae6ee4" }, "hello" : "world" }
    +
    +
    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 find-specific.c
    +C:\> find-specific
    +{ "_id" : { "$oid" : "55ef43766cb5f36a3bae6ee4" }, "hello" : "world" }
    +
    +
    +
    +
    +

    Updating a Document

    +

    This code snippet gives an example of using mongoc_collection_update_one() to update the fields of a document.

    +

    Using the “mydb” database, the following example inserts an example document into the “mycoll” collection. Then, using its _id field, the document is updated with different values and a new field.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_collection_t *collection;
    +   mongoc_client_t *client;
    +   bson_error_t error;
    +   bson_oid_t oid;
    +   bson_t *doc = NULL;
    +   bson_t *update = NULL;
    +   bson_t *query = NULL;
    +
    +   mongoc_init ();
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost:27017/?appname=update-example");
    +   collection = mongoc_client_get_collection (client, "mydb", "mycoll");
    +
    +   bson_oid_init (&oid, NULL);
    +   doc = BCON_NEW ("_id", BCON_OID (&oid), "key", BCON_UTF8 ("old_value"));
    +
    +   if (!mongoc_collection_insert_one (collection, doc, NULL, &error)) {
    +      fprintf (stderr, "%s\n", error.message);
    +      goto fail;
    +   }
    +
    +   query = BCON_NEW ("_id", BCON_OID (&oid));
    +   update = BCON_NEW ("$set",
    +                      "{",
    +                      "key",
    +                      BCON_UTF8 ("new_value"),
    +                      "updated",
    +                      BCON_BOOL (true),
    +                      "}");
    +
    +   if (!mongoc_collection_update_one (
    +          collection, query, update, NULL, NULL, &error)) {
    +      fprintf (stderr, "%s\n", error.message);
    +      goto fail;
    +   }
    +
    +fail:
    +   if (doc)
    +      bson_destroy (doc);
    +   if (query)
    +      bson_destroy (query);
    +   if (update)
    +      bson_destroy (update);
    +
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +

    Compile the code and run it:

    +
    $ gcc -o update update.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./update
    +
    +
    +

    On Windows:

    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 update.c
    +C:\> update
    +{ "_id" : { "$oid" : "55ef43766cb5f36a3bae6ee4" }, "hello" : "world" }
    +
    +
    +

    To verify that the update succeeded, connect with the MongoDB shell.

    +
    $ mongo
    +MongoDB shell version: 3.0.6
    +connecting to: test
    +> use mydb
    +switched to db mydb
    +> db.mycoll.find({"updated" : true})
    +{ "_id" : ObjectId("55ef549236fe322f9490e17b"), "updated" : true, "key" : "new_value" }
    +>
    +
    +
    +
    +
    +

    Deleting a Document

    +

    This example illustrates the use of mongoc_collection_delete_one() to delete a document.

    +

    The following code inserts a sample document into the database “mydb” and collection “mycoll”. Then, it deletes all documents matching {"hello" : "world"}.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   bson_error_t error;
    +   bson_oid_t oid;
    +   bson_t *doc;
    +
    +   mongoc_init ();
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost:27017/?appname=delete-example");
    +   collection = mongoc_client_get_collection (client, "test", "test");
    +
    +   doc = bson_new ();
    +   bson_oid_init (&oid, NULL);
    +   BSON_APPEND_OID (doc, "_id", &oid);
    +   BSON_APPEND_UTF8 (doc, "hello", "world");
    +
    +   if (!mongoc_collection_insert_one (collection, doc, NULL, &error)) {
    +      fprintf (stderr, "Insert failed: %s\n", error.message);
    +   }
    +
    +   bson_destroy (doc);
    +
    +   doc = bson_new ();
    +   BSON_APPEND_OID (doc, "_id", &oid);
    +
    +   if (!mongoc_collection_delete_one (
    +          collection, doc, NULL, NULL, &error)) {
    +      fprintf (stderr, "Delete failed: %s\n", error.message);
    +   }
    +
    +   bson_destroy (doc);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +

    Compile the code and run it:

    +
    $ gcc -o delete delete.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./delete
    +
    +
    +

    On Windows:

    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 delete.c
    +C:\> delete
    +
    +
    +

    Use the MongoDB shell to prove that the documents have been removed successfully.

    +
    $ mongo
    +MongoDB shell version: 3.0.6
    +connecting to: test
    +> use mydb
    +switched to db mydb
    +> db.mycoll.count({"hello" : "world"})
    +0
    +>
    +
    +
    +
    +
    +

    Counting Documents

    +

    Counting the number of documents in a MongoDB collection is similar to performing a find operation. This example counts the number of documents matching {"hello" : "world"} in the database “mydb” and collection “mycoll”.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   mongoc_collection_t *collection;
    +   bson_error_t error;
    +   bson_t *doc;
    +   int64_t count;
    +
    +   mongoc_init ();
    +
    +   client =
    +      mongoc_client_new ("mongodb://localhost:27017/?appname=count-example");
    +   collection = mongoc_client_get_collection (client, "mydb", "mycoll");
    +   doc = bson_new_from_json (
    +      (const uint8_t *) "{\"hello\" : \"world\"}", -1, &error);
    +
    +   count = mongoc_collection_count (
    +      collection, MONGOC_QUERY_NONE, doc, 0, 0, NULL, &error);
    +
    +   if (count < 0) {
    +      fprintf (stderr, "%s\n", error.message);
    +   } else {
    +      printf ("%" PRId64 "\n", count);
    +   }
    +
    +   bson_destroy (doc);
    +   mongoc_collection_destroy (collection);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +

    Compile the code and run it:

    +
    $ gcc -o count count.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./count
    +1
    +
    +
    +

    On Windows:

    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 count.c
    +C:\> count
    +1
    +
    +
    +
    +
    +
    +

    Executing Commands

    +

    The driver provides helper functions for executing MongoDB commands on client, database and collection structures. The _simple variants return booleans indicating success or failure.

    +

    This example executes the ping command against the database “mydb”.

    +
    #include <bson/bson.h>
    +#include <mongoc/mongoc.h>
    +#include <stdio.h>
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   mongoc_client_t *client;
    +   bson_error_t error;
    +   bson_t *command;
    +   bson_t reply;
    +   char *str;
    +
    +   mongoc_init ();
    +
    +   client = mongoc_client_new (
    +      "mongodb://localhost:27017/?appname=executing-example");
    +
    +   command = BCON_NEW ("ping", BCON_INT32 (1));
    +   if (mongoc_client_command_simple (
    +          client, "mydb", command, NULL, &reply, &error)) {
    +      str = bson_as_canonical_extended_json (&reply, NULL);
    +      printf ("%s\n", str);
    +      bson_free (str);
    +   } else {
    +      fprintf (stderr, "Failed to run command: %s\n", error.message);
    +   }
    +
    +   bson_destroy (command);
    +   bson_destroy (&reply);
    +   mongoc_client_destroy (client);
    +   mongoc_cleanup ();
    +
    +   return 0;
    +}
    +
    +
    +

    Compile the code and run it:

    +
    $ gcc -o executing executing.c $(pkg-config --cflags --libs libmongoc-1.0)
    +$ ./executing
    +{ "ok" : { "$numberDouble" : "1.0" }, "$clusterTime" : { "clusterTime" : { "$timestamp" : { "t" : 1682609211, "i" : 1 } }, "signature" : { "hash" : { "$binary" : { "base64" : "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", "subType" : "00" } }, "keyId" : { "$numberLong" : "0" } } }, "operationTime" : { "$timestamp" : { "t" : 1682609211, "i" : 1 } } }
    +
    +
    +

    On Windows:

    +
    C:\> cl.exe /IC:\mongo-c-driver\include\libbson-1.0 /IC:\mongo-c-driver\include\libmongoc-1.0 executing.c
    +C:\> executing
    +{ "ok" : { "$numberDouble" : "1.0" }, "$clusterTime" : { "clusterTime" : { "$timestamp" : { "t" : 1682609211, "i" : 1 } }, "signature" : { "hash" : { "$binary" : { "base64" : "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", "subType" : "00" } }, "keyId" : { "$numberLong" : "0" } } }, "operationTime" : { "$timestamp" : { "t" : 1682609211, "i" : 1 } } }
    +
    +
    +
    +
    +

    Threading

    +

    The MongoDB C Driver is thread-unaware in the vast majority of its operations. This means it is up to the programmer to guarantee thread-safety.

    +

    However, mongoc_client_pool_t is thread-safe and is used to fetch a mongoc_client_t in a thread-safe manner. After retrieving a client from the pool, the client structure should be considered owned by the calling thread. When the thread is finished, the client should be placed back into the pool.

    +
    +
    example-pool.c
    +
    /* gcc example-pool.c -o example-pool $(pkg-config --cflags --libs
    + * libmongoc-1.0) */
    +
    +/* ./example-pool [CONNECTION_STRING] */
    +
    +#include <mongoc/mongoc.h>
    +#include <pthread.h>
    +#include <stdio.h>
    +
    +static pthread_mutex_t mutex;
    +static bool in_shutdown = false;
    +
    +static void *
    +worker (void *data)
    +{
    +   mongoc_client_pool_t *pool = data;
    +   mongoc_client_t *client;
    +   bson_t ping = BSON_INITIALIZER;
    +   bson_error_t error;
    +   bool r;
    +
    +   BSON_APPEND_INT32 (&ping, "ping", 1);
    +
    +   while (true) {
    +      client = mongoc_client_pool_pop (pool);
    +      /* Do something with client. If you are writing an HTTP server, you
    +       * probably only want to hold onto the client for the portion of the
    +       * request performing database queries.
    +       */
    +      r = mongoc_client_command_simple (
    +         client, "admin", &ping, NULL, NULL, &error);
    +
    +      if (!r) {
    +         fprintf (stderr, "%s\n", error.message);
    +      }
    +
    +      mongoc_client_pool_push (pool, client);
    +
    +      pthread_mutex_lock (&mutex);
    +      if (in_shutdown || !r) {
    +         pthread_mutex_unlock (&mutex);
    +         break;
    +      }
    +
    +      pthread_mutex_unlock (&mutex);
    +   }
    +
    +   bson_destroy (&ping);
    +   return NULL;
    +}
    +
    +int
    +main (int argc, char *argv[])
    +{
    +   const char *uri_string = "mongodb://127.0.0.1/?appname=pool-example";
    +   mongoc_uri_t *uri;
    +   bson_error_t error;
    +   mongoc_client_pool_t *pool;
    +   pthread_t threads[10];
    +   unsigned i;
    +   void *ret;
    +
    +   pthread_mutex_init (&mutex, NULL);
    +   mongoc_init ();
    +
    +   if (argc > 1) {
    +      uri_string = argv[1];
    +   }
    +
    +   uri = mongoc_uri_new_with_error (uri_string, &error);
    +   if (!uri) {
    +      fprintf (stderr,
    +               "failed to parse URI: %s\n"
    +               "error message:       %s\n",
    +               uri_string,
    +               error.message);
    +      return EXIT_FAILURE;
    +   }
    +
    +   pool = mongoc_client_pool_new (uri);
    +   mongoc_client_pool_set_error_api (pool, 2);
    +
    +   for (i = 0; i < 10; i++) {
    +      pthread_create (&threads[i], NULL, worker, pool);
    +   }
    +
    +   sleep (10);
    +   pthread_mutex_lock (&mutex);
    +   in_shutdown = true;
    +   pthread_mutex_unlock (&mutex);
    +
    +   for (i = 0; i < 10; i++) {
    +      pthread_join (threads[i], &ret);
    +   }
    +
    +   mongoc_client_pool_destroy (pool);
    +   mongoc_uri_destroy (uri);
    +
    +   mongoc_cleanup ();
    +
    +   return EXIT_SUCCESS;
    +}
    +
    +
    +
    +
    +
    +

    Next Steps

    +

    To find information on advanced topics, browse the rest of the C driver guide or the official MongoDB documentation.

    +

    For help with common issues, consult the Troubleshooting page. To report a bug or request a new feature, follow these instructions.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/1.24.0/visual-studio-guide.html b/libmongoc/1.24.0/visual-studio-guide.html new file mode 100644 index 0000000000000000000000000000000000000000..14f2d0a414a3e0b76fcb06430d4e0172f855f129 --- /dev/null +++ b/libmongoc/1.24.0/visual-studio-guide.html @@ -0,0 +1,186 @@ + + + + + + + + + + + + + + Using libmongoc in a Microsoft Visual Studio project — libmongoc 1.24.0 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Using libmongoc in a Microsoft Visual Studio project

    +

    Download and install libmongoc on your system, then open Visual Studio, select “File→New→Project…”, and create a new Win32 Console Application.

    +_images/msvc-create-project.png +

    Remember to switch the platform from 32-bit to 64-bit:

    +_images/msvc-switch-architecture.png +

    Right-click on your console application in the Solution Explorer and select “Properties”. Choose to edit properties for “All Configurations”, expand the “C/C++” options and choose “General”. Add to the “Additional Include Directories” these paths:

    +
    C:\mongo-c-driver\include\libbson-1.0
    +C:\mongo-c-driver\include\libmongoc-1.0
    +
    +
    +_images/msvc-add-include-directories.png +

    (If you chose a different CMAKE_INSTALL_PREFIX when you ran CMake, your include paths will be different.)

    +

    Also in the Properties dialog, expand the “Linker” options and choose “Input”, and add to the “Additional Dependencies” these libraries:

    +
    C:\mongo-c-driver\lib\bson-1.0.lib
    +C:\mongo-c-driver\lib\mongoc-1.0.lib
    +
    +
    +_images/msvc-add-dependencies.png +

    Adding these libraries as dependencies provides linker symbols to build your application, but to actually run it, libbson’s and libmongoc’s DLLs must be in your executable path. Select “Debugging” in the Properties dialog, and set the “Environment” option to:

    +
    PATH=c:/mongo-c-driver/bin
    +
    +
    +_images/msvc-set-path.png +

    Finally, include “mongoc/mongoc.h” in your project’s “stdafx.h”:

    +
    #include <mongoc/mongoc.h>
    +
    +
    +
    +

    Static linking

    +

    Following the instructions above, you have dynamically linked your application to the libbson and libmongoc DLLs. This is usually the right choice. If you want to link statically instead, update your “Additional Dependencies” list by removing bson-1.0.lib and mongoc-1.0.lib and replacing them with these libraries:

    +
    C:\mongo-c-driver\lib\bson-static-1.0.lib
    +C:\mongo-c-driver\lib\mongoc-static-1.0.lib
    +ws2_32.lib
    +Secur32.lib
    +Crypt32.lib
    +BCrypt.lib
    +
    +
    +_images/msvc-add-dependencies-static.png +

    (To explain the purpose of each library: bson-static-1.0.lib and mongoc-static-1.0.lib are static archives of the driver code. The socket library ws2_32 is required by libbson, which uses the socket routine gethostname to help guarantee ObjectId uniqueness. The BCrypt library is used by libmongoc for TLS connections to MongoDB, and Secur32 and Crypt32 are required for enterprise authentication methods like Kerberos.)

    +

    Finally, define two preprocessor symbols before including mongoc/mongoc.h in your stdafx.h:

    +
    #define BSON_STATIC
    +#define MONGOC_STATIC
    +#include <mongoc/mongoc.h>
    +
    +
    +

    Making these changes to your project is only required for static linking; for most people, the dynamic-linking instructions above are preferred.

    +
    +
    +

    Next Steps

    +

    Now you can build and debug applications in Visual Studio that use libbson and libmongoc. Proceed to Making a Connection in the tutorial to learn how connect to MongoDB and perform operations.

    +
    +
    + + +
    +
    +
    + +
    +
    + + + + \ No newline at end of file diff --git a/libmongoc/_static/documentation_options.js b/libmongoc/_static/documentation_options.js index a4969fc55daeb7f18a16ec726272b15dfc0064c5..eec1d8b48f6cf6f99c4baf7464abf2f323fe3786 100644 --- a/libmongoc/_static/documentation_options.js +++ b/libmongoc/_static/documentation_options.js @@ -1,6 +1,6 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '1.23.5', + VERSION: '1.24.0', LANGUAGE: 'en', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', diff --git a/libmongoc/current b/libmongoc/current index c7b21462fc8b9ce00826ee2d8a6b03cdb9ad0bea..d4370468344bcbc6fc43f88fa92bf0d4bd4c7a0a 120000 --- a/libmongoc/current +++ b/libmongoc/current @@ -1 +1 @@ -1.23.5 \ No newline at end of file +1.24.0 \ No newline at end of file diff --git a/libmongoc/index.html b/libmongoc/index.html index 5f9f06b5709950f266b14004cd115e3a79b9be46..7d1b95382198a5b26580591674a0b6f653442f43 100644 --- a/libmongoc/index.html +++ b/libmongoc/index.html @@ -21,7 +21,7 @@ delighted.survey(); - libmongoc Releases — MongoDB C Driver 1.23.5 + libmongoc Releases — MongoDB C Driver 1.24.0 @@ -52,7 +52,7 @@
  • previous |
  • - +
    @@ -62,104 +62,105 @@

    libmongoc Releases

    -

    Latest Release (1.23.5)

    +

    Latest Release (1.24.0)

    Current Development (master)

    diff --git a/objects.inv b/objects.inv index d79db0f7b6aa07d0073e7055fe3ac788cb6f167a..53c078c1880a304552f7a2618aeefe415071e88f 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/search.html b/search.html index 1f126fee25ecb57002e7cce539164d5d395a146f..f860897cedded578e4dbbade07cd0a77f0004c89 100644 --- a/search.html +++ b/search.html @@ -20,7 +20,7 @@ delighted.survey(); - Search — MongoDB C Driver 1.23.5 + Search — MongoDB C Driver 1.24.0 @@ -51,7 +51,7 @@ diff --git a/searchindex.js b/searchindex.js index 3589c75d40b62357a7140d6eb387e4995b7e5dd9..da6de2bc9760366e6e51ad201b619a0c15147a75 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["index", "libbson-releases", "libmongoc-releases"], "filenames": ["index.rst", "libbson-releases.rst", "libmongoc-releases.rst"], "titles": ["MongoDB C Driver", "libbson Releases", "libmongoc Releases"], "terms": {"A": 0, "cross": 0, "platform": 0, "client": 0, "librari": 0, "The": 0, "also": 0, "known": 0, "libmongoc": 0, "i": 0, "us": 0, "from": 0, "applic": 0, "write": 0, "higher": 0, "level": 0, "languag": 0, "It": 0, "depend": 0, "libbson": 0, "gener": 0, "pars": 0, "bson": 0, "nativ": 0, "data": 0, "format": 0, "latest": [0, 1, 2], "releas": 0, "mongo": 0, "1": [0, 1, 2], "23": [0, 1, 2], "4": [1, 2], "tar": 0, "gz": 0, "instal": 0, "tutori": 0, "refer": 0, "commun": 0, "forum": 0, "file": 0, "bug": 0, "featur": 0, "request": 0, "jira": 0, "issu": 0, "tracker": 0, "current": [1, 2], "develop": [1, 2], "master": [1, 2], "3": [1, 2], "2": [1, 2], "0": [1, 2], "22": [1, 2], "beta0": [1, 2], "21": [1, 2], "20": [1, 2], "19": [1, 2], "18": [1, 2], "alpha2": [1, 2], "alpha": [1, 2], "17": [1, 2], "7": [1, 2], "6": [1, 2], "5": [0, 1, 2], "rc0": [1, 2], "beta2": [1, 2], "beta": [1, 2], "16": [1, 2], "15": [1, 2], "14": [1, 2], "13": [1, 2], "12": [1, 2], "11": [1, 2], "10": [1, 2], "9": [1, 2], "8": [1, 2]}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"mongodb": 0, "c": 0, "driver": 0, "download": 0, "document": 0, "how": 0, "To": 0, "ask": 0, "For": 0, "help": 0, "older": 0, "version": 0, "libbson": 1, "releas": [1, 2], "libmongoc": 2}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"MongoDB C Driver": [[0, "mongodb-c-driver"]], "Download": [[0, "download"]], "Documentation": [[0, "documentation"]], "How To Ask For Help": [[0, "how-to-ask-for-help"]], "Documentation for Older Versions": [[0, "documentation-for-older-versions"]], "libbson Releases": [[1, "libbson-releases"]], "libmongoc Releases": [[2, "libmongoc-releases"]]}, "indexentries": {}}) \ No newline at end of file +Search.setIndex({"docnames": ["index", "libbson-releases", "libmongoc-releases"], "filenames": ["index.rst", "libbson-releases.rst", "libmongoc-releases.rst"], "titles": ["MongoDB C Driver", "libbson Releases", "libmongoc Releases"], "terms": {"A": 0, "cross": 0, "platform": 0, "client": 0, "librari": 0, "The": 0, "also": 0, "known": 0, "libmongoc": 0, "i": 0, "us": 0, "from": 0, "applic": 0, "write": 0, "higher": 0, "level": 0, "languag": 0, "It": 0, "depend": 0, "libbson": 0, "gener": 0, "pars": 0, "bson": 0, "nativ": 0, "data": 0, "format": 0, "latest": [0, 1, 2], "releas": 0, "mongo": 0, "1": [0, 1, 2], "23": [1, 2], "4": [1, 2], "tar": 0, "gz": 0, "instal": 0, "tutori": 0, "refer": 0, "commun": 0, "forum": 0, "file": 0, "bug": 0, "featur": 0, "request": 0, "jira": 0, "issu": 0, "tracker": 0, "current": [1, 2], "develop": [1, 2], "master": [1, 2], "3": [1, 2], "2": [1, 2], "0": [0, 1, 2], "22": [1, 2], "beta0": [1, 2], "21": [1, 2], "20": [1, 2], "19": [1, 2], "18": [1, 2], "alpha2": [1, 2], "alpha": [1, 2], "17": [1, 2], "7": [1, 2], "6": [1, 2], "5": [1, 2], "rc0": [1, 2], "beta2": [1, 2], "beta": [1, 2], "16": [1, 2], "15": [1, 2], "14": [1, 2], "13": [1, 2], "12": [1, 2], "11": [1, 2], "10": [1, 2], "9": [1, 2], "8": [1, 2], "24": [0, 1, 2]}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"mongodb": 0, "c": 0, "driver": 0, "download": 0, "document": 0, "how": 0, "To": 0, "ask": 0, "For": 0, "help": 0, "older": 0, "version": 0, "libbson": 1, "releas": [1, 2], "libmongoc": 2}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"MongoDB C Driver": [[0, "mongodb-c-driver"]], "Download": [[0, "download"]], "Documentation": [[0, "documentation"]], "How To Ask For Help": [[0, "how-to-ask-for-help"]], "Documentation for Older Versions": [[0, "documentation-for-older-versions"]], "libbson Releases": [[1, "libbson-releases"]], "libmongoc Releases": [[2, "libmongoc-releases"]]}, "indexentries": {}}) \ No newline at end of file