diff --git a/_static/documentation_options.js b/_static/documentation_options.js index db3c2d90eb65d7de854ebea94cb777e9c1f8e46e..c264ead4e26ab9dd3aff569935b1a2a35ae7bdac 100644 --- a/_static/documentation_options.js +++ b/_static/documentation_options.js @@ -1,7 +1,7 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '1.24.2', - LANGUAGE: 'None', + VERSION: '1.24.3', + LANGUAGE: 'en', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: false, diff --git a/_static/searchtools.js b/_static/searchtools.js index 41b8336776442fbc64332ffbd3d2c1ddd8b3b9c2..024ac7c430a70907a6715006dc263b4f6d1976ba 100644 --- a/_static/searchtools.js +++ b/_static/searchtools.js @@ -227,105 +227,11 @@ var Scorer = { - - -var splitChars = (function() { - var result = {}; - var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648, - 1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702, - 2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971, - 2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345, - 3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761, - 3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823, - 4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125, - 8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695, - 11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587, - 43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141]; - var i, j, start, end; - for (i = 0; i < singles.length; i++) { - result[singles[i]] = true; - } - var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709], - [722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161], - [1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568], - [1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807], - [1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047], - [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383], - [2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450], - [2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547], - [2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673], - [2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820], - [2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946], - [2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023], - [3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173], - [3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332], - [3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481], - [3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718], - [3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791], - [3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095], - [4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205], - [4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687], - [4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968], - [4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869], - [5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102], - [6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271], - [6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592], - [6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822], - [6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167], - [7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959], - [7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143], - [8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318], - [8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483], - [8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101], - [10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567], - [11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292], - [12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444], - [12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783], - [12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311], - [19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511], - [42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774], - [42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071], - [43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263], - [43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519], - [43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647], - [43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967], - [44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295], - [57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274], - [64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007], - [65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381], - [65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]]; - for (i = 0; i < ranges.length; i++) { - start = ranges[i][0]; - end = ranges[i][1]; - for (j = start; j <= end; j++) { - result[j] = true; - } - } - return result; -})(); - function splitQuery(query) { - var result = []; - var start = -1; - for (var i = 0; i < query.length; i++) { - if (splitChars[query.charCodeAt(i)]) { - if (start !== -1) { - result.push(query.slice(start, i)); - start = -1; - } - } else if (start === -1) { - start = i; - } - } - if (start !== -1) { - result.push(query.slice(start)); - } - return result; + return query.split(/\s+/); } - - /** * Search Module */ @@ -417,7 +323,7 @@ var Search = { */ query : function(query) { var i; - var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]; + var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; // stem the searchterms and add them to the correct list var stemmer = new Stemmer(); diff --git a/index.html b/index.html index 629887dfa64ec98748031f1813e3caca99737dc8..22c06cdc705a16083135f920af8946ebee262e87 100644 --- a/index.html +++ b/index.html @@ -1,11 +1,10 @@ - + - + - - + + - MongoDB C Driver — MongoDB C Driver 1.24.2 + MongoDB C Driver — MongoDB C Driver 1.24.3 + + + + - + @@ -47,7 +50,7 @@
  • next
    • -
  • MongoDB C Driver 1.24.2 »
    • +
  • MongoDB C Driver 1.24.3 »
    • @@ -55,37 +58,37 @@
    -
    -

    MongoDB C Driver

    +
    +

    MongoDB C Driver

    A Cross Platform MongoDB Client Library for C

    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.

    -
    -

    Download

    -

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

    -
    -
    -

    Documentation

    +
    +

    Download

    +

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

    +
    +
    +

    Documentation

    Installation

    Tutorial

    libmongoc reference

    libbson reference

    -
    -
    -

    How To Ask For Help

    +
    +
    +

    How To Ask For Help

    For help using the driver: MongoDB Community Forums.

    To file a bug or feature request: MongoDB Jira Issue Tracker.

    -
    -
    -

    Documentation for Older Versions

    + +
    +

    Documentation for Older Versions

    -
    -
    + +
    @@ -94,7 +97,7 @@
    © Copyright 2017, MongoDB, Inc. - Created using Sphinx 1.8.0. + Created using Sphinx 5.3.0.
    diff --git a/libbson-releases.html b/libbson-releases.html index 93ebc4138d8af7ea372196717d688994a5a164b9..6d8a03b798f7527b7b177b80fb672b7171e75aa9 100644 --- a/libbson-releases.html +++ b/libbson-releases.html @@ -1,11 +1,10 @@ - + - + - - + + - libbson Releases — MongoDB C Driver 1.24.2 + libbson Releases — MongoDB C Driver 1.24.3 + + + + - + @@ -45,7 +48,7 @@
  • previous
    • -
  • MongoDB C Driver 1.24.2 »
    • +
  • MongoDB C Driver 1.24.3 »
    • @@ -53,110 +56,111 @@
    -
    -

    libbson Releases

    -

    Latest Release (1.24.2)

    +
    +

    libbson Releases

    +

    Latest Release (1.24.3)

    Current Development (master)

    -
    +
    @@ -165,7 +169,7 @@
    © Copyright 2017, MongoDB, Inc. - Created using Sphinx 1.8.0. + Created using Sphinx 5.3.0.
    diff --git a/libbson/1.24.2/api.html b/libbson/1.24.2/api.html index bdb17f34a8fbdab6d0d250104bbdee64d3cdbed2..761d19b406956b6cebcca19c89dc71c2134458cb 100644 --- a/libbson/1.24.2/api.html +++ b/libbson/1.24.2/api.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_aligned_alloc.html b/libbson/1.24.2/bson_aligned_alloc.html index e5fd5b9ed67a4c647e9f127fbd77e56de1e91dbe..33edf2dcefcfad8d0a9d41ed96f8e88d0483d7c3 100644 --- a/libbson/1.24.2/bson_aligned_alloc.html +++ b/libbson/1.24.2/bson_aligned_alloc.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_aligned_alloc0.html b/libbson/1.24.2/bson_aligned_alloc0.html index 7c202780022154154183996cdaa93763fa6ac278..28c4782c45558a484a1a62f327aea6ba1b9f6e52 100644 --- a/libbson/1.24.2/bson_aligned_alloc0.html +++ b/libbson/1.24.2/bson_aligned_alloc0.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_array.html b/libbson/1.24.2/bson_append_array.html index ce9fc96143f05b8ebfcd358db9db37e55c059dcf..ac1d5a49c359f6b9561b182aec44b7813458bf75 100644 --- a/libbson/1.24.2/bson_append_array.html +++ b/libbson/1.24.2/bson_append_array.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_array_begin.html b/libbson/1.24.2/bson_append_array_begin.html index 46ad9d1517f4e1a087a5449fd8b6dc13d8858470..08be4e0614cfe468db6c9e60d8404339931558fa 100644 --- a/libbson/1.24.2/bson_append_array_begin.html +++ b/libbson/1.24.2/bson_append_array_begin.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_array_end.html b/libbson/1.24.2/bson_append_array_end.html index debb29951c899d99b8c360996df02d008eda1af4..2ffaa0ef00f3e240a660fb0b6afeb20076951ac1 100644 --- a/libbson/1.24.2/bson_append_array_end.html +++ b/libbson/1.24.2/bson_append_array_end.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_binary.html b/libbson/1.24.2/bson_append_binary.html index 58e1c0a7dd79b7b7fba1c7ba6b21da5464da97a0..9eac262a5147470af68973705bcaffe4986ae1d9 100644 --- a/libbson/1.24.2/bson_append_binary.html +++ b/libbson/1.24.2/bson_append_binary.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_bool.html b/libbson/1.24.2/bson_append_bool.html index aeb1f3f49795abc3f392b594bebf1a7e17471984..3fa8ff378e5ca1d48f2f9e794e2fb4d9e913ce00 100644 --- a/libbson/1.24.2/bson_append_bool.html +++ b/libbson/1.24.2/bson_append_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_code.html b/libbson/1.24.2/bson_append_code.html index 71467e2f56fe133a1e05152771964b5b0ab08b68..6944153aecf8ae2df627b4cb2b034bdb17041d7a 100644 --- a/libbson/1.24.2/bson_append_code.html +++ b/libbson/1.24.2/bson_append_code.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_code_with_scope.html b/libbson/1.24.2/bson_append_code_with_scope.html index eaf4f1fe5dd765542405fe413c87e9d572be63d5..8344d892a3183130adcb59bbdcb03a97ce71e254 100644 --- a/libbson/1.24.2/bson_append_code_with_scope.html +++ b/libbson/1.24.2/bson_append_code_with_scope.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_date_time.html b/libbson/1.24.2/bson_append_date_time.html index 94e971a8bb993534e1afbf578895f2776f17726b..3fcee6e97c50ed1ea151c4e34f1e329c4d022348 100644 --- a/libbson/1.24.2/bson_append_date_time.html +++ b/libbson/1.24.2/bson_append_date_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_dbpointer.html b/libbson/1.24.2/bson_append_dbpointer.html index 779ceb826f3e3e9c2a2f00f95cb2bcd5e0058ae5..736a7acac53e8f0911b8da3668b0b5f48aeb3e36 100644 --- a/libbson/1.24.2/bson_append_dbpointer.html +++ b/libbson/1.24.2/bson_append_dbpointer.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_decimal128.html b/libbson/1.24.2/bson_append_decimal128.html index fcd9e9b6b31724c5fa1ff87d324d906a23bae75d..93432c3f567ecbb2668f3499fc330dea17f1d5e1 100644 --- a/libbson/1.24.2/bson_append_decimal128.html +++ b/libbson/1.24.2/bson_append_decimal128.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_document.html b/libbson/1.24.2/bson_append_document.html index b59c4d0bda56544e3e1a4e4919e77487796cd1a4..42a5775f6fcd096286565b7e860ee60b3c5b6d29 100644 --- a/libbson/1.24.2/bson_append_document.html +++ b/libbson/1.24.2/bson_append_document.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_document_begin.html b/libbson/1.24.2/bson_append_document_begin.html index 8c28369939f94278796af2fc1cf94adb8aeefbd2..df853580ed3fa5afd2e906c174094f36783d07eb 100644 --- a/libbson/1.24.2/bson_append_document_begin.html +++ b/libbson/1.24.2/bson_append_document_begin.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_document_end.html b/libbson/1.24.2/bson_append_document_end.html index e868255cff2ae9037a3e28cf8c73da59fcfc9ed8..c2af9fa82ac12b6524e8cb204500220a5eb3a1ae 100644 --- a/libbson/1.24.2/bson_append_document_end.html +++ b/libbson/1.24.2/bson_append_document_end.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_double.html b/libbson/1.24.2/bson_append_double.html index 7f4e034221ca47707fe2ae4a64469ad1d5b8e186..23f2e50dbad4e045d2587df40e0c0d826418cae8 100644 --- a/libbson/1.24.2/bson_append_double.html +++ b/libbson/1.24.2/bson_append_double.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_int32.html b/libbson/1.24.2/bson_append_int32.html index 60583f604956274210728c2fa664b05aef679522..617930ff75d84bfb72f9d9b3e1ce6f2c9a1c5308 100644 --- a/libbson/1.24.2/bson_append_int32.html +++ b/libbson/1.24.2/bson_append_int32.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_int64.html b/libbson/1.24.2/bson_append_int64.html index 29e0b9fe95618df5b2441c4e68a8a383a0d13864..f71b588e19588122cc080159b95b0abf4ccda961 100644 --- a/libbson/1.24.2/bson_append_int64.html +++ b/libbson/1.24.2/bson_append_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_iter.html b/libbson/1.24.2/bson_append_iter.html index 2597fa4ddee62c2e9043f346f2bfc0a8c058fd4d..1bce28c9ab463013bedca786a0f0785753ebb06b 100644 --- a/libbson/1.24.2/bson_append_iter.html +++ b/libbson/1.24.2/bson_append_iter.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_maxkey.html b/libbson/1.24.2/bson_append_maxkey.html index f3dcb3ca9ba489611e80a872af0ffea1f0d39a23..76b3da8dea127f88de178e55af208409220d5c61 100644 --- a/libbson/1.24.2/bson_append_maxkey.html +++ b/libbson/1.24.2/bson_append_maxkey.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_minkey.html b/libbson/1.24.2/bson_append_minkey.html index 7fc04e30306922b88ece3ea345f180d36df9020e..b60aede50361e3c7901908537473fd46a4711057 100644 --- a/libbson/1.24.2/bson_append_minkey.html +++ b/libbson/1.24.2/bson_append_minkey.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_now_utc.html b/libbson/1.24.2/bson_append_now_utc.html index 39652b26fec87cc44aa280d136e73aedbc51b7f5..2ecf1caa196aa6dfc1475eb4c3744b5fb0a03b38 100644 --- a/libbson/1.24.2/bson_append_now_utc.html +++ b/libbson/1.24.2/bson_append_now_utc.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_null.html b/libbson/1.24.2/bson_append_null.html index c2b5d43caca09d04aec39b63837359ef88f7d0fe..006a23526c651929a19a75f5c2a1412913ffd5c8 100644 --- a/libbson/1.24.2/bson_append_null.html +++ b/libbson/1.24.2/bson_append_null.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_oid.html b/libbson/1.24.2/bson_append_oid.html index d14f323da808d0a8a148af6dc00da2111e7a3a74..30a71d9f06ab23e8ab9fa9fb26099e1096fd1226 100644 --- a/libbson/1.24.2/bson_append_oid.html +++ b/libbson/1.24.2/bson_append_oid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_regex.html b/libbson/1.24.2/bson_append_regex.html index ef57b7b8e10bbfe0b4e97e6d38d2ed2d7c4ca452..a901a03c35898218280230e32677d94b363325be 100644 --- a/libbson/1.24.2/bson_append_regex.html +++ b/libbson/1.24.2/bson_append_regex.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_regex_w_len.html b/libbson/1.24.2/bson_append_regex_w_len.html index 6abd6288eea50819a856ccb543c8f29971379649..8c1236fad310c3546fea1402171b01db40a00fe2 100644 --- a/libbson/1.24.2/bson_append_regex_w_len.html +++ b/libbson/1.24.2/bson_append_regex_w_len.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_symbol.html b/libbson/1.24.2/bson_append_symbol.html index a6c9b608ce55f787feb959ae0b573122135c8bae..80c421429d0b2b4ad7af1dba520dd6b2bb20f192 100644 --- a/libbson/1.24.2/bson_append_symbol.html +++ b/libbson/1.24.2/bson_append_symbol.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_time_t.html b/libbson/1.24.2/bson_append_time_t.html index 2fdf746186fd0c7748ed6ce9d0e1f422c3b95540..198cd87885abb6accd0438748258ee60c7f3034d 100644 --- a/libbson/1.24.2/bson_append_time_t.html +++ b/libbson/1.24.2/bson_append_time_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_timestamp.html b/libbson/1.24.2/bson_append_timestamp.html index 1664eec8ca0f49e1272bc5bb6c1c972c9d9c0112..0ca378a91333787304e9dbf3f60dc3c91cdd6918 100644 --- a/libbson/1.24.2/bson_append_timestamp.html +++ b/libbson/1.24.2/bson_append_timestamp.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_timeval.html b/libbson/1.24.2/bson_append_timeval.html index 74c75a179e0eac20fcfe63a0b60c18aa17d15086..92686bafcb697c1332b2654a334e7eca73c08abb 100644 --- a/libbson/1.24.2/bson_append_timeval.html +++ b/libbson/1.24.2/bson_append_timeval.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_undefined.html b/libbson/1.24.2/bson_append_undefined.html index 6cf32181c6b5dcec299b7a85c8261ea0278cf4b7..3b7ed39fe7cc55b1a45e419838f7164a053122ad 100644 --- a/libbson/1.24.2/bson_append_undefined.html +++ b/libbson/1.24.2/bson_append_undefined.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_utf8.html b/libbson/1.24.2/bson_append_utf8.html index 44908cde1969bfc0789e796f3cd20959149ede02..d7afc58903b754efea5b62cc8b6e1453681d3a0e 100644 --- a/libbson/1.24.2/bson_append_utf8.html +++ b/libbson/1.24.2/bson_append_utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_append_value.html b/libbson/1.24.2/bson_append_value.html index d472566fd0b7e00f5df13863cd88bcbf0abc95ca..defddc6b3ab54526500f9550f808494e5f9fc1d3 100644 --- a/libbson/1.24.2/bson_append_value.html +++ b/libbson/1.24.2/bson_append_value.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_array_as_canonical_extended_json.html b/libbson/1.24.2/bson_array_as_canonical_extended_json.html index 6ae73fdefa2678804178c0bea32343bc3d3d8207..c918a9c19f79521c1a9a78e76b8638660ff65a16 100644 --- a/libbson/1.24.2/bson_array_as_canonical_extended_json.html +++ b/libbson/1.24.2/bson_array_as_canonical_extended_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_array_as_json.html b/libbson/1.24.2/bson_array_as_json.html index e8e88f3ca355da27932c834d6c63bc33dc9fedfe..a5d0cf741e40cb8e9d82db1d5e176c69c3b854e2 100644 --- a/libbson/1.24.2/bson_array_as_json.html +++ b/libbson/1.24.2/bson_array_as_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_array_as_relaxed_extended_json.html b/libbson/1.24.2/bson_array_as_relaxed_extended_json.html index a3e0059397b7ad4b50a27b18e6600a85c6b4616d..4abfb2628cad485c97d3c3bc93c511f75c6c9bcd 100644 --- a/libbson/1.24.2/bson_array_as_relaxed_extended_json.html +++ b/libbson/1.24.2/bson_array_as_relaxed_extended_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_as_canonical_extended_json.html b/libbson/1.24.2/bson_as_canonical_extended_json.html index 20d9513cee1df5392d701b23141c21233eec4e71..1d1159faa8ea7adb9f9a39d7ca1af5d82b630941 100644 --- a/libbson/1.24.2/bson_as_canonical_extended_json.html +++ b/libbson/1.24.2/bson_as_canonical_extended_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_as_json.html b/libbson/1.24.2/bson_as_json.html index 6e647593f7e10b6506fe078e960b41db00c05c52..dfbdce88e745945f601b9f14afa33db11023c554 100644 --- a/libbson/1.24.2/bson_as_json.html +++ b/libbson/1.24.2/bson_as_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_as_json_with_opts.html b/libbson/1.24.2/bson_as_json_with_opts.html index 76cab5fa8053deae5484f2b90e4ac6d57b6fd2c2..b1efbddcdd5210dcc17d6176906ac70c2b4f5bf5 100644 --- a/libbson/1.24.2/bson_as_json_with_opts.html +++ b/libbson/1.24.2/bson_as_json_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_as_relaxed_extended_json.html b/libbson/1.24.2/bson_as_relaxed_extended_json.html index 1eb99573a4327ca1eb41ec4171b2d801add0e3a6..0621d6917cbab692d9de18d38527ded078f6dbff 100644 --- a/libbson/1.24.2/bson_as_relaxed_extended_json.html +++ b/libbson/1.24.2/bson_as_relaxed_extended_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_ascii_strtoll.html b/libbson/1.24.2/bson_ascii_strtoll.html index a823f04f1c51b73c2b9cc7ccf217b3401f67408a..f632aadb74b05e32aad2701a9bf7559acaea9581 100644 --- a/libbson/1.24.2/bson_ascii_strtoll.html +++ b/libbson/1.24.2/bson_ascii_strtoll.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_check_version.html b/libbson/1.24.2/bson_check_version.html index def8d3327f8767c74467543717c9db80994fe5fd..808aef6b5ec4881dd0013c0c62d288d53f7321aa 100644 --- a/libbson/1.24.2/bson_check_version.html +++ b/libbson/1.24.2/bson_check_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_compare.html b/libbson/1.24.2/bson_compare.html index 05bfc8ab8fee5fc41b51236d848eb23dbb96c67a..77c16cfb31c986a4c90d1e8e7fcbd411cb0bf2fd 100644 --- a/libbson/1.24.2/bson_compare.html +++ b/libbson/1.24.2/bson_compare.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_concat.html b/libbson/1.24.2/bson_concat.html index 3acfc9b26be009468972fa07ef9c13e151cfb427..d6524a993d58fcceb18b3b02c7ae5ee7813b60d3 100644 --- a/libbson/1.24.2/bson_concat.html +++ b/libbson/1.24.2/bson_concat.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_context_destroy.html b/libbson/1.24.2/bson_context_destroy.html index 4040d82c279019a39cd41141744158b758cc21ca..042638f49b9e8cd1435dd3541967f9a0c1826f79 100644 --- a/libbson/1.24.2/bson_context_destroy.html +++ b/libbson/1.24.2/bson_context_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_context_get_default.html b/libbson/1.24.2/bson_context_get_default.html index 74c26078cf5791df396c878a89d6bd5d4854f501..a99496b24d506e5d6776dc9b1c349c1dab772a8f 100644 --- a/libbson/1.24.2/bson_context_get_default.html +++ b/libbson/1.24.2/bson_context_get_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_context_new.html b/libbson/1.24.2/bson_context_new.html index a7c797101c6eaf6c2c145d238c6f7b0bc4ac451c..e24308facb400d8818f1313dd6824637c28d8f96 100644 --- a/libbson/1.24.2/bson_context_new.html +++ b/libbson/1.24.2/bson_context_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_context_t.html b/libbson/1.24.2/bson_context_t.html index 4d2e2bda80554ef12693cf664fdfc314a83f720a..a1c1cef6efb53e69575fc794e672850b0010bb2f 100644 --- a/libbson/1.24.2/bson_context_t.html +++ b/libbson/1.24.2/bson_context_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_copy.html b/libbson/1.24.2/bson_copy.html index 0dc899a257d913cd4a59eed0273063c0ccf3ce66..ff282025c8ca6b4029bc1d358f783f3d54a7dfa7 100644 --- a/libbson/1.24.2/bson_copy.html +++ b/libbson/1.24.2/bson_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_copy_to.html b/libbson/1.24.2/bson_copy_to.html index bf77561e3febcd1367dac930e76b843d1e70611d..518dcb660bee04cd5376d3300696574cd904a9bd 100644 --- a/libbson/1.24.2/bson_copy_to.html +++ b/libbson/1.24.2/bson_copy_to.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_copy_to_excluding.html b/libbson/1.24.2/bson_copy_to_excluding.html index c6fb64b825ca4274f95b3aa80d84fa7d89572558..997889e3c4e6198cb8faabb391bbdb3a313fb3d1 100644 --- a/libbson/1.24.2/bson_copy_to_excluding.html +++ b/libbson/1.24.2/bson_copy_to_excluding.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_copy_to_excluding_noinit.html b/libbson/1.24.2/bson_copy_to_excluding_noinit.html index 592b48b23d456173ee24c3629ff61ff165497c80..0b417abf16a90b776fae42fdbfebf3476da609fa 100644 --- a/libbson/1.24.2/bson_copy_to_excluding_noinit.html +++ b/libbson/1.24.2/bson_copy_to_excluding_noinit.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_copy_to_excluding_noinit_va.html b/libbson/1.24.2/bson_copy_to_excluding_noinit_va.html index 00e1c9d50c2700a732c4618853be8fe22b6f0bc9..c105a5677d64b3d27772bac097f16eb4c0ef9197 100644 --- a/libbson/1.24.2/bson_copy_to_excluding_noinit_va.html +++ b/libbson/1.24.2/bson_copy_to_excluding_noinit_va.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_count_keys.html b/libbson/1.24.2/bson_count_keys.html index 5eeb3533cccee521a801d8a1661904b32f8543d8..e4898790fa822c1ded28f9c356f9d3dcfaafca7c 100644 --- a/libbson/1.24.2/bson_count_keys.html +++ b/libbson/1.24.2/bson_count_keys.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_decimal128_from_string.html b/libbson/1.24.2/bson_decimal128_from_string.html index 1de2345bf3b62c9a77b1fd5fe57476eae84bad4e..e5582ded0e480ead155182be892097f3f6643c21 100644 --- a/libbson/1.24.2/bson_decimal128_from_string.html +++ b/libbson/1.24.2/bson_decimal128_from_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_decimal128_from_string_w_len.html b/libbson/1.24.2/bson_decimal128_from_string_w_len.html index 82e69cb3c8f521acc98c294cec6c08fb38fb3f5a..9af7eae06be72beff99520b6e22b52bb8dc801dc 100644 --- a/libbson/1.24.2/bson_decimal128_from_string_w_len.html +++ b/libbson/1.24.2/bson_decimal128_from_string_w_len.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_decimal128_t.html b/libbson/1.24.2/bson_decimal128_t.html index 99a5c20459942384cf922ebf3c38684c3a72b26f..2a20bda7846ee59ef990ed825fa226e2b8d6b243 100644 --- a/libbson/1.24.2/bson_decimal128_t.html +++ b/libbson/1.24.2/bson_decimal128_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_decimal128_to_string.html b/libbson/1.24.2/bson_decimal128_to_string.html index f2536dbc6231f2a568644ccb64e43c0c273739b2..e00b198e58b146ae8afdc6ebd4aa49710fa398dc 100644 --- a/libbson/1.24.2/bson_decimal128_to_string.html +++ b/libbson/1.24.2/bson_decimal128_to_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_destroy.html b/libbson/1.24.2/bson_destroy.html index 9b37c5c252d2ef2487636d15ae36c14872d816e8..123b09dd932c7aed28870462c06d96d303a289a2 100644 --- a/libbson/1.24.2/bson_destroy.html +++ b/libbson/1.24.2/bson_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_destroy_with_steal.html b/libbson/1.24.2/bson_destroy_with_steal.html index f4c10b8d74cebfa4851e61c462048deda0019654..7b20c6f179256b690a31914260854340841bc22d 100644 --- a/libbson/1.24.2/bson_destroy_with_steal.html +++ b/libbson/1.24.2/bson_destroy_with_steal.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_equal.html b/libbson/1.24.2/bson_equal.html index 2cc38fab1f36686bf6d576304683f8a4e9ff707d..abe5e427562cf3c62d29f3dddc81ed2532983802 100644 --- a/libbson/1.24.2/bson_equal.html +++ b/libbson/1.24.2/bson_equal.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_error_t.html b/libbson/1.24.2/bson_error_t.html index 537bf06abcb3b84399de63dcc8907e92389a42b4..1d4fea70c5505cb414d8262a0af0dade640fab94 100644 --- a/libbson/1.24.2/bson_error_t.html +++ b/libbson/1.24.2/bson_error_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_free.html b/libbson/1.24.2/bson_free.html index 2f321d048a839621a69de636652a3c3f3bb3c0db..66dddb162bd88847d90e784a0bccf92ec17d1bc9 100644 --- a/libbson/1.24.2/bson_free.html +++ b/libbson/1.24.2/bson_free.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_get_data.html b/libbson/1.24.2/bson_get_data.html index 012dec89717c4ee2a56df0c535a02f741a737513..d822dae37bb5dfbb7c72d7157cbb437a0da12ca2 100644 --- a/libbson/1.24.2/bson_get_data.html +++ b/libbson/1.24.2/bson_get_data.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_get_major_version.html b/libbson/1.24.2/bson_get_major_version.html index f7d2d9195d38ff54785a121c5248603bb221967e..ba8950d35ecf88d40349ac73457ce398f40b75b8 100644 --- a/libbson/1.24.2/bson_get_major_version.html +++ b/libbson/1.24.2/bson_get_major_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_get_micro_version.html b/libbson/1.24.2/bson_get_micro_version.html index 70488a6061dbcae222ecb317114a09da465da3c3..2e2dc8abde27c77fc7d47c0fbf586e03c4ec4352 100644 --- a/libbson/1.24.2/bson_get_micro_version.html +++ b/libbson/1.24.2/bson_get_micro_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_get_minor_version.html b/libbson/1.24.2/bson_get_minor_version.html index bad0b678ab9f1df15151ff76309d7bb73dfb7f1b..0ee58f50d2b953534d0e85fc818cb5b973a20b9f 100644 --- a/libbson/1.24.2/bson_get_minor_version.html +++ b/libbson/1.24.2/bson_get_minor_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_get_monotonic_time.html b/libbson/1.24.2/bson_get_monotonic_time.html index 7f3a2c1758e28d28cc2f8232e4b9b02743a3c8a7..4c6957a6d5f11eb7e1737385dd6b5b80b76bfbde 100644 --- a/libbson/1.24.2/bson_get_monotonic_time.html +++ b/libbson/1.24.2/bson_get_monotonic_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_get_version.html b/libbson/1.24.2/bson_get_version.html index 7aea4c854eb85336bbc73aff79354ef8ec777493..4ba2ec72d694f0b1d64166a3ac941aa5ae448402 100644 --- a/libbson/1.24.2/bson_get_version.html +++ b/libbson/1.24.2/bson_get_version.html @@ -36,6 +36,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_has_field.html b/libbson/1.24.2/bson_has_field.html index 4238da6ac99e5e130f8b6b7e5246dcde8e391605..29c6cdde0acad5bdb2d3b949be218f1b58449918 100644 --- a/libbson/1.24.2/bson_has_field.html +++ b/libbson/1.24.2/bson_has_field.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_init.html b/libbson/1.24.2/bson_init.html index 74ac01f98adc9d958f28329b7ef7ea986606d5dd..e17f70c30145906dadbd45f506ae49a124b8170f 100644 --- a/libbson/1.24.2/bson_init.html +++ b/libbson/1.24.2/bson_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_init_from_json.html b/libbson/1.24.2/bson_init_from_json.html index 7988a2ce4ce4772cc5b41c84d14a3705c74a5bda..6ea989b188ceb8a4f4e90961d1879354e768b494 100644 --- a/libbson/1.24.2/bson_init_from_json.html +++ b/libbson/1.24.2/bson_init_from_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_init_static.html b/libbson/1.24.2/bson_init_static.html index f4740bec0e295127ebe7eb1e1bcc8f8a163e6dcd..e52bd0e7a0a7c30f53de549f72cfd5deed264783 100644 --- a/libbson/1.24.2/bson_init_static.html +++ b/libbson/1.24.2/bson_init_static.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_isspace.html b/libbson/1.24.2/bson_isspace.html index 89be53a87a31e178f05db5ba554b5d0275ee6da5..d516bd4c30f88be86d9242d8f7fb7ab39edf0d7b 100644 --- a/libbson/1.24.2/bson_isspace.html +++ b/libbson/1.24.2/bson_isspace.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_array.html b/libbson/1.24.2/bson_iter_array.html index c0f91b00410a6e77195660ed9edd88a15e0ad0d1..84521d6b83c188e3e7696e59c1dd4f5728e44e81 100644 --- a/libbson/1.24.2/bson_iter_array.html +++ b/libbson/1.24.2/bson_iter_array.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_as_bool.html b/libbson/1.24.2/bson_iter_as_bool.html index 99518f29ff4473550050617a5c4c60b2678406c6..31d0360649916645054f03778a93fdf10a4b1fab 100644 --- a/libbson/1.24.2/bson_iter_as_bool.html +++ b/libbson/1.24.2/bson_iter_as_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_as_double.html b/libbson/1.24.2/bson_iter_as_double.html index aaea0af123c260ed29b3474010398a355194e9c4..f90782eb63895eadbeca5a4df17e3e847ee473ec 100644 --- a/libbson/1.24.2/bson_iter_as_double.html +++ b/libbson/1.24.2/bson_iter_as_double.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_as_int64.html b/libbson/1.24.2/bson_iter_as_int64.html index 178ec78334812bdbb780bd685455765f21b1ee2c..694eb036c163e16bd197b586ac1902689ef94689 100644 --- a/libbson/1.24.2/bson_iter_as_int64.html +++ b/libbson/1.24.2/bson_iter_as_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_binary.html b/libbson/1.24.2/bson_iter_binary.html index 864d68950c9cd8ef85ea559226928e011c5b0966..54209dc17719d9a9f1f847dce921a7f5d2e6944e 100644 --- a/libbson/1.24.2/bson_iter_binary.html +++ b/libbson/1.24.2/bson_iter_binary.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_bool.html b/libbson/1.24.2/bson_iter_bool.html index 72159b972fc617fc846a5858552db9ba725db0f2..0d4a4072005474f634b9db808be4f69d58ec79a6 100644 --- a/libbson/1.24.2/bson_iter_bool.html +++ b/libbson/1.24.2/bson_iter_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_code.html b/libbson/1.24.2/bson_iter_code.html index e942ce647d461fede2f626ca1314b8a786a2b9c4..7bee45c51b41e29a0ea25993a683c3d9ec53db8d 100644 --- a/libbson/1.24.2/bson_iter_code.html +++ b/libbson/1.24.2/bson_iter_code.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_codewscope.html b/libbson/1.24.2/bson_iter_codewscope.html index 8ef7f456dff88d732d39c680c2208d275cb69b54..d1a072b7c812133f84e7dd11d7e8c4d73e8f263a 100644 --- a/libbson/1.24.2/bson_iter_codewscope.html +++ b/libbson/1.24.2/bson_iter_codewscope.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_date_time.html b/libbson/1.24.2/bson_iter_date_time.html index 40d440832811a3aa07139d967180c164d76bfb9b..7a3ec5728ff41d5129394def764ce30dfe73b3d4 100644 --- a/libbson/1.24.2/bson_iter_date_time.html +++ b/libbson/1.24.2/bson_iter_date_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_dbpointer.html b/libbson/1.24.2/bson_iter_dbpointer.html index 5473c392d1d89e0ef0458560f195dfebac3fbd11..0aacb33511ae5bbb4c252cc84261e5fbe677e1ab 100644 --- a/libbson/1.24.2/bson_iter_dbpointer.html +++ b/libbson/1.24.2/bson_iter_dbpointer.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_decimal128.html b/libbson/1.24.2/bson_iter_decimal128.html index eedaedc0b50341370be541e20ee26b3a05f63f1b..6cc5aaf2df396c07c4f09b8f38ff6511824d6170 100644 --- a/libbson/1.24.2/bson_iter_decimal128.html +++ b/libbson/1.24.2/bson_iter_decimal128.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_document.html b/libbson/1.24.2/bson_iter_document.html index 5d6c2c734fec6242af0566a84747af69888176e0..deb6266295e20b7b8b12b4a2de4bb83158e3570e 100644 --- a/libbson/1.24.2/bson_iter_document.html +++ b/libbson/1.24.2/bson_iter_document.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_double.html b/libbson/1.24.2/bson_iter_double.html index 853695b327fa545dc427dc31e0285c3c6fa10f1b..f9d0726c461c3949569310d355ae4d06c783e5ee 100644 --- a/libbson/1.24.2/bson_iter_double.html +++ b/libbson/1.24.2/bson_iter_double.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_dup_utf8.html b/libbson/1.24.2/bson_iter_dup_utf8.html index 44af251bfc5e7888b0e63430d8d4439bd14c02d7..3a5fb1f773b617748aa61f772b8156366f21b33a 100644 --- a/libbson/1.24.2/bson_iter_dup_utf8.html +++ b/libbson/1.24.2/bson_iter_dup_utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_find.html b/libbson/1.24.2/bson_iter_find.html index 4c8460e6bb7bd594deb71c157474f58cc3fdfc06..22941bc7ce79351a3b1b83f068f1ad52669d63f8 100644 --- a/libbson/1.24.2/bson_iter_find.html +++ b/libbson/1.24.2/bson_iter_find.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_find_case.html b/libbson/1.24.2/bson_iter_find_case.html index 015f5c5e32ea112dff5dc38035a20c71de0f38ea..8cdbdac100b011f56f41053d2c509b719f4400d7 100644 --- a/libbson/1.24.2/bson_iter_find_case.html +++ b/libbson/1.24.2/bson_iter_find_case.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_find_descendant.html b/libbson/1.24.2/bson_iter_find_descendant.html index 5ffd15902805756e84b7aa0c97b8ac0502d1316d..74940b29fdf70f0425322afb0c4aa78b4d731eb2 100644 --- a/libbson/1.24.2/bson_iter_find_descendant.html +++ b/libbson/1.24.2/bson_iter_find_descendant.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_find_w_len.html b/libbson/1.24.2/bson_iter_find_w_len.html index 455cdf8dde58aacd8fd464283a794bb2bf99b79d..d4b159bac9260c35e5e6b4de7bc28664de61dd89 100644 --- a/libbson/1.24.2/bson_iter_find_w_len.html +++ b/libbson/1.24.2/bson_iter_find_w_len.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_init.html b/libbson/1.24.2/bson_iter_init.html index ccfe3c0d8e523ee9b91df2fca7bd995f0108e423..1e4de2fb8f28b4bff531761a909072a4c7e52873 100644 --- a/libbson/1.24.2/bson_iter_init.html +++ b/libbson/1.24.2/bson_iter_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_init_find.html b/libbson/1.24.2/bson_iter_init_find.html index d25edddad8a82b899a9d4d77de498ffde99677e1..e6029f3f58c6b44fa19c5b59913eadda6b524409 100644 --- a/libbson/1.24.2/bson_iter_init_find.html +++ b/libbson/1.24.2/bson_iter_init_find.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_init_find_case.html b/libbson/1.24.2/bson_iter_init_find_case.html index 95fcd1cf38ac8ed64f2e0bd64c8063ec75b6d4ff..229f88449d6e5c4a3c9ef4fbdc801c6342fd579c 100644 --- a/libbson/1.24.2/bson_iter_init_find_case.html +++ b/libbson/1.24.2/bson_iter_init_find_case.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_init_find_w_len.html b/libbson/1.24.2/bson_iter_init_find_w_len.html index d0282272a5760c09a7b06124c948dd7661507131..a205964c3aede5c978c82252259c79175738fe27 100644 --- a/libbson/1.24.2/bson_iter_init_find_w_len.html +++ b/libbson/1.24.2/bson_iter_init_find_w_len.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_init_from_data.html b/libbson/1.24.2/bson_iter_init_from_data.html index 66b10a7032519fa2478956d44a3f09b60a051e3e..b6d2e0319d2fb8de9d38b2c527120fee311d1a2d 100644 --- a/libbson/1.24.2/bson_iter_init_from_data.html +++ b/libbson/1.24.2/bson_iter_init_from_data.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_init_from_data_at_offset.html b/libbson/1.24.2/bson_iter_init_from_data_at_offset.html index ae5d3c42dbfbfc53a702098b9abf9fce27de5d26..09fb5a1a81279c86185304551cacd3791d682682 100644 --- a/libbson/1.24.2/bson_iter_init_from_data_at_offset.html +++ b/libbson/1.24.2/bson_iter_init_from_data_at_offset.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_int32.html b/libbson/1.24.2/bson_iter_int32.html index 9e1ca752ae0d6e0c03bd9eccc8bf9dc103beb662..9333c681d03c9131f0ebab2d23513b1a941380aa 100644 --- a/libbson/1.24.2/bson_iter_int32.html +++ b/libbson/1.24.2/bson_iter_int32.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_int64.html b/libbson/1.24.2/bson_iter_int64.html index 621be70070569e6625761c95a2eaacf8c60e82df..8ac5a1f5fc2a770fc4add4d22402a5525f327ee5 100644 --- a/libbson/1.24.2/bson_iter_int64.html +++ b/libbson/1.24.2/bson_iter_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_key.html b/libbson/1.24.2/bson_iter_key.html index 3f657c9c32590f3330de1ac2281718bc2744c1bd..361c6e6e80fb22c314da769217a3d2e4818d199b 100644 --- a/libbson/1.24.2/bson_iter_key.html +++ b/libbson/1.24.2/bson_iter_key.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_key_len.html b/libbson/1.24.2/bson_iter_key_len.html index a7a6c4444274aec5e388d15729ef09ef6e00667b..23464cf0866dcb171db62826708c00f7915c5ea1 100644 --- a/libbson/1.24.2/bson_iter_key_len.html +++ b/libbson/1.24.2/bson_iter_key_len.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_next.html b/libbson/1.24.2/bson_iter_next.html index ac4e9df7eda2b3215d42df6201af9e5e4dbb27d7..d39451a43502205c582e59e77058f72308eba3e2 100644 --- a/libbson/1.24.2/bson_iter_next.html +++ b/libbson/1.24.2/bson_iter_next.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_offset.html b/libbson/1.24.2/bson_iter_offset.html index 3d55b51def3b11cdda62ff81a3229b7950b971f5..01e9f76d1b743014e9478c549bc0da8f2688f062 100644 --- a/libbson/1.24.2/bson_iter_offset.html +++ b/libbson/1.24.2/bson_iter_offset.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_oid.html b/libbson/1.24.2/bson_iter_oid.html index 9a5538147ca949b0a7889d44b99ad8e2d31be11a..c34d5dbf19e418a1136a91294d1315b3c9d0bc55 100644 --- a/libbson/1.24.2/bson_iter_oid.html +++ b/libbson/1.24.2/bson_iter_oid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_bool.html b/libbson/1.24.2/bson_iter_overwrite_bool.html index 53ff616545603fdb68bb51052c20371deb3dcfca..0297e7aaec4e79345470298de1184295dbf2f7f1 100644 --- a/libbson/1.24.2/bson_iter_overwrite_bool.html +++ b/libbson/1.24.2/bson_iter_overwrite_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_date_time.html b/libbson/1.24.2/bson_iter_overwrite_date_time.html index d4d1128570a37b2401b51fa46e2906762587a6c5..6493859dffc5c59bfb99a1a32c55bcb24a0e38d3 100644 --- a/libbson/1.24.2/bson_iter_overwrite_date_time.html +++ b/libbson/1.24.2/bson_iter_overwrite_date_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_decimal128.html b/libbson/1.24.2/bson_iter_overwrite_decimal128.html index e7fbc8b336ef73bed60bb626dab8e57cb2dfa1c1..5d80cc128fa1214d63c9ba7e5f92946b8b8b91f4 100644 --- a/libbson/1.24.2/bson_iter_overwrite_decimal128.html +++ b/libbson/1.24.2/bson_iter_overwrite_decimal128.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_double.html b/libbson/1.24.2/bson_iter_overwrite_double.html index 9227cf467c2c133a08f6eedf745a566fec2468d2..3d9142c5fd95f2848e47e8250ab66e4a9043b12f 100644 --- a/libbson/1.24.2/bson_iter_overwrite_double.html +++ b/libbson/1.24.2/bson_iter_overwrite_double.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_int32.html b/libbson/1.24.2/bson_iter_overwrite_int32.html index 00871df6b4c4d04d1b5ec57bd5f6fdbd4da12a53..d268269c63be003ad5d9833aad7f117f1e74c367 100644 --- a/libbson/1.24.2/bson_iter_overwrite_int32.html +++ b/libbson/1.24.2/bson_iter_overwrite_int32.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_int64.html b/libbson/1.24.2/bson_iter_overwrite_int64.html index 1822b7994dbab68ee99d1052452083135a8a2375..4cb11da80c0b22147d284bd989f5fdd9efc88290 100644 --- a/libbson/1.24.2/bson_iter_overwrite_int64.html +++ b/libbson/1.24.2/bson_iter_overwrite_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_oid.html b/libbson/1.24.2/bson_iter_overwrite_oid.html index eb414c43396f6a51d4c4cb4686ad66bac2b8117c..4ed914e012dc69637225b5bfc3bf989fe8c8c16f 100644 --- a/libbson/1.24.2/bson_iter_overwrite_oid.html +++ b/libbson/1.24.2/bson_iter_overwrite_oid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_overwrite_timestamp.html b/libbson/1.24.2/bson_iter_overwrite_timestamp.html index 4d2528cb28442a7d823453bf293e0aa819ee7d22..fca20a9337765d4c803f9e481b659f12e3d7a4e3 100644 --- a/libbson/1.24.2/bson_iter_overwrite_timestamp.html +++ b/libbson/1.24.2/bson_iter_overwrite_timestamp.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_recurse.html b/libbson/1.24.2/bson_iter_recurse.html index e5962d3587e4ce2d405889fa4f0ec660492a3cf6..71268754ace5c7347e4d598f82c6ab3de2a3f122 100644 --- a/libbson/1.24.2/bson_iter_recurse.html +++ b/libbson/1.24.2/bson_iter_recurse.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_regex.html b/libbson/1.24.2/bson_iter_regex.html index 37afdf7262dd98fd21d4da37de93ae9d370d6957..ee5c0e79c5b5da2e14159e8c967244f5e8a57fce 100644 --- a/libbson/1.24.2/bson_iter_regex.html +++ b/libbson/1.24.2/bson_iter_regex.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_symbol.html b/libbson/1.24.2/bson_iter_symbol.html index 836df5b6c3d6cbe750e7801bb5cf98f1586ccc85..f32ce54168bd1ce4cbbcf3d44de88902fe8bd036 100644 --- a/libbson/1.24.2/bson_iter_symbol.html +++ b/libbson/1.24.2/bson_iter_symbol.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_t.html b/libbson/1.24.2/bson_iter_t.html index f154e122597da5598557d1b5948ad6300eb4ac2d..1b6f7ec0d9424385f4b01ea7514ca0ad288c4e17 100644 --- a/libbson/1.24.2/bson_iter_t.html +++ b/libbson/1.24.2/bson_iter_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_time_t.html b/libbson/1.24.2/bson_iter_time_t.html index 1654dc619db489e659f62dc8485ffd916edfa391..c4178e0b71aa5233fa3a37d33b8675ad912592a4 100644 --- a/libbson/1.24.2/bson_iter_time_t.html +++ b/libbson/1.24.2/bson_iter_time_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_timestamp.html b/libbson/1.24.2/bson_iter_timestamp.html index 9fcad5f1c5a97205766f544f5aa494ca53e35d23..2ded54bc9537b24cb6b10061f6ac800ac354dcf0 100644 --- a/libbson/1.24.2/bson_iter_timestamp.html +++ b/libbson/1.24.2/bson_iter_timestamp.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_timeval.html b/libbson/1.24.2/bson_iter_timeval.html index 3818523423cd6246f28667ba64588c7361de1e7c..afcec660ae97e224df9e4b23532025e5219ed8c2 100644 --- a/libbson/1.24.2/bson_iter_timeval.html +++ b/libbson/1.24.2/bson_iter_timeval.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_type.html b/libbson/1.24.2/bson_iter_type.html index 44365c500fb01dc360f609b867bc3eee9b7bf15b..cb9a702e0d4d2ae5aa7bc48670efab30dd9e5447 100644 --- a/libbson/1.24.2/bson_iter_type.html +++ b/libbson/1.24.2/bson_iter_type.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_utf8.html b/libbson/1.24.2/bson_iter_utf8.html index 3bb0660bbb442b4a616957d080964620e75d9e0a..77f1d98f8727890419a6e4c9edd2845257682427 100644 --- a/libbson/1.24.2/bson_iter_utf8.html +++ b/libbson/1.24.2/bson_iter_utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_value.html b/libbson/1.24.2/bson_iter_value.html index 8043e62b3ef5342f818cb49c223840fa5fc1f265..9152c4d7d21c44824bbb0fe98c8cb74913ca38a5 100644 --- a/libbson/1.24.2/bson_iter_value.html +++ b/libbson/1.24.2/bson_iter_value.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_iter_visit_all.html b/libbson/1.24.2/bson_iter_visit_all.html index 2b75b755d60c2c4e93b281d1e0755dc500b8fd32..8be6d8ff0a598aaa7e0ce1e653e4403eb26a173b 100644 --- a/libbson/1.24.2/bson_iter_visit_all.html +++ b/libbson/1.24.2/bson_iter_visit_all.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_data_reader_ingest.html b/libbson/1.24.2/bson_json_data_reader_ingest.html index 4562bcb508020762f1d2c9dc8c469785259f48e1..5606c052907217b333199cbfea1a8e230df0f5b8 100644 --- a/libbson/1.24.2/bson_json_data_reader_ingest.html +++ b/libbson/1.24.2/bson_json_data_reader_ingest.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_data_reader_new.html b/libbson/1.24.2/bson_json_data_reader_new.html index cc379749fa8c2703422bdd4a6d312d31b5bcc19b..f985f92f3b5caad4ec70b001393c7d652924debf 100644 --- a/libbson/1.24.2/bson_json_data_reader_new.html +++ b/libbson/1.24.2/bson_json_data_reader_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_mode_t.html b/libbson/1.24.2/bson_json_mode_t.html index 69561ebaa9a59c44d9f4ea2b07d3c55e01a2972a..feb8caf8e138bbb7407f03a422e1d77a3b29b1c5 100644 --- a/libbson/1.24.2/bson_json_mode_t.html +++ b/libbson/1.24.2/bson_json_mode_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_opts_destroy.html b/libbson/1.24.2/bson_json_opts_destroy.html index 80ae8acb0b99e54b5d183fa86498038ff45e3ebe..b52344e152e1b6cb0a34df09f883c346044dfd7f 100644 --- a/libbson/1.24.2/bson_json_opts_destroy.html +++ b/libbson/1.24.2/bson_json_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_opts_new.html b/libbson/1.24.2/bson_json_opts_new.html index 597dbddf47109957b0e6898270d984c52876edcb..83d44bbc1c67a245c4e8a8d5d7cf40f6cd9d0c50 100644 --- a/libbson/1.24.2/bson_json_opts_new.html +++ b/libbson/1.24.2/bson_json_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_opts_set_outermost_array.html b/libbson/1.24.2/bson_json_opts_set_outermost_array.html index 5f72e02dea323ead3396e2c6fad49cf91450a6e4..4a17700f318da571509e6b07d10fcc8ea58cf6e3 100644 --- a/libbson/1.24.2/bson_json_opts_set_outermost_array.html +++ b/libbson/1.24.2/bson_json_opts_set_outermost_array.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_opts_t.html b/libbson/1.24.2/bson_json_opts_t.html index ceeb4cf71b41e4ec544285b7be735939d0b4d67b..eab5fd606bcdd954c812870c1e1a29bd29b480e1 100644 --- a/libbson/1.24.2/bson_json_opts_t.html +++ b/libbson/1.24.2/bson_json_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_reader_destroy.html b/libbson/1.24.2/bson_json_reader_destroy.html index 43bded1d8623c76b0e60d976eb421c396292e5b5..8dd7cd795405cc1fdd0033b82a4776616211089d 100644 --- a/libbson/1.24.2/bson_json_reader_destroy.html +++ b/libbson/1.24.2/bson_json_reader_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_reader_new.html b/libbson/1.24.2/bson_json_reader_new.html index 25d73c31d8ba318f361b86c0a2d790382f30b026..b75286336e51a8f1a4e6ff515b9e67b0ece5bf47 100644 --- a/libbson/1.24.2/bson_json_reader_new.html +++ b/libbson/1.24.2/bson_json_reader_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_reader_new_from_fd.html b/libbson/1.24.2/bson_json_reader_new_from_fd.html index e4959a5f339afdbd5a8fa79eee435478628456d8..0f2c67beea26b6a35935826fc24fbf7cd00a884c 100644 --- a/libbson/1.24.2/bson_json_reader_new_from_fd.html +++ b/libbson/1.24.2/bson_json_reader_new_from_fd.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_reader_new_from_file.html b/libbson/1.24.2/bson_json_reader_new_from_file.html index f86f015ac5a996c7cbcdb6195fc46e2141745bb4..3b9fccbfd0c66e45990716fbdb465744ffcab7b6 100644 --- a/libbson/1.24.2/bson_json_reader_new_from_file.html +++ b/libbson/1.24.2/bson_json_reader_new_from_file.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_reader_read.html b/libbson/1.24.2/bson_json_reader_read.html index 564f3c226e0e295f6c56a0430229e05ab300f28f..bfff51cc8da4e4a71f535e7bbc8d01c9fb8faa2a 100644 --- a/libbson/1.24.2/bson_json_reader_read.html +++ b/libbson/1.24.2/bson_json_reader_read.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_json_reader_t.html b/libbson/1.24.2/bson_json_reader_t.html index 0c98d58803b8ea139c0dfd16395c52e33c40cd8a..06183732e8641de425b6406f7093feecefae2972 100644 --- a/libbson/1.24.2/bson_json_reader_t.html +++ b/libbson/1.24.2/bson_json_reader_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_malloc.html b/libbson/1.24.2/bson_malloc.html index a3ecf0bb8a3e3013a0066ec7bfdfe4e4ce0ab460..deaab218f185a40f700f3575d01cac576194b560 100644 --- a/libbson/1.24.2/bson_malloc.html +++ b/libbson/1.24.2/bson_malloc.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_malloc0.html b/libbson/1.24.2/bson_malloc0.html index 000f2b8e5be937425618770507f789c2816d1723..e5d285914bb202042df028cf2497a262d9f48e12 100644 --- a/libbson/1.24.2/bson_malloc0.html +++ b/libbson/1.24.2/bson_malloc0.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_mem_restore_vtable.html b/libbson/1.24.2/bson_mem_restore_vtable.html index c089579800cb1baa9ba681023717cd82f5963205..4bd0973c1eb2868d5f62044a9b3201f784608657 100644 --- a/libbson/1.24.2/bson_mem_restore_vtable.html +++ b/libbson/1.24.2/bson_mem_restore_vtable.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_mem_set_vtable.html b/libbson/1.24.2/bson_mem_set_vtable.html index 4db9dfe0712ccb5a60b128c9490b552120da482d..976c3459f9010faf8efcd6e559fa2c5cf4b2e89b 100644 --- a/libbson/1.24.2/bson_mem_set_vtable.html +++ b/libbson/1.24.2/bson_mem_set_vtable.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_memory.html b/libbson/1.24.2/bson_memory.html index fddb48573657054b8b4ff29831286c218c533270..ddb87dc1a3571842fa55b48e1f00e31e9b5b26b6 100644 --- a/libbson/1.24.2/bson_memory.html +++ b/libbson/1.24.2/bson_memory.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_new.html b/libbson/1.24.2/bson_new.html index be6ca54ee6364100668f010cbb7ac03c498d6a32..9ed1bc7678b47e601eb095229118e84b4d12630d 100644 --- a/libbson/1.24.2/bson_new.html +++ b/libbson/1.24.2/bson_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_new_from_buffer.html b/libbson/1.24.2/bson_new_from_buffer.html index 79cff3d47b0d8ff6f8bb771e9b8b8d51112a694d..80d2b822d02383c1e8ef86407229d2cd92860b07 100644 --- a/libbson/1.24.2/bson_new_from_buffer.html +++ b/libbson/1.24.2/bson_new_from_buffer.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_new_from_data.html b/libbson/1.24.2/bson_new_from_data.html index 1da3afc67fbe45340a00e129fa41cdf17e172ca2..bb2fe18620ab04776cf20d3e57c3853a7be94ae0 100644 --- a/libbson/1.24.2/bson_new_from_data.html +++ b/libbson/1.24.2/bson_new_from_data.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_new_from_json.html b/libbson/1.24.2/bson_new_from_json.html index f06bec1c027ae5d26cf56c841ec0482513e7e5de..dd7ae098fe400c38a8c0d016d9c25df99c24918e 100644 --- a/libbson/1.24.2/bson_new_from_json.html +++ b/libbson/1.24.2/bson_new_from_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_compare.html b/libbson/1.24.2/bson_oid_compare.html index 65b6bcd454a3b91e80c2e2e37091debc3a391a5d..d807067be8c24a2074238a9c35e36cfc8db4f827 100644 --- a/libbson/1.24.2/bson_oid_compare.html +++ b/libbson/1.24.2/bson_oid_compare.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_copy.html b/libbson/1.24.2/bson_oid_copy.html index fc555d757560952bfee6349c3aa2306de62e357c..0389ec97f69dca3387f5a522958345348e8ee474 100644 --- a/libbson/1.24.2/bson_oid_copy.html +++ b/libbson/1.24.2/bson_oid_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_equal.html b/libbson/1.24.2/bson_oid_equal.html index 1cd1b3372e265664f6360ef34a897eb8ed135328..e2527d294eb6935dc4a622333b69cdda3f0c3893 100644 --- a/libbson/1.24.2/bson_oid_equal.html +++ b/libbson/1.24.2/bson_oid_equal.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_get_time_t.html b/libbson/1.24.2/bson_oid_get_time_t.html index a89e7b04e6eec24c534d1468341376e05cc22c75..7d23ed5c04c628f01ef56532f94540ccbddcbc2c 100644 --- a/libbson/1.24.2/bson_oid_get_time_t.html +++ b/libbson/1.24.2/bson_oid_get_time_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_hash.html b/libbson/1.24.2/bson_oid_hash.html index 8e0e52d5399d43304ac66c4d9abe4819165a130b..85bd0b96edb34e0f6cc48462dd986d1462044c42 100644 --- a/libbson/1.24.2/bson_oid_hash.html +++ b/libbson/1.24.2/bson_oid_hash.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_init.html b/libbson/1.24.2/bson_oid_init.html index d7476280bef15a2c94409bd6fc3d8db3878b2f58..38e430800ffaeca369401bcf7b7fbc41f450936a 100644 --- a/libbson/1.24.2/bson_oid_init.html +++ b/libbson/1.24.2/bson_oid_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_init_from_data.html b/libbson/1.24.2/bson_oid_init_from_data.html index c03b16b020db0603c81bdc6626e5398eb733159d..2a0b843118d44b09213f1bda4175011c235cb187 100644 --- a/libbson/1.24.2/bson_oid_init_from_data.html +++ b/libbson/1.24.2/bson_oid_init_from_data.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_init_from_string.html b/libbson/1.24.2/bson_oid_init_from_string.html index 33b06e520d3cb8cae3dd27987c7ef5137c727700..3b267266dfccdd0ce4f2b526898e5e6cba0ebbef 100644 --- a/libbson/1.24.2/bson_oid_init_from_string.html +++ b/libbson/1.24.2/bson_oid_init_from_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_init_sequence.html b/libbson/1.24.2/bson_oid_init_sequence.html index 5aadd159caa22b50b7981d4d1175b67c185665ff..d7c93a25c63df13f63e67bec70b94db11730a113 100644 --- a/libbson/1.24.2/bson_oid_init_sequence.html +++ b/libbson/1.24.2/bson_oid_init_sequence.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_is_valid.html b/libbson/1.24.2/bson_oid_is_valid.html index 0687d72a5edf3bb482fa00c33d637fa77780bf5c..154050f280c1014517f054f740ff8143a784207e 100644 --- a/libbson/1.24.2/bson_oid_is_valid.html +++ b/libbson/1.24.2/bson_oid_is_valid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_t.html b/libbson/1.24.2/bson_oid_t.html index c4b6189aedc8e1d65fbda8a5cd1aad0f7251976c..23e28301327d643c96dd959dfce3ccfbd6474e5c 100644 --- a/libbson/1.24.2/bson_oid_t.html +++ b/libbson/1.24.2/bson_oid_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_oid_to_string.html b/libbson/1.24.2/bson_oid_to_string.html index 0aa351e8da810ba2d1c2dcb6707b0dcac4281d88..bf5539738ef630fb83e1c283d6ea74c6684f655d 100644 --- a/libbson/1.24.2/bson_oid_to_string.html +++ b/libbson/1.24.2/bson_oid_to_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_destroy.html b/libbson/1.24.2/bson_reader_destroy.html index 7021f1b48bb07372a01e449402e917fe27e441dc..2c93f556347ff43b3e742120e5677f642c4a7b72 100644 --- a/libbson/1.24.2/bson_reader_destroy.html +++ b/libbson/1.24.2/bson_reader_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_destroy_func_t.html b/libbson/1.24.2/bson_reader_destroy_func_t.html index cfabcbfae0712777f292384818cfae974374324c..1daf10c945d128911d6e60f5f5faf9e48afdc514 100644 --- a/libbson/1.24.2/bson_reader_destroy_func_t.html +++ b/libbson/1.24.2/bson_reader_destroy_func_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_new_from_data.html b/libbson/1.24.2/bson_reader_new_from_data.html index bb0ec483afe2309c10a911933480828f6a46fc42..ee23e8c1e9004a286fca7419631acb1d46acf0d8 100644 --- a/libbson/1.24.2/bson_reader_new_from_data.html +++ b/libbson/1.24.2/bson_reader_new_from_data.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_new_from_fd.html b/libbson/1.24.2/bson_reader_new_from_fd.html index 7d666c34b8371b8b06c3a51d807ac2647e8a527b..59b71921ff779e246060cf4b6534fc3a7424335b 100644 --- a/libbson/1.24.2/bson_reader_new_from_fd.html +++ b/libbson/1.24.2/bson_reader_new_from_fd.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_new_from_file.html b/libbson/1.24.2/bson_reader_new_from_file.html index 6cfabcdc7c7cf8d7e2f2e6bbbd50bf16cd9727c2..e52bba45f733fcc4fa165380970a504495d15a16 100644 --- a/libbson/1.24.2/bson_reader_new_from_file.html +++ b/libbson/1.24.2/bson_reader_new_from_file.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_new_from_handle.html b/libbson/1.24.2/bson_reader_new_from_handle.html index 2e703ff133478b43eccdee201306500ec8ef4a5d..92ab8c1f0dd74ada5b1331132d80332ab0f8fbab 100644 --- a/libbson/1.24.2/bson_reader_new_from_handle.html +++ b/libbson/1.24.2/bson_reader_new_from_handle.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_read.html b/libbson/1.24.2/bson_reader_read.html index 67d7e69f02ea59bfb6423ea98d16441e2bb7493f..972306a0af8009bdd5712ca8e99af1a7cf7dbb65 100644 --- a/libbson/1.24.2/bson_reader_read.html +++ b/libbson/1.24.2/bson_reader_read.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_read_func_t.html b/libbson/1.24.2/bson_reader_read_func_t.html index 54ca67256ef6baef795ac8e972e33420ecab4cd6..b029b982ce704b606ee2786c6e18df33e3f0c73a 100644 --- a/libbson/1.24.2/bson_reader_read_func_t.html +++ b/libbson/1.24.2/bson_reader_read_func_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_reset.html b/libbson/1.24.2/bson_reader_reset.html index cd0aed9f935e336336f7d398d08c0f6cb8bd1c02..64fdb3903bdc369511e120bcbee3dda30c8051b4 100644 --- a/libbson/1.24.2/bson_reader_reset.html +++ b/libbson/1.24.2/bson_reader_reset.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_set_destroy_func.html b/libbson/1.24.2/bson_reader_set_destroy_func.html index c84eb8dc16fecade8ea7461f72c2c784548c7242..92cc2d2fc35e0a9b0ad27d8ea96cc00d3120c1b8 100644 --- a/libbson/1.24.2/bson_reader_set_destroy_func.html +++ b/libbson/1.24.2/bson_reader_set_destroy_func.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_set_read_func.html b/libbson/1.24.2/bson_reader_set_read_func.html index f49864f3455fc9415997ba25c4d792732ae3982f..7f37b5ece5aa4acb63262e730fdb7c8d82edd3a5 100644 --- a/libbson/1.24.2/bson_reader_set_read_func.html +++ b/libbson/1.24.2/bson_reader_set_read_func.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_t.html b/libbson/1.24.2/bson_reader_t.html index a8851fe997a1310295fe8d61f25fd9432773f0d7..e2fb0e7a154e7e1e9eb27c5edcab04ed9bad29fe 100644 --- a/libbson/1.24.2/bson_reader_t.html +++ b/libbson/1.24.2/bson_reader_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reader_tell.html b/libbson/1.24.2/bson_reader_tell.html index f06adfaea94ef0c1f22175b933c65d32f2cb1b25..8b026d3b5f61d2fe48a1bb591df02eaffbca40c5 100644 --- a/libbson/1.24.2/bson_reader_tell.html +++ b/libbson/1.24.2/bson_reader_tell.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_realloc.html b/libbson/1.24.2/bson_realloc.html index 752d5ed825d2894d1507c07eb9b67fdb7b5d0909..5f9d09a8c86eeb41faba25be16704b46ed4b0ab1 100644 --- a/libbson/1.24.2/bson_realloc.html +++ b/libbson/1.24.2/bson_realloc.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_realloc_ctx.html b/libbson/1.24.2/bson_realloc_ctx.html index 253f5470d4d383321b9bb67e1284ba208890eaf6..958651c5063c35f3f145a9f2df1a151d078f8a25 100644 --- a/libbson/1.24.2/bson_realloc_ctx.html +++ b/libbson/1.24.2/bson_realloc_ctx.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_realloc_func.html b/libbson/1.24.2/bson_realloc_func.html index 9df11af4f80b04af26ce0f583f8663453d450b10..54075e7537c84efde99777ae51a771ac65855b5f 100644 --- a/libbson/1.24.2/bson_realloc_func.html +++ b/libbson/1.24.2/bson_realloc_func.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reinit.html b/libbson/1.24.2/bson_reinit.html index c426f1a7c047ba21efc9114d5b1f43232e3b4f8e..87b0d622a44b3e25d6bdb1c5b02758bbb9569338 100644 --- a/libbson/1.24.2/bson_reinit.html +++ b/libbson/1.24.2/bson_reinit.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_reserve_buffer.html b/libbson/1.24.2/bson_reserve_buffer.html index 4dae5dcf3a1eb9357990a026921262d7a10f3b93..2f2a1b81cb2c7cfcf39c8a06f85f11b42978c265 100644 --- a/libbson/1.24.2/bson_reserve_buffer.html +++ b/libbson/1.24.2/bson_reserve_buffer.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_set_error.html b/libbson/1.24.2/bson_set_error.html index c10d5bc8e22a569d451ee474f3fed601b9586c9d..68806df77302f6a92292775da49d41d0f59b844b 100644 --- a/libbson/1.24.2/bson_set_error.html +++ b/libbson/1.24.2/bson_set_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_sized_new.html b/libbson/1.24.2/bson_sized_new.html index c3bfca272d474c2933872a55477061380dda864f..34e2ef34e1042297a91f98897aa533edf6253443 100644 --- a/libbson/1.24.2/bson_sized_new.html +++ b/libbson/1.24.2/bson_sized_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_snprintf.html b/libbson/1.24.2/bson_snprintf.html index 3b3e0b14bd662b48f9fe114bee04e343ae126211..d27375ba991588c87eb9d656143a0edeba42e07b 100644 --- a/libbson/1.24.2/bson_snprintf.html +++ b/libbson/1.24.2/bson_snprintf.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_steal.html b/libbson/1.24.2/bson_steal.html index 845546ad447b18c0bfb0485022dbbb595a812cbd..d41f7a9c34e5d803d816c949240636bee1cc80fd 100644 --- a/libbson/1.24.2/bson_steal.html +++ b/libbson/1.24.2/bson_steal.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strcasecmp.html b/libbson/1.24.2/bson_strcasecmp.html index d3f431542ce8a647826c8190de0d33dedc071cec..fe34b664da26ec6391ac332bbdb030d5271af728 100644 --- a/libbson/1.24.2/bson_strcasecmp.html +++ b/libbson/1.24.2/bson_strcasecmp.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strdup.html b/libbson/1.24.2/bson_strdup.html index 6653f653efc9b728b6c423837a894b823c3bde6e..9b60ffa700fd19a9dc4bf6361d68a27ad82b9fbb 100644 --- a/libbson/1.24.2/bson_strdup.html +++ b/libbson/1.24.2/bson_strdup.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strdup_printf.html b/libbson/1.24.2/bson_strdup_printf.html index af642d2ba2147d88d6a492585761e04877dff843..5cc41d2aeeefc8b575539e488ffb0a5c4aab9761 100644 --- a/libbson/1.24.2/bson_strdup_printf.html +++ b/libbson/1.24.2/bson_strdup_printf.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strdupv_printf.html b/libbson/1.24.2/bson_strdupv_printf.html index 4779e1a1141a7e47d9f3fef3d3fbc98d84a72f6c..813e2da946fd0e9865da8680fb782a4538bf47c7 100644 --- a/libbson/1.24.2/bson_strdupv_printf.html +++ b/libbson/1.24.2/bson_strdupv_printf.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strerror_r.html b/libbson/1.24.2/bson_strerror_r.html index 7f0ef2e44e661c4db330641f26b375e904463991..22842f33956b312d37f652b45bafb097e77db332 100644 --- a/libbson/1.24.2/bson_strerror_r.html +++ b/libbson/1.24.2/bson_strerror_r.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strfreev.html b/libbson/1.24.2/bson_strfreev.html index 2450c4b095831d1473937613f4925a3c24fb9fc0..2e7fafd514ba130a6a245822183e8a7fb4d43fbb 100644 --- a/libbson/1.24.2/bson_strfreev.html +++ b/libbson/1.24.2/bson_strfreev.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_append.html b/libbson/1.24.2/bson_string_append.html index 99d9030430ba1f0e3086a85c3a95077b0eae09e5..5191ff9428b754172d2e47f92d40c444316038e1 100644 --- a/libbson/1.24.2/bson_string_append.html +++ b/libbson/1.24.2/bson_string_append.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_append_c.html b/libbson/1.24.2/bson_string_append_c.html index de4df73c5d9a270ea02351df13f9eaada92bc519..6dae8d150ae4190ab9b30b2407b8a9031d4f305c 100644 --- a/libbson/1.24.2/bson_string_append_c.html +++ b/libbson/1.24.2/bson_string_append_c.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_append_printf.html b/libbson/1.24.2/bson_string_append_printf.html index ce37f447a5f14b3f5d763c9f9d752957fe95c84a..e0f18c4b80c42878862375e647380de1f66b2d5d 100644 --- a/libbson/1.24.2/bson_string_append_printf.html +++ b/libbson/1.24.2/bson_string_append_printf.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_append_unichar.html b/libbson/1.24.2/bson_string_append_unichar.html index 78e4775adc830399dff7b4cc9e8ed398aadcca29..f41f18fdfc60246405fdd11147e3caa259f41efd 100644 --- a/libbson/1.24.2/bson_string_append_unichar.html +++ b/libbson/1.24.2/bson_string_append_unichar.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_free.html b/libbson/1.24.2/bson_string_free.html index 5a6b75bfaa93d1c96fa4c420712c9ea1da57273f..6fe5f6ccc1cb65eab28685b75e74c59ce9673a62 100644 --- a/libbson/1.24.2/bson_string_free.html +++ b/libbson/1.24.2/bson_string_free.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_new.html b/libbson/1.24.2/bson_string_new.html index ee38452686668a3a82a1f61edd0ed2267afe52c2..5421f7502ae79a40de2c63354630aa387f429454 100644 --- a/libbson/1.24.2/bson_string_new.html +++ b/libbson/1.24.2/bson_string_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_t.html b/libbson/1.24.2/bson_string_t.html index d12791f0579a7bebdca7c9d2c46d7b28280ce0a2..f8f3f63b9812a8216d64f2d9b1f1ac717d8cc9c7 100644 --- a/libbson/1.24.2/bson_string_t.html +++ b/libbson/1.24.2/bson_string_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_string_truncate.html b/libbson/1.24.2/bson_string_truncate.html index 70b9a4fac79e3352bc819d0b76a88640a974cffa..7bd9a7e44976b4bac96d1dd127f0d3de9613706b 100644 --- a/libbson/1.24.2/bson_string_truncate.html +++ b/libbson/1.24.2/bson_string_truncate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strncpy.html b/libbson/1.24.2/bson_strncpy.html index 834056f55917595c53d419f0808d684d8abba786..0c89837040da4d505ef3121a897ba896af9d1a43 100644 --- a/libbson/1.24.2/bson_strncpy.html +++ b/libbson/1.24.2/bson_strncpy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strndup.html b/libbson/1.24.2/bson_strndup.html index 36763cdacf613088b69f2ceccbbed993bcb94163..b6652040f4b18f3340e59d21718b59c24a4b908f 100644 --- a/libbson/1.24.2/bson_strndup.html +++ b/libbson/1.24.2/bson_strndup.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_strnlen.html b/libbson/1.24.2/bson_strnlen.html index c53388dc72da95349b6324f802d4391a2b871731..4dba310595c0b63ce44666953cd4cced635607e9 100644 --- a/libbson/1.24.2/bson_strnlen.html +++ b/libbson/1.24.2/bson_strnlen.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_subtype_t.html b/libbson/1.24.2/bson_subtype_t.html index 26fdb8efde87f74ca881c1d44670843dbc9f96b2..803ab9c83176c300bc47e7ab66228cbdee6fbc7d 100644 --- a/libbson/1.24.2/bson_subtype_t.html +++ b/libbson/1.24.2/bson_subtype_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_t.html b/libbson/1.24.2/bson_t.html index 5f3390c6910042538df4e44b71e7173e5316bc71..f6bbc3034b3b9621a61d7d8378ef7ce113ff8d0c 100644 --- a/libbson/1.24.2/bson_t.html +++ b/libbson/1.24.2/bson_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_type_t.html b/libbson/1.24.2/bson_type_t.html index f179fda58599413d0d834b38e7549af5219e7266..c8c86aa41bbe70a8a9f6aebacff73cba073a6dc5 100644 --- a/libbson/1.24.2/bson_type_t.html +++ b/libbson/1.24.2/bson_type_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_uint32_to_string.html b/libbson/1.24.2/bson_uint32_to_string.html index ce51b560f577b11cd49d7fef8ebd24970efc42ea..811ca3663ec61d207caac9c691ced896a6666a34 100644 --- a/libbson/1.24.2/bson_uint32_to_string.html +++ b/libbson/1.24.2/bson_uint32_to_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_unichar_t.html b/libbson/1.24.2/bson_unichar_t.html index f1562037ca4dc8e9eda20a6da0a814e7ec4bb258..e955d853187a44a00f0ee0fefef01f45912ba4fc 100644 --- a/libbson/1.24.2/bson_unichar_t.html +++ b/libbson/1.24.2/bson_unichar_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_utf8_escape_for_json.html b/libbson/1.24.2/bson_utf8_escape_for_json.html index c1c19b93e0e524490a84f4f00a126c0d3aceac5f..c3cff6de98bd38a851c4394ce39391ce0291727a 100644 --- a/libbson/1.24.2/bson_utf8_escape_for_json.html +++ b/libbson/1.24.2/bson_utf8_escape_for_json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_utf8_from_unichar.html b/libbson/1.24.2/bson_utf8_from_unichar.html index e8faeeed15654e23dfdbab5f68752de25562dce4..f78e2559adb462b01ffaf18a06b150a7f1bd7177 100644 --- a/libbson/1.24.2/bson_utf8_from_unichar.html +++ b/libbson/1.24.2/bson_utf8_from_unichar.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_utf8_get_char.html b/libbson/1.24.2/bson_utf8_get_char.html index ca6f0656665768b725ee369d05253e9cb4cd4b94..8ceedac1d3ce4f0d62bb833ae2201a212a692278 100644 --- a/libbson/1.24.2/bson_utf8_get_char.html +++ b/libbson/1.24.2/bson_utf8_get_char.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_utf8_next_char.html b/libbson/1.24.2/bson_utf8_next_char.html index 6c8bd3edf7b3b5e6a26933cfcf9405d5b0b575b6..b2849b8b60fca4084cfb13716977bdca916c1e39 100644 --- a/libbson/1.24.2/bson_utf8_next_char.html +++ b/libbson/1.24.2/bson_utf8_next_char.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_utf8_validate.html b/libbson/1.24.2/bson_utf8_validate.html index 8006238e284881b4a053b001900f2d52461d347a..3ada4414e9c99f7c9affa5a1e59920820f80539e 100644 --- a/libbson/1.24.2/bson_utf8_validate.html +++ b/libbson/1.24.2/bson_utf8_validate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_validate.html b/libbson/1.24.2/bson_validate.html index 6f73794906e4fd9f8eed0ede6e52f967266ca7f3..15efef6f90059f31419fa7aa61b2de9a9af9f822 100644 --- a/libbson/1.24.2/bson_validate.html +++ b/libbson/1.24.2/bson_validate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_validate_with_error.html b/libbson/1.24.2/bson_validate_with_error.html index 9a9b97578160e8c70f2723ed544b624e08d448e7..85a3afbe82ab12dd9a56da3b84d192a3e4a1bc2d 100644 --- a/libbson/1.24.2/bson_validate_with_error.html +++ b/libbson/1.24.2/bson_validate_with_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_value_copy.html b/libbson/1.24.2/bson_value_copy.html index 1841944c3ba75413542785491c10465d40de1fb5..b753247e021974c2d0b9e315062d02e338e978fd 100644 --- a/libbson/1.24.2/bson_value_copy.html +++ b/libbson/1.24.2/bson_value_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_value_destroy.html b/libbson/1.24.2/bson_value_destroy.html index d2f8ee10f8f7ef5d90b3319a6455d32fc75f46b7..7e016d200142a40845e533c3ad781a698159a02b 100644 --- a/libbson/1.24.2/bson_value_destroy.html +++ b/libbson/1.24.2/bson_value_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_value_t.html b/libbson/1.24.2/bson_value_t.html index 93d8b07125801803832db601fe0f999e87375d75..6bb3d60eafc4d8a47ff2e3e0eb3f90a125eed3cd 100644 --- a/libbson/1.24.2/bson_value_t.html +++ b/libbson/1.24.2/bson_value_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_visitor_t.html b/libbson/1.24.2/bson_visitor_t.html index 3624208c6e4c36a53f90b2d4963837fec2541ebb..ae376ad6b018001fdbe7df464ed1b88758c765dc 100644 --- a/libbson/1.24.2/bson_visitor_t.html +++ b/libbson/1.24.2/bson_visitor_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_vsnprintf.html b/libbson/1.24.2/bson_vsnprintf.html index 254ad51e5fa51ab5ce7890bbac832c3c963f23b4..e22ea039c516e27d6e94685ccb3d9d128785128e 100644 --- a/libbson/1.24.2/bson_vsnprintf.html +++ b/libbson/1.24.2/bson_vsnprintf.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_begin.html b/libbson/1.24.2/bson_writer_begin.html index 236aba35630c33aaa0a65c67fbea8a62d8e384d5..45a32beab24ac4915dfcf2d4d7d6b59f14df5d8b 100644 --- a/libbson/1.24.2/bson_writer_begin.html +++ b/libbson/1.24.2/bson_writer_begin.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_destroy.html b/libbson/1.24.2/bson_writer_destroy.html index b36e866590e54d0f5ce8488b2b6b99033427b037..41fce09006daddfd5adf8961e744a382dd62809a 100644 --- a/libbson/1.24.2/bson_writer_destroy.html +++ b/libbson/1.24.2/bson_writer_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_end.html b/libbson/1.24.2/bson_writer_end.html index 90b84940db260ff36b6ce7be463067e13839d181..1fd60526c08b98da2f025f93aa32349f7626da58 100644 --- a/libbson/1.24.2/bson_writer_end.html +++ b/libbson/1.24.2/bson_writer_end.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_get_length.html b/libbson/1.24.2/bson_writer_get_length.html index ebb8fff9ad04ee5123f60933ff45b92a5ea7d084..02a61bbe055faff0192821d404c2401d56ead75c 100644 --- a/libbson/1.24.2/bson_writer_get_length.html +++ b/libbson/1.24.2/bson_writer_get_length.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_new.html b/libbson/1.24.2/bson_writer_new.html index 92cfbd9f8ed40eb9484b4925343d12896cc9f197..7357a87fd1fd60a3a04ce30fc7c8f2ac63a70417 100644 --- a/libbson/1.24.2/bson_writer_new.html +++ b/libbson/1.24.2/bson_writer_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_rollback.html b/libbson/1.24.2/bson_writer_rollback.html index 5f8c31950bb1add8819325171fa1a1d34d0b9bef..fd6de6d885811c9de236025cbe104d50b78d4c02 100644 --- a/libbson/1.24.2/bson_writer_rollback.html +++ b/libbson/1.24.2/bson_writer_rollback.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_writer_t.html b/libbson/1.24.2/bson_writer_t.html index a026de0fd56213020cef523c2245c802d6f8b0f7..1f4155ea7b7badb14a73be5fb4ca0bb4991d7e80 100644 --- a/libbson/1.24.2/bson_writer_t.html +++ b/libbson/1.24.2/bson_writer_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/bson_zero_free.html b/libbson/1.24.2/bson_zero_free.html index 180147b9052e8941fd840d11184ca95225ce347c..06a7c308d2a07b4b385d99e3d3a38f85c2148cb2 100644 --- a/libbson/1.24.2/bson_zero_free.html +++ b/libbson/1.24.2/bson_zero_free.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/character_and_string_routines.html b/libbson/1.24.2/character_and_string_routines.html index b98d34f0cebabdd1fc7d4e89e4af91502292e517..5952856901b5a3b6113c6f67527f5ea3bec5ea9e 100644 --- a/libbson/1.24.2/character_and_string_routines.html +++ b/libbson/1.24.2/character_and_string_routines.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/creating.html b/libbson/1.24.2/creating.html index 1ffcabc4ce0be15cec52630eb64e3f88126ad3dd..723f734496bec9f8d608aafff9fddf43c94f7831 100644 --- a/libbson/1.24.2/creating.html +++ b/libbson/1.24.2/creating.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/cross-platform-notes.html b/libbson/1.24.2/cross-platform-notes.html index c57cd59a61554e4a30051247dedcdfde3bbc9b0f..02afc4a27476995096dac96f995deab44c77bb1e 100644 --- a/libbson/1.24.2/cross-platform-notes.html +++ b/libbson/1.24.2/cross-platform-notes.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/endianness.html b/libbson/1.24.2/endianness.html index 92a91462aab2de8796ed9285e50eb3d4615f2952..30511922385ea499902378820f4044161924a7fe 100644 --- a/libbson/1.24.2/endianness.html +++ b/libbson/1.24.2/endianness.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/errors.html b/libbson/1.24.2/errors.html index 5de5d0eed7a2501e95d908b53e2d9af02ef6547a..20948928ccbeb002a79c00a473ad7d814ec078f3 100644 --- a/libbson/1.24.2/errors.html +++ b/libbson/1.24.2/errors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/full_index.html b/libbson/1.24.2/full_index.html index 06d0f2e95bf84c9482c312a6aa5b92e4a5cb5f17..4692ac75e1be3fc32fde2c13fcb67c5f29463a66 100644 --- a/libbson/1.24.2/full_index.html +++ b/libbson/1.24.2/full_index.html @@ -35,6 +35,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/guides.html b/libbson/1.24.2/guides.html index 74004e07f849c6be6f38780d2841032b00e50909..d4236c00d5ba967c5acbe1c65a1935e2e9d2a4a6 100644 --- a/libbson/1.24.2/guides.html +++ b/libbson/1.24.2/guides.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/include-and-link.html b/libbson/1.24.2/include-and-link.html index 3928359851bbd99e7d3a83e28b50b7011030a8cb..8d90a3a2f40a298287eb563ae07a0d437ea717ca 100644 --- a/libbson/1.24.2/include-and-link.html +++ b/libbson/1.24.2/include-and-link.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/index.html b/libbson/1.24.2/index.html index 45b2c74db82280814c4246b761814fa8a0c12eb7..3b0dd5e64a1ae713942132ff07f9d2ed611fb78b 100644 --- a/libbson/1.24.2/index.html +++ b/libbson/1.24.2/index.html @@ -36,6 +36,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/json.html b/libbson/1.24.2/json.html index 99545c70d1050aece2ebb1603bb059132ea28f91..03669a08dd22798c623ee422849249a0cfaa2241 100644 --- a/libbson/1.24.2/json.html +++ b/libbson/1.24.2/json.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/oid.html b/libbson/1.24.2/oid.html index 877be88ffc9801bc7b0b4c3ac3a8709617aff2f9..4f5fb3f48e51c97a53aa6d5ecd2d98630b897cc8 100644 --- a/libbson/1.24.2/oid.html +++ b/libbson/1.24.2/oid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/parsing.html b/libbson/1.24.2/parsing.html index 5f887cf224d1475d84c8151a6bb2a99df36e5d44..bdeba553af0642c26f92644880564832324a5144 100644 --- a/libbson/1.24.2/parsing.html +++ b/libbson/1.24.2/parsing.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/search.html b/libbson/1.24.2/search.html index 955e2a2802f813eac7a6f3b17eb45d9ff6be5ed3..c6ff4b5eb7ae48b73847644d0f56ddf042f8c47c 100644 --- a/libbson/1.24.2/search.html +++ b/libbson/1.24.2/search.html @@ -43,6 +43,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/streaming-bson.html b/libbson/1.24.2/streaming-bson.html index 7b0375640780ecbb0389661dfc9eec97891ca71f..fc8ca5326cb65662f7e3d9b058a5476ec81970c2 100644 --- a/libbson/1.24.2/streaming-bson.html +++ b/libbson/1.24.2/streaming-bson.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/threading.html b/libbson/1.24.2/threading.html index dc21d83cfde0e67af82e8078a53646873333593a..76da2efd41575a6e8fdfed679806b27e1ff473ba 100644 --- a/libbson/1.24.2/threading.html +++ b/libbson/1.24.2/threading.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/tutorial.html b/libbson/1.24.2/tutorial.html index 54aa11942d802e4d40a7adab8a4bbe0f7cfb899b..ea76e8186003335f58ddce00debd49731d9583c9 100644 --- a/libbson/1.24.2/tutorial.html +++ b/libbson/1.24.2/tutorial.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/utf8.html b/libbson/1.24.2/utf8.html index 80c07c5e7186f727b85c8c4b3e61bf522e7aef6b..789eb1ba1482292339ff8b5808616350682621cc 100644 --- a/libbson/1.24.2/utf8.html +++ b/libbson/1.24.2/utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.2/version.html b/libbson/1.24.2/version.html index 622260b7c61872a6dd78afc8283f6b1af95b4fb1..8371d923546bec5b481384837c4a5784e392dbdc 100644 --- a/libbson/1.24.2/version.html +++ b/libbson/1.24.2/version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libbson/1.24.3/.nojekyll b/libbson/1.24.3/.nojekyll new file mode 100644 index 0000000000000000000000000000000000000000..19102815663d23f8b75a47e7a01965dcdc96468c --- /dev/null +++ b/libbson/1.24.3/.nojekyll @@ -0,0 +1 @@ +foo \ No newline at end of file diff --git a/libbson/1.24.3/CMakeLists.txt b/libbson/1.24.3/CMakeLists.txt new file mode 100644 index 0000000000000000000000000000000000000000..447d8c0657362ef7a10a17e4e5cfc7f650c6c3a4 --- /dev/null +++ b/libbson/1.24.3/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.3/_static/ajax-loader.gif b/libbson/1.24.3/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 Binary files /dev/null and b/libbson/1.24.3/_static/ajax-loader.gif differ diff --git a/libbson/1.24.3/_static/basic.css b/libbson/1.24.3/_static/basic.css new file mode 100644 index 0000000000000000000000000000000000000000..19ced1057aebf39d3dac6f6a5d864491231a3e33 --- /dev/null +++ b/libbson/1.24.3/_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.3/_static/comment-bright.png b/libbson/1.24.3/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..15e27edb12ac25701ac0ac21b97b52bb4e45415e Binary files /dev/null and b/libbson/1.24.3/_static/comment-bright.png differ diff --git a/libbson/1.24.3/_static/comment-close.png b/libbson/1.24.3/_static/comment-close.png new file mode 100644 index 0000000000000000000000000000000000000000..4d91bcf57de866a901a89a2a68c0f36af1114841 Binary files /dev/null and b/libbson/1.24.3/_static/comment-close.png differ diff --git a/libbson/1.24.3/_static/comment.png b/libbson/1.24.3/_static/comment.png new file mode 100644 index 0000000000000000000000000000000000000000..dfbc0cbd512bdeefcb1984c99d8e577efb77f006 Binary files /dev/null and b/libbson/1.24.3/_static/comment.png differ diff --git a/libbson/1.24.3/_static/doctools.js b/libbson/1.24.3/_static/doctools.js new file mode 100644 index 0000000000000000000000000000000000000000..d8928926bf24bb081d91a12f7b92e1b2d8b142b6 --- /dev/null +++ b/libbson/1.24.3/_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); + $('

    ' + _('Hide Search Matches') + '

    ') + .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.3/_static/documentation_options.js b/libbson/1.24.3/_static/documentation_options.js new file mode 100644 index 0000000000000000000000000000000000000000..bc12cb35cdbb5228850f6e53832f07a9febac8ed --- /dev/null +++ b/libbson/1.24.3/_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.3/_static/down-pressed.png b/libbson/1.24.3/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..5756c8cad8854722893dc70b9eb4bb0400343a39 Binary files /dev/null and b/libbson/1.24.3/_static/down-pressed.png differ diff --git a/libbson/1.24.3/_static/down.png b/libbson/1.24.3/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..1b3bdad2ceffae91cee61b32f3295f9bbe646e48 Binary files /dev/null and b/libbson/1.24.3/_static/down.png differ diff --git a/libbson/1.24.3/_static/file.png b/libbson/1.24.3/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 Binary files /dev/null and b/libbson/1.24.3/_static/file.png differ diff --git a/libbson/1.24.3/_static/jquery-3.2.1.js b/libbson/1.24.3/_static/jquery-3.2.1.js new file mode 100644 index 0000000000000000000000000000000000000000..d2d8ca4790e52b0537f3cbb7dcd766099b789583 --- /dev/null +++ b/libbson/1.24.3/_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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    API Reference

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_aligned_alloc.html b/libbson/1.24.3/bson_aligned_alloc.html new file mode 100644 index 0000000000000000000000000000000000000000..51dbd998bd2eaf52156b4344f86b8a85d9d1bd90 --- /dev/null +++ b/libbson/1.24.3/bson_aligned_alloc.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_aligned_alloc() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_aligned_alloc0.html b/libbson/1.24.3/bson_aligned_alloc0.html new file mode 100644 index 0000000000000000000000000000000000000000..e58d28aaedcc0a77544753d51cd625924367fcef --- /dev/null +++ b/libbson/1.24.3/bson_aligned_alloc0.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_aligned_alloc0() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_array.html b/libbson/1.24.3/bson_append_array.html new file mode 100644 index 0000000000000000000000000000000000000000..c991f8e58eb4fb050eaee37ecb05be5aa7b2d13a --- /dev/null +++ b/libbson/1.24.3/bson_append_array.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_array() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_array_begin.html b/libbson/1.24.3/bson_append_array_begin.html new file mode 100644 index 0000000000000000000000000000000000000000..f18b4c6608f170ecbdebce9af13ba3bfeb916946 --- /dev/null +++ b/libbson/1.24.3/bson_append_array_begin.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_append_array_begin() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_array_end.html b/libbson/1.24.3/bson_append_array_end.html new file mode 100644 index 0000000000000000000000000000000000000000..fabe40d51aef75de49b0d286a0ef1b46e330b195 --- /dev/null +++ b/libbson/1.24.3/bson_append_array_end.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_append_array_end() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_binary.html b/libbson/1.24.3/bson_append_binary.html new file mode 100644 index 0000000000000000000000000000000000000000..3ae2a3e6ca35dd0c55da841040e21200b0b392ed --- /dev/null +++ b/libbson/1.24.3/bson_append_binary.html @@ -0,0 +1,168 @@ + + + + + + + + + + + + + + bson_append_binary() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_bool.html b/libbson/1.24.3/bson_append_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..4bd2f2f128ab9f94ca35eaf17d767f2ec3bc0744 --- /dev/null +++ b/libbson/1.24.3/bson_append_bool.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_append_bool() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_code.html b/libbson/1.24.3/bson_append_code.html new file mode 100644 index 0000000000000000000000000000000000000000..903dfa39953b0a37d0fd69f266e5fd055159bbae --- /dev/null +++ b/libbson/1.24.3/bson_append_code.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_code() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_code_with_scope.html b/libbson/1.24.3/bson_append_code_with_scope.html new file mode 100644 index 0000000000000000000000000000000000000000..bc32a21fb7bd873560c3772159fcd45ed514cee7 --- /dev/null +++ b/libbson/1.24.3/bson_append_code_with_scope.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_append_code_with_scope() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_date_time.html b/libbson/1.24.3/bson_append_date_time.html new file mode 100644 index 0000000000000000000000000000000000000000..61eb576b435d1b17d39d79420579ac9cea61fed7 --- /dev/null +++ b/libbson/1.24.3/bson_append_date_time.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_date_time() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_dbpointer.html b/libbson/1.24.3/bson_append_dbpointer.html new file mode 100644 index 0000000000000000000000000000000000000000..37d52ae4bd836b4ac5bc481ead068c31c46856a7 --- /dev/null +++ b/libbson/1.24.3/bson_append_dbpointer.html @@ -0,0 +1,169 @@ + + + + + + + + + + + + + + bson_append_dbpointer() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_decimal128.html b/libbson/1.24.3/bson_append_decimal128.html new file mode 100644 index 0000000000000000000000000000000000000000..c4e0f0ea96e67d916949d9358a4339ab8f46096d --- /dev/null +++ b/libbson/1.24.3/bson_append_decimal128.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_decimal128() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_document.html b/libbson/1.24.3/bson_append_document.html new file mode 100644 index 0000000000000000000000000000000000000000..48e90ce5810112af3f641866c6cd34f5277ef00f --- /dev/null +++ b/libbson/1.24.3/bson_append_document.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_document() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_document_begin.html b/libbson/1.24.3/bson_append_document_begin.html new file mode 100644 index 0000000000000000000000000000000000000000..91a5979dc700a00cd338af9d801d391179343142 --- /dev/null +++ b/libbson/1.24.3/bson_append_document_begin.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_append_document_begin() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_document_end.html b/libbson/1.24.3/bson_append_document_end.html new file mode 100644 index 0000000000000000000000000000000000000000..2cb2f23120080394ff5d66cb3d55e6c7d06a4e10 --- /dev/null +++ b/libbson/1.24.3/bson_append_document_end.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_append_document_end() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_double.html b/libbson/1.24.3/bson_append_double.html new file mode 100644 index 0000000000000000000000000000000000000000..4be9302d126b0761ff644ff39ea37678e543c97f --- /dev/null +++ b/libbson/1.24.3/bson_append_double.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_double() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_int32.html b/libbson/1.24.3/bson_append_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..9d4c4f4765882f6f5f020199e49bda090b92ea07 --- /dev/null +++ b/libbson/1.24.3/bson_append_int32.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_int32() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_int64.html b/libbson/1.24.3/bson_append_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..e519c5f10f87455a4600c418c04f59ef8a3c4f10 --- /dev/null +++ b/libbson/1.24.3/bson_append_int64.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_int64() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_iter.html b/libbson/1.24.3/bson_append_iter.html new file mode 100644 index 0000000000000000000000000000000000000000..e6b1b6bc4b820c89171b88922d27e98e4bb306ed --- /dev/null +++ b/libbson/1.24.3/bson_append_iter.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_append_iter() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_maxkey.html b/libbson/1.24.3/bson_append_maxkey.html new file mode 100644 index 0000000000000000000000000000000000000000..cd4ead261d633fcb693c082365dc6700f572d6b2 --- /dev/null +++ b/libbson/1.24.3/bson_append_maxkey.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_append_maxkey() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_minkey.html b/libbson/1.24.3/bson_append_minkey.html new file mode 100644 index 0000000000000000000000000000000000000000..2d1b80971a95f5dee5c150526de3fdd905ec6693 --- /dev/null +++ b/libbson/1.24.3/bson_append_minkey.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_append_minkey() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_now_utc.html b/libbson/1.24.3/bson_append_now_utc.html new file mode 100644 index 0000000000000000000000000000000000000000..750e05328e7f1fcb74764af03289dd53daf3e17f --- /dev/null +++ b/libbson/1.24.3/bson_append_now_utc.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_append_now_utc() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_null.html b/libbson/1.24.3/bson_append_null.html new file mode 100644 index 0000000000000000000000000000000000000000..6dee84bd331200b43f161ef2af01ee391475d549 --- /dev/null +++ b/libbson/1.24.3/bson_append_null.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_append_null() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_oid.html b/libbson/1.24.3/bson_append_oid.html new file mode 100644 index 0000000000000000000000000000000000000000..32abedb667bd62176deaa015d837803c83d1e739 --- /dev/null +++ b/libbson/1.24.3/bson_append_oid.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_oid() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_regex.html b/libbson/1.24.3/bson_append_regex.html new file mode 100644 index 0000000000000000000000000000000000000000..f2d7c45bc6cb395eafbb1efd22d0a68f8ad8f5da --- /dev/null +++ b/libbson/1.24.3/bson_append_regex.html @@ -0,0 +1,175 @@ + + + + + + + + + + + + + + bson_append_regex() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_regex_w_len.html b/libbson/1.24.3/bson_append_regex_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..e2643f69c8961de20cb8fb9c29d5ada7bdaad596 --- /dev/null +++ b/libbson/1.24.3/bson_append_regex_w_len.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + bson_append_regex_w_len() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_symbol.html b/libbson/1.24.3/bson_append_symbol.html new file mode 100644 index 0000000000000000000000000000000000000000..43bbe1363477334067a0b8e4ae6cdd2ba3fb3e74 --- /dev/null +++ b/libbson/1.24.3/bson_append_symbol.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_append_symbol() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_time_t.html b/libbson/1.24.3/bson_append_time_t.html new file mode 100644 index 0000000000000000000000000000000000000000..680f20912c64137f730593f9e5485314ce6e0ec1 --- /dev/null +++ b/libbson/1.24.3/bson_append_time_t.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_time_t() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_timestamp.html b/libbson/1.24.3/bson_append_timestamp.html new file mode 100644 index 0000000000000000000000000000000000000000..b42bb156c292e94d138d66e3cb9980fed5b3ea82 --- /dev/null +++ b/libbson/1.24.3/bson_append_timestamp.html @@ -0,0 +1,168 @@ + + + + + + + + + + + + + + bson_append_timestamp() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_timeval.html b/libbson/1.24.3/bson_append_timeval.html new file mode 100644 index 0000000000000000000000000000000000000000..b7b94c3759bdee79e718690f6c500460c17f4568 --- /dev/null +++ b/libbson/1.24.3/bson_append_timeval.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_timeval() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_undefined.html b/libbson/1.24.3/bson_append_undefined.html new file mode 100644 index 0000000000000000000000000000000000000000..5427e234fd91c66db6469db4b62cb1624789bdeb --- /dev/null +++ b/libbson/1.24.3/bson_append_undefined.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_append_undefined() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_utf8.html b/libbson/1.24.3/bson_append_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..0dbe3df54b784dc76cc4f8829480d3060df2c7ff --- /dev/null +++ b/libbson/1.24.3/bson_append_utf8.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_append_utf8() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_append_value.html b/libbson/1.24.3/bson_append_value.html new file mode 100644 index 0000000000000000000000000000000000000000..4c330f4f96838345d4534f9af7b4d2de1d7a8b4b --- /dev/null +++ b/libbson/1.24.3/bson_append_value.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_append_value() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_array_as_canonical_extended_json.html b/libbson/1.24.3/bson_array_as_canonical_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..69c90f8cbe9fa8e3ac25b10d823cc15cd6601063 --- /dev/null +++ b/libbson/1.24.3/bson_array_as_canonical_extended_json.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + bson_array_as_canonical_extended_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_array_as_json.html b/libbson/1.24.3/bson_array_as_json.html new file mode 100644 index 0000000000000000000000000000000000000000..032d9f3bf4c7328a844e389d0a964604a64c29f6 --- /dev/null +++ b/libbson/1.24.3/bson_array_as_json.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + bson_array_as_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_array_as_relaxed_extended_json.html b/libbson/1.24.3/bson_array_as_relaxed_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..7f3c8fc77cb5d194037daf83be857aff9496c646 --- /dev/null +++ b/libbson/1.24.3/bson_array_as_relaxed_extended_json.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + bson_array_as_relaxed_extended_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_as_canonical_extended_json.html b/libbson/1.24.3/bson_as_canonical_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..be876899554661a3efc21a0cd0b15b1db0f8423e --- /dev/null +++ b/libbson/1.24.3/bson_as_canonical_extended_json.html @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + bson_as_canonical_extended_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_as_json.html b/libbson/1.24.3/bson_as_json.html new file mode 100644 index 0000000000000000000000000000000000000000..59f46e7d55058f4666a46ad6d2befb5f76a8635e --- /dev/null +++ b/libbson/1.24.3/bson_as_json.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + bson_as_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_as_json_with_opts.html b/libbson/1.24.3/bson_as_json_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..88316fb18762144df5eee3c3213f65ea69f20c9e --- /dev/null +++ b/libbson/1.24.3/bson_as_json_with_opts.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + bson_as_json_with_opts() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_as_relaxed_extended_json.html b/libbson/1.24.3/bson_as_relaxed_extended_json.html new file mode 100644 index 0000000000000000000000000000000000000000..c67438be7da961341d14adae9ca476526c5c0a05 --- /dev/null +++ b/libbson/1.24.3/bson_as_relaxed_extended_json.html @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + bson_as_relaxed_extended_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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()
    +
    +
    +
    bson_array_as_json()
    +
    +
    +
    :symbol: bson_array_as_relaxed_extended_json()
    +
    +
    +
    bson_as_canonical_extended_json()
    +
    +
    +
    bson_as_json()
    +
    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    bson_as_relaxed_extended_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_ascii_strtoll.html b/libbson/1.24.3/bson_ascii_strtoll.html new file mode 100644 index 0000000000000000000000000000000000000000..496f274f420c03cbf9a41531cac72ced6b2951db --- /dev/null +++ b/libbson/1.24.3/bson_ascii_strtoll.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_ascii_strtoll() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_check_version.html b/libbson/1.24.3/bson_check_version.html new file mode 100644 index 0000000000000000000000000000000000000000..c7fb01159ebea3a1458674629a36c588a4330c83 --- /dev/null +++ b/libbson/1.24.3/bson_check_version.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_check_version() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_compare.html b/libbson/1.24.3/bson_compare.html new file mode 100644 index 0000000000000000000000000000000000000000..1bef084599df26d983dfa2af9cc607d6f9e6e502 --- /dev/null +++ b/libbson/1.24.3/bson_compare.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_compare() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_concat.html b/libbson/1.24.3/bson_concat.html new file mode 100644 index 0000000000000000000000000000000000000000..a4a215526df88a38821e3990de9350dc70c4d994 --- /dev/null +++ b/libbson/1.24.3/bson_concat.html @@ -0,0 +1,192 @@ + + + + + + + + + + + + + + bson_concat() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_context_destroy.html b/libbson/1.24.3/bson_context_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..14372699baf6b74d289069866589e5be3b99a6ca --- /dev/null +++ b/libbson/1.24.3/bson_context_destroy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_context_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_context_get_default.html b/libbson/1.24.3/bson_context_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..a99901794dac196e534cd6efb994d19e8085410d --- /dev/null +++ b/libbson/1.24.3/bson_context_get_default.html @@ -0,0 +1,146 @@ + + + + + + + + + + + + + + bson_context_get_default() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_context_new.html b/libbson/1.24.3/bson_context_new.html new file mode 100644 index 0000000000000000000000000000000000000000..0cfab6a753e47adaef71168e720bc121b334ac81 --- /dev/null +++ b/libbson/1.24.3/bson_context_new.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_context_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_context_t.html b/libbson/1.24.3/bson_context_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7e0316f15795ca248458f639b873d99c44e9c164 --- /dev/null +++ b/libbson/1.24.3/bson_context_t.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + bson_context_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_copy.html b/libbson/1.24.3/bson_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..f2ae34ccc227d1566514b96513044acf84a32154 --- /dev/null +++ b/libbson/1.24.3/bson_copy.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_copy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_copy_to.html b/libbson/1.24.3/bson_copy_to.html new file mode 100644 index 0000000000000000000000000000000000000000..42483001e447b70a5ee1a57b5affe731cefa33ea --- /dev/null +++ b/libbson/1.24.3/bson_copy_to.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_copy_to() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_copy_to_excluding.html b/libbson/1.24.3/bson_copy_to_excluding.html new file mode 100644 index 0000000000000000000000000000000000000000..5fb19c9a977744951cc15054f376b3ca2651beee --- /dev/null +++ b/libbson/1.24.3/bson_copy_to_excluding.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_copy_to_excluding() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_copy_to_excluding_noinit.html b/libbson/1.24.3/bson_copy_to_excluding_noinit.html new file mode 100644 index 0000000000000000000000000000000000000000..2cafe5c031d6d4afb5e0bfd32c0913641a227ce8 --- /dev/null +++ b/libbson/1.24.3/bson_copy_to_excluding_noinit.html @@ -0,0 +1,196 @@ + + + + + + + + + + + + + + bson_copy_to_excluding_noinit() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_copy_to_excluding_noinit_va.html b/libbson/1.24.3/bson_copy_to_excluding_noinit_va.html new file mode 100644 index 0000000000000000000000000000000000000000..d987b63d2642513481a8bac617c58a45647b0f27 --- /dev/null +++ b/libbson/1.24.3/bson_copy_to_excluding_noinit_va.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_copy_to_excluding_noinit_va() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_copy_to_excluding_noinit()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_count_keys.html b/libbson/1.24.3/bson_count_keys.html new file mode 100644 index 0000000000000000000000000000000000000000..85de8ccf95d639ac90df13161873e8752e003cea --- /dev/null +++ b/libbson/1.24.3/bson_count_keys.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_count_keys() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_decimal128_from_string.html b/libbson/1.24.3/bson_decimal128_from_string.html new file mode 100644 index 0000000000000000000000000000000000000000..6d1594ed913531e71601ba720d28608454111ab5 --- /dev/null +++ b/libbson/1.24.3/bson_decimal128_from_string.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + bson_decimal128_from_string() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_decimal128_from_string_w_len.html b/libbson/1.24.3/bson_decimal128_from_string_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..7b64f75a0f2e9e512e278c990ca303b6162be3dd --- /dev/null +++ b/libbson/1.24.3/bson_decimal128_from_string_w_len.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_decimal128_from_string_w_len() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_decimal128_t.html b/libbson/1.24.3/bson_decimal128_t.html new file mode 100644 index 0000000000000000000000000000000000000000..796828db039b61bdfc9bae12e1d700f90ac00c04 --- /dev/null +++ b/libbson/1.24.3/bson_decimal128_t.html @@ -0,0 +1,194 @@ + + + + + + + + + + + + + + bson_decimal128_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_decimal128_to_string.html b/libbson/1.24.3/bson_decimal128_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..ad3092a17f678e682428b8a9d7cf27828af0695b --- /dev/null +++ b/libbson/1.24.3/bson_decimal128_to_string.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_decimal128_to_string() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_destroy.html b/libbson/1.24.3/bson_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..1abccb342c03ec7a11573d76a3d0e37f7abc3614 --- /dev/null +++ b/libbson/1.24.3/bson_destroy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_destroy_with_steal.html b/libbson/1.24.3/bson_destroy_with_steal.html new file mode 100644 index 0000000000000000000000000000000000000000..0a08d9f4a57e2530217e9aad25d8c287e87368f8 --- /dev/null +++ b/libbson/1.24.3/bson_destroy_with_steal.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + bson_destroy_with_steal() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_equal.html b/libbson/1.24.3/bson_equal.html new file mode 100644 index 0000000000000000000000000000000000000000..875fd2cee437f9a22282e9f74200b973136ab571 --- /dev/null +++ b/libbson/1.24.3/bson_equal.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_equal() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_error_t.html b/libbson/1.24.3/bson_error_t.html new file mode 100644 index 0000000000000000000000000000000000000000..8eeec089713955b7dbdc6f7c580bd2fbafee373d --- /dev/null +++ b/libbson/1.24.3/bson_error_t.html @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + bson_error_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_free.html b/libbson/1.24.3/bson_free.html new file mode 100644 index 0000000000000000000000000000000000000000..6113438e82b274c5634f9f777ecd11522dfa18fe --- /dev/null +++ b/libbson/1.24.3/bson_free.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_free() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_get_data.html b/libbson/1.24.3/bson_get_data.html new file mode 100644 index 0000000000000000000000000000000000000000..b9ce65b5159ea2a05e04e93334a0965ac1da5646 --- /dev/null +++ b/libbson/1.24.3/bson_get_data.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_get_data() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_get_major_version.html b/libbson/1.24.3/bson_get_major_version.html new file mode 100644 index 0000000000000000000000000000000000000000..dc99a973e8f11ab3d8e94cf67ba75bfe19dc33c5 --- /dev/null +++ b/libbson/1.24.3/bson_get_major_version.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_get_major_version() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_get_micro_version.html b/libbson/1.24.3/bson_get_micro_version.html new file mode 100644 index 0000000000000000000000000000000000000000..59dd415170ed9fa14942cecb3a74fabf3f9e9d2b --- /dev/null +++ b/libbson/1.24.3/bson_get_micro_version.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_get_micro_version() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_get_minor_version.html b/libbson/1.24.3/bson_get_minor_version.html new file mode 100644 index 0000000000000000000000000000000000000000..d51c17b0f6c7c3dabb7930684e10ca2ae5acab52 --- /dev/null +++ b/libbson/1.24.3/bson_get_minor_version.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_get_minor_version() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_get_monotonic_time.html b/libbson/1.24.3/bson_get_monotonic_time.html new file mode 100644 index 0000000000000000000000000000000000000000..85b8deb425d5191153c8f2c1a229b65c158cf536 --- /dev/null +++ b/libbson/1.24.3/bson_get_monotonic_time.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + System Clock — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_get_version.html b/libbson/1.24.3/bson_get_version.html new file mode 100644 index 0000000000000000000000000000000000000000..2e75c416ff632037140bd92c10d2c6f5a1612737 --- /dev/null +++ b/libbson/1.24.3/bson_get_version.html @@ -0,0 +1,145 @@ + + + + + + + + + + + + + + bson_get_version() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_has_field.html b/libbson/1.24.3/bson_has_field.html new file mode 100644 index 0000000000000000000000000000000000000000..4f9e3780c8b0631e67e1f21ab3482f5441f889a6 --- /dev/null +++ b/libbson/1.24.3/bson_has_field.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_has_field() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_init.html b/libbson/1.24.3/bson_init.html new file mode 100644 index 0000000000000000000000000000000000000000..aa3db982f8d8eef5651fb7623e96f2880bf7fd95 --- /dev/null +++ b/libbson/1.24.3/bson_init.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + bson_init() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_init_from_json.html b/libbson/1.24.3/bson_init_from_json.html new file mode 100644 index 0000000000000000000000000000000000000000..674f789c9d4fc4c9232f8fbf7eee7e20045c2099 --- /dev/null +++ b/libbson/1.24.3/bson_init_from_json.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + bson_init_from_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +

    See also

    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_json_reader_read()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_init_static.html b/libbson/1.24.3/bson_init_static.html new file mode 100644 index 0000000000000000000000000000000000000000..81a875329ddd2c810bb4b2e571b0ed6db522f347 --- /dev/null +++ b/libbson/1.24.3/bson_init_static.html @@ -0,0 +1,194 @@ + + + + + + + + + + + + + + bson_init_static() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_isspace.html b/libbson/1.24.3/bson_isspace.html new file mode 100644 index 0000000000000000000000000000000000000000..aa56a26e64e0b7ec699f65faf0a3a36374bd5c57 --- /dev/null +++ b/libbson/1.24.3/bson_isspace.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_isspace() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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).

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_array.html b/libbson/1.24.3/bson_iter_array.html new file mode 100644 index 0000000000000000000000000000000000000000..5268ad8bb33a8bd136e61dee9fef351117423e75 --- /dev/null +++ b/libbson/1.24.3/bson_iter_array.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_array() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_as_bool.html b/libbson/1.24.3/bson_iter_as_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..0d670f51251a007b8ff27e77bb763040e732b946 --- /dev/null +++ b/libbson/1.24.3/bson_iter_as_bool.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + bson_iter_as_bool() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_as_double.html b/libbson/1.24.3/bson_iter_as_double.html new file mode 100644 index 0000000000000000000000000000000000000000..d877677d5adc2ea05f89e5fcec12ff38b6d7642c --- /dev/null +++ b/libbson/1.24.3/bson_iter_as_double.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + bson_iter_as_double() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_as_int64.html b/libbson/1.24.3/bson_iter_as_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..6b5d2e2090e4d68772ca5e1ce8432050f8565a2f --- /dev/null +++ b/libbson/1.24.3/bson_iter_as_int64.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_as_int64() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_binary.html b/libbson/1.24.3/bson_iter_binary.html new file mode 100644 index 0000000000000000000000000000000000000000..57d3d5b9fd8dca4c27a49aa1fd80d9121e92403c --- /dev/null +++ b/libbson/1.24.3/bson_iter_binary.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_binary() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_bool.html b/libbson/1.24.3/bson_iter_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..5629d0f566c90818164ad61571a0dfbfb903fcc9 --- /dev/null +++ b/libbson/1.24.3/bson_iter_bool.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_bool() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_code.html b/libbson/1.24.3/bson_iter_code.html new file mode 100644 index 0000000000000000000000000000000000000000..547c1f5dc0eca0311d807010c319d2d856722789 --- /dev/null +++ b/libbson/1.24.3/bson_iter_code.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_iter_code() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_codewscope.html b/libbson/1.24.3/bson_iter_codewscope.html new file mode 100644 index 0000000000000000000000000000000000000000..f81b54f00f9422355239cc1d702c167677b55b9c --- /dev/null +++ b/libbson/1.24.3/bson_iter_codewscope.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_iter_codewscope() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_date_time.html b/libbson/1.24.3/bson_iter_date_time.html new file mode 100644 index 0000000000000000000000000000000000000000..1669ffa989dcc78b1c85218675aaba419e276999 --- /dev/null +++ b/libbson/1.24.3/bson_iter_date_time.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_date_time() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_dbpointer.html b/libbson/1.24.3/bson_iter_dbpointer.html new file mode 100644 index 0000000000000000000000000000000000000000..866c276845b8b399f8f4a51334ef6d268832542f --- /dev/null +++ b/libbson/1.24.3/bson_iter_dbpointer.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_dbpointer() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_decimal128.html b/libbson/1.24.3/bson_iter_decimal128.html new file mode 100644 index 0000000000000000000000000000000000000000..bb87d86a952fe309c7ed7a484444269c6c027fff --- /dev/null +++ b/libbson/1.24.3/bson_iter_decimal128.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_iter_decimal128() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_document.html b/libbson/1.24.3/bson_iter_document.html new file mode 100644 index 0000000000000000000000000000000000000000..1d5f95b9f131d945e39662341b5af265ebd1becf --- /dev/null +++ b/libbson/1.24.3/bson_iter_document.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_document() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_double.html b/libbson/1.24.3/bson_iter_double.html new file mode 100644 index 0000000000000000000000000000000000000000..b1ce5617c78a246572c0ab83e8d72016ffedadfe --- /dev/null +++ b/libbson/1.24.3/bson_iter_double.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_double() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_dup_utf8.html b/libbson/1.24.3/bson_iter_dup_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..a976a91278c954140b83136c161e43d5fd15655a --- /dev/null +++ b/libbson/1.24.3/bson_iter_dup_utf8.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_iter_dup_utf8() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_find.html b/libbson/1.24.3/bson_iter_find.html new file mode 100644 index 0000000000000000000000000000000000000000..618d3e17623c0cfd49522a88bde138580f8320ca --- /dev/null +++ b/libbson/1.24.3/bson_iter_find.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_find() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_find_case.html b/libbson/1.24.3/bson_iter_find_case.html new file mode 100644 index 0000000000000000000000000000000000000000..530e30dff4e082a009c1fe22846ea7149bbaeaab --- /dev/null +++ b/libbson/1.24.3/bson_iter_find_case.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_find_case() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_find_descendant.html b/libbson/1.24.3/bson_iter_find_descendant.html new file mode 100644 index 0000000000000000000000000000000000000000..9527666d8bc1375bf3d2bb2c05c572658396419f --- /dev/null +++ b/libbson/1.24.3/bson_iter_find_descendant.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_iter_find_descendant() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_find_w_len.html b/libbson/1.24.3/bson_iter_find_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..5d1fa740be5920b73c8f18acc579e3e677789049 --- /dev/null +++ b/libbson/1.24.3/bson_iter_find_w_len.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_find_w_len() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_init.html b/libbson/1.24.3/bson_iter_init.html new file mode 100644 index 0000000000000000000000000000000000000000..d650a2a0adaa09a13ee2c957e3ef4ddd9970b45a --- /dev/null +++ b/libbson/1.24.3/bson_iter_init.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + bson_iter_init() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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");
+   }
+}
+
    +
    +
    +

    See also

    +
    +
    bson_iter_init()
    +
    +
    +
    bson_iter_init_find()
    +
    +
    +
    bson_iter_init_find_case()
    +
    +
    +
    bson_iter_init_from_data()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_init_find.html b/libbson/1.24.3/bson_iter_init_find.html new file mode 100644 index 0000000000000000000000000000000000000000..0d207788add3cc48d44812d12337321d9336fc07 --- /dev/null +++ b/libbson/1.24.3/bson_iter_init_find.html @@ -0,0 +1,168 @@ + + + + + + + + + + + + + + bson_iter_init_find() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    bson_iter_init()
    +
    +
    +
    bson_iter_init_find()
    +
    +
    +
    bson_iter_init_find_case()
    +
    +
    +
    bson_iter_init_from_data()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_init_find_case.html b/libbson/1.24.3/bson_iter_init_find_case.html new file mode 100644 index 0000000000000000000000000000000000000000..3dccff4a74d37def368c36ec79e58588aaba722d --- /dev/null +++ b/libbson/1.24.3/bson_iter_init_find_case.html @@ -0,0 +1,170 @@ + + + + + + + + + + + + + + bson_iter_init_find_case() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    bson_iter_init()
    +
    +
    +
    bson_iter_init_find()
    +
    +
    +
    bson_iter_init_find_case()
    +
    +
    +
    bson_iter_init_from_data()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_init_find_w_len.html b/libbson/1.24.3/bson_iter_init_find_w_len.html new file mode 100644 index 0000000000000000000000000000000000000000..88a765fc089ba4585480466abc5bd993b1bb8d84 --- /dev/null +++ b/libbson/1.24.3/bson_iter_init_find_w_len.html @@ -0,0 +1,172 @@ + + + + + + + + + + + + + + bson_iter_init_find_w_len() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    bson_iter_init()
    +
    +
    +
    bson_iter_init_find()
    +
    +
    +
    bson_iter_init_find_case()
    +
    +
    +
    bson_iter_init_from_data()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_init_from_data.html b/libbson/1.24.3/bson_iter_init_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..7ee99a2cac4c882f2d0aca3b265b99386890bf7b --- /dev/null +++ b/libbson/1.24.3/bson_iter_init_from_data.html @@ -0,0 +1,193 @@ + + + + + + + + + + + + + + bson_iter_init_from_data() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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");
+   }
+}
+
    +
    +
    +

    See also

    +
    +
    bson_iter_init()
    +
    +
    +
    bson_iter_init_find()
    +
    +
    +
    bson_iter_init_find_case()
    +
    +
    +
    bson_iter_init_from_data()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_init_from_data_at_offset.html b/libbson/1.24.3/bson_iter_init_from_data_at_offset.html new file mode 100644 index 0000000000000000000000000000000000000000..d74138bb3e4dcfa981df45b9f1fda6419eb68022 --- /dev/null +++ b/libbson/1.24.3/bson_iter_init_from_data_at_offset.html @@ -0,0 +1,188 @@ + + + + + + + + + + + + + + bson_iter_init_from_data_at_offset() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_iter_key_len()
    +
    +
    +
    bson_iter_offset()
    +
    +
    +
    bson_get_data()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_int32.html b/libbson/1.24.3/bson_iter_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..98fac6b5f51621743ea93e47c309c350042c8c2f --- /dev/null +++ b/libbson/1.24.3/bson_iter_int32.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_int32() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_int64.html b/libbson/1.24.3/bson_iter_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..626d4baa7391099c50b7ca20bb6b7d31f5c2468c --- /dev/null +++ b/libbson/1.24.3/bson_iter_int64.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_int64() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_key.html b/libbson/1.24.3/bson_iter_key.html new file mode 100644 index 0000000000000000000000000000000000000000..c5b9b13d062dbe07d874e8bf5cb539f21dbb7281 --- /dev/null +++ b/libbson/1.24.3/bson_iter_key.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_key() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_key_len.html b/libbson/1.24.3/bson_iter_key_len.html new file mode 100644 index 0000000000000000000000000000000000000000..d9fb9e011900f5f6e88aa459d6898496b07b63d7 --- /dev/null +++ b/libbson/1.24.3/bson_iter_key_len.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_key_len() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_next.html b/libbson/1.24.3/bson_iter_next.html new file mode 100644 index 0000000000000000000000000000000000000000..e2261955d4beeac844a40167c0617bd7df32ecc6 --- /dev/null +++ b/libbson/1.24.3/bson_iter_next.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_iter_next() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_offset.html b/libbson/1.24.3/bson_iter_offset.html new file mode 100644 index 0000000000000000000000000000000000000000..7a9b6d313088008863a8b2513c429e88b9c7b282 --- /dev/null +++ b/libbson/1.24.3/bson_iter_offset.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_offset() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_oid.html b/libbson/1.24.3/bson_iter_oid.html new file mode 100644 index 0000000000000000000000000000000000000000..9c0067cc9ccdfdc3ff4306042f0eb90b9a441461 --- /dev/null +++ b/libbson/1.24.3/bson_iter_oid.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_oid() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_bool.html b/libbson/1.24.3/bson_iter_overwrite_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..ebee3420d292ea29c121362075e34f51bdc5284c --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_bool.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_bool() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_date_time.html b/libbson/1.24.3/bson_iter_overwrite_date_time.html new file mode 100644 index 0000000000000000000000000000000000000000..8878a955266f5730949a65f8405713b0f3b305ec --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_date_time.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_date_time() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_decimal128.html b/libbson/1.24.3/bson_iter_overwrite_decimal128.html new file mode 100644 index 0000000000000000000000000000000000000000..64b60cd6bee0bd98a43fe1f16d56efc71eeb684f --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_decimal128.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_decimal128() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_double.html b/libbson/1.24.3/bson_iter_overwrite_double.html new file mode 100644 index 0000000000000000000000000000000000000000..bcd9b33077d9fbc47377488ce5ceab0a94fa6608 --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_double.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_double() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_int32.html b/libbson/1.24.3/bson_iter_overwrite_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..14e6be2321d20bb6f20f75b3b85693b8c4d83450 --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_int32.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_int32() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_int64.html b/libbson/1.24.3/bson_iter_overwrite_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..7e983026e0663c437becd6bd61c2431affad7e96 --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_int64.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_int64() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_oid.html b/libbson/1.24.3/bson_iter_overwrite_oid.html new file mode 100644 index 0000000000000000000000000000000000000000..3eb498a35e1c063e275c39cea9273c9b85f0401c --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_oid.html @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + bson_iter_overwrite_oid() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_overwrite_timestamp.html b/libbson/1.24.3/bson_iter_overwrite_timestamp.html new file mode 100644 index 0000000000000000000000000000000000000000..7c8503f2d4ff8de0706f4697c9c512d8ae331b7d --- /dev/null +++ b/libbson/1.24.3/bson_iter_overwrite_timestamp.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_overwrite_timestamp() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_recurse.html b/libbson/1.24.3/bson_iter_recurse.html new file mode 100644 index 0000000000000000000000000000000000000000..982904292ea2efe79b224f014decbd38c33f6a6d --- /dev/null +++ b/libbson/1.24.3/bson_iter_recurse.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_recurse() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_regex.html b/libbson/1.24.3/bson_iter_regex.html new file mode 100644 index 0000000000000000000000000000000000000000..66f2f183f01901d217a58c102f5c2f211fe7c11d --- /dev/null +++ b/libbson/1.24.3/bson_iter_regex.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_iter_regex() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_symbol.html b/libbson/1.24.3/bson_iter_symbol.html new file mode 100644 index 0000000000000000000000000000000000000000..78ae6abf5368e1ffd781ca5fd20e7ca45edac45f --- /dev/null +++ b/libbson/1.24.3/bson_iter_symbol.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_iter_symbol() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_t.html b/libbson/1.24.3/bson_iter_t.html new file mode 100644 index 0000000000000000000000000000000000000000..cb9c9a49b24d6b6548b62dee7334f75e3da8c8d7 --- /dev/null +++ b/libbson/1.24.3/bson_iter_t.html @@ -0,0 +1,295 @@ + + + + + + + + + + + + + + bson_iter_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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));
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_time_t.html b/libbson/1.24.3/bson_iter_time_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a6144ebc3d7ced1dc474fac4cfa1cb5fa212b4b4 --- /dev/null +++ b/libbson/1.24.3/bson_iter_time_t.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_iter_time_t() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_timestamp.html b/libbson/1.24.3/bson_iter_timestamp.html new file mode 100644 index 0000000000000000000000000000000000000000..ddf3d41a025866471ef2040a32f2fd9792c2925b --- /dev/null +++ b/libbson/1.24.3/bson_iter_timestamp.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_iter_timestamp() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_timeval.html b/libbson/1.24.3/bson_iter_timeval.html new file mode 100644 index 0000000000000000000000000000000000000000..3af4867547375e8ed747fb7d50cab75fe716f02b --- /dev/null +++ b/libbson/1.24.3/bson_iter_timeval.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_iter_timeval() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_type.html b/libbson/1.24.3/bson_iter_type.html new file mode 100644 index 0000000000000000000000000000000000000000..f0c9433d2896b8564c807b676b3e709accd707d4 --- /dev/null +++ b/libbson/1.24.3/bson_iter_type.html @@ -0,0 +1,179 @@ + + + + + + + + + + + + + + bson_iter_type() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_utf8.html b/libbson/1.24.3/bson_iter_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..197709846f65bc2d4e9d4d4b91d240e0978787ef --- /dev/null +++ b/libbson/1.24.3/bson_iter_utf8.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_iter_utf8() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_value.html b/libbson/1.24.3/bson_iter_value.html new file mode 100644 index 0000000000000000000000000000000000000000..a5d3e6074ac625471540c311f6d370e5c921d41d --- /dev/null +++ b/libbson/1.24.3/bson_iter_value.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_iter_value() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_iter_visit_all.html b/libbson/1.24.3/bson_iter_visit_all.html new file mode 100644 index 0000000000000000000000000000000000000000..28d211fbe7aad152c25c4ad9aca82e0ec36624c4 --- /dev/null +++ b/libbson/1.24.3/bson_iter_visit_all.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_iter_visit_all() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_data_reader_ingest.html b/libbson/1.24.3/bson_json_data_reader_ingest.html new file mode 100644 index 0000000000000000000000000000000000000000..826d7eab9593292d5f811e579ac377a59d5043f9 --- /dev/null +++ b/libbson/1.24.3/bson_json_data_reader_ingest.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_json_data_reader_ingest() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_data_reader_new.html b/libbson/1.24.3/bson_json_data_reader_new.html new file mode 100644 index 0000000000000000000000000000000000000000..4ee699f0e229414f2c656ed910db86e1f9b8ffc5 --- /dev/null +++ b/libbson/1.24.3/bson_json_data_reader_new.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_json_data_reader_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_mode_t.html b/libbson/1.24.3/bson_json_mode_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b34f7b0911be169d14b1935865c5e7ee28c102b9 --- /dev/null +++ b/libbson/1.24.3/bson_json_mode_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_json_mode_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_opts_destroy.html b/libbson/1.24.3/bson_json_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..2ecbebec6a2826d43acebcf0a5d63901d09704fe --- /dev/null +++ b/libbson/1.24.3/bson_json_opts_destroy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_json_opts_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_opts_new.html b/libbson/1.24.3/bson_json_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..ec6d162980d00e6fc700543fa34aeea70fd1fa24 --- /dev/null +++ b/libbson/1.24.3/bson_json_opts_new.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_json_opts_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_opts_set_outermost_array.html b/libbson/1.24.3/bson_json_opts_set_outermost_array.html new file mode 100644 index 0000000000000000000000000000000000000000..6278652646a56227cc9342a56e1cbe919999488c --- /dev/null +++ b/libbson/1.24.3/bson_json_opts_set_outermost_array.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_json_opts_set_outermost_array() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_opts_t.html b/libbson/1.24.3/bson_json_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..61df4a7e3d85a59fabfe5ddb8606a13cabba53f4 --- /dev/null +++ b/libbson/1.24.3/bson_json_opts_t.html @@ -0,0 +1,171 @@ + + + + + + + + + + + + + + bson_json_opts_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    bson_as_json_with_opts()
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_reader_destroy.html b/libbson/1.24.3/bson_json_reader_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..76ecef281b35433e847ca287128d8e8d714aee00 --- /dev/null +++ b/libbson/1.24.3/bson_json_reader_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_json_reader_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_reader_new.html b/libbson/1.24.3/bson_json_reader_new.html new file mode 100644 index 0000000000000000000000000000000000000000..26d756204a2d77679e601e022a4f8c78bbd42bef --- /dev/null +++ b/libbson/1.24.3/bson_json_reader_new.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_json_reader_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_reader_new_from_fd.html b/libbson/1.24.3/bson_json_reader_new_from_fd.html new file mode 100644 index 0000000000000000000000000000000000000000..f241f67cefc18efd123eafb65be7e52669891d23 --- /dev/null +++ b/libbson/1.24.3/bson_json_reader_new_from_fd.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_json_reader_new_from_fd() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_reader_new_from_file.html b/libbson/1.24.3/bson_json_reader_new_from_file.html new file mode 100644 index 0000000000000000000000000000000000000000..62c0ec4ce5bc73970e09f515cb72c88953d54367 --- /dev/null +++ b/libbson/1.24.3/bson_json_reader_new_from_file.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_json_reader_new_from_file() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_reader_read.html b/libbson/1.24.3/bson_json_reader_read.html new file mode 100644 index 0000000000000000000000000000000000000000..b47eb1ad78eff131c3855c9e886581333c17bffe --- /dev/null +++ b/libbson/1.24.3/bson_json_reader_read.html @@ -0,0 +1,175 @@ + + + + + + + + + + + + + + bson_json_reader_read() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_json_reader_read()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_json_reader_t.html b/libbson/1.24.3/bson_json_reader_t.html new file mode 100644 index 0000000000000000000000000000000000000000..0cf189dc52df6c7a3ba50b97a004bbdda2d9f292 --- /dev/null +++ b/libbson/1.24.3/bson_json_reader_t.html @@ -0,0 +1,263 @@ + + + + + + + + + + + + + + bson_json_reader_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_malloc.html b/libbson/1.24.3/bson_malloc.html new file mode 100644 index 0000000000000000000000000000000000000000..780ce27261ec1936e80c051a43265a535c91d42a --- /dev/null +++ b/libbson/1.24.3/bson_malloc.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_malloc() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_malloc0.html b/libbson/1.24.3/bson_malloc0.html new file mode 100644 index 0000000000000000000000000000000000000000..75f9743a2a2f74a07416584a3b281b87725fa7f4 --- /dev/null +++ b/libbson/1.24.3/bson_malloc0.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_malloc0() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_mem_restore_vtable.html b/libbson/1.24.3/bson_mem_restore_vtable.html new file mode 100644 index 0000000000000000000000000000000000000000..80389875eee6162510ea60310d26c95a6d23badd --- /dev/null +++ b/libbson/1.24.3/bson_mem_restore_vtable.html @@ -0,0 +1,149 @@ + + + + + + + + + + + + + + bson_mem_restore_vtable() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_mem_set_vtable.html b/libbson/1.24.3/bson_mem_set_vtable.html new file mode 100644 index 0000000000000000000000000000000000000000..6111ab740ee17e1f386663e9e526e39f0a39792a --- /dev/null +++ b/libbson/1.24.3/bson_mem_set_vtable.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + bson_mem_set_vtable() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_memory.html b/libbson/1.24.3/bson_memory.html new file mode 100644 index 0000000000000000000000000000000000000000..8e0c260aead23d7af223fb206c49ff7cb099107f --- /dev/null +++ b/libbson/1.24.3/bson_memory.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + Memory Management — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_new.html b/libbson/1.24.3/bson_new.html new file mode 100644 index 0000000000000000000000000000000000000000..983b910eefb8cb23ad77f0cfe0a83506c7920654 --- /dev/null +++ b/libbson/1.24.3/bson_new.html @@ -0,0 +1,185 @@ + + + + + + + + + + + + + + bson_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_new_from_buffer.html b/libbson/1.24.3/bson_new_from_buffer.html new file mode 100644 index 0000000000000000000000000000000000000000..20345eb2b060e8c1fa7ad95373177a302c417bc0 --- /dev/null +++ b/libbson/1.24.3/bson_new_from_buffer.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + bson_new_from_buffer() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_new_from_data.html b/libbson/1.24.3/bson_new_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..86fb5b21accd4292cc55f66b5003008db84139b8 --- /dev/null +++ b/libbson/1.24.3/bson_new_from_data.html @@ -0,0 +1,192 @@ + + + + + + + + + + + + + + bson_new_from_data() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_new_from_json.html b/libbson/1.24.3/bson_new_from_json.html new file mode 100644 index 0000000000000000000000000000000000000000..d78345f3782e4ad242f897ab88c42094af226caf --- /dev/null +++ b/libbson/1.24.3/bson_new_from_json.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + bson_new_from_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +

    See also

    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_json_reader_read()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_compare.html b/libbson/1.24.3/bson_oid_compare.html new file mode 100644 index 0000000000000000000000000000000000000000..5bfc1efed17563dfe05cef9766b09ee1a295a3f8 --- /dev/null +++ b/libbson/1.24.3/bson_oid_compare.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_oid_compare() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_copy.html b/libbson/1.24.3/bson_oid_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..11af126dd0d5848ace1a78a3ba07c819c3ee7f09 --- /dev/null +++ b/libbson/1.24.3/bson_oid_copy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_copy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_equal.html b/libbson/1.24.3/bson_oid_equal.html new file mode 100644 index 0000000000000000000000000000000000000000..0a2de5a1573162b9265d4a156efa80da00968b8b --- /dev/null +++ b/libbson/1.24.3/bson_oid_equal.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_oid_equal() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_get_time_t.html b/libbson/1.24.3/bson_oid_get_time_t.html new file mode 100644 index 0000000000000000000000000000000000000000..9a73b8432855dd98a3f9b759130e04bdeb338071 --- /dev/null +++ b/libbson/1.24.3/bson_oid_get_time_t.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_oid_get_time_t() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_hash.html b/libbson/1.24.3/bson_oid_hash.html new file mode 100644 index 0000000000000000000000000000000000000000..21cc6d0e66fd6855edada32b7487861ad4b030c0 --- /dev/null +++ b/libbson/1.24.3/bson_oid_hash.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_oid_hash() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_init.html b/libbson/1.24.3/bson_oid_init.html new file mode 100644 index 0000000000000000000000000000000000000000..5810ee738ea6c4125ab89082f408c99f327e8b24 --- /dev/null +++ b/libbson/1.24.3/bson_oid_init.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_init() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_init_from_data.html b/libbson/1.24.3/bson_oid_init_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..d974fef37925b55746b224962007509f9c0e16e3 --- /dev/null +++ b/libbson/1.24.3/bson_oid_init_from_data.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_init_from_data() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_init_from_string.html b/libbson/1.24.3/bson_oid_init_from_string.html new file mode 100644 index 0000000000000000000000000000000000000000..ab631cd2aa3ac875dd50ad179ee7ea77a493cd11 --- /dev/null +++ b/libbson/1.24.3/bson_oid_init_from_string.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_oid_init_from_string() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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");
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_init_sequence.html b/libbson/1.24.3/bson_oid_init_sequence.html new file mode 100644 index 0000000000000000000000000000000000000000..b33f4229ef0d8ec38a0024acd73a31549e57b1b6 --- /dev/null +++ b/libbson/1.24.3/bson_oid_init_sequence.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_oid_init_sequence() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_is_valid.html b/libbson/1.24.3/bson_oid_is_valid.html new file mode 100644 index 0000000000000000000000000000000000000000..a4925b56eae82bd167d24c55b22ca9015941e911 --- /dev/null +++ b/libbson/1.24.3/bson_oid_is_valid.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_oid_is_valid() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_t.html b/libbson/1.24.3/bson_oid_t.html new file mode 100644 index 0000000000000000000000000000000000000000..0b4f8a6e2d4c6a43b9f354c9be46558c2c91e3f1 --- /dev/null +++ b/libbson/1.24.3/bson_oid_t.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + bson_oid_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_oid_to_string.html b/libbson/1.24.3/bson_oid_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..78b165f9fe0b9d736d04e6a0f11b8863cbad72cf --- /dev/null +++ b/libbson/1.24.3/bson_oid_to_string.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_oid_to_string() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_destroy.html b/libbson/1.24.3/bson_reader_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..d5a389cc0e3448c78da9fe7943452e4400f8af68 --- /dev/null +++ b/libbson/1.24.3/bson_reader_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_reader_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_destroy_func_t.html b/libbson/1.24.3/bson_reader_destroy_func_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b347e70b843187eee6d1d6ef90d670a699806e97 --- /dev/null +++ b/libbson/1.24.3/bson_reader_destroy_func_t.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_reader_destroy_func_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_new_from_data.html b/libbson/1.24.3/bson_reader_new_from_data.html new file mode 100644 index 0000000000000000000000000000000000000000..e3914fb71438854c4ebde06cf961e05fc552c932 --- /dev/null +++ b/libbson/1.24.3/bson_reader_new_from_data.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_reader_new_from_data() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_new_from_fd.html b/libbson/1.24.3/bson_reader_new_from_fd.html new file mode 100644 index 0000000000000000000000000000000000000000..92f49bc00a0eb33925c16538995318513a51fef0 --- /dev/null +++ b/libbson/1.24.3/bson_reader_new_from_fd.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_reader_new_from_fd() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_new_from_file.html b/libbson/1.24.3/bson_reader_new_from_file.html new file mode 100644 index 0000000000000000000000000000000000000000..5becb079c6c36fa87da9bc59ad5553f38516d7d0 --- /dev/null +++ b/libbson/1.24.3/bson_reader_new_from_file.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + bson_reader_new_from_file() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_new_from_handle.html b/libbson/1.24.3/bson_reader_new_from_handle.html new file mode 100644 index 0000000000000000000000000000000000000000..67139e99b5d01916662fcf9f612cafd4fe8048f0 --- /dev/null +++ b/libbson/1.24.3/bson_reader_new_from_handle.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_reader_new_from_handle() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_read.html b/libbson/1.24.3/bson_reader_read.html new file mode 100644 index 0000000000000000000000000000000000000000..f45637abc53989dd4b9431dfb0af7c0406006ef6 --- /dev/null +++ b/libbson/1.24.3/bson_reader_read.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + bson_reader_read() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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");
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_read_func_t.html b/libbson/1.24.3/bson_reader_read_func_t.html new file mode 100644 index 0000000000000000000000000000000000000000..96904a42cab632dbbdb09e2176b2d7af1a370e0c --- /dev/null +++ b/libbson/1.24.3/bson_reader_read_func_t.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_reader_read_func_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_reset.html b/libbson/1.24.3/bson_reader_reset.html new file mode 100644 index 0000000000000000000000000000000000000000..fdc4373aa7f3c8fa479fad08a2c233d52c1b56cf --- /dev/null +++ b/libbson/1.24.3/bson_reader_reset.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_reader_reset() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_set_destroy_func.html b/libbson/1.24.3/bson_reader_set_destroy_func.html new file mode 100644 index 0000000000000000000000000000000000000000..f79c5acc737627cd8ee61f9fafdc544249798782 --- /dev/null +++ b/libbson/1.24.3/bson_reader_set_destroy_func.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_reader_set_destroy_func() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_set_read_func.html b/libbson/1.24.3/bson_reader_set_read_func.html new file mode 100644 index 0000000000000000000000000000000000000000..0a7621ed99bc6d629e7f260c01fdeda81d6bc726 --- /dev/null +++ b/libbson/1.24.3/bson_reader_set_read_func.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_reader_set_read_func() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_t.html b/libbson/1.24.3/bson_reader_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c853d960195db0d9a918a82fdc89c62e6e407119 --- /dev/null +++ b/libbson/1.24.3/bson_reader_t.html @@ -0,0 +1,262 @@ + + + + + + + + + + + + + + bson_reader_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reader_tell.html b/libbson/1.24.3/bson_reader_tell.html new file mode 100644 index 0000000000000000000000000000000000000000..522c96dde25099fbef6d68ee4db5b2f5f553f1c9 --- /dev/null +++ b/libbson/1.24.3/bson_reader_tell.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_reader_tell() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_realloc.html b/libbson/1.24.3/bson_realloc.html new file mode 100644 index 0000000000000000000000000000000000000000..a8052ce3b7186a7db5327a6e03d8db7d63f28043 --- /dev/null +++ b/libbson/1.24.3/bson_realloc.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + bson_realloc() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_realloc_ctx.html b/libbson/1.24.3/bson_realloc_ctx.html new file mode 100644 index 0000000000000000000000000000000000000000..3db18896697395b1557014469b3fa0c64d86a058 --- /dev/null +++ b/libbson/1.24.3/bson_realloc_ctx.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_realloc_ctx() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_realloc_func.html b/libbson/1.24.3/bson_realloc_func.html new file mode 100644 index 0000000000000000000000000000000000000000..2a58a52970e108dadf588aeaf4ac32f03cfaf164 --- /dev/null +++ b/libbson/1.24.3/bson_realloc_func.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_realloc_func — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reinit.html b/libbson/1.24.3/bson_reinit.html new file mode 100644 index 0000000000000000000000000000000000000000..47341653b226ef56d610f2eb097e99ff9d6ff01b --- /dev/null +++ b/libbson/1.24.3/bson_reinit.html @@ -0,0 +1,188 @@ + + + + + + + + + + + + + + bson_reinit() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_reserve_buffer.html b/libbson/1.24.3/bson_reserve_buffer.html new file mode 100644 index 0000000000000000000000000000000000000000..45eb3149dffa339e1b6a82871aebc4080669a306 --- /dev/null +++ b/libbson/1.24.3/bson_reserve_buffer.html @@ -0,0 +1,267 @@ + + + + + + + + + + + + + + bson_reserve_buffer() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_set_error.html b/libbson/1.24.3/bson_set_error.html new file mode 100644 index 0000000000000000000000000000000000000000..65a2cd1a4a906e434ec2c2441d3e90bb40d43969 --- /dev/null +++ b/libbson/1.24.3/bson_set_error.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_set_error() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_sized_new.html b/libbson/1.24.3/bson_sized_new.html new file mode 100644 index 0000000000000000000000000000000000000000..866bb260c4d230e32bc01ca92b2541128012845b --- /dev/null +++ b/libbson/1.24.3/bson_sized_new.html @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + bson_sized_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    bson_concat()
    +
    +
    +
    bson_init()
    +
    +
    +
    bson_init_from_json()
    +
    +
    +
    bson_init_static()
    +
    +
    +
    bson_new()
    +
    +
    +
    bson_new_from_buffer()
    +
    +
    +
    bson_new_from_data()
    +
    +
    +
    bson_new_from_json()
    +
    +
    +
    bson_reinit()
    +
    +
    +
    bson_reserve_buffer()
    +
    +
    +
    bson_sized_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_snprintf.html b/libbson/1.24.3/bson_snprintf.html new file mode 100644 index 0000000000000000000000000000000000000000..81c7557512c8c04a69a5d3c5326e9ca67674e124 --- /dev/null +++ b/libbson/1.24.3/bson_snprintf.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_snprintf() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_steal.html b/libbson/1.24.3/bson_steal.html new file mode 100644 index 0000000000000000000000000000000000000000..2ca93c0e07609005a27c34feba8ed49e13c5be4e --- /dev/null +++ b/libbson/1.24.3/bson_steal.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + bson_steal() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strcasecmp.html b/libbson/1.24.3/bson_strcasecmp.html new file mode 100644 index 0000000000000000000000000000000000000000..ad9ea450af5acf7b38cc693d9beea05342eb0b6c --- /dev/null +++ b/libbson/1.24.3/bson_strcasecmp.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + bson_strcasecmp() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strdup.html b/libbson/1.24.3/bson_strdup.html new file mode 100644 index 0000000000000000000000000000000000000000..b195df24c596c10594e15ab2bc26fa37e9773ecf --- /dev/null +++ b/libbson/1.24.3/bson_strdup.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_strdup() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strdup_printf.html b/libbson/1.24.3/bson_strdup_printf.html new file mode 100644 index 0000000000000000000000000000000000000000..ecd38ad644057552dae9cd7eda7e68bc5d0baf39 --- /dev/null +++ b/libbson/1.24.3/bson_strdup_printf.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_strdup_printf() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strdupv_printf.html b/libbson/1.24.3/bson_strdupv_printf.html new file mode 100644 index 0000000000000000000000000000000000000000..1e8bfbb44105c2e0d257068ac3438d21baa7b875 --- /dev/null +++ b/libbson/1.24.3/bson_strdupv_printf.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_strdupv_printf() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strerror_r.html b/libbson/1.24.3/bson_strerror_r.html new file mode 100644 index 0000000000000000000000000000000000000000..35e5be8ab96f9192abe2a2860f7308c77db5c128 --- /dev/null +++ b/libbson/1.24.3/bson_strerror_r.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_strerror_r() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strfreev.html b/libbson/1.24.3/bson_strfreev.html new file mode 100644 index 0000000000000000000000000000000000000000..37c8c1f2a535f0423debc0235df52eac83fbb484 --- /dev/null +++ b/libbson/1.24.3/bson_strfreev.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_strfreev() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_append.html b/libbson/1.24.3/bson_string_append.html new file mode 100644 index 0000000000000000000000000000000000000000..e9e773bd3bba659d7a193db19eafbb1af9b6d6ce --- /dev/null +++ b/libbson/1.24.3/bson_string_append.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_string_append() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_append_c.html b/libbson/1.24.3/bson_string_append_c.html new file mode 100644 index 0000000000000000000000000000000000000000..d3084bf88ac9ae83c6235ec533b1f00b281ebc03 --- /dev/null +++ b/libbson/1.24.3/bson_string_append_c.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_string_append_c() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_append_printf.html b/libbson/1.24.3/bson_string_append_printf.html new file mode 100644 index 0000000000000000000000000000000000000000..67bc93347e56cc6d074b620e9c8531fe466a9dab --- /dev/null +++ b/libbson/1.24.3/bson_string_append_printf.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_string_append_printf() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_append_unichar.html b/libbson/1.24.3/bson_string_append_unichar.html new file mode 100644 index 0000000000000000000000000000000000000000..2f677ac98e07f64ee49d974f0cd3667c4adfb47f --- /dev/null +++ b/libbson/1.24.3/bson_string_append_unichar.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_string_append_unichar() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_free.html b/libbson/1.24.3/bson_string_free.html new file mode 100644 index 0000000000000000000000000000000000000000..54c4979c31f35432051efa53c0396c7449daf76b --- /dev/null +++ b/libbson/1.24.3/bson_string_free.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_string_free() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_new.html b/libbson/1.24.3/bson_string_new.html new file mode 100644 index 0000000000000000000000000000000000000000..c77a353e316a6f990dfc4ecdfcc6f0a64e5e0289 --- /dev/null +++ b/libbson/1.24.3/bson_string_new.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_string_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_t.html b/libbson/1.24.3/bson_string_t.html new file mode 100644 index 0000000000000000000000000000000000000000..25009898fd1458b89626a5b5ef12813f2ec2b5ad --- /dev/null +++ b/libbson/1.24.3/bson_string_t.html @@ -0,0 +1,181 @@ + + + + + + + + + + + + + + bson_string_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_string_truncate.html b/libbson/1.24.3/bson_string_truncate.html new file mode 100644 index 0000000000000000000000000000000000000000..ea732fa6e7d8c13ad3de43f83daf6f927b65d87d --- /dev/null +++ b/libbson/1.24.3/bson_string_truncate.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_string_truncate() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strncpy.html b/libbson/1.24.3/bson_strncpy.html new file mode 100644 index 0000000000000000000000000000000000000000..692e58786fa5eca8bc89e4d5d5237edbffe77c42 --- /dev/null +++ b/libbson/1.24.3/bson_strncpy.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_strncpy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strndup.html b/libbson/1.24.3/bson_strndup.html new file mode 100644 index 0000000000000000000000000000000000000000..2943a48bc99888d8333ff81eccdeeeecc34de21c --- /dev/null +++ b/libbson/1.24.3/bson_strndup.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_strndup() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_strnlen.html b/libbson/1.24.3/bson_strnlen.html new file mode 100644 index 0000000000000000000000000000000000000000..97d7971411543b36271120bad0bf61c46ec60112 --- /dev/null +++ b/libbson/1.24.3/bson_strnlen.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_strnlen() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_subtype_t.html b/libbson/1.24.3/bson_subtype_t.html new file mode 100644 index 0000000000000000000000000000000000000000..18766668af5b37b17e522d7df8d2fddd025dc119 --- /dev/null +++ b/libbson/1.24.3/bson_subtype_t.html @@ -0,0 +1,169 @@ + + + + + + + + + + + + + + bson_subtype_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_t.html b/libbson/1.24.3/bson_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b29e7fab25490eff262d59a7e4582ac7faf7afda --- /dev/null +++ b/libbson/1.24.3/bson_t.html @@ -0,0 +1,364 @@ + + + + + + + + + + + + + + bson_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_type_t.html b/libbson/1.24.3/bson_type_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c035b7c6d6edaf43e922b7c640eed1534c82bae9 --- /dev/null +++ b/libbson/1.24.3/bson_type_t.html @@ -0,0 +1,185 @@ + + + + + + + + + + + + + + bson_type_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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");
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_uint32_to_string.html b/libbson/1.24.3/bson_uint32_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..3a3a2173534718a0f72fa956ef46df761176c8bd --- /dev/null +++ b/libbson/1.24.3/bson_uint32_to_string.html @@ -0,0 +1,178 @@ + + + + + + + + + + + + + + bson_uint32_to_string() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_unichar_t.html b/libbson/1.24.3/bson_unichar_t.html new file mode 100644 index 0000000000000000000000000000000000000000..efbc8d91753e9098b1d525b53ae77f58aabcd32f --- /dev/null +++ b/libbson/1.24.3/bson_unichar_t.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_unichar_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+   }
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_utf8_escape_for_json.html b/libbson/1.24.3/bson_utf8_escape_for_json.html new file mode 100644 index 0000000000000000000000000000000000000000..46ebc707a58826756c20c37ffd17fa1050d37d5c --- /dev/null +++ b/libbson/1.24.3/bson_utf8_escape_for_json.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + bson_utf8_escape_for_json() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_utf8_from_unichar.html b/libbson/1.24.3/bson_utf8_from_unichar.html new file mode 100644 index 0000000000000000000000000000000000000000..246c7caeca12c0c06789e9812efaea70769f9499 --- /dev/null +++ b/libbson/1.24.3/bson_utf8_from_unichar.html @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + bson_utf8_from_unichar() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_utf8_get_char.html b/libbson/1.24.3/bson_utf8_get_char.html new file mode 100644 index 0000000000000000000000000000000000000000..674df2a935b25b80d884d3ca6d28f5106d5c1868 --- /dev/null +++ b/libbson/1.24.3/bson_utf8_get_char.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + bson_utf8_get_char() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_utf8_next_char.html b/libbson/1.24.3/bson_utf8_next_char.html new file mode 100644 index 0000000000000000000000000000000000000000..5d51eb08767c3443750a227e88483bf3ee138a66 --- /dev/null +++ b/libbson/1.24.3/bson_utf8_next_char.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_utf8_next_char() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_utf8_validate.html b/libbson/1.24.3/bson_utf8_validate.html new file mode 100644 index 0000000000000000000000000000000000000000..ed530f82da1c3acb7ada03329517dfc0ef7ebbc6 --- /dev/null +++ b/libbson/1.24.3/bson_utf8_validate.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + bson_utf8_validate() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_validate.html b/libbson/1.24.3/bson_validate.html new file mode 100644 index 0000000000000000000000000000000000000000..48e9c794290efd10c32fc20d00a243b04bebb57d --- /dev/null +++ b/libbson/1.24.3/bson_validate.html @@ -0,0 +1,167 @@ + + + + + + + + + + + + + + bson_validate() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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_validate_with_error().
    +
    +
    +
    bson_visitor_t can be used for custom validation, Example Custom Validation.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_validate_with_error.html b/libbson/1.24.3/bson_validate_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..e177db59f912d2149faa9e4a04ec65734b97a186 --- /dev/null +++ b/libbson/1.24.3/bson_validate_with_error.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + bson_validate_with_error() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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_validate().
    +
    +
    +
    bson_visitor_t can be used for custom validation, Example Custom Validation.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_value_copy.html b/libbson/1.24.3/bson_value_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..80c6e040226424a31f248d2dee5377d6a6f430ee --- /dev/null +++ b/libbson/1.24.3/bson_value_copy.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_value_copy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_value_destroy.html b/libbson/1.24.3/bson_value_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..0ef1c9bb292cca29e88c4d3f850c8cff8df58e18 --- /dev/null +++ b/libbson/1.24.3/bson_value_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_value_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_value_t.html b/libbson/1.24.3/bson_value_t.html new file mode 100644 index 0000000000000000000000000000000000000000..5aad5bd75ae1666d818dd5922eec0c0a270e143e --- /dev/null +++ b/libbson/1.24.3/bson_value_t.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + bson_value_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_visitor_t.html b/libbson/1.24.3/bson_visitor_t.html new file mode 100644 index 0000000000000000000000000000000000000000..03cc41a61dff0600ffbda01c96c616a1beb26415 --- /dev/null +++ b/libbson/1.24.3/bson_visitor_t.html @@ -0,0 +1,468 @@ + + + + + + + + + + + + + + bson_visitor_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_vsnprintf.html b/libbson/1.24.3/bson_vsnprintf.html new file mode 100644 index 0000000000000000000000000000000000000000..1d8103d9cc80f233c7924165ef88cb8bbd30dd75 --- /dev/null +++ b/libbson/1.24.3/bson_vsnprintf.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + bson_vsnprintf() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_begin.html b/libbson/1.24.3/bson_writer_begin.html new file mode 100644 index 0000000000000000000000000000000000000000..90e1323c4cffb456a0bb56c5288792cc4c610e35 --- /dev/null +++ b/libbson/1.24.3/bson_writer_begin.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_writer_begin() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_destroy.html b/libbson/1.24.3/bson_writer_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..3f413358885a007cd6ce4388bc696e10a328b6c2 --- /dev/null +++ b/libbson/1.24.3/bson_writer_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_writer_destroy() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_end.html b/libbson/1.24.3/bson_writer_end.html new file mode 100644 index 0000000000000000000000000000000000000000..2259051d5fdb9d9cbbef9c1c42139735cbafb25b --- /dev/null +++ b/libbson/1.24.3/bson_writer_end.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_writer_end() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_get_length.html b/libbson/1.24.3/bson_writer_get_length.html new file mode 100644 index 0000000000000000000000000000000000000000..fa517de3904954e21713034df268dee5292b5a14 --- /dev/null +++ b/libbson/1.24.3/bson_writer_get_length.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + bson_writer_get_length() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_new.html b/libbson/1.24.3/bson_writer_new.html new file mode 100644 index 0000000000000000000000000000000000000000..4cc83a63e46d744b53564cb43390cd58b1253ff5 --- /dev/null +++ b/libbson/1.24.3/bson_writer_new.html @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + bson_writer_new() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_rollback.html b/libbson/1.24.3/bson_writer_rollback.html new file mode 100644 index 0000000000000000000000000000000000000000..de92ce0a47a133746503aaa31a340ba28ad7bd6e --- /dev/null +++ b/libbson/1.24.3/bson_writer_rollback.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + bson_writer_rollback() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_writer_t.html b/libbson/1.24.3/bson_writer_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ad447ee60cb0bb89637d049ce536ed588d0ce72f --- /dev/null +++ b/libbson/1.24.3/bson_writer_t.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + bson_writer_t — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/bson_zero_free.html b/libbson/1.24.3/bson_zero_free.html new file mode 100644 index 0000000000000000000000000000000000000000..3ba91c47e4de57b6b0c4d1cbf54ae68bc6e57bf6 --- /dev/null +++ b/libbson/1.24.3/bson_zero_free.html @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + bson_zero_free() — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/character_and_string_routines.html b/libbson/1.24.3/character_and_string_routines.html new file mode 100644 index 0000000000000000000000000000000000000000..9e41235e351bba254d28eb090bfcead2eafbf1f4 --- /dev/null +++ b/libbson/1.24.3/character_and_string_routines.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + Character and String Routines — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Character and String Routines

    +

    We provide a small number of character and string routines to substitute for those that are not available on all platforms, and routines to make UTF-8 character manipulation convenient.

    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/creating.html b/libbson/1.24.3/creating.html new file mode 100644 index 0000000000000000000000000000000000000000..257a4dd7e1c488ab76d092dc87f70f24f72d754f --- /dev/null +++ b/libbson/1.24.3/creating.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + Creating a BSON Document — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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" } ] } }
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/cross-platform-notes.html b/libbson/1.24.3/cross-platform-notes.html new file mode 100644 index 0000000000000000000000000000000000000000..f53e42b1560fdc52fb7988f4f21c03c69021b434 --- /dev/null +++ b/libbson/1.24.3/cross-platform-notes.html @@ -0,0 +1,121 @@ + + + + + + + + + + + + + + Cross Platform Notes — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Cross Platform Notes

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/endianness.html b/libbson/1.24.3/endianness.html new file mode 100644 index 0000000000000000000000000000000000000000..08e51a64e95abff247606442769e660dfa0bc07e --- /dev/null +++ b/libbson/1.24.3/endianness.html @@ -0,0 +1,117 @@ + + + + + + + + + + + + + + Endianness — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/errors.html b/libbson/1.24.3/errors.html new file mode 100644 index 0000000000000000000000000000000000000000..05613a572db305cdfed31f7dafc473c681f53ccf --- /dev/null +++ b/libbson/1.24.3/errors.html @@ -0,0 +1,105 @@ + + + + + + + + + + + + + + Handling Errors — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/full_index.html b/libbson/1.24.3/full_index.html new file mode 100644 index 0000000000000000000000000000000000000000..b113835baf9bd3add60f91f50b5bc3a6a889122e --- /dev/null +++ b/libbson/1.24.3/full_index.html @@ -0,0 +1,396 @@ + + + + + + + + + + + + + + Index — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Index

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/guides.html b/libbson/1.24.3/guides.html new file mode 100644 index 0000000000000000000000000000000000000000..80f25413673e87b32e690416a3f87972dde28b05 --- /dev/null +++ b/libbson/1.24.3/guides.html @@ -0,0 +1,121 @@ + + + + + + + + + + + + + + Guides — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Guides

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/include-and-link.html b/libbson/1.24.3/include-and-link.html new file mode 100644 index 0000000000000000000000000000000000000000..58c16797fea99b4528ed786f61a1839520e5c052 --- /dev/null +++ b/libbson/1.24.3/include-and-link.html @@ -0,0 +1,182 @@ + + + + + + + + + + + + + + Using libbson In Your C Program — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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)
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/index.html b/libbson/1.24.3/index.html new file mode 100644 index 0000000000000000000000000000000000000000..56cb02690ed32916a804fc0fd09097a167be8967 --- /dev/null +++ b/libbson/1.24.3/index.html @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + libbson — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + +
    + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/json.html b/libbson/1.24.3/json.html new file mode 100644 index 0000000000000000000000000000000000000000..b747b4af9ae521bcea23f216731b60aa4156c993 --- /dev/null +++ b/libbson/1.24.3/json.html @@ -0,0 +1,348 @@ + + + + + + + + + + + + + + JSON — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/objects.inv b/libbson/1.24.3/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..0c9d44fe49c401bd1bea5807f4dabead6eca14f5 Binary files /dev/null and b/libbson/1.24.3/objects.inv differ diff --git a/libbson/1.24.3/oid.html b/libbson/1.24.3/oid.html new file mode 100644 index 0000000000000000000000000000000000000000..61b891d88bfda84c653fac6953dd9d2f31ca6bdb --- /dev/null +++ b/libbson/1.24.3/oid.html @@ -0,0 +1,180 @@ + + + + + + + + + + + + + + ObjectIDs — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/parsing.html b/libbson/1.24.3/parsing.html new file mode 100644 index 0000000000000000000000000000000000000000..bf3bc4791cea5c5c4970d1d6652b90145c870014 --- /dev/null +++ b/libbson/1.24.3/parsing.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + Parsing and Iterating BSON Documents — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/search.html b/libbson/1.24.3/search.html new file mode 100644 index 0000000000000000000000000000000000000000..1b0cac9efdcac60862e6c4359e5cfc3dd2fe7582 --- /dev/null +++ b/libbson/1.24.3/search.html @@ -0,0 +1,117 @@ + + + + + + + + + + + + + Search — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +

    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. +

    +
    + + + +
    + +
    + +
    + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/searchindex.js b/libbson/1.24.3/searchindex.js new file mode 100644 index 0000000000000000000000000000000000000000..238e7ccc47feec2b6395e09e9d12ef05e9ebe72c --- /dev/null +++ b/libbson/1.24.3/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.3/streaming-bson.html b/libbson/1.24.3/streaming-bson.html new file mode 100644 index 0000000000000000000000000000000000000000..13de95bc836af2d604aacc8078b635261ad8e7e1 --- /dev/null +++ b/libbson/1.24.3/streaming-bson.html @@ -0,0 +1,196 @@ + + + + + + + + + + + + + + Streaming BSON — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/threading.html b/libbson/1.24.3/threading.html new file mode 100644 index 0000000000000000000000000000000000000000..0b02f8f7edd321a15d3b37c43aef35ff7f8b7d3f --- /dev/null +++ b/libbson/1.24.3/threading.html @@ -0,0 +1,118 @@ + + + + + + + + + + + + + + Threading — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/tutorial.html b/libbson/1.24.3/tutorial.html new file mode 100644 index 0000000000000000000000000000000000000000..57758d9736a2be913227a5efbd331e4f6e6f9af6 --- /dev/null +++ b/libbson/1.24.3/tutorial.html @@ -0,0 +1,129 @@ + + + + + + + + + + + + + + Tutorial — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Tutorial

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/utf8.html b/libbson/1.24.3/utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..6e0461f3d10f47fddb7054d885abab3ff5145c44 --- /dev/null +++ b/libbson/1.24.3/utf8.html @@ -0,0 +1,141 @@ + + + + + + + + + + + + + + UTF-8 — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/1.24.3/version.html b/libbson/1.24.3/version.html new file mode 100644 index 0000000000000000000000000000000000000000..9bd5f5b2d9c4c3a1b095297b9b309c118b22a578 --- /dev/null +++ b/libbson/1.24.3/version.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + Libbson Versioning — libbson 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libbson/current b/libbson/current index 0b4c970ea2c7b506f928cbe70c316cd3fee29fe4..95587e55b3bd11b5874af3b55d681964e0f2fdcf 120000 --- a/libbson/current +++ b/libbson/current @@ -1 +1 @@ -1.24.2 \ No newline at end of file +1.24.3 \ No newline at end of file diff --git a/libbson/index.html b/libbson/index.html index 93ebc4138d8af7ea372196717d688994a5a164b9..6d8a03b798f7527b7b177b80fb672b7171e75aa9 100644 --- a/libbson/index.html +++ b/libbson/index.html @@ -1,11 +1,10 @@ - + - + - - + + - libbson Releases — MongoDB C Driver 1.24.2 + libbson Releases — MongoDB C Driver 1.24.3 + + + + - + @@ -45,7 +48,7 @@
  • previous
    • -
  • MongoDB C Driver 1.24.2 »
    • +
  • MongoDB C Driver 1.24.3 »
    • @@ -53,110 +56,111 @@
    -
    -

    libbson Releases

    -

    Latest Release (1.24.2)

    +
    +

    libbson Releases

    +

    Latest Release (1.24.3)

    Current Development (master)

    -
    +
    @@ -165,7 +169,7 @@
    © Copyright 2017, MongoDB, Inc. - Created using Sphinx 1.8.0. + Created using Sphinx 5.3.0.
    diff --git a/libmongoc-releases.html b/libmongoc-releases.html index f8c6c1df89502985853d7db6d056f3d598a05094..048f662c22290686f1b70863c87f7dda1412622d 100644 --- a/libmongoc-releases.html +++ b/libmongoc-releases.html @@ -1,11 +1,10 @@ - + - + - - + + - libmongoc Releases — MongoDB C Driver 1.24.2 + libmongoc Releases — MongoDB C Driver 1.24.3 + + + + - + @@ -49,7 +52,7 @@
  • previous |
    • -
  • MongoDB C Driver 1.24.2 »
    • +
  • MongoDB C Driver 1.24.3 »
    • @@ -57,111 +60,112 @@
    -
    -

    libmongoc Releases

    -

    Latest Release (1.24.2)

    +
    +

    libmongoc Releases

    +

    Latest Release (1.24.3)

    Current Development (master)

    -
    +
    @@ -170,7 +174,7 @@
    © Copyright 2017, MongoDB, Inc. - Created using Sphinx 1.8.0. + Created using Sphinx 5.3.0.
    diff --git a/libmongoc/1.24.2/advanced-connections.html b/libmongoc/1.24.2/advanced-connections.html index 09c7bb9d41af43b68a57967a8318c2a8944b2d41..71454d95818f27d95b965b7466dec26b547b34de 100644 --- a/libmongoc/1.24.2/advanced-connections.html +++ b/libmongoc/1.24.2/advanced-connections.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/aggregate.html b/libmongoc/1.24.2/aggregate.html index 88931d543a564f51561e1d4cd7da73f41c248a01..40d6caf5bfd57d2ed0091f0b85c03a0478696347 100644 --- a/libmongoc/1.24.2/aggregate.html +++ b/libmongoc/1.24.2/aggregate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/api.html b/libmongoc/1.24.2/api.html index 2f6cbeb53ff00343632551df1b076e7f533edf01..b4813d370d276d36f8c86208524254bcc021beea 100644 --- a/libmongoc/1.24.2/api.html +++ b/libmongoc/1.24.2/api.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/application-performance-monitoring.html b/libmongoc/1.24.2/application-performance-monitoring.html index 4f923ce6faab8bbf59a95341484702347f9cb238..28540d01044c2e64846574061dbaeb24517ea0b8 100644 --- a/libmongoc/1.24.2/application-performance-monitoring.html +++ b/libmongoc/1.24.2/application-performance-monitoring.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/authentication.html b/libmongoc/1.24.2/authentication.html index 3cd26c029ab1bf76f0945f0537159e67199cea60..1d6b89dab0f2304b3286c51c15b8568e091c7cf7 100644 --- a/libmongoc/1.24.2/authentication.html +++ b/libmongoc/1.24.2/authentication.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/basic-troubleshooting.html b/libmongoc/1.24.2/basic-troubleshooting.html index 57bebeec0ef6121c7fce3de5070b256ff7af531b..b5456b5c7c83b9b3f4cb07cfdf36cb529c41b7d1 100644 --- a/libmongoc/1.24.2/basic-troubleshooting.html +++ b/libmongoc/1.24.2/basic-troubleshooting.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/bulk.html b/libmongoc/1.24.2/bulk.html index 5633da5defdf5b0c0c16a6e0554bac76e435f1bd..38f845d3de3d9829003848312af455f6752a1bf8 100644 --- a/libmongoc/1.24.2/bulk.html +++ b/libmongoc/1.24.2/bulk.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/client-side-field-level-encryption.html b/libmongoc/1.24.2/client-side-field-level-encryption.html index 822569d1a9182180fce8e4e2e6d2222e5655bc0c..ac5be79150902deebdd1c229c0fbca61f74bba89 100644 --- a/libmongoc/1.24.2/client-side-field-level-encryption.html +++ b/libmongoc/1.24.2/client-side-field-level-encryption.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/configuring_tls.html b/libmongoc/1.24.2/configuring_tls.html index 4a08b7f1b0f4d3469368b27bf4d2ac89103a4eb0..eb66a523607319b4c6ae335d32832767fdc23db4 100644 --- a/libmongoc/1.24.2/configuring_tls.html +++ b/libmongoc/1.24.2/configuring_tls.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/connection-pooling.html b/libmongoc/1.24.2/connection-pooling.html index abc3c48ecf20dfa6c2d1d26ec56118aa3c8a4fff..8591380a65c88e737edd6521217979fe053b81df 100644 --- a/libmongoc/1.24.2/connection-pooling.html +++ b/libmongoc/1.24.2/connection-pooling.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/cursors.html b/libmongoc/1.24.2/cursors.html index 0fcfa70246b437da90e5b4eb178327e9d1d21be9..f72bf01117c36fc5c4961517e1bed4836b3d402d 100644 --- a/libmongoc/1.24.2/cursors.html +++ b/libmongoc/1.24.2/cursors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/debugging.html b/libmongoc/1.24.2/debugging.html index 9f9bc2d24a3ad8e6956a151c67b94c31e6475259..aabe561f3cfd1ae90ec1d1746a021dbc08da69d0 100644 --- a/libmongoc/1.24.2/debugging.html +++ b/libmongoc/1.24.2/debugging.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/distinct-mapreduce.html b/libmongoc/1.24.2/distinct-mapreduce.html index f79f846d2428f41fc1e7f554ae2babca84a5153e..cfd1aff30a3410307ec41f3a0498d8cc6b34cb78 100644 --- a/libmongoc/1.24.2/distinct-mapreduce.html +++ b/libmongoc/1.24.2/distinct-mapreduce.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/errors.html b/libmongoc/1.24.2/errors.html index 6f8a634eed76243f34578e63f304595a364d834f..d6b808773bfa887a57d88558f9f802d1f41ae364 100644 --- a/libmongoc/1.24.2/errors.html +++ b/libmongoc/1.24.2/errors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/full_index.html b/libmongoc/1.24.2/full_index.html index adac8da70e5ec35b2606bcabceb12b8e598e4588..bc55e853322ff59ce608965ed76b325c9bef2a5f 100644 --- a/libmongoc/1.24.2/full_index.html +++ b/libmongoc/1.24.2/full_index.html @@ -35,6 +35,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/gridfs.html b/libmongoc/1.24.2/gridfs.html index 3beda2bf4e78729fbbe682bbdf334d0f6b3d2204..0de7a93a2ecf6e4e4530e96ca8874729356f84b2 100644 --- a/libmongoc/1.24.2/gridfs.html +++ b/libmongoc/1.24.2/gridfs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/guides.html b/libmongoc/1.24.2/guides.html index 8cd590865f251f31599ac9898d986aa4b98902b9..5f182af51f130251c828e1d391dfc9bdf31d410d 100644 --- a/libmongoc/1.24.2/guides.html +++ b/libmongoc/1.24.2/guides.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/in-use-encryption.html b/libmongoc/1.24.2/in-use-encryption.html index 4017aa2aa6010c197717362f209104685f514c64..60c52081b6f2c5c2b05e302ed7d2f068aa46a6aa 100644 --- a/libmongoc/1.24.2/in-use-encryption.html +++ b/libmongoc/1.24.2/in-use-encryption.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/index.html b/libmongoc/1.24.2/index.html index 0847737737e14f9bda9f7e6a70681b40ca1d0627..9e6601f7a4d5ddd5d6843dead700d6865231e652 100644 --- a/libmongoc/1.24.2/index.html +++ b/libmongoc/1.24.2/index.html @@ -36,6 +36,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/init-cleanup.html b/libmongoc/1.24.2/init-cleanup.html index b38716f183e501d3168215b608d9d589a5fc8bbd..72395d7609c238aff1d65f9258507903e140367b 100644 --- a/libmongoc/1.24.2/init-cleanup.html +++ b/libmongoc/1.24.2/init-cleanup.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/installing.html b/libmongoc/1.24.2/installing.html index 0b2b3681cc5a2e81ccca46b64ce43da7812bda47..3ad83ef131167662535f29dd76f40230d162d140 100644 --- a/libmongoc/1.24.2/installing.html +++ b/libmongoc/1.24.2/installing.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/lifecycle.html b/libmongoc/1.24.2/lifecycle.html index 0379d17f287a4400f58d811c52773ee6489cc71e..20d62c5ba09e781a5b6785c392af673ca30ca558 100644 --- a/libmongoc/1.24.2/lifecycle.html +++ b/libmongoc/1.24.2/lifecycle.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/logging.html b/libmongoc/1.24.2/logging.html index 235ddf3546a06821d8743597a9ea9ede9c06fca2..af03d759cc30b687e3ef856e8c1fd187a556278b 100644 --- a/libmongoc/1.24.2/logging.html +++ b/libmongoc/1.24.2/logging.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/manage-collection-indexes.html b/libmongoc/1.24.2/manage-collection-indexes.html index 02012d3a201cefb116a23695ac99e1980896a08b..a84f6fe9579507e0e1912ffd1b2836ef3c70001d 100644 --- a/libmongoc/1.24.2/manage-collection-indexes.html +++ b/libmongoc/1.24.2/manage-collection-indexes.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc-common-task-examples.html b/libmongoc/1.24.2/mongoc-common-task-examples.html index 82edc6a487b0c95167beb6467d4693cd1b806d82..7adb6c63fac0f528f12f06f63b833205da1eea10 100644 --- a/libmongoc/1.24.2/mongoc-common-task-examples.html +++ b/libmongoc/1.24.2/mongoc-common-task-examples.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_callbacks_destroy.html b/libmongoc/1.24.2/mongoc_apm_callbacks_destroy.html index dfb92182eccf5d7e3d945343b197e29bbf10094f..e497a3b5868405f169caec3a1a3d752b780b3102 100644 --- a/libmongoc/1.24.2/mongoc_apm_callbacks_destroy.html +++ b/libmongoc/1.24.2/mongoc_apm_callbacks_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_callbacks_new.html b/libmongoc/1.24.2/mongoc_apm_callbacks_new.html index 0edc89ce120402db72cd4cb8bc37a8d0c0d140bd..b195b90fd3b23a65cb31ca3419d85d35ed66975e 100644 --- a/libmongoc/1.24.2/mongoc_apm_callbacks_new.html +++ b/libmongoc/1.24.2/mongoc_apm_callbacks_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_callbacks_t.html b/libmongoc/1.24.2/mongoc_apm_callbacks_t.html index 506c26f5492434c3bcfc6e70ac1239d894ee7fb8..92708b1586b3f59c6070a5e849354477da88a0fe 100644 --- a/libmongoc/1.24.2/mongoc_apm_callbacks_t.html +++ b/libmongoc/1.24.2/mongoc_apm_callbacks_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_command_name.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_command_name.html index 2f2303556833b3dbf66150275917e98889cb44fd..d87b621292845a55b263186d6b7de81df0de16d3 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_command_name.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_command_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_context.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_context.html index b622e6867bdaf1ab9d099577c50d4484225c5519..65650f710f1e1b5de2e7bacf3c288817446f7e8e 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_duration.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_duration.html index afb631d040845012d35242e2b6df0e31564d7985..2293d2ade2501981adf907b5b3fbc0aa8f0f5fea 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_duration.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_duration.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_error.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_error.html index 4722500926e7733f83cf35d55693b32e3274f61a..9d762137bd80c3c63b0912492dfb84c096bae712 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_error.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_host.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_host.html index cc29f2d7d1ed6b405f0510d91092379f8cd49063..c93505b75b9b580cfc2e7ee308b1c0eef4cd290f 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_operation_id.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_operation_id.html index 0e08a1279a5bb7bd4533202258b9c959f604f0b6..50b76e1e69cc7f42038c9ac7c102c9d85c99b6a2 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_operation_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_operation_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_reply.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_reply.html index 98501f16656615f82cf81d02ed086deced841607..7ed5827a256836645eb77233b797295a9c5a436f 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_reply.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_reply.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_request_id.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_request_id.html index 66f13217f590377a5c6f5709922526af2a9b271f..959bb523966b0ea56bae8567037a8c97c920f883 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_request_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_request_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id.html index e0b4b9ce36a56bce1e61381aefa376a3cffbe6ca..15f3c4957fc40c087c6c4a231fcdac10ab7e65bf 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id_int64.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id_int64.html index 5d436130fda5f84f3c4d0e3b1b838bb9aa32eb8a..22b8dcb1fb342398ee63f324d3c9be2911f25000 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id_int64.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_connection_id_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_id.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_id.html index be961f9d6bc8e6f5393d18879caf18856b014040..e3bcda63e8391baeab0eb98e87f74ac0da5f87f2 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_server_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_get_service_id.html b/libmongoc/1.24.2/mongoc_apm_command_failed_get_service_id.html index df25cfb6be4be53a971afcecd1fd8dce36b55626..0a7388ca1169f00046fd744abc763b6f7d8ccd6a 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_get_service_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_get_service_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_failed_t.html b/libmongoc/1.24.2/mongoc_apm_command_failed_t.html index 16b949c81a5ea83b9af52393f18970b19cb7de7d..b50a1f2f3e7349cb964a4ae7236cfdfaa4e18b30 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_failed_t.html +++ b/libmongoc/1.24.2/mongoc_apm_command_failed_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_command.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_command.html index 9fb908a5a07797acfde08db1860a43f72716d94a..74a331d8260bccdc8bccbb783e6483ee0cae75b1 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_command.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_command.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_command_name.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_command_name.html index 00837ef41a24d6de762c416b95d8667fad420c93..e6bcd1a0cef35bbaaddf162cb86e7abaa7823fae 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_command_name.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_command_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_context.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_context.html index 3e29ce2d00c38492f61b90765e728dd70c4b9b92..a0a408e7e4a03e7c58b7de05b2142542e336d3ad 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_database_name.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_database_name.html index 3a945d120bda755263f361c584f53b76e90252d1..44813f551352b5388dfdcb33026225215908502f 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_database_name.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_database_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_host.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_host.html index 1e1470c9486ddc3c6851e6c1fab87a5d950c5b03..09cd9a27072a2bc2be97527941c3870c5f459641 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_operation_id.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_operation_id.html index 7f1a8a4f46739a64c1c3a57253ddd01f01f2118d..5cf6de719aabf5557f8b21c5ccf9bde1853098a5 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_operation_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_operation_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_request_id.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_request_id.html index 8079b830dac67232bee4425f478870454413b07a..cdbda12e1fc7fb61a9b3800d46a8cb82379ccb3e 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_request_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_request_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id.html index 0e3d03a01445034e1066bf07b7376d7ffaa67a69..92e0e16f73f74205ba15cd5e2436ca7fd1a2678c 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id_int64.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id_int64.html index feab58bd076ca94c7e230045669482f1fb58e22b..f16a2ff2cba1bd743fb85d5da12a132568192bb7 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id_int64.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_server_connection_id_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_server_id.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_server_id.html index c186a4483203bf9d3ea8810f63e567bcbf1f03f4..f3fd5ee80baffa9d0c5f3b50b1049132e43ac647 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_server_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_server_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_get_service_id.html b/libmongoc/1.24.2/mongoc_apm_command_started_get_service_id.html index 2a383c424255e428688df3cca6ccfd366510e092..b3bb7c26b91987d8b1f17aee3e6f0f04375c696a 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_get_service_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_get_service_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_started_t.html b/libmongoc/1.24.2/mongoc_apm_command_started_t.html index 9ed13a7a01be842d1bed0d837fc44d747ebd800e..cd4fca7627edf158950b2916eb39767595ffa40c 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_started_t.html +++ b/libmongoc/1.24.2/mongoc_apm_command_started_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_command_name.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_command_name.html index ebc207c3ca1f45964d266655ee6129bf0283c200..bc150bd451a68d8c4e3817a1ff7db454e43f850f 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_command_name.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_command_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_context.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_context.html index 9c59ec7c64b18cc136135c9b097c36daa168da0f..c8b781d8da5b78f9572517064f73b178f36922fc 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_duration.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_duration.html index 18916054735910ad7a4f75567abda03834466d6a..42b4d00aca7846f1da21ed8306559cc83d353cb0 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_duration.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_duration.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_host.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_host.html index 0f58bf76d52592a78d1b0a4cb1e94700533f8a96..7f18e14df7ad394a12b991ec6c0a5808f1372006 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_operation_id.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_operation_id.html index a342b0a7e5d8610143f5d6772ccdbce05f4f7245..83e53bcfdc030ebb84a4bf1846f6c4a787ce698d 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_operation_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_operation_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_reply.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_reply.html index bfb9a45e998e2eafa897a14e97ba7d8d3993d5ef..51dca4301bf5b22c13593fca5eb50e6fd8a1ed55 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_reply.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_reply.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_request_id.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_request_id.html index 52af8079c7d48deea8d1d27dedb7cb37ed6e6da1..14bfe3686727f2f4590b25a062b843d6f3b32ccd 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_request_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_request_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id.html index edb8e1768f62b2a656549d92bb291b886106298e..1b0aec37480ab3760e297a5f1d618716900625f0 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id_int64.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id_int64.html index 805df1149d5507916744ba9a8c829400ecf7b809..f5edccf0d4358ed67c948ec4736805efbf75ef25 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id_int64.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_connection_id_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_id.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_id.html index 44fedca559b47a1586d871f58744fd5de44c75bb..954f2cb12ed738434b7986c51ba547396d66ded0 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_server_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_service_id.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_service_id.html index 0eee79a1f04d26cf2c7a173de0b8b549bdf97baf..68b2e121c17792980a88b46d71def419309948fc 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_service_id.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_get_service_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_command_succeeded_t.html b/libmongoc/1.24.2/mongoc_apm_command_succeeded_t.html index 32b01d72d1daa70e0a0e86b7f164b78298c50927..c4ce26afa05006341ac1cea512312955e370bdd2 100644 --- a/libmongoc/1.24.2/mongoc_apm_command_succeeded_t.html +++ b/libmongoc/1.24.2/mongoc_apm_command_succeeded_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_changed_get_context.html b/libmongoc/1.24.2/mongoc_apm_server_changed_get_context.html index 976197c07dc6843f1ee76ea9e1ee4cf301743984..b5c4feda474516eba8a0d6a21281a902d8bf3cde 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_changed_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_server_changed_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_changed_get_host.html b/libmongoc/1.24.2/mongoc_apm_server_changed_get_host.html index b4e95d54a10e69894ce6d280330f5f6b4039ddaa..3f3b9b58ea5c56611acd8cf77e945cf72ff530f6 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_changed_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_server_changed_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_changed_get_new_description.html b/libmongoc/1.24.2/mongoc_apm_server_changed_get_new_description.html index 7257aecf9c7abd9ac6c396535fe88eeab225d244..90379aa060e6b9f80b39c504947033751e1630ef 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_changed_get_new_description.html +++ b/libmongoc/1.24.2/mongoc_apm_server_changed_get_new_description.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_changed_get_previous_description.html b/libmongoc/1.24.2/mongoc_apm_server_changed_get_previous_description.html index 1f01bd8d96365e61c34799a049973e0fff8ee8f4..483989561158d14628217ba39b26e59e44e7834c 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_changed_get_previous_description.html +++ b/libmongoc/1.24.2/mongoc_apm_server_changed_get_previous_description.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_changed_get_topology_id.html b/libmongoc/1.24.2/mongoc_apm_server_changed_get_topology_id.html index 059ef8a889b181f73d1d4d60cef60326ca40fd26..6515aeab224c6ff7e1fd3d0d8b30636c28a29d40 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_changed_get_topology_id.html +++ b/libmongoc/1.24.2/mongoc_apm_server_changed_get_topology_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_changed_t.html b/libmongoc/1.24.2/mongoc_apm_server_changed_t.html index aaa90fab844442d655ecd3203c9fdadeab42f71b..7bee638b422a33475a7020a1070dff4eccb62cd5 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_changed_t.html +++ b/libmongoc/1.24.2/mongoc_apm_server_changed_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_closed_get_context.html b/libmongoc/1.24.2/mongoc_apm_server_closed_get_context.html index b2955542506be55bcbc20d52ce127ab4a6d800a4..588d736f215bdf98ea4003de5ebcce620aac4f5f 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_closed_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_server_closed_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_closed_get_host.html b/libmongoc/1.24.2/mongoc_apm_server_closed_get_host.html index 8dfbc7cc543ade305970083cb738e8dd35e3a35f..3481179bec5c615a84538706167f9cde525410f1 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_closed_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_server_closed_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_closed_get_topology_id.html b/libmongoc/1.24.2/mongoc_apm_server_closed_get_topology_id.html index 562054c394d587e626dfae3e84e4884c55fe12ea..7d7e178a901731a16cb408e7f9a209d0067e8519 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_closed_get_topology_id.html +++ b/libmongoc/1.24.2/mongoc_apm_server_closed_get_topology_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_closed_t.html b/libmongoc/1.24.2/mongoc_apm_server_closed_t.html index 551240b287cdf795ed3d16bacfe1cba38bbfc7cf..1a65aef58f0ba225ecc00d137f48fc51407059c1 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_closed_t.html +++ b/libmongoc/1.24.2/mongoc_apm_server_closed_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_awaited.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_awaited.html index e470eb2da87492000447e1debae8e7ea84349fad..ae045f936b6458eee3fbca960b1123a7690dd702 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_awaited.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_awaited.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_context.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_context.html index 372ea60aa68cc1ab2fa72ecba1e6be8012792fab..439e1681e5a5210d4fe7b28db29ab22bb0d87717 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_duration.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_duration.html index 8a1344ed1f664e1f009e9112c243842ba5106867..778a9c64eaa31e5646fce0b2b1bde1ba45c5340d 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_duration.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_duration.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_error.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_error.html index c785259a23649d43085b9c39d172f62eb663fe16..068a2febca6ee6b4028bbd8f22cfdb755e5c6c6a 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_error.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_host.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_host.html index 63bbf6eca9747a0ccdae49ddfbae6768b8194c17..fc95febd05a0a781b4b1d21832cf3ab75aeae896 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_t.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_t.html index 0a9cd8635812bd41e1f31523ff928eab50745e67..59eb8df42467f8261205d4cb6ac747ae37766a8d 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_t.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_failed_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_awaited.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_awaited.html index 1cb6aa88ff7ec2aff5e6efbe1938273391f221f7..ced7737b8005ced74c573f21a1b14c445c509a13 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_awaited.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_awaited.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_context.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_context.html index 47dc1d71ea35cf04ffa00278662972085d749673..f81813db7bd5f6b22be301e706dc645f026036b5 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_host.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_host.html index 2484d9177e4dac8d6dca8925d0ac2b3381219f5f..f8bfcfbfdd86ab619ef3a7718f0b5a2ea8c92e43 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_t.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_t.html index 718f9d840f56f1dacf878834b0483e03fef6c007..dfc7b5b3dd4736d091a0e9dce3146e33f1c5e90f 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_t.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_started_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_awaited.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_awaited.html index 79b1307dd2be40fcae70155cfd3615e9fdb99418..85901897f14cb85cd5594ac1849e9724fecdd244 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_awaited.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_awaited.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_context.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_context.html index 766b5c1f30c9fdfb64de63e484f53a14d0062413..e430bb1501e5c55100d1706b53b3e13e2173c0f2 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_duration.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_duration.html index 08e01a2b1e18d8a3d4f7e4e90871a3b72867956a..5cd63e4d1121bb556fc85288b926df17228c6ffd 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_duration.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_duration.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_host.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_host.html index 39f5344eac90bc98d99159e0763964de8cc8a174..004897fea46ccb3e707aed630b3d7b76ba684c4b 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_reply.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_reply.html index 85c9601dfa6e08c4d924c84db4f46fac74a322d8..37aca4d01646f40a38fd4010fd77d6e88741d8c7 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_reply.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_get_reply.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_t.html b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_t.html index 604b87b11f0d0278931ccf440bc8d5ae6bd31fad..abf4277bc9ed16fd606c1788d21d227cff40f98c 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_t.html +++ b/libmongoc/1.24.2/mongoc_apm_server_heartbeat_succeeded_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_opening_get_context.html b/libmongoc/1.24.2/mongoc_apm_server_opening_get_context.html index 5d6463225bcff37bc272be96e258c7de2c65ab3f..d0d7b52a7df0d4fbe2b6e901fca26cec16ba91e3 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_opening_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_server_opening_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_opening_get_host.html b/libmongoc/1.24.2/mongoc_apm_server_opening_get_host.html index 728b417582befd7b4cfdff52d22b6196686de72d..ccd37eaf1f9cb81dfc9b9223ae8cb43e7420e134 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_opening_get_host.html +++ b/libmongoc/1.24.2/mongoc_apm_server_opening_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_opening_get_topology_id.html b/libmongoc/1.24.2/mongoc_apm_server_opening_get_topology_id.html index 85a1a2fde2dd77c76cc62420ba309502c1a96e29..e26ad8e048ae5242153cbb3720f6522ad970b9a8 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_opening_get_topology_id.html +++ b/libmongoc/1.24.2/mongoc_apm_server_opening_get_topology_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_server_opening_t.html b/libmongoc/1.24.2/mongoc_apm_server_opening_t.html index cd419be1f5e4c5e92b089271586ed72264f5962e..6e5d75f820d848842046b404cf9ffa342f0aef9c 100644 --- a/libmongoc/1.24.2/mongoc_apm_server_opening_t.html +++ b/libmongoc/1.24.2/mongoc_apm_server_opening_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_command_failed_cb.html b/libmongoc/1.24.2/mongoc_apm_set_command_failed_cb.html index 7ea5eb8916638d6ae34beda4961fd01107219de6..f6a27e445fa706147c2eb19156a5e0b795394d5d 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_command_failed_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_command_failed_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_command_started_cb.html b/libmongoc/1.24.2/mongoc_apm_set_command_started_cb.html index 1e188af956fd6b28150be2dd1264d6762a9f12ac..d9efae24e38fedf2c677fe83033b43a1c24820da 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_command_started_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_command_started_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_command_succeeded_cb.html b/libmongoc/1.24.2/mongoc_apm_set_command_succeeded_cb.html index 95633e0838488c08ea90953bc3433496d3b6e607..ed39554fe69000632b022d658aaff15e03fa0e50 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_command_succeeded_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_command_succeeded_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_server_changed_cb.html b/libmongoc/1.24.2/mongoc_apm_set_server_changed_cb.html index cb8893da86108ef3e3525d690297bbd5937993d3..f20114c6af77ef2f66ebe4d7ca5c92a7c4484610 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_server_changed_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_server_changed_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_server_closed_cb.html b/libmongoc/1.24.2/mongoc_apm_set_server_closed_cb.html index fd7a9b32fbf1c4446da1b0d986271c71060efaa4..1b0fe55d6b2c6887b6cc649b425cc31c19b647ec 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_server_closed_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_server_closed_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_failed_cb.html b/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_failed_cb.html index b579533bb5952f7830e11c855288474d8aa762f9..33134a5c5b3f26ef15c8d1e8bbd4239a7eec5d26 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_failed_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_failed_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_started_cb.html b/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_started_cb.html index bcdb77e67ab7211b8abab0306635f16cd9b8ecd1..5c8057cc7f9d0748130fe1db121d802b0d581000 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_started_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_started_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_succeeded_cb.html b/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_succeeded_cb.html index 7d61533cc5fb4966dc5de2f385d2ee7c9e6973ae..addee0833691a3366af6193b2c506f4f0c9b18c8 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_succeeded_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_server_heartbeat_succeeded_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_server_opening_cb.html b/libmongoc/1.24.2/mongoc_apm_set_server_opening_cb.html index 1019e02d2b730fd0ac6ba3c49d29e9bdf0a47480..2fa1ed304107dd54a96ba2f3e59546c3fec0d618 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_server_opening_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_server_opening_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_topology_changed_cb.html b/libmongoc/1.24.2/mongoc_apm_set_topology_changed_cb.html index bb07a8200a884633bbfde91cdce98df4705341bf..fe735f11ec75ac5f5cbe187674355ab6fcaa2884 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_topology_changed_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_topology_changed_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_topology_closed_cb.html b/libmongoc/1.24.2/mongoc_apm_set_topology_closed_cb.html index 9f5af0bc7f0290c03e3d18781876de9d3737c154..eba66eb3f3d1bfb1224eb46d9532139818e17ea9 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_topology_closed_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_topology_closed_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_set_topology_opening_cb.html b/libmongoc/1.24.2/mongoc_apm_set_topology_opening_cb.html index 5468350bb69fd1988fd3a8cc3c25247c1f2e2330..7236718316f462f92a40eb11032ba8bdbb531070 100644 --- a/libmongoc/1.24.2/mongoc_apm_set_topology_opening_cb.html +++ b/libmongoc/1.24.2/mongoc_apm_set_topology_opening_cb.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_context.html b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_context.html index 184a5ecea5daf23ef68f4390cba5cedaac0e26fe..23feda655044c0ab3eb9967c8740c5e89bdcf679 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_new_description.html b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_new_description.html index cd1a3a32da145832a40e93b335309950f6013370..cb2edf002eff4240020b9c84f7ab69041ccedbbe 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_new_description.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_new_description.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_previous_description.html b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_previous_description.html index 46155ca7d4ecbafa545812807245855cd8f5beb2..181b11f2c32396f16851decfb00ada0a11d51eac 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_previous_description.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_previous_description.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_topology_id.html b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_topology_id.html index 1e8d5364c3281e551663bd53a76c458a601926a9..58652698ab1d67cd8118f55b026e713da26db8b1 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_changed_get_topology_id.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_changed_get_topology_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_changed_t.html b/libmongoc/1.24.2/mongoc_apm_topology_changed_t.html index d2c3f4304cbb08a4bfa8564a8eb133952affd2e1..d10fb0274836963da85fb7fb06d030bf57b7fcfb 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_changed_t.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_changed_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_closed_get_context.html b/libmongoc/1.24.2/mongoc_apm_topology_closed_get_context.html index d56772699cb24bcfcf042a1a91ad25643b651a33..eb9b7bec0ffb3b89ccaf9eb3e41c111d0ab2e171 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_closed_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_closed_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_closed_get_topology_id.html b/libmongoc/1.24.2/mongoc_apm_topology_closed_get_topology_id.html index a264c4939fb379639800a37006181627dbbf3d11..4cd7db377833f5d850e98c4efd9e41f466abd315 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_closed_get_topology_id.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_closed_get_topology_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_closed_t.html b/libmongoc/1.24.2/mongoc_apm_topology_closed_t.html index 7855993928ba0eae1eb29b96ec10f13bc3ef80a0..d6ce6b6b9fd3f2a82e4b25a9d0455346825d4294 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_closed_t.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_closed_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_opening_get_context.html b/libmongoc/1.24.2/mongoc_apm_topology_opening_get_context.html index 8f3b52a876c3e53f1224ffb8795cacff2c40d45d..66e47134c366679ab252a0f62518f66611f0b5c8 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_opening_get_context.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_opening_get_context.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_opening_get_topology_id.html b/libmongoc/1.24.2/mongoc_apm_topology_opening_get_topology_id.html index 1af46da195e1db967ec01384a431fee89052ae99..2a0611db94b15541f8e690c4839097bf613c217a 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_opening_get_topology_id.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_opening_get_topology_id.html @@ -36,6 +36,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_apm_topology_opening_t.html b/libmongoc/1.24.2/mongoc_apm_topology_opening_t.html index 11629a5467b5e08ac58995c13e226c0c82a57f7c..c4835566e9f5002fe846ebe569014df87c884a3c 100644 --- a/libmongoc/1.24.2/mongoc_apm_topology_opening_t.html +++ b/libmongoc/1.24.2/mongoc_apm_topology_opening_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_destroy.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_destroy.html index d3e20d83b39a1b5cb92fe83b66ebbf11c8a9bfdf..c0f43e0020b58002a69197894670a0a5153c7a4e 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_new.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_new.html index c12429a30ca51e294e87aab7886c568b7b1283b8..e1f42b80b77db85dd874d501ef999fac80425696 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_new.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html index a462c43f9685c03fb1edad284644eaf199351435..8f01db730adfa5c8adf29d39ea2caca0bbe3e143 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_query_analysis.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_query_analysis.html index 2b727e1b2b8e1a59b6ccfd63411f51b247c6b5fe..05836c9e424944a3de3fd113c72a753ab457931c 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_query_analysis.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_bypass_query_analysis.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_encrypted_fields_map.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_encrypted_fields_map.html index 1d04c32466548f715ebbf850a38f974ed9bcd843..de4242772fa79183661c4830f09e986ebf574fa9 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_encrypted_fields_map.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_encrypted_fields_map.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_extra.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_extra.html index 7518a75f724f98f4ad6cff172d7096730fc8be04..31c23073b8f99f7e997b9e142a4967e68d2a0bc0 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_extra.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_extra.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client.html index 351e08c0ce57469e5199b2be162938e064a893ba..63ad513c76f578ee8dbc9969ef2d1ebb21e7d3c3 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client_pool.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client_pool.html index 9bed6d941ebdb5e2dcf50f3b9b95d6437354ff1f..01891affb8e2bf57a7940ad1d213c58997b61a69 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client_pool.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_client_pool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_namespace.html index d2c6400e12e243bb2c470811027daec9851597c0..9ed19387fbcadc29a18b1f3a497c8f724b826fd5 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_namespace.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_keyvault_namespace.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html index 3838972b5e82d4b61b8509607c4874631778163f..04fe432a1dcf670fe9e44163adbefd747d9dd3f2 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_providers.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_providers.html index f9c8e95fdc12b6b8b3d55dedd026aa288708dc06..41d9d8fb615f8461aaa1da450ecc8afb66a5ccd4 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_providers.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_kms_providers.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_schema_map.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_schema_map.html index 0954f6794c0d7c35c43af6042ea39ebc81717c7b..193390fc5548c784b9f03d9460185cd273bb598b 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_schema_map.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_schema_map.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_tls_opts.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_tls_opts.html index da039eeee7c3ebc416da1e8e1b92933e03910e86..b2a87240d4397aa4f70a1799d92f46b84d5fdb1d 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_tls_opts.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_set_tls_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_auto_encryption_opts_t.html b/libmongoc/1.24.2/mongoc_auto_encryption_opts_t.html index 5d1422a229b01d4c608ad0753ac8e142307b560a..fc217d78db5ddd60e1bb08f9e171ffc2ce841a3f 100644 --- a/libmongoc/1.24.2/mongoc_auto_encryption_opts_t.html +++ b/libmongoc/1.24.2/mongoc_auto_encryption_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_delete.html b/libmongoc/1.24.2/mongoc_bulk_operation_delete.html index a6a24cbfc41f95a50b352938702dea043070a66c..585530a0e474f17a4046c2e35f0d684a78f71088 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_delete.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_delete.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_delete_one.html b/libmongoc/1.24.2/mongoc_bulk_operation_delete_one.html index 16c69d14f7352be739436c0323eed9fdd936fd7c..c41ff48ba4670597a29e118085f4d17eb44f50db 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_delete_one.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_delete_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_destroy.html b/libmongoc/1.24.2/mongoc_bulk_operation_destroy.html index 0bcd9c3e67fe6a7e65f308cc08d61e548fff4437..19e146877eb0810370ff8cd63b21f511abf75ed1 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_destroy.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_execute.html b/libmongoc/1.24.2/mongoc_bulk_operation_execute.html index a226da6fa95e20cd9095e55b4e194f246d88b1f1..1360b1b987d04ee9ef89a048a8ad11ecf1e8497f 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_execute.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_execute.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_get_hint.html b/libmongoc/1.24.2/mongoc_bulk_operation_get_hint.html index ee7a75560b8953a88716d4ec14d71c4ab56d1113..6e38ee93dd7d42fa353a79559c0574482f78f499 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_get_hint.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_get_hint.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_get_write_concern.html b/libmongoc/1.24.2/mongoc_bulk_operation_get_write_concern.html index b978f986227037f02b9dc4cfc5d28c5a4305b252..e3b05533faf1718cf9364ef4f12710121d1d297d 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_get_write_concern.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_get_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_insert.html b/libmongoc/1.24.2/mongoc_bulk_operation_insert.html index dab80c8e43a6bd39f47b7f7e169055a638385344..838fb81ce4fe5edc55decb340241e22deea93958 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_insert.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_insert.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_insert_with_opts.html b/libmongoc/1.24.2/mongoc_bulk_operation_insert_with_opts.html index 716e36389be850757c8394b109d6c3b344814e5b..1c959a22de3a738e863e90de8c9584daa7a24f76 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_insert_with_opts.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_insert_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_remove.html b/libmongoc/1.24.2/mongoc_bulk_operation_remove.html index 0cdffa22bf100c4c3fdc4d70b89f30f1ed6678e2..40f5029a7cd9f28b675375e433c7a580a597f32c 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_remove.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_remove.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_remove_many_with_opts.html b/libmongoc/1.24.2/mongoc_bulk_operation_remove_many_with_opts.html index c907eb0eae778a5da296dcf031bb6b5bfe14a25f..82de3dc64f99033da4ad3f031bfc18dd4997379d 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_remove_many_with_opts.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_remove_many_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_remove_one.html b/libmongoc/1.24.2/mongoc_bulk_operation_remove_one.html index f74208df1a7a0a5fff5a73d986558ce8310ba5a7..8c4d952ad6fe5ec1f14c72d9b74befa0e51cfb75 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_remove_one.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_remove_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_remove_one_with_opts.html b/libmongoc/1.24.2/mongoc_bulk_operation_remove_one_with_opts.html index c7a732146dbc74959be1f8f04f9e2db3d099717b..7e67b09527441958bcdb3e53e5fbb2841c585ba1 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_remove_one_with_opts.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_remove_one_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_replace_one.html b/libmongoc/1.24.2/mongoc_bulk_operation_replace_one.html index 6a0a2c7c976c5715ca01b90447737e7f5b174931..9254bff82e76cd275c9a14eaca30a0f5be7c3635 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_replace_one.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_replace_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_replace_one_with_opts.html b/libmongoc/1.24.2/mongoc_bulk_operation_replace_one_with_opts.html index aca0c182d8af66fe224264bb1ad68baaa16864ba..78726e2cf03d36ed70e956630033e8ddc31c06fa 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_replace_one_with_opts.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_replace_one_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_set_bypass_document_validation.html b/libmongoc/1.24.2/mongoc_bulk_operation_set_bypass_document_validation.html index b56addf3ca33ca5bdadcbdee279c50490d8231b2..00c2cb04ea31cba7453a9187905ab46c075ae1dd 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_set_bypass_document_validation.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_set_bypass_document_validation.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_set_client_session.html b/libmongoc/1.24.2/mongoc_bulk_operation_set_client_session.html index fab8beaa40bb4b063d241e6390c0babf3083fccc..aec976074519b3e72889771abb9e7f8b9cb188f8 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_set_client_session.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_set_client_session.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_set_comment.html b/libmongoc/1.24.2/mongoc_bulk_operation_set_comment.html index 315f054da284f24b4aca86a0b220368ac4757f39..ccb08ddf412fcc5279453862c6930edc798b8280 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_set_comment.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_set_comment.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_set_hint.html b/libmongoc/1.24.2/mongoc_bulk_operation_set_hint.html index bd9506ff3d981ce3b3a636d904ffb4336a2be743..ab2c3bf88e9ba7f808dbfc372f8b790b6f1a770d 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_set_hint.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_set_hint.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_set_let.html b/libmongoc/1.24.2/mongoc_bulk_operation_set_let.html index 7faef6d53e8ee7cde23b3699657d5348af8a2261..d9e7eb88bda85a340587d7483c058aecc32eda12 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_set_let.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_set_let.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_t.html b/libmongoc/1.24.2/mongoc_bulk_operation_t.html index e038910090f0a11a5c93d0aef7929388850c12e7..778533bd0da8af699fb1d5361f74b397f2cf885e 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_t.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_update.html b/libmongoc/1.24.2/mongoc_bulk_operation_update.html index 05c344fa49d355f7706c4a93cfa32e4356899884..6143b99543f924ef2d1f558cb80700fafab7351b 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_update.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_update.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_update_many_with_opts.html b/libmongoc/1.24.2/mongoc_bulk_operation_update_many_with_opts.html index abb64502de1793f8506d7d5664b4083a49d0cc79..de2eecf06d07e9fb28bafe7c304fded6f4073ef0 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_update_many_with_opts.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_update_many_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_update_one.html b/libmongoc/1.24.2/mongoc_bulk_operation_update_one.html index bbdce3eefa1a978093b887d1c0c80153f21d9d3c..b3cb013fb348b43fe3460bf11734eb69309a1fdf 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_update_one.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_update_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_bulk_operation_update_one_with_opts.html b/libmongoc/1.24.2/mongoc_bulk_operation_update_one_with_opts.html index 25baa33b5539d59a39bc04620c0315c584177c3a..ccb6abab5f29d8fb170d22f6387d058e8cbbe07f 100644 --- a/libmongoc/1.24.2/mongoc_bulk_operation_update_one_with_opts.html +++ b/libmongoc/1.24.2/mongoc_bulk_operation_update_one_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_change_stream_destroy.html b/libmongoc/1.24.2/mongoc_change_stream_destroy.html index 250ad863f7f7f3efe1dfc0b8c6dfc01c105f5fca..c6760e13aaffad1c32888f79e9c09a879079af54 100644 --- a/libmongoc/1.24.2/mongoc_change_stream_destroy.html +++ b/libmongoc/1.24.2/mongoc_change_stream_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_change_stream_error_document.html b/libmongoc/1.24.2/mongoc_change_stream_error_document.html index 6d7792aeadc45ef2980ec9086379772debd27141..5e32cf7528f32589ced7a801257e1b334030b960 100644 --- a/libmongoc/1.24.2/mongoc_change_stream_error_document.html +++ b/libmongoc/1.24.2/mongoc_change_stream_error_document.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_change_stream_get_resume_token.html b/libmongoc/1.24.2/mongoc_change_stream_get_resume_token.html index 82ca6193b0b789b66823ffbc70e80363bd061406..6e83ecf9e1dc39bf0d08ed75ac677bc8ff0c1d10 100644 --- a/libmongoc/1.24.2/mongoc_change_stream_get_resume_token.html +++ b/libmongoc/1.24.2/mongoc_change_stream_get_resume_token.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_change_stream_next.html b/libmongoc/1.24.2/mongoc_change_stream_next.html index 8f5267b69dab457fa4838ae741602c76ceda994d..dc7ef7c8cb00bc498cef389fc4c1e2107a58913d 100644 --- a/libmongoc/1.24.2/mongoc_change_stream_next.html +++ b/libmongoc/1.24.2/mongoc_change_stream_next.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_change_stream_t.html b/libmongoc/1.24.2/mongoc_change_stream_t.html index 148d1864dcb32cc0d5dfc3bbb1ffe094ce3ed946..d55bf143ff6b83b674c2f8454eaa539fa883f0a6 100644 --- a/libmongoc/1.24.2/mongoc_change_stream_t.html +++ b/libmongoc/1.24.2/mongoc_change_stream_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_check_version.html b/libmongoc/1.24.2/mongoc_check_version.html index 1706c114db2d568f2ffa548b9fee59f65021c255..c005ec050b4c89127e2813fbc36e0c35bd086116 100644 --- a/libmongoc/1.24.2/mongoc_check_version.html +++ b/libmongoc/1.24.2/mongoc_check_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cleanup.html b/libmongoc/1.24.2/mongoc_cleanup.html index fe4000177a0f200c62cc28b817a1d1e60b751934..e83b9545b9de2d1aa27fd8132670169b0a27ec03 100644 --- a/libmongoc/1.24.2/mongoc_cleanup.html +++ b/libmongoc/1.24.2/mongoc_cleanup.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_command.html b/libmongoc/1.24.2/mongoc_client_command.html index 07af51489514157e3658199ce7bbd378286efa20..6db09b997c30a8212ebb94874dea82f4c8508923 100644 --- a/libmongoc/1.24.2/mongoc_client_command.html +++ b/libmongoc/1.24.2/mongoc_client_command.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_command_simple.html b/libmongoc/1.24.2/mongoc_client_command_simple.html index 41cfb370aab674e13c1a2e3a048912a8dd4f3880..9c2bff8b71d104883c3692d01738f2e3cc437eac 100644 --- a/libmongoc/1.24.2/mongoc_client_command_simple.html +++ b/libmongoc/1.24.2/mongoc_client_command_simple.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_command_simple_with_server_id.html b/libmongoc/1.24.2/mongoc_client_command_simple_with_server_id.html index c0e03964409d3195c3675e8bfee54c43861eae12..886a86701e3662c8ca0ffd59762a7dea676e18fc 100644 --- a/libmongoc/1.24.2/mongoc_client_command_simple_with_server_id.html +++ b/libmongoc/1.24.2/mongoc_client_command_simple_with_server_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_command_with_opts.html b/libmongoc/1.24.2/mongoc_client_command_with_opts.html index f053019ce68133834e04923c18978508e025cd24..ea3b8ccf695c31a1f620523350b1886a104bbeae 100644 --- a/libmongoc/1.24.2/mongoc_client_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_client_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_destroy.html b/libmongoc/1.24.2/mongoc_client_destroy.html index 55724acd78c9325901946c6a3c02b16618eb3bc5..f62e0e87da37256c60b9c80ca7873be358088fc6 100644 --- a/libmongoc/1.24.2/mongoc_client_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_enable_auto_encryption.html b/libmongoc/1.24.2/mongoc_client_enable_auto_encryption.html index 4165f4183fa891143aa238a03992e4812b8ce851..8eddac12e0ca1c0d1b1df5e5ae483206820703e0 100644 --- a/libmongoc/1.24.2/mongoc_client_enable_auto_encryption.html +++ b/libmongoc/1.24.2/mongoc_client_enable_auto_encryption.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_add_key_alt_name.html b/libmongoc/1.24.2/mongoc_client_encryption_add_key_alt_name.html index 0d9648d5d8c875873d7bf87ee4d1f4b244106665..243952d02e84d9c9727f685ce8473df0713204f7 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_add_key_alt_name.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_add_key_alt_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_create_datakey.html b/libmongoc/1.24.2/mongoc_client_encryption_create_datakey.html index eb1101218335ae70c33fb4d9114e690657b6c509..09d303b03c31529eab25ccdac8b141d00a2894e8 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_create_datakey.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_create_datakey.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_create_encrypted_collection.html b/libmongoc/1.24.2/mongoc_client_encryption_create_encrypted_collection.html index 8ce124c238937994195a4e8245e57760bd331c8d..369767e0da4fbd7a044599c822216357636f6196 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_create_encrypted_collection.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_create_encrypted_collection.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_destroy.html b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_destroy.html index 0f1cfb1578e763d138152b66f32ffa8d87596ded..0304a0c89aabcfeb9f412a382c6fe2c18b64d59b 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_new.html b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_new.html index b645ef815152be3b5ac7111db37efe7393591edd..df4a19634c866474c63291a6de4ea3182bb21424 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_new.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keyaltnames.html b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keyaltnames.html index e9f8af39da8aa26bfa38cb521f3ed218584c3a33..b9548ea4b003a46955350c2fc83b7550346e49bc 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keyaltnames.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keyaltnames.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keymaterial.html b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keymaterial.html index 35cfef96ca6b94288dd9b7ac64ecbfc2b8dae752..e6092b70b3fabfeba0b7080c4300b2a8328c1c7c 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keymaterial.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_keymaterial.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_masterkey.html b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_masterkey.html index cf8d06fcba1080dfeeb65c443decb09b60e63a0d..4add9e41614f7516c64e5e69d35662ee399c1595 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_masterkey.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_set_masterkey.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_t.html b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_t.html index 1bd2babd00b1afa80b8eb95e3898458c2ef05229..e1a60ac5e57b11b00d9a5eaf26294ebf3c3211b3 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_t.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_datakey_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_decrypt.html b/libmongoc/1.24.2/mongoc_client_encryption_decrypt.html index cbbda8c90a5d6cb9399b9fe628e169a760c76d5c..5166e456b6180ed0f31600aee31486ba0dc35ded 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_decrypt.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_decrypt.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_delete_key.html b/libmongoc/1.24.2/mongoc_client_encryption_delete_key.html index e237edb4d43aa672d082abf03c65fe7bb591e485..642b4aaabb9bd923097a4b7b23103ecedc150e95 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_delete_key.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_delete_key.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_destroy.html b/libmongoc/1.24.2/mongoc_client_encryption_destroy.html index 8d3c96105cce1b890e1c03a56f6a4b70ef3babe9..9d06ac90539e1668915c258624007e555aa116fa 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt.html index 7970392118d17721d5dd221770580913374be2d7..5764df0b1d21b076448dc136fbc6a2a7adb623ba 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_expression.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_expression.html index ec19b825cd90fa12f68d3a9079361320e7eb5b60..7191ce42928c73a8c3754e4fadf7979a45bcfe21 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_expression.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_expression.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_destroy.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_destroy.html index 98f8a852aa3f6fd9af8148682cb4c93eeebd29de..d3ce05cc8da8c9cd1bf0f060e0dd81ef8ab2ac32 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_new.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_new.html index 5aceab06b6287d5f30a1f61d78dbf2e6c1f84107..d338e860e9e6945aef1a1a5a930ef7d7435e2fd6 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_new.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_algorithm.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_algorithm.html index 75b5837dab5eda3761661725e4bfdbc043be7de0..ad87988eaa5c5281788cfb1b57185baf511de11a 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_algorithm.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_algorithm.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_contention_factor.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_contention_factor.html index 19a81001b6ad5984f8e5d6348437198d80a2dda8..98c09f6f62b49f3c6cabbdc911bb5f71d7cc491f 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_contention_factor.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_contention_factor.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyaltname.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyaltname.html index 99ce1f15258c9ea17bf9a6ad7d87f5056692e88f..81f940424612f3c9f2ad80e926858ac14242353e 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyaltname.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyaltname.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyid.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyid.html index 56f87e20272ea37b876752d535ddc513cf3809e3..0f1815d902a8eb882a59d66e48de7ca3ea1812b5 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyid.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_keyid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_query_type.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_query_type.html index e8dce61ca14b14ed30802e5fdcbcb278445fb489..86c608e4a0cda99c9c20521a60c745d87bcb649e 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_query_type.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_query_type.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_range_opts.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_range_opts.html index 2c6ad04121add98e057b0cf300591610ae4407bb..703208cef2405e8f114b862f72a4dd58c6b4d269 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_range_opts.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_set_range_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_t.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_t.html index 7e44970f9e42eee444e7af827d6ccfca3e062b2e..d871e3a57ba862463e129c8cee0a3871598e7ec0 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_t.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_destroy.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_destroy.html index e0a469a5fa4347625186525fd45b23ca588fb71b..039a09b441bb2a8d06c0f114e664b5b791bf1e65 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_new.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_new.html index 7333701b7992a553b2520f4faa10d4dc191a2f42..8b6d1dec7485454ce9f54bdc8ce2d5a4012d86fd 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_new.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_max.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_max.html index aa628eb599ac04fdcb816fff2229ce1d853ec440..554465b8aa32c5ffa8c51d554bf10a54b966cdb6 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_max.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_max.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_min.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_min.html index 61b2ab7bd66404f4991d82184acebfbb5a06106c..b24ba9b545fb693c8377ee7c1550d30236db8cc5 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_min.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_min.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_precision.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_precision.html index f7972da90f49172db699c5ffa0815ac8d358c8a2..c73714c6be8ac87b23678ace1cba9ae1448b53a4 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_precision.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_precision.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html index b060d0f2a273015449fedb6ee8240d224ac8ed61..387414aad1ec3785cd1c95517f45dcda3de305e5 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_t.html b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_t.html index d188f9149c5af237f29c8adae706f5e549d53beb..ce5890d3fbda0cc9942818b4daa5c2d0c6062dac 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_t.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_encrypt_range_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_get_crypt_shared_version.html b/libmongoc/1.24.2/mongoc_client_encryption_get_crypt_shared_version.html index e4ed967ba75c677eb2e097383750b967098aadf6..e823ca2a3f4cccacc12694f6623d75a88a442270 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_get_crypt_shared_version.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_get_crypt_shared_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_get_key.html b/libmongoc/1.24.2/mongoc_client_encryption_get_key.html index 3bf1b8b1ecdc68c891c418f256a112401ab3a5cb..f1844d6e054ee4da461c8c676d3cc2a77931a311 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_get_key.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_get_key.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_get_key_by_alt_name.html b/libmongoc/1.24.2/mongoc_client_encryption_get_key_by_alt_name.html index 2893b9a76bb137fd8b6595649c80590edcce5826..0070ed23201c34ec04bac190b1d87576c7deb55c 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_get_key_by_alt_name.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_get_key_by_alt_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_get_keys.html b/libmongoc/1.24.2/mongoc_client_encryption_get_keys.html index 0ab0098c012feb76e8e1dd94d6cf8b24eecbf3dd..a969e8804f7703c7c7839057f59c8d107782b662 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_get_keys.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_get_keys.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_new.html b/libmongoc/1.24.2/mongoc_client_encryption_new.html index 3bc7c99f44924993027d85df9dbabe17654a7395..f728a2aa9d369eaf19d86e541aca5b807ffc3f87 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_new.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_destroy.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_destroy.html index 4f81fafbb3752e788a6a2db02ce0a1a42a646e55..e5700e9086037b21be1b7160471741048bb4eef5 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_new.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_new.html index 2387804ffc47252a5784efe62690da50d63a2fb9..dec5fc551e6b23d1a5d4955065d31091495a3c50 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_new.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_client.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_client.html index 36f9b47c2905d516f964c8b01c0668a345741db7..8d81a635bc31405e63550803b22a54e01e918c53 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_client.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_client.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_namespace.html index 18bdff9870967124460430ecb752415c7055fa92..28bfee863d1845e48b1dfcd01d95d455998a5613 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_namespace.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_keyvault_namespace.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html index dcb04448bda5acfee885eab78017d0e75f6b3e96..e47b4042b3b9ae343ce75ff82ba3e315f05b8be8 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_providers.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_providers.html index ae5ba5e5d72c40ecbd12e8e966b60b293e97a37b..df11dec54fc430126d1d69990a8bda9dac5bed8d 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_providers.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_kms_providers.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_tls_opts.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_tls_opts.html index 5ebbc08cfa868474bacc29382fec90563b58e39f..333c71630a66e9e17c2664bb64ee2cf83a8deb8e 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_set_tls_opts.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_set_tls_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_opts_t.html b/libmongoc/1.24.2/mongoc_client_encryption_opts_t.html index fe6ac8916e84ae20c5e9e25f09186ca2a6fb1a6b..af909bd2ac24e1b8687a6509a995856eb068c735 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_opts_t.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_remove_key_alt_name.html b/libmongoc/1.24.2/mongoc_client_encryption_remove_key_alt_name.html index c1e973924104b4d8ef08f66652012f303dc28d94..30f917db3c22671715e9cba77889e41a74faecc5 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_remove_key_alt_name.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_remove_key_alt_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey.html b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey.html index 844ff990b476a4abfae19d9fb04738dad61f6db4..a1dc265e64a9803d821829310e8a92af733c1ee7 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html index ff2bd73f95544fd24fdff1368658d0a28d04cb15..e2349ec64e8ce67e6c70ab85db7e2fa28d7b57b2 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html index feb7f6909e65eeb1f133236b21898f814f0a50ce..034661e214582803eb8f739a210a08857d7ce21d 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_new.html b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_new.html index a81cb9fe7d37fa6b60fab47be3bdf4dc7168a539..efc1955dc3464c059582dabd7d1f37a930295590 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_new.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_t.html b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_t.html index c082a2cfc007edea7b0c62c401e50651a20ac9ed..9d05b60827c0e810101e9b36523ca2a09f761a0d 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_t.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_rewrap_many_datakey_result_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_encryption_t.html b/libmongoc/1.24.2/mongoc_client_encryption_t.html index 7cb77edad5dcdfa33e16834cb7970d58f870e028..739ac1d05784c28fb1f3ebd3374e64bc9f8fa00f 100644 --- a/libmongoc/1.24.2/mongoc_client_encryption_t.html +++ b/libmongoc/1.24.2/mongoc_client_encryption_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_find_databases_with_opts.html b/libmongoc/1.24.2/mongoc_client_find_databases_with_opts.html index 594304d82a9b951604ed0cb6f1ed6b806e8f5d4a..68ee636dc40d47e2d810caf59bb8c93201b1d00b 100644 --- a/libmongoc/1.24.2/mongoc_client_find_databases_with_opts.html +++ b/libmongoc/1.24.2/mongoc_client_find_databases_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_collection.html b/libmongoc/1.24.2/mongoc_client_get_collection.html index 1cd7068d68bb841c6748d3b28495de71750985ce..7e42f03f3934898763c2961f94d4a1d43e3f37c6 100644 --- a/libmongoc/1.24.2/mongoc_client_get_collection.html +++ b/libmongoc/1.24.2/mongoc_client_get_collection.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_crypt_shared_version.html b/libmongoc/1.24.2/mongoc_client_get_crypt_shared_version.html index cb2eeab8bef5af284482edaaacb6f83907d8096f..10083a390afc79160aa06258f393c25ad9c3e8c6 100644 --- a/libmongoc/1.24.2/mongoc_client_get_crypt_shared_version.html +++ b/libmongoc/1.24.2/mongoc_client_get_crypt_shared_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_database.html b/libmongoc/1.24.2/mongoc_client_get_database.html index fdd6536c098575f2059bc5b2c11d85c3a0d7dbfd..c8997b0e4b9e8dad3015cba9094194e7638b0ada 100644 --- a/libmongoc/1.24.2/mongoc_client_get_database.html +++ b/libmongoc/1.24.2/mongoc_client_get_database.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_database_names.html b/libmongoc/1.24.2/mongoc_client_get_database_names.html index 9f10989418ceaf324a511bc169692cadcf201f83..a9ff667e1e48a644ac0a3ef2c56e087a7ed19d29 100644 --- a/libmongoc/1.24.2/mongoc_client_get_database_names.html +++ b/libmongoc/1.24.2/mongoc_client_get_database_names.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_database_names_with_opts.html b/libmongoc/1.24.2/mongoc_client_get_database_names_with_opts.html index 0cee932fe66934ca539e95924b362a3c256433f1..092e55c040b520d682d22b9d637bbff2b0f199c6 100644 --- a/libmongoc/1.24.2/mongoc_client_get_database_names_with_opts.html +++ b/libmongoc/1.24.2/mongoc_client_get_database_names_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_default_database.html b/libmongoc/1.24.2/mongoc_client_get_default_database.html index 1370be1a532982c5b61236a4ca4756f1fbd696db..e5e8decd4047fd9c3e6974496d905fef4d55a849 100644 --- a/libmongoc/1.24.2/mongoc_client_get_default_database.html +++ b/libmongoc/1.24.2/mongoc_client_get_default_database.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_gridfs.html b/libmongoc/1.24.2/mongoc_client_get_gridfs.html index 2ed95cbfbb975518baa1ec401923d8aaf6c5f304..b29d8345bd738198286afeb6c6db050ba19fa1e1 100644 --- a/libmongoc/1.24.2/mongoc_client_get_gridfs.html +++ b/libmongoc/1.24.2/mongoc_client_get_gridfs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_handshake_description.html b/libmongoc/1.24.2/mongoc_client_get_handshake_description.html index 92932c606ea7a187037370da84c7b8057053a2d6..069d66668703a5f7f0d0e20c998cf639839e079c 100644 --- a/libmongoc/1.24.2/mongoc_client_get_handshake_description.html +++ b/libmongoc/1.24.2/mongoc_client_get_handshake_description.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_read_concern.html b/libmongoc/1.24.2/mongoc_client_get_read_concern.html index 65d694b229897de78cb2e7676097624db5c435aa..f95c83c9ca8070ded7f95a9a4f1ef1fff533a147 100644 --- a/libmongoc/1.24.2/mongoc_client_get_read_concern.html +++ b/libmongoc/1.24.2/mongoc_client_get_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_read_prefs.html b/libmongoc/1.24.2/mongoc_client_get_read_prefs.html index 2458d6a6b288940dfc0ec842e37988dd42ecc5f6..f428f184791bd266693a231ad5c98e8cf170ac7b 100644 --- a/libmongoc/1.24.2/mongoc_client_get_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_client_get_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_server_description.html b/libmongoc/1.24.2/mongoc_client_get_server_description.html index 4f37338a5c5dc2e1e678efa167f9c8f82f2555cd..4549873b43d435ecd9ea70a9f6399c022a060f97 100644 --- a/libmongoc/1.24.2/mongoc_client_get_server_description.html +++ b/libmongoc/1.24.2/mongoc_client_get_server_description.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_server_descriptions.html b/libmongoc/1.24.2/mongoc_client_get_server_descriptions.html index 3e8be3b9ad253950c36562615e8a2298ea477b0a..252df3d98f8033bc234d774f1d120be29560b1fe 100644 --- a/libmongoc/1.24.2/mongoc_client_get_server_descriptions.html +++ b/libmongoc/1.24.2/mongoc_client_get_server_descriptions.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_server_status.html b/libmongoc/1.24.2/mongoc_client_get_server_status.html index 08b7390846cf4c383b8eb6939c865098acaa08c4..d09ea477c41d2b50ac00cd54248d0c4bd2792f89 100644 --- a/libmongoc/1.24.2/mongoc_client_get_server_status.html +++ b/libmongoc/1.24.2/mongoc_client_get_server_status.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_uri.html b/libmongoc/1.24.2/mongoc_client_get_uri.html index fb4ada93ebb7ba7a1c580c0c19f8d2dc349a95a7..b3f8063cae23eaaeea730c174d0d73ea9775ca90 100644 --- a/libmongoc/1.24.2/mongoc_client_get_uri.html +++ b/libmongoc/1.24.2/mongoc_client_get_uri.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_get_write_concern.html b/libmongoc/1.24.2/mongoc_client_get_write_concern.html index 64de106642cb03d48629ff9929f35f9f66531eaf..8afc2ede0a856ef45ba56092fdfb69eceee40488 100644 --- a/libmongoc/1.24.2/mongoc_client_get_write_concern.html +++ b/libmongoc/1.24.2/mongoc_client_get_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_new.html b/libmongoc/1.24.2/mongoc_client_new.html index 2b9e608ba3dc83f5671c88030e4dc29148c8fc60..a5f4dcb56f460de478be353a9dcf204fc9dfcf32 100644 --- a/libmongoc/1.24.2/mongoc_client_new.html +++ b/libmongoc/1.24.2/mongoc_client_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_new_from_uri.html b/libmongoc/1.24.2/mongoc_client_new_from_uri.html index f61e7899d60372311e013e8822a3f5605e394e1b..bc732e78e167b1916842a7dce49d175b08007109 100644 --- a/libmongoc/1.24.2/mongoc_client_new_from_uri.html +++ b/libmongoc/1.24.2/mongoc_client_new_from_uri.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_new_from_uri_with_error.html b/libmongoc/1.24.2/mongoc_client_new_from_uri_with_error.html index f6cf38ae7698215f705d5b31c6b4fa2be4255ced..02a8ed95f3d8905753535ea4383f5d4689743074 100644 --- a/libmongoc/1.24.2/mongoc_client_new_from_uri_with_error.html +++ b/libmongoc/1.24.2/mongoc_client_new_from_uri_with_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_destroy.html b/libmongoc/1.24.2/mongoc_client_pool_destroy.html index aad8357e67306e0954df4acb2260eef42fb9de41..30f50e435d636581183ea4166d0ee27666b30dca 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_pool_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_enable_auto_encryption.html b/libmongoc/1.24.2/mongoc_client_pool_enable_auto_encryption.html index 5a581d9b9d85791808569c319025423416842a48..d166c99d5ad971741c2777ea09857ef36c97974f 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_enable_auto_encryption.html +++ b/libmongoc/1.24.2/mongoc_client_pool_enable_auto_encryption.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_max_size.html b/libmongoc/1.24.2/mongoc_client_pool_max_size.html index c17f72f8f62fca75aededab5ab6b4563fe417dcf..d37a7e49b97d0b97d25a35be54a1ea186e69a9cb 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_max_size.html +++ b/libmongoc/1.24.2/mongoc_client_pool_max_size.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_min_size.html b/libmongoc/1.24.2/mongoc_client_pool_min_size.html index b93238f7e42bf08adc2e7304dd0e5eb7ff47fcd4..f614a6a70383353fef7701853e2bf20a5eb6127a 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_min_size.html +++ b/libmongoc/1.24.2/mongoc_client_pool_min_size.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_new.html b/libmongoc/1.24.2/mongoc_client_pool_new.html index 89639eadcf99e51c4a4ac2bdba8dcb9854c1827c..1acc452c8a925aed51313f402050bcbedf8eaaf6 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_new.html +++ b/libmongoc/1.24.2/mongoc_client_pool_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_new_with_error.html b/libmongoc/1.24.2/mongoc_client_pool_new_with_error.html index 19895fa8cb34fcbdcda616914f7ec0c85dc48726..6f8a0c12bdd4d9dc83d04ee936dca3c9d18d2e7c 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_new_with_error.html +++ b/libmongoc/1.24.2/mongoc_client_pool_new_with_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_pop.html b/libmongoc/1.24.2/mongoc_client_pool_pop.html index 9cf6f437b48c46dfdc8faac57d6924953a26a339..e7e01413c8eed05723485f313fe41425793bb516 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_pop.html +++ b/libmongoc/1.24.2/mongoc_client_pool_pop.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_push.html b/libmongoc/1.24.2/mongoc_client_pool_push.html index 4dcb0780118791a7c7db3e95be6cd37d2fc07c81..fe3b15ed3656daedca63f35d4add0bb3066de237 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_push.html +++ b/libmongoc/1.24.2/mongoc_client_pool_push.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_set_apm_callbacks.html b/libmongoc/1.24.2/mongoc_client_pool_set_apm_callbacks.html index a9ddf9b7b94d50fd7a917c882365901872b011f8..668ba3619e165ed9aace65613fdc1a33df789a2f 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_set_apm_callbacks.html +++ b/libmongoc/1.24.2/mongoc_client_pool_set_apm_callbacks.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_set_appname.html b/libmongoc/1.24.2/mongoc_client_pool_set_appname.html index cb63a838f5b796e38fd0aca03f1ce4cd9dbb90d8..939cca0caf61aa0bb82e978f5a068da6f59f2064 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_set_appname.html +++ b/libmongoc/1.24.2/mongoc_client_pool_set_appname.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_set_error_api.html b/libmongoc/1.24.2/mongoc_client_pool_set_error_api.html index 088be75970c0fb1b62153bb65aac676765f77015..044c138a92613614ecf23d4bc72df8857121b914 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_set_error_api.html +++ b/libmongoc/1.24.2/mongoc_client_pool_set_error_api.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_set_server_api.html b/libmongoc/1.24.2/mongoc_client_pool_set_server_api.html index 336fbcdb007b98fe7944f4a513e0ccf4543ece30..719de687afcac6780dc69336c90785fd6b8a86fd 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_set_server_api.html +++ b/libmongoc/1.24.2/mongoc_client_pool_set_server_api.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_set_ssl_opts.html b/libmongoc/1.24.2/mongoc_client_pool_set_ssl_opts.html index 98ec87493e3ee7a891ed96aabd1add2bb5eb0784..257c3fd565039148d0ae7888436a2c69e7808c8c 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_set_ssl_opts.html +++ b/libmongoc/1.24.2/mongoc_client_pool_set_ssl_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_t.html b/libmongoc/1.24.2/mongoc_client_pool_t.html index 5c833fad0b5725ec859f89be7991037c55b6bd19..f0b586485ccbb64276810f1c6fe60b69fbc9974e 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_t.html +++ b/libmongoc/1.24.2/mongoc_client_pool_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_pool_try_pop.html b/libmongoc/1.24.2/mongoc_client_pool_try_pop.html index 2dea02c41e6c6be5b1316443a965d28fc5eeec0a..650a4c52b94c8a79347cc6adbee8982841fd1e08 100644 --- a/libmongoc/1.24.2/mongoc_client_pool_try_pop.html +++ b/libmongoc/1.24.2/mongoc_client_pool_try_pop.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_read_command_with_opts.html b/libmongoc/1.24.2/mongoc_client_read_command_with_opts.html index 3a88f77ea51e9133a46b2f1902e3bb2009094421..c45b4e83acc2068502d59c53feac4dc71ae1db08 100644 --- a/libmongoc/1.24.2/mongoc_client_read_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_client_read_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_read_write_command_with_opts.html b/libmongoc/1.24.2/mongoc_client_read_write_command_with_opts.html index 746054492aa17bfaf8ac0029bdd4422096960c2d..df721466e6be9764b0d3fd1b66a89dcf5a070a67 100644 --- a/libmongoc/1.24.2/mongoc_client_read_write_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_client_read_write_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_reset.html b/libmongoc/1.24.2/mongoc_client_reset.html index c4ce4ff3c6b4c263a789aecb43ff2adf32df7240..4a07409bfea9cf708972cce414450984fde4e712 100644 --- a/libmongoc/1.24.2/mongoc_client_reset.html +++ b/libmongoc/1.24.2/mongoc_client_reset.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_select_server.html b/libmongoc/1.24.2/mongoc_client_select_server.html index f318f85b99b555b1e6dfb318eeb2967e2bd31664..bab1f6fb414875bd6177898346bf66ab3e402d94 100644 --- a/libmongoc/1.24.2/mongoc_client_select_server.html +++ b/libmongoc/1.24.2/mongoc_client_select_server.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_abort_transaction.html b/libmongoc/1.24.2/mongoc_client_session_abort_transaction.html index 10ce963bb087f3d2865fd8e7c54f451e095d3859..51c1b9376da0c84cba09fa27f5c4c1b7f7d8add3 100644 --- a/libmongoc/1.24.2/mongoc_client_session_abort_transaction.html +++ b/libmongoc/1.24.2/mongoc_client_session_abort_transaction.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_advance_cluster_time.html b/libmongoc/1.24.2/mongoc_client_session_advance_cluster_time.html index b017ed7e11eab10c70db74ba9e988b5fd464e89f..b369d6b37ba1307752ba3cd7e270b7476cf41445 100644 --- a/libmongoc/1.24.2/mongoc_client_session_advance_cluster_time.html +++ b/libmongoc/1.24.2/mongoc_client_session_advance_cluster_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_advance_operation_time.html b/libmongoc/1.24.2/mongoc_client_session_advance_operation_time.html index 42bc8e3aabc76fcd5f36bbf18bba6c2ab07c5341..388a81ccae31bea6ae1c435374f84283d1606190 100644 --- a/libmongoc/1.24.2/mongoc_client_session_advance_operation_time.html +++ b/libmongoc/1.24.2/mongoc_client_session_advance_operation_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_append.html b/libmongoc/1.24.2/mongoc_client_session_append.html index 181836e384ec4db924e4670c2b3d4610bbe36390..8f773aaae3b4cbc1a6821487083dc97692472eae 100644 --- a/libmongoc/1.24.2/mongoc_client_session_append.html +++ b/libmongoc/1.24.2/mongoc_client_session_append.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_commit_transaction.html b/libmongoc/1.24.2/mongoc_client_session_commit_transaction.html index 84653107e48e908e6777a1aef3b9ebecb1552e79..121d448642801fdb924046ca0d783948b052bb87 100644 --- a/libmongoc/1.24.2/mongoc_client_session_commit_transaction.html +++ b/libmongoc/1.24.2/mongoc_client_session_commit_transaction.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_destroy.html b/libmongoc/1.24.2/mongoc_client_session_destroy.html index 6640627576ea240126407e7243d87cc6f394bc20..fce8155b8e2749dc5349f3e2797e868d21692c04 100644 --- a/libmongoc/1.24.2/mongoc_client_session_destroy.html +++ b/libmongoc/1.24.2/mongoc_client_session_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_client.html b/libmongoc/1.24.2/mongoc_client_session_get_client.html index 967c28d8079f695496038d67f97cd23fc51e5758..53c04cb0f333d0308e779692bba29efe4118a236 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_client.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_client.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_cluster_time.html b/libmongoc/1.24.2/mongoc_client_session_get_cluster_time.html index 3b62df641d5103597f7b3750ad996472e42f3222..4d4e0fc1a173730184a73367184cc20b42cafa27 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_cluster_time.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_cluster_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_dirty.html b/libmongoc/1.24.2/mongoc_client_session_get_dirty.html index 0112a9d791b6d74084002c47c40541cf6468cea8..aa5d71059db1ec6977d77bedd3e1ae6acee6eefe 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_dirty.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_dirty.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_lsid.html b/libmongoc/1.24.2/mongoc_client_session_get_lsid.html index 8c43f15da28c9446d0d4a29095e39498d9b9fd1a..2d8a271a2eb31cb3b6cebe2f3a25d1970c906a6e 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_lsid.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_lsid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_operation_time.html b/libmongoc/1.24.2/mongoc_client_session_get_operation_time.html index 2e7ae566af36d22342f89284116a6ce4ccde85de..4121077ad8e86aab6c735191816b0c7942017093 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_operation_time.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_operation_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_opts.html b/libmongoc/1.24.2/mongoc_client_session_get_opts.html index 6bd12058c496893a2088a3acb84ea40b782b0ce6..740e95ad4145678b9d62bac2ef4cabf89ce993dd 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_opts.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_server_id.html b/libmongoc/1.24.2/mongoc_client_session_get_server_id.html index 45351741447683014b439f1a9d5f0f14b0f1f956..36050814e3ea6a51c1ce526c92769794b5813503 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_server_id.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_server_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_get_transaction_state.html b/libmongoc/1.24.2/mongoc_client_session_get_transaction_state.html index 72838d32b646787e4745a96c11ba8ce4a4843942..97730c5647ad75c4c3a89896866548a5261dce12 100644 --- a/libmongoc/1.24.2/mongoc_client_session_get_transaction_state.html +++ b/libmongoc/1.24.2/mongoc_client_session_get_transaction_state.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_in_transaction.html b/libmongoc/1.24.2/mongoc_client_session_in_transaction.html index 6c0c8552795eb81812aaf467c4ddc8bca49bad8e..49126cdd063039b5ece87849c58347de92483ccd 100644 --- a/libmongoc/1.24.2/mongoc_client_session_in_transaction.html +++ b/libmongoc/1.24.2/mongoc_client_session_in_transaction.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_start_transaction.html b/libmongoc/1.24.2/mongoc_client_session_start_transaction.html index c2a5d302bb2ed175c63111d31e3fb31b4385ea5e..fccadb17c23ddc352e1d997fac93fdf7c8d3ccc0 100644 --- a/libmongoc/1.24.2/mongoc_client_session_start_transaction.html +++ b/libmongoc/1.24.2/mongoc_client_session_start_transaction.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_t.html b/libmongoc/1.24.2/mongoc_client_session_t.html index 35a5ecea1e5e9542f9e390245c4361e2dbeaabf7..7e0660aa7936f2febaed9a1620768d317d723ed7 100644 --- a/libmongoc/1.24.2/mongoc_client_session_t.html +++ b/libmongoc/1.24.2/mongoc_client_session_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_with_transaction.html b/libmongoc/1.24.2/mongoc_client_session_with_transaction.html index cc2a8946c6f8ae27ef70740b5458d6ace6ae3d20..e19178f30a37088128b96584985b075500c92d07 100644 --- a/libmongoc/1.24.2/mongoc_client_session_with_transaction.html +++ b/libmongoc/1.24.2/mongoc_client_session_with_transaction.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_session_with_transaction_cb_t.html b/libmongoc/1.24.2/mongoc_client_session_with_transaction_cb_t.html index ab2c280b742c3a2a34c35c83d94f8e71b5577bff..a8fa86c198a29440051542d9819258d1ff86bddc 100644 --- a/libmongoc/1.24.2/mongoc_client_session_with_transaction_cb_t.html +++ b/libmongoc/1.24.2/mongoc_client_session_with_transaction_cb_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_apm_callbacks.html b/libmongoc/1.24.2/mongoc_client_set_apm_callbacks.html index 36f516b4cd5962996014432d1cbc9c0efad65fec..6d28f9223893a3439d9bc88b51997518ef75fcb9 100644 --- a/libmongoc/1.24.2/mongoc_client_set_apm_callbacks.html +++ b/libmongoc/1.24.2/mongoc_client_set_apm_callbacks.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_appname.html b/libmongoc/1.24.2/mongoc_client_set_appname.html index 9d1aa4d5c2744f297f460c1ab01c58fd76466f0a..ff86131cc1acf11d39f209125ff443562ff7eaab 100644 --- a/libmongoc/1.24.2/mongoc_client_set_appname.html +++ b/libmongoc/1.24.2/mongoc_client_set_appname.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_error_api.html b/libmongoc/1.24.2/mongoc_client_set_error_api.html index 23500a9f4c26b0cb7d1b0758b26a866240084264..001fb1807514d8492e161d2206ed8b7947a080c8 100644 --- a/libmongoc/1.24.2/mongoc_client_set_error_api.html +++ b/libmongoc/1.24.2/mongoc_client_set_error_api.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_read_concern.html b/libmongoc/1.24.2/mongoc_client_set_read_concern.html index db1d4b57c7de219fe5a899d607da7c17c7d59a07..22e0436cbd428d06f2f9466d3748d13d7faeaf11 100644 --- a/libmongoc/1.24.2/mongoc_client_set_read_concern.html +++ b/libmongoc/1.24.2/mongoc_client_set_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_read_prefs.html b/libmongoc/1.24.2/mongoc_client_set_read_prefs.html index d833a5d1df7fa771a66fc242e01f2de7335fc662..ec62c51d3ac321f4bb541dbbc8a3a659b88ec621 100644 --- a/libmongoc/1.24.2/mongoc_client_set_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_client_set_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_server_api.html b/libmongoc/1.24.2/mongoc_client_set_server_api.html index cfb7eaca3baafe5abb250fe6b2f55a142e54f87c..0e25aeea01a2db24dc7a0cea6de0c1f131ae37ce 100644 --- a/libmongoc/1.24.2/mongoc_client_set_server_api.html +++ b/libmongoc/1.24.2/mongoc_client_set_server_api.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_ssl_opts.html b/libmongoc/1.24.2/mongoc_client_set_ssl_opts.html index 2bcb15c7737cbeb15f6f7ec88c5ef047b8352a4d..dfeafa1590a53b362567e074805624ed56308fb7 100644 --- a/libmongoc/1.24.2/mongoc_client_set_ssl_opts.html +++ b/libmongoc/1.24.2/mongoc_client_set_ssl_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_stream_initiator.html b/libmongoc/1.24.2/mongoc_client_set_stream_initiator.html index 0edf462bc53ddb0723e226a7b33e88c89a694200..15c47082bdd970b387c1870f9545fa7fdfd75c57 100644 --- a/libmongoc/1.24.2/mongoc_client_set_stream_initiator.html +++ b/libmongoc/1.24.2/mongoc_client_set_stream_initiator.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_set_write_concern.html b/libmongoc/1.24.2/mongoc_client_set_write_concern.html index 1a10820ae03e169b428832fe288a47f37cd680f1..7424731e700151f8fc1eaea4ab6ae1639f1c9908 100644 --- a/libmongoc/1.24.2/mongoc_client_set_write_concern.html +++ b/libmongoc/1.24.2/mongoc_client_set_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_start_session.html b/libmongoc/1.24.2/mongoc_client_start_session.html index 6877778249f83f63d37b99ed16cbf09ffdfd0701..f6573767d8d73e4f9fd4434af7b1d937c5839297 100644 --- a/libmongoc/1.24.2/mongoc_client_start_session.html +++ b/libmongoc/1.24.2/mongoc_client_start_session.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_t.html b/libmongoc/1.24.2/mongoc_client_t.html index f6566ff9bfe727b5c07a907209702f343c0d3cca..42e88c6a15db5dcd7458af86d3e89b1f437d88fd 100644 --- a/libmongoc/1.24.2/mongoc_client_t.html +++ b/libmongoc/1.24.2/mongoc_client_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_watch.html b/libmongoc/1.24.2/mongoc_client_watch.html index 764682448e265ef56611207ff81787450afcc1a3..df64d9e203189f092d654e79837c17a9cd8f36d9 100644 --- a/libmongoc/1.24.2/mongoc_client_watch.html +++ b/libmongoc/1.24.2/mongoc_client_watch.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_client_write_command_with_opts.html b/libmongoc/1.24.2/mongoc_client_write_command_with_opts.html index 9b894d4a19cd575c1ce44f3048df0d4fa8e55831..8420e648fa9a932fdd1629767f4c1bd383b3d2f0 100644 --- a/libmongoc/1.24.2/mongoc_client_write_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_client_write_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_aggregate.html b/libmongoc/1.24.2/mongoc_collection_aggregate.html index 0d30f692a24327f8851187a9765cbc9c5485c26b..8a5f23f71968ec9798c8fac4781892021862d071 100644 --- a/libmongoc/1.24.2/mongoc_collection_aggregate.html +++ b/libmongoc/1.24.2/mongoc_collection_aggregate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_command.html b/libmongoc/1.24.2/mongoc_collection_command.html index e9b1ca73b625c8c8d77440147d94e3d145f7206d..34d10e036cb35f5c377dafda86c0403d03f0dbf9 100644 --- a/libmongoc/1.24.2/mongoc_collection_command.html +++ b/libmongoc/1.24.2/mongoc_collection_command.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_command_simple.html b/libmongoc/1.24.2/mongoc_collection_command_simple.html index ab6c531c7f64d8e9b9d15cf791b32ecbf0240bc5..5c1890d9b20aad43467607d0dcb2e14036f6ab7d 100644 --- a/libmongoc/1.24.2/mongoc_collection_command_simple.html +++ b/libmongoc/1.24.2/mongoc_collection_command_simple.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_command_with_opts.html b/libmongoc/1.24.2/mongoc_collection_command_with_opts.html index c97a1f9ebbc955f2a72ecf445030fb5b11c48de9..8c1801e9aedddee54037b0266caf2c83073b6f07 100644 --- a/libmongoc/1.24.2/mongoc_collection_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_copy.html b/libmongoc/1.24.2/mongoc_collection_copy.html index aae3e46bbccce4a510794326ee3c914f90cbe675..b618d68afff51d34fc6d4476b5645d338fb28a1a 100644 --- a/libmongoc/1.24.2/mongoc_collection_copy.html +++ b/libmongoc/1.24.2/mongoc_collection_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_count.html b/libmongoc/1.24.2/mongoc_collection_count.html index ba93a4782eb19c998e1431e488a70687307200b5..b08c822fbc14331f8fb3214b4582f88756e59b48 100644 --- a/libmongoc/1.24.2/mongoc_collection_count.html +++ b/libmongoc/1.24.2/mongoc_collection_count.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_count_documents.html b/libmongoc/1.24.2/mongoc_collection_count_documents.html index bf59e9c5c7a9ee28b08293f3acbb58c7d1882af5..e083a5efbcf792eb47e5ec18dd9b2cc61e715370 100644 --- a/libmongoc/1.24.2/mongoc_collection_count_documents.html +++ b/libmongoc/1.24.2/mongoc_collection_count_documents.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_count_with_opts.html b/libmongoc/1.24.2/mongoc_collection_count_with_opts.html index c258454bc4115db7350cd88700cba0d739541412..6caaef66f5ed865ab1ad138f40f1c87332c8929d 100644 --- a/libmongoc/1.24.2/mongoc_collection_count_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_count_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_create_bulk_operation.html b/libmongoc/1.24.2/mongoc_collection_create_bulk_operation.html index fa580094df9bf52637aaf32fc969e807857f5d7e..249464b2ad5a89467ee92b0f68d6160492f4a66c 100644 --- a/libmongoc/1.24.2/mongoc_collection_create_bulk_operation.html +++ b/libmongoc/1.24.2/mongoc_collection_create_bulk_operation.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_create_bulk_operation_with_opts.html b/libmongoc/1.24.2/mongoc_collection_create_bulk_operation_with_opts.html index 70e47aa5a279e155675594e5b2e4f9ff9badcc7c..9720a28660f21271ab75d81fb9a1c53368099c9c 100644 --- a/libmongoc/1.24.2/mongoc_collection_create_bulk_operation_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_create_bulk_operation_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_create_index.html b/libmongoc/1.24.2/mongoc_collection_create_index.html index 5095533284ef72a31d969c69eb54ab4e4b68d7e4..2e75176ea6fe5609382881e77dcdf596a6b376a2 100644 --- a/libmongoc/1.24.2/mongoc_collection_create_index.html +++ b/libmongoc/1.24.2/mongoc_collection_create_index.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_create_index_with_opts.html b/libmongoc/1.24.2/mongoc_collection_create_index_with_opts.html index 6eeb7d6feeafa896a2f3eb739fdac40328e9f013..06fd6052c203c4c784abe550516f28ea22e00d27 100644 --- a/libmongoc/1.24.2/mongoc_collection_create_index_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_create_index_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_create_indexes_with_opts.html b/libmongoc/1.24.2/mongoc_collection_create_indexes_with_opts.html index 2ebbdb5cc769e99eb46ddea1feb1dbbae2e190d8..b4d18d961bade9017111b5bb56e9f427001bd046 100644 --- a/libmongoc/1.24.2/mongoc_collection_create_indexes_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_create_indexes_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_delete.html b/libmongoc/1.24.2/mongoc_collection_delete.html index 56151c0d4a35f4b88f394863418276ce469d13e4..5a2122e79636fc27f32d5e9999f307c516eb6289 100644 --- a/libmongoc/1.24.2/mongoc_collection_delete.html +++ b/libmongoc/1.24.2/mongoc_collection_delete.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_delete_many.html b/libmongoc/1.24.2/mongoc_collection_delete_many.html index b6ebfe1ae9607be6d86da0be847fd890a7d9ea73..48e0377ec653bf0ef63288849ef60c01141a1658 100644 --- a/libmongoc/1.24.2/mongoc_collection_delete_many.html +++ b/libmongoc/1.24.2/mongoc_collection_delete_many.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_delete_one.html b/libmongoc/1.24.2/mongoc_collection_delete_one.html index 74a0ad35cb26291958a7cbeeae82fce97d28968a..42a799fab798b504ac129c217bbff9b12fd9d395 100644 --- a/libmongoc/1.24.2/mongoc_collection_delete_one.html +++ b/libmongoc/1.24.2/mongoc_collection_delete_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_destroy.html b/libmongoc/1.24.2/mongoc_collection_destroy.html index 18e5544221cdd3b670a7b469c742a0dc627278eb..16fe1ef211ac8e75e68f46816ca228dd71065a5d 100644 --- a/libmongoc/1.24.2/mongoc_collection_destroy.html +++ b/libmongoc/1.24.2/mongoc_collection_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_drop.html b/libmongoc/1.24.2/mongoc_collection_drop.html index 65e72010751bc6f5edfd79e836fbe776a850090e..0524815e2083af680bb973ce78a9ab40d5c25439 100644 --- a/libmongoc/1.24.2/mongoc_collection_drop.html +++ b/libmongoc/1.24.2/mongoc_collection_drop.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_drop_index.html b/libmongoc/1.24.2/mongoc_collection_drop_index.html index 0f9a9280930d5f95d35e3bb4b867429966dac058..ef2c32ddefe3c1ec81b78ddd145cb7a4dc5ccd71 100644 --- a/libmongoc/1.24.2/mongoc_collection_drop_index.html +++ b/libmongoc/1.24.2/mongoc_collection_drop_index.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_drop_index_with_opts.html b/libmongoc/1.24.2/mongoc_collection_drop_index_with_opts.html index b1b6ba53951818d5d5caf9c4d963280b744f300d..3bc9f6525650f149f19901481941947854845406 100644 --- a/libmongoc/1.24.2/mongoc_collection_drop_index_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_drop_index_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_drop_with_opts.html b/libmongoc/1.24.2/mongoc_collection_drop_with_opts.html index 34b1ef13d571c4f27673ef0249ab0241b8952449..9391a7f9121d3b4ae4a01c962cde05a03e4ef3fe 100644 --- a/libmongoc/1.24.2/mongoc_collection_drop_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_drop_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_ensure_index.html b/libmongoc/1.24.2/mongoc_collection_ensure_index.html index c94df751ffe1cc911f2379e67260b142f7ee5390..cc5abbc6e9604762add3e5dffe50f91a5524896c 100644 --- a/libmongoc/1.24.2/mongoc_collection_ensure_index.html +++ b/libmongoc/1.24.2/mongoc_collection_ensure_index.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_estimated_document_count.html b/libmongoc/1.24.2/mongoc_collection_estimated_document_count.html index 82f8787ac55dad166e3fb5c8a97646816b485b40..4781c595a91ae175167db270ab313938f4c85281 100644 --- a/libmongoc/1.24.2/mongoc_collection_estimated_document_count.html +++ b/libmongoc/1.24.2/mongoc_collection_estimated_document_count.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_find.html b/libmongoc/1.24.2/mongoc_collection_find.html index 0466a0d3e270a95eeb014b29ca949bacd460c0f7..0508bd3eeb2f220d02edf694581f957d6d7971cb 100644 --- a/libmongoc/1.24.2/mongoc_collection_find.html +++ b/libmongoc/1.24.2/mongoc_collection_find.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_find_and_modify.html b/libmongoc/1.24.2/mongoc_collection_find_and_modify.html index 48da4e314768354080e1086fe397e79336a74e63..b99e5c837ca4b3064429c454fcac842d8d02913a 100644 --- a/libmongoc/1.24.2/mongoc_collection_find_and_modify.html +++ b/libmongoc/1.24.2/mongoc_collection_find_and_modify.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_find_and_modify_with_opts.html b/libmongoc/1.24.2/mongoc_collection_find_and_modify_with_opts.html index 6ae10b438f316b0011df769ded7d499091ae4d44..1b7b67f93c68a35183ec3fcd20d021a52fb3969f 100644 --- a/libmongoc/1.24.2/mongoc_collection_find_and_modify_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_find_and_modify_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_find_indexes.html b/libmongoc/1.24.2/mongoc_collection_find_indexes.html index d669f4044ffb88e11c2c290846973aa325395d23..d127d654f1b8a2ad2982bf79ea62c2396c8d18c4 100644 --- a/libmongoc/1.24.2/mongoc_collection_find_indexes.html +++ b/libmongoc/1.24.2/mongoc_collection_find_indexes.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_find_indexes_with_opts.html b/libmongoc/1.24.2/mongoc_collection_find_indexes_with_opts.html index b7b6f350c9bb618838eeda3a60b0e2bc7ea35846..e72e2670a3ef7f147e1f138146f3d13f3716efa6 100644 --- a/libmongoc/1.24.2/mongoc_collection_find_indexes_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_find_indexes_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_find_with_opts.html b/libmongoc/1.24.2/mongoc_collection_find_with_opts.html index 415d8084c318d32c10aca345ec3cf176a9ba759d..4f745de8ce010176ee3e0acc433042e4881c5adb 100644 --- a/libmongoc/1.24.2/mongoc_collection_find_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_find_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_get_last_error.html b/libmongoc/1.24.2/mongoc_collection_get_last_error.html index 9476c052c57d87d721c0b088bc66a484e95a3a6f..c9008c1c57ff7352cfb0b99cbc7e08f0f7fdfe15 100644 --- a/libmongoc/1.24.2/mongoc_collection_get_last_error.html +++ b/libmongoc/1.24.2/mongoc_collection_get_last_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_get_name.html b/libmongoc/1.24.2/mongoc_collection_get_name.html index 78e7cd7fc935abfae1d8d9002e33b1d824fa77fe..9f021fa19149aec1d421a9cbd2fb41ab4e97f6b8 100644 --- a/libmongoc/1.24.2/mongoc_collection_get_name.html +++ b/libmongoc/1.24.2/mongoc_collection_get_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_get_read_concern.html b/libmongoc/1.24.2/mongoc_collection_get_read_concern.html index 9f6b0afc671e8e68fff8f5b78b047770a24f6152..2abaafee41181a7107e55bbcf24a24c4ffe3c7b9 100644 --- a/libmongoc/1.24.2/mongoc_collection_get_read_concern.html +++ b/libmongoc/1.24.2/mongoc_collection_get_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_get_read_prefs.html b/libmongoc/1.24.2/mongoc_collection_get_read_prefs.html index 80a957f2c5603b51f91835f4c63a79abbeedb8da..085778f0933ea2388a5f5c1e7ace71a1309eea0d 100644 --- a/libmongoc/1.24.2/mongoc_collection_get_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_collection_get_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_get_write_concern.html b/libmongoc/1.24.2/mongoc_collection_get_write_concern.html index 6c0618ed191e34eb63f73759defc92d0a68e39fd..c773e2be728e2f912c7fc4b8328fbae37c2854a7 100644 --- a/libmongoc/1.24.2/mongoc_collection_get_write_concern.html +++ b/libmongoc/1.24.2/mongoc_collection_get_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_insert.html b/libmongoc/1.24.2/mongoc_collection_insert.html index ee1daeb337e1bea70122690ad4c2b30d557ee296..e4ceb09d7d20586cdba7eacaa50b012628dd501b 100644 --- a/libmongoc/1.24.2/mongoc_collection_insert.html +++ b/libmongoc/1.24.2/mongoc_collection_insert.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_insert_bulk.html b/libmongoc/1.24.2/mongoc_collection_insert_bulk.html index 98153c45ccd866438f0e13a9e91343f4b06ac512..75a56c7abcd3159b44ebedf47b664404bbe88060 100644 --- a/libmongoc/1.24.2/mongoc_collection_insert_bulk.html +++ b/libmongoc/1.24.2/mongoc_collection_insert_bulk.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_insert_many.html b/libmongoc/1.24.2/mongoc_collection_insert_many.html index 20099779307c71f78ccc4f6af6c15343d4549b1e..5683fe4abcfeaddafb45f968f4a5b3d0b6f02ab4 100644 --- a/libmongoc/1.24.2/mongoc_collection_insert_many.html +++ b/libmongoc/1.24.2/mongoc_collection_insert_many.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_insert_one.html b/libmongoc/1.24.2/mongoc_collection_insert_one.html index 256fce5acd061370e04a6aebe8470877c6b9cb0f..28bfbfaef9d0bf324db628ec32c96d96e7d7a78a 100644 --- a/libmongoc/1.24.2/mongoc_collection_insert_one.html +++ b/libmongoc/1.24.2/mongoc_collection_insert_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_keys_to_index_string.html b/libmongoc/1.24.2/mongoc_collection_keys_to_index_string.html index d535667de131786c2a3e2e1ef89d45c63dde7e40..79a1884431f8458a10ac64d430c79c4f5855b75e 100644 --- a/libmongoc/1.24.2/mongoc_collection_keys_to_index_string.html +++ b/libmongoc/1.24.2/mongoc_collection_keys_to_index_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_read_command_with_opts.html b/libmongoc/1.24.2/mongoc_collection_read_command_with_opts.html index 858573924aae8ac992512864dd9593869efebc37..58b81c6d6b67fc4d0b774c10fb227e355bbfdc30 100644 --- a/libmongoc/1.24.2/mongoc_collection_read_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_read_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_read_write_command_with_opts.html b/libmongoc/1.24.2/mongoc_collection_read_write_command_with_opts.html index 8b750fa306b94821a60a2b4cd3f3f057b83c5079..c1805ff46101b959a29bd1f8a3321a010b83f0be 100644 --- a/libmongoc/1.24.2/mongoc_collection_read_write_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_read_write_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_remove.html b/libmongoc/1.24.2/mongoc_collection_remove.html index 99fffcffdd7a48582894d9bc943f72b6dd91e498..a9ce4f57658f4590b12c6f49316bfd598ea2961f 100644 --- a/libmongoc/1.24.2/mongoc_collection_remove.html +++ b/libmongoc/1.24.2/mongoc_collection_remove.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_rename.html b/libmongoc/1.24.2/mongoc_collection_rename.html index e92ff0b9fafe8a61cd61d9ff08605ee9046cdadb..728a177a82f35867b9075ebf5bf9137b25de1e1c 100644 --- a/libmongoc/1.24.2/mongoc_collection_rename.html +++ b/libmongoc/1.24.2/mongoc_collection_rename.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_rename_with_opts.html b/libmongoc/1.24.2/mongoc_collection_rename_with_opts.html index 0ed2c0953d8a6ab53fe81c23a1be8884dd37f03d..8abfba387eb2895270f3250eb376bb113175c60d 100644 --- a/libmongoc/1.24.2/mongoc_collection_rename_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_rename_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_replace_one.html b/libmongoc/1.24.2/mongoc_collection_replace_one.html index ac335e6d160e0b1b3a3935568e4604eb487197c0..88dd8c74bf45077c83e084349e892900ad46da40 100644 --- a/libmongoc/1.24.2/mongoc_collection_replace_one.html +++ b/libmongoc/1.24.2/mongoc_collection_replace_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_save.html b/libmongoc/1.24.2/mongoc_collection_save.html index 82238d2822c98aa6b53949f46e444d38569fab4b..1399a07f1383351987daf93ef8da0fa58f5d5917 100644 --- a/libmongoc/1.24.2/mongoc_collection_save.html +++ b/libmongoc/1.24.2/mongoc_collection_save.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_set_read_concern.html b/libmongoc/1.24.2/mongoc_collection_set_read_concern.html index 24f38e49415cfbf090a0208fa60e6e05e2bdfe92..ed135983453937106cd648acfbce6dda507d91c7 100644 --- a/libmongoc/1.24.2/mongoc_collection_set_read_concern.html +++ b/libmongoc/1.24.2/mongoc_collection_set_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_set_read_prefs.html b/libmongoc/1.24.2/mongoc_collection_set_read_prefs.html index 2ebce5aefcac3a851747198a566a52ab0b95a651..fcf144dfd3493bc4c463917d19a29804fceb5db4 100644 --- a/libmongoc/1.24.2/mongoc_collection_set_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_collection_set_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_set_write_concern.html b/libmongoc/1.24.2/mongoc_collection_set_write_concern.html index 487da40d35b1e5926eddbda6f89052ccb4c7bf34..8aff8eee08d24cbb2761aff1f420733544847f35 100644 --- a/libmongoc/1.24.2/mongoc_collection_set_write_concern.html +++ b/libmongoc/1.24.2/mongoc_collection_set_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_stats.html b/libmongoc/1.24.2/mongoc_collection_stats.html index b16f3365181107c2bdb70ac29b95876a5cd7db6c..e242441163b9f6803cdfbb845a85cd8919e01001 100644 --- a/libmongoc/1.24.2/mongoc_collection_stats.html +++ b/libmongoc/1.24.2/mongoc_collection_stats.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_t.html b/libmongoc/1.24.2/mongoc_collection_t.html index fdcee6887109281a875f6a0204d8ab19e0250f84..60d6b02dad1c955bd72807f692880b5a3bb56fb9 100644 --- a/libmongoc/1.24.2/mongoc_collection_t.html +++ b/libmongoc/1.24.2/mongoc_collection_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_update.html b/libmongoc/1.24.2/mongoc_collection_update.html index cc99f27cc89c8cfa99a9e0d2844ca99695f9e0bc..b787955763271657cd0448a25db89d3d66f44c78 100644 --- a/libmongoc/1.24.2/mongoc_collection_update.html +++ b/libmongoc/1.24.2/mongoc_collection_update.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_update_many.html b/libmongoc/1.24.2/mongoc_collection_update_many.html index 8a2dd6f542d16c0dea5616823207a3b04be2657c..ed3b8db08c90fe6051a49827adc203a398ddd11d 100644 --- a/libmongoc/1.24.2/mongoc_collection_update_many.html +++ b/libmongoc/1.24.2/mongoc_collection_update_many.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_update_one.html b/libmongoc/1.24.2/mongoc_collection_update_one.html index cf58c09c67fb6849ffc6e9858e0f6c540ab8eff4..06c97a37afd006d66d4c4a9eeb822382eb62ce42 100644 --- a/libmongoc/1.24.2/mongoc_collection_update_one.html +++ b/libmongoc/1.24.2/mongoc_collection_update_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_validate.html b/libmongoc/1.24.2/mongoc_collection_validate.html index 5d263fa9e89096ffb6d56d45500d92d322650ab1..19ec637952a0146618565b6accfd4074e98ef453 100644 --- a/libmongoc/1.24.2/mongoc_collection_validate.html +++ b/libmongoc/1.24.2/mongoc_collection_validate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_watch.html b/libmongoc/1.24.2/mongoc_collection_watch.html index 06eb1d580606ec6b74d278dd1cc2a1c45594ef8a..542f177aead7269de4b0b39a5f657867e23c92c1 100644 --- a/libmongoc/1.24.2/mongoc_collection_watch.html +++ b/libmongoc/1.24.2/mongoc_collection_watch.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_collection_write_command_with_opts.html b/libmongoc/1.24.2/mongoc_collection_write_command_with_opts.html index 84b49cbb11ed668ffb84d576608c00b571d1345f..68b4dbba6815952ac5f26c88f1fc6b0be7431478 100644 --- a/libmongoc/1.24.2/mongoc_collection_write_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_collection_write_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_clone.html b/libmongoc/1.24.2/mongoc_cursor_clone.html index 1c67f3a2c1fd928bdfbb7613fc3624e2d70cea3e..e47bc6a36287616c87ac0ebfc0e18d83d6eb0deb 100644 --- a/libmongoc/1.24.2/mongoc_cursor_clone.html +++ b/libmongoc/1.24.2/mongoc_cursor_clone.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_current.html b/libmongoc/1.24.2/mongoc_cursor_current.html index c23bda05186efb2431860088df78ef36cdb58d96..118a278b5e9df4153098e29b25e79b1ead946bfc 100644 --- a/libmongoc/1.24.2/mongoc_cursor_current.html +++ b/libmongoc/1.24.2/mongoc_cursor_current.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_destroy.html b/libmongoc/1.24.2/mongoc_cursor_destroy.html index cbd3a48c5373686c5223257e05ed7e8ce5378d44..ee180d7e7e2b753ed094a89998d567bda979e75a 100644 --- a/libmongoc/1.24.2/mongoc_cursor_destroy.html +++ b/libmongoc/1.24.2/mongoc_cursor_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_error.html b/libmongoc/1.24.2/mongoc_cursor_error.html index 4168c96f65cf1ae2fb0260fc3e1e7fdfa19cf63e..af7e8e56865802562f76e041c2e98cae06238f84 100644 --- a/libmongoc/1.24.2/mongoc_cursor_error.html +++ b/libmongoc/1.24.2/mongoc_cursor_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_error_document.html b/libmongoc/1.24.2/mongoc_cursor_error_document.html index 15c9dabbbf58c3f0bb1e07fc4d5371d50bd5271f..eceba9183883ae6262eba84fb673a3859db1162a 100644 --- a/libmongoc/1.24.2/mongoc_cursor_error_document.html +++ b/libmongoc/1.24.2/mongoc_cursor_error_document.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_get_batch_size.html b/libmongoc/1.24.2/mongoc_cursor_get_batch_size.html index e9660a6b7a57ef10f1a81db75cc99f94124b06c3..fe1ec2b86c6504e9a0cd648203e77a6f2bf6d006 100644 --- a/libmongoc/1.24.2/mongoc_cursor_get_batch_size.html +++ b/libmongoc/1.24.2/mongoc_cursor_get_batch_size.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_get_hint.html b/libmongoc/1.24.2/mongoc_cursor_get_hint.html index 5ab60193fa324d8acc0fb281fa5a09424f87ba6e..6a99e889bdcdf2baf3a97c0052200ef515dafd48 100644 --- a/libmongoc/1.24.2/mongoc_cursor_get_hint.html +++ b/libmongoc/1.24.2/mongoc_cursor_get_hint.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_get_host.html b/libmongoc/1.24.2/mongoc_cursor_get_host.html index d19a53f86393ab723489e4a2073d2922166f2611..aabb38dff09d99d2b0ec79819a2b2c74da0b7792 100644 --- a/libmongoc/1.24.2/mongoc_cursor_get_host.html +++ b/libmongoc/1.24.2/mongoc_cursor_get_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_get_id.html b/libmongoc/1.24.2/mongoc_cursor_get_id.html index 9e34d00d620e9cd9e68e86e8b2aae7ca5adcc43c..72eb53fd70df108d679436327e9273aeb5e5f0c3 100644 --- a/libmongoc/1.24.2/mongoc_cursor_get_id.html +++ b/libmongoc/1.24.2/mongoc_cursor_get_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_get_limit.html b/libmongoc/1.24.2/mongoc_cursor_get_limit.html index 25a0a2a50ddc840b90a00f08a3ba1515cd160e56..bd31f793f1998a20e9eb3df9fdd4fc2dff7c1160 100644 --- a/libmongoc/1.24.2/mongoc_cursor_get_limit.html +++ b/libmongoc/1.24.2/mongoc_cursor_get_limit.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_get_max_await_time_ms.html b/libmongoc/1.24.2/mongoc_cursor_get_max_await_time_ms.html index a583b569fac499f4726a39e414c7eba9e06342d6..10de241616447de5518273b013709900298a5323 100644 --- a/libmongoc/1.24.2/mongoc_cursor_get_max_await_time_ms.html +++ b/libmongoc/1.24.2/mongoc_cursor_get_max_await_time_ms.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_is_alive.html b/libmongoc/1.24.2/mongoc_cursor_is_alive.html index 2cb6660eeaa926d0ef630446f7d4c91d3f59ff6e..83e80927f580911c4c545ebf35fc91c3d72946c1 100644 --- a/libmongoc/1.24.2/mongoc_cursor_is_alive.html +++ b/libmongoc/1.24.2/mongoc_cursor_is_alive.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_more.html b/libmongoc/1.24.2/mongoc_cursor_more.html index f3039f17ca5005d7192be0691abc44ad286c8f13..c4e3d0c06187f98c1bb8197aef4951d7b4e568ca 100644 --- a/libmongoc/1.24.2/mongoc_cursor_more.html +++ b/libmongoc/1.24.2/mongoc_cursor_more.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply.html b/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply.html index 94baea6f92670ecac4199d7564304768fa7af313..942ac4ff3584b8f6ec957a6f8831466bd8db6915 100644 --- a/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply.html +++ b/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply_with_opts.html b/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply_with_opts.html index 025ae3b95bfd1210161f680cc5f3ce5b68a8e90e..471fa946142b274546bced0f12439c35c1bb742b 100644 --- a/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply_with_opts.html +++ b/libmongoc/1.24.2/mongoc_cursor_new_from_command_reply_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_next.html b/libmongoc/1.24.2/mongoc_cursor_next.html index 675635e9babdcd4e43606f19547c18de1fade841..18782b80415704852b2a26e3da7b60964c6ad277 100644 --- a/libmongoc/1.24.2/mongoc_cursor_next.html +++ b/libmongoc/1.24.2/mongoc_cursor_next.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_set_batch_size.html b/libmongoc/1.24.2/mongoc_cursor_set_batch_size.html index aab3e5ce5e985613b13b31c76f124e19b4ce7063..894b6d20a629a390d96f38cef9c5aab05fc2fbd0 100644 --- a/libmongoc/1.24.2/mongoc_cursor_set_batch_size.html +++ b/libmongoc/1.24.2/mongoc_cursor_set_batch_size.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_set_hint.html b/libmongoc/1.24.2/mongoc_cursor_set_hint.html index 339fa4b6d0b5503be772699a1f3f32e5c60b2ff6..417992cb0f95979757433f2cf6dc39847199640f 100644 --- a/libmongoc/1.24.2/mongoc_cursor_set_hint.html +++ b/libmongoc/1.24.2/mongoc_cursor_set_hint.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_set_limit.html b/libmongoc/1.24.2/mongoc_cursor_set_limit.html index fc0dad998eb3c26955e69071d1b94e0fd80622b1..14dd126c16ddf49b4563758ffd0578410dbed008 100644 --- a/libmongoc/1.24.2/mongoc_cursor_set_limit.html +++ b/libmongoc/1.24.2/mongoc_cursor_set_limit.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_set_max_await_time_ms.html b/libmongoc/1.24.2/mongoc_cursor_set_max_await_time_ms.html index 829e14d57a23575fd338b784d3b69da8f4df1f6b..d0b18b874c627ac6ab44c3c4de96a25cbc723cb1 100644 --- a/libmongoc/1.24.2/mongoc_cursor_set_max_await_time_ms.html +++ b/libmongoc/1.24.2/mongoc_cursor_set_max_await_time_ms.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_cursor_t.html b/libmongoc/1.24.2/mongoc_cursor_t.html index a4ee392a7ae46dda0af70f1a2d935fc710713a92..563b1c23c0e83612ecb2fc1f547014a40db1c1b5 100644 --- a/libmongoc/1.24.2/mongoc_cursor_t.html +++ b/libmongoc/1.24.2/mongoc_cursor_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_add_user.html b/libmongoc/1.24.2/mongoc_database_add_user.html index bf38daceb2edbcffef21bb0fc859d259db20d197..e21a4b5eb202485d0de6f31cebf29cd203665882 100644 --- a/libmongoc/1.24.2/mongoc_database_add_user.html +++ b/libmongoc/1.24.2/mongoc_database_add_user.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_aggregate.html b/libmongoc/1.24.2/mongoc_database_aggregate.html index 0820d77d160ca0082967d914d54f8873655b7632..d3f127fa44e9f381cb3160a8aa0a55dbc6a50044 100644 --- a/libmongoc/1.24.2/mongoc_database_aggregate.html +++ b/libmongoc/1.24.2/mongoc_database_aggregate.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_command.html b/libmongoc/1.24.2/mongoc_database_command.html index 069fa54583b6ed2e801c44be60ec9a0e31fbecde..e03303adbe464cba35e3c5ed981b05dfcc5645b7 100644 --- a/libmongoc/1.24.2/mongoc_database_command.html +++ b/libmongoc/1.24.2/mongoc_database_command.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_command_simple.html b/libmongoc/1.24.2/mongoc_database_command_simple.html index be6a4d2fd030f7587dfecd3a066dc46ec8cc2800..9d5b8ae202b714f6a0219cd663ac4a5784112607 100644 --- a/libmongoc/1.24.2/mongoc_database_command_simple.html +++ b/libmongoc/1.24.2/mongoc_database_command_simple.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_command_with_opts.html b/libmongoc/1.24.2/mongoc_database_command_with_opts.html index d680b64a12a410f7b0fe11562628a87d47c8fce5..9f719c2caa2ab30fe894c490fdc87cf04d628ca1 100644 --- a/libmongoc/1.24.2/mongoc_database_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_copy.html b/libmongoc/1.24.2/mongoc_database_copy.html index 400904f2d4ca37cdfabea1870869304113aa725d..b400ce482eec2e2841d06328d72820f3239264f8 100644 --- a/libmongoc/1.24.2/mongoc_database_copy.html +++ b/libmongoc/1.24.2/mongoc_database_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_create_collection.html b/libmongoc/1.24.2/mongoc_database_create_collection.html index fdfba4ca3a539a8e16f16e60eafd2b6f0704faed..18bfbc2ca2ea4e1a0647d4def5ebeda0e0112c13 100644 --- a/libmongoc/1.24.2/mongoc_database_create_collection.html +++ b/libmongoc/1.24.2/mongoc_database_create_collection.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_destroy.html b/libmongoc/1.24.2/mongoc_database_destroy.html index e2e495a2e910a27268c79c5646cf2633247fdaf7..9f70ec01322f9155d924acb3c3e8ad1d34a497db 100644 --- a/libmongoc/1.24.2/mongoc_database_destroy.html +++ b/libmongoc/1.24.2/mongoc_database_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_drop.html b/libmongoc/1.24.2/mongoc_database_drop.html index bab611a8f8c15404db1dc914139852b959f21b58..4859e07414b43b4cd29378c99e306bb9db93882a 100644 --- a/libmongoc/1.24.2/mongoc_database_drop.html +++ b/libmongoc/1.24.2/mongoc_database_drop.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_drop_with_opts.html b/libmongoc/1.24.2/mongoc_database_drop_with_opts.html index a9dcb54f001c58c8f36acad71fb0425cc645f74d..ea939bbec7dd1b0c05f428d1a76d772be1a3f0ba 100644 --- a/libmongoc/1.24.2/mongoc_database_drop_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_drop_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_find_collections.html b/libmongoc/1.24.2/mongoc_database_find_collections.html index a0509cfca03427d0d4e52fd9fc78be550a4f485a..f56e32a3a0227403a3a9d1d8e743fc29b856afbb 100644 --- a/libmongoc/1.24.2/mongoc_database_find_collections.html +++ b/libmongoc/1.24.2/mongoc_database_find_collections.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_find_collections_with_opts.html b/libmongoc/1.24.2/mongoc_database_find_collections_with_opts.html index 2fda9790a07d8f0e24c304a32b61226dd0e0813a..b481d415746a518b598f7a7cb6cb8dfdc9f94cdf 100644 --- a/libmongoc/1.24.2/mongoc_database_find_collections_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_find_collections_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_collection.html b/libmongoc/1.24.2/mongoc_database_get_collection.html index ee30bb616431c0325b21cf0ccd9492faa909d40d..bbcd52c3b47bc3a86e2c4c7c09999c9cf7f3ff8f 100644 --- a/libmongoc/1.24.2/mongoc_database_get_collection.html +++ b/libmongoc/1.24.2/mongoc_database_get_collection.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_collection_names.html b/libmongoc/1.24.2/mongoc_database_get_collection_names.html index dd4c71e3f6155efa684b62149ac2b583d22d3cae..4468978ded49d46e00b19fd1ee8183cc08dcf3ba 100644 --- a/libmongoc/1.24.2/mongoc_database_get_collection_names.html +++ b/libmongoc/1.24.2/mongoc_database_get_collection_names.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_collection_names_with_opts.html b/libmongoc/1.24.2/mongoc_database_get_collection_names_with_opts.html index 5d38d024ca10a65c488ad1c37a0d60f261b82eb6..1e8e59ee46aa6ff18a230592f33d9d597b7df660 100644 --- a/libmongoc/1.24.2/mongoc_database_get_collection_names_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_get_collection_names_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_name.html b/libmongoc/1.24.2/mongoc_database_get_name.html index 69a88c34e12515e6afc21cd82151df549bac25d4..8ecb3c190f2ac8d4bea7c137d492ddfbe8379fd5 100644 --- a/libmongoc/1.24.2/mongoc_database_get_name.html +++ b/libmongoc/1.24.2/mongoc_database_get_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_read_concern.html b/libmongoc/1.24.2/mongoc_database_get_read_concern.html index 9445bcbc55feab532b332294ba12eb1d25ba1f11..a06dd96fcce36709ec7a087d8d8042eeb9368081 100644 --- a/libmongoc/1.24.2/mongoc_database_get_read_concern.html +++ b/libmongoc/1.24.2/mongoc_database_get_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_read_prefs.html b/libmongoc/1.24.2/mongoc_database_get_read_prefs.html index b2ef21ced9315d0e700b812553d01420dbc653f4..0c05cddf42ae16538e9f351f66515c71a28126b5 100644 --- a/libmongoc/1.24.2/mongoc_database_get_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_database_get_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_get_write_concern.html b/libmongoc/1.24.2/mongoc_database_get_write_concern.html index bd0f108d1bb3f0e099cd2dd1f8cdfc7ebd5dad18..f40cfb4ecb6e0dbc35933f0d3273801cb570652a 100644 --- a/libmongoc/1.24.2/mongoc_database_get_write_concern.html +++ b/libmongoc/1.24.2/mongoc_database_get_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_has_collection.html b/libmongoc/1.24.2/mongoc_database_has_collection.html index 8e82bcd44ee40553d9348e626d0be06bc89007c1..42cb09f78028decd67383c6df3ce7f0e7673b8b6 100644 --- a/libmongoc/1.24.2/mongoc_database_has_collection.html +++ b/libmongoc/1.24.2/mongoc_database_has_collection.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_read_command_with_opts.html b/libmongoc/1.24.2/mongoc_database_read_command_with_opts.html index ce5bb10a74dd8d35f39a8cae22b7f5efdf943213..98d4f3edbb9f85d78fb7bd0adc8c1b285cfa754b 100644 --- a/libmongoc/1.24.2/mongoc_database_read_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_read_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_read_write_command_with_opts.html b/libmongoc/1.24.2/mongoc_database_read_write_command_with_opts.html index d8a0ac3619aead4c0d4278b97295c50fe45922f8..93e7c76e8fe24f0b76e12d4970cca9cbf5c7226f 100644 --- a/libmongoc/1.24.2/mongoc_database_read_write_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_read_write_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_remove_all_users.html b/libmongoc/1.24.2/mongoc_database_remove_all_users.html index 1d76d72ac31529dcafb97c853c291e990c8180c3..260931abfb55ed62fc6ba9da35cf56eef40218be 100644 --- a/libmongoc/1.24.2/mongoc_database_remove_all_users.html +++ b/libmongoc/1.24.2/mongoc_database_remove_all_users.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_remove_user.html b/libmongoc/1.24.2/mongoc_database_remove_user.html index bbf90a4daae2519d5dbf597d5e81ee66fd58b2b1..c49df9f27125d3a88199e7e15aeae63d3c65bca7 100644 --- a/libmongoc/1.24.2/mongoc_database_remove_user.html +++ b/libmongoc/1.24.2/mongoc_database_remove_user.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_set_read_concern.html b/libmongoc/1.24.2/mongoc_database_set_read_concern.html index d09b38f45f36df038e89f738b10f8acca5004dbd..13722c3c90d469eed8a79a8d26e2905317bfe7c4 100644 --- a/libmongoc/1.24.2/mongoc_database_set_read_concern.html +++ b/libmongoc/1.24.2/mongoc_database_set_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_set_read_prefs.html b/libmongoc/1.24.2/mongoc_database_set_read_prefs.html index c3f39bb99b1ff8172c60c605482c6b731e97a7f8..86c7f5eac079422dc2ab32b2a2e17f16ff1c4a5f 100644 --- a/libmongoc/1.24.2/mongoc_database_set_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_database_set_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_set_write_concern.html b/libmongoc/1.24.2/mongoc_database_set_write_concern.html index 5e1485619d22523f651cafe2d15fcbec5df16fa5..20189d0e4efd88da3da5be5bf59d4f6b75c1f2c8 100644 --- a/libmongoc/1.24.2/mongoc_database_set_write_concern.html +++ b/libmongoc/1.24.2/mongoc_database_set_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_t.html b/libmongoc/1.24.2/mongoc_database_t.html index 9193e6780fd2f21da282e29e990635685c21b8da..92e4fc0852ce442632fb886e309899d64a5d1dff 100644 --- a/libmongoc/1.24.2/mongoc_database_t.html +++ b/libmongoc/1.24.2/mongoc_database_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_watch.html b/libmongoc/1.24.2/mongoc_database_watch.html index 42f81bc64c9916b544105dbbb0df8bdbdb952f45..2fa0d81f0575a85684613fe1ab74709f23260625 100644 --- a/libmongoc/1.24.2/mongoc_database_watch.html +++ b/libmongoc/1.24.2/mongoc_database_watch.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_database_write_command_with_opts.html b/libmongoc/1.24.2/mongoc_database_write_command_with_opts.html index 100b7007f5443c1e229c7334a0eb5ab19dd48d12..3b7b93d2a5a15f487ba12b0898394a155ec52d7e 100644 --- a/libmongoc/1.24.2/mongoc_database_write_command_with_opts.html +++ b/libmongoc/1.24.2/mongoc_database_write_command_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_delete_flags_t.html b/libmongoc/1.24.2/mongoc_delete_flags_t.html index 6b1d615f6a90e9248acc36592d71a3dfcf538f5f..ace2a563289f0f5bcf330c0c2ab2996f4ddd9372 100644 --- a/libmongoc/1.24.2/mongoc_delete_flags_t.html +++ b/libmongoc/1.24.2/mongoc_delete_flags_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_error_has_label.html b/libmongoc/1.24.2/mongoc_error_has_label.html index 5929f67ecae3e015153dfb354f9b8eeb0dca62ab..38123255761892e84330120110e0e420b1da8497 100644 --- a/libmongoc/1.24.2/mongoc_error_has_label.html +++ b/libmongoc/1.24.2/mongoc_error_has_label.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_append.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_append.html index b4e1b5cfc4d3c2ab51e3531ed8c99f8d1065a2d7..7c912c3b767d8d567f7a8d93e6bd21e4185a587e 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_append.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_append.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_destroy.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_destroy.html index eb839293995e67ba51e71c25847b15a39b0354e9..ca9d017ba5f5da05effc331df78278a5925d6cba 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_bypass_document_validation.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_bypass_document_validation.html index b7361da0cdaf641d6b6412daa3fbdf0b46daa449..3a6eefac24270417b7a85037f1b8bfd805e62bfe 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_bypass_document_validation.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_bypass_document_validation.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_fields.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_fields.html index 6e0f4e2bbb308ef6f847bf40036f723c4a7488b5..d147bc9f082cdccc4f52092ac6dc069ea3cc8c07 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_fields.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_fields.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_flags.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_flags.html index cad1306332105ed6fcae4d064df52bc52051a37c..cc3e3f8b43db95c2fb88112be9978236983a8b75 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_flags.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_flags.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_max_time_ms.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_max_time_ms.html index 8de74a75bb82f6cbe47b21de4e0137e2cf4cb5b4..4dec3f4a702eca56a8594417911795f1fd3784c2 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_max_time_ms.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_max_time_ms.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_sort.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_sort.html index 49f14334d050d34d66808d578b9999906c337411..524bfcfa5eba7eba633bb244c8cc6f6b3aadf57c 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_sort.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_sort.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_update.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_update.html index 31666cd7a6c5c8145839c2778e463354bf09bf53..cb716f2eff9c435be96fcc913d03bbe901da336b 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_update.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_get_update.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_new.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_new.html index d626edf69c5bb4fcf741c3b3f77954eb4db190a2..62c83f13e0a2b77977f9206512ea0a4681757dcb 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_new.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_bypass_document_validation.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_bypass_document_validation.html index a6bd3d1392428fefd3710dd2c91db81659e06c61..ddc2a7e4c5f4670d1caf3b2f0c5baedd86cfb2c9 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_bypass_document_validation.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_bypass_document_validation.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_fields.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_fields.html index 857966af513af7f60e72f9841acc0c96f40c5034..adce1e5eb996a727fd1a830389e12403de9606c6 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_fields.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_fields.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_flags.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_flags.html index 3c6c414073be6d72cfa679ba42261883f11eb0ea..94ca0174798195b6b8c103183bbee9843da7f09d 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_flags.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_flags.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_max_time_ms.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_max_time_ms.html index 11adf0524fa67c90437a2a0701e70d231c3731e7..5e24ae23b86c4bca39a6803069fb6eb29e9e6f65 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_max_time_ms.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_max_time_ms.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_sort.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_sort.html index a9ab09d3ab7a50a54517c9b8ed0fca1c88ea8a93..eff57c109cb54ca71d675888d9739741e7a22167 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_sort.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_sort.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_update.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_update.html index 36948553e3b8d8ef0c428f8e6fb2129fcf66f3ed..08134da6168c63ab0a2da8fafa7ec94442e3a29d 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_update.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_set_update.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_find_and_modify_opts_t.html b/libmongoc/1.24.2/mongoc_find_and_modify_opts_t.html index 70e059e71ee4fa6e3a65b62017475063b51ebb9f..f7e6e615403dde87b7d8118ab7d4ecc5a2d39193 100644 --- a/libmongoc/1.24.2/mongoc_find_and_modify_opts_t.html +++ b/libmongoc/1.24.2/mongoc_find_and_modify_opts_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_get_major_version.html b/libmongoc/1.24.2/mongoc_get_major_version.html index b910a0a2ba38177be647beea3ade75ec5b897e51..c7e2c4950eeeba1db704b790fbf20e9b0dbcb1c9 100644 --- a/libmongoc/1.24.2/mongoc_get_major_version.html +++ b/libmongoc/1.24.2/mongoc_get_major_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_get_micro_version.html b/libmongoc/1.24.2/mongoc_get_micro_version.html index 2cbc34c10ce129e240e89e08437023cfc5b217ab..e4b6500720bceaf421c6bad30326d67569b18643 100644 --- a/libmongoc/1.24.2/mongoc_get_micro_version.html +++ b/libmongoc/1.24.2/mongoc_get_micro_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_get_minor_version.html b/libmongoc/1.24.2/mongoc_get_minor_version.html index 45847d57b8a7b54bb6f99355ea2a547f837d0c51..a6aa41f17b12e0df2bf56124d94b365c1ace1a6d 100644 --- a/libmongoc/1.24.2/mongoc_get_minor_version.html +++ b/libmongoc/1.24.2/mongoc_get_minor_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_get_version.html b/libmongoc/1.24.2/mongoc_get_version.html index 7a3d10a7b3a516367aa6b659ff983ba34c9c51ae..ef3e00f989c70b254fb8e239255b69fd98cdeb2c 100644 --- a/libmongoc/1.24.2/mongoc_get_version.html +++ b/libmongoc/1.24.2/mongoc_get_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_abort_upload.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_abort_upload.html index 273f420e46a2f02732d1e2332834a25553664d92..46f1955bf2e79134a928ebd72bc719a37785c93b 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_abort_upload.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_abort_upload.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_delete_by_id.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_delete_by_id.html index c1824bd5f94ac9669873d9b184cd501d3ab20b88..d122a29fa2bf2879ee0d831ad65d22f4b671242b 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_delete_by_id.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_delete_by_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_destroy.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_destroy.html index 6661ebd4aebae2ad46707d03be00a95332964665..3badd389787f62c6600e48f85474a2c98fbae91c 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_destroy.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_download_to_stream.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_download_to_stream.html index 99177e8e88e609a024c157fa7042e8cdf2d5ef08..f617faea04950601e79cb491abef7c5810020a39 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_download_to_stream.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_download_to_stream.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_find.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_find.html index a0754ec35b0035689af6c28a2379ab4bc1d7e05c..ddfad6c2e910ccf0d6fed8a024fc1fbb27196ec7 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_find.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_find.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_new.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_new.html index e789159c7fe02557e0aea3bfd9638e8d6d3e20b3..cd2e20364278fc3dbba225b6c0d3be9b7fc84991 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_new.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_open_download_stream.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_open_download_stream.html index 3bdd5c28be75edecc14ea1c675a43cc1ac0bee19..ec4cebe1b9dfe4fde52ee918dcbe28cb9d35d118 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_open_download_stream.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_open_download_stream.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream.html index 8fc57c33817d55db1922a391ba2573ca1bbc0349..0fbeb598f45b9114075fab5c8745b02c1a068e29 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream_with_id.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream_with_id.html index 9f634cbfd101096e83ea34991baca5a561f717d1..47f3d62ae811573d84ae061f49fff1572ae5700f 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream_with_id.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_open_upload_stream_with_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_stream_error.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_stream_error.html index 2db704b385aeed854ffc374619b14dfd3ecd34e9..79f019deb76bbe0dd5cee76e7ac4787a16df3a3a 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_stream_error.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_stream_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_t.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_t.html index 81014e9639d9d469e92bd1e035131b621dc8e273..56da0a047902cab8b3d6326a6a9cd661cea256a2 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_t.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream.html index b0104cf0b337fb421e01b63e421ed054d6c31aca..bb3e3ec0d31e410971b93dfc56ad22b659e86bd5 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream_with_id.html b/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream_with_id.html index eb8bba8b13ede370dc6f6eee9a8c5293778bc995..e8f660d8d2f91c37f97e4a66a7d955e8b75142e9 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream_with_id.html +++ b/libmongoc/1.24.2/mongoc_gridfs_bucket_upload_from_stream_with_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_create_file.html b/libmongoc/1.24.2/mongoc_gridfs_create_file.html index e17cb21d8963e874e03c61db67aeceb8b1e43b23..a6f8e2778ec3d58b76226c21443e5f808e6eb63b 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_create_file.html +++ b/libmongoc/1.24.2/mongoc_gridfs_create_file.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_create_file_from_stream.html b/libmongoc/1.24.2/mongoc_gridfs_create_file_from_stream.html index 67732a832380141da102a520b6acc4c280a814c7..db415049cf8b5cdd7b0fa586927b11575549957e 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_create_file_from_stream.html +++ b/libmongoc/1.24.2/mongoc_gridfs_create_file_from_stream.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_destroy.html b/libmongoc/1.24.2/mongoc_gridfs_destroy.html index f8fb86c5cc43d2947b2580309fada1ff295a19a6..aefc728d8a9669250ba78ee518d0bd75eb8b7096 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_destroy.html +++ b/libmongoc/1.24.2/mongoc_gridfs_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_drop.html b/libmongoc/1.24.2/mongoc_gridfs_drop.html index f1306047c114190b91178513594dacbff1a9e656..e86d9f28732bdb1fae1f77a68cc804bc3dc248c0 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_drop.html +++ b/libmongoc/1.24.2/mongoc_gridfs_drop.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_destroy.html b/libmongoc/1.24.2/mongoc_gridfs_file_destroy.html index 54b94bd107269122ad88695a191e555cf9b6b1fc..c41f5f7d33f9539a92573046024f7726b85a5513 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_destroy.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_error.html b/libmongoc/1.24.2/mongoc_gridfs_file_error.html index c79725ce7fdd8995d77538e75b6346918cb7eff6..c4ee5ca1db6e028af053f854643b129ef1cc305d 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_error.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_aliases.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_aliases.html index 923050d1ece65be1959c14f90d611b49fcc8131b..f919667fb901a86c2d01b324a223cad7ab7d4c67 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_aliases.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_aliases.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_chunk_size.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_chunk_size.html index 8e939bae824fbea10fb8061c866a5f6ac0aaf715..d5ceccedfc3a850f200873fedfe6c2c0dfd50fc0 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_chunk_size.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_chunk_size.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_content_type.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_content_type.html index 02b02999f4f8861961c75be8ffb16e9b68045e4b..ddbc8d691767b92bdac11b1773b9092ddcfaa80b 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_content_type.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_content_type.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_filename.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_filename.html index dfa02389501f76ad00b18fe5e9cf337851ce41b2..88121fbe3a59dae5e5855d0464b39b5c7ac687e5 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_filename.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_filename.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_id.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_id.html index f1aab690fb50bd1dadb7bb98c1c0cf1672b5d700..a812fe9714bc83de80072d1ecf4efc3b7fcaf566 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_id.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_length.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_length.html index c2c45aa157603f9c8c7533114ab0679ed05046f4..762ad5d5a6aedf0c03a3577a15e61c1588cd2c31 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_length.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_length.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_md5.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_md5.html index 877e9e27d86fedaf85654fcc3bec8d2aee6d0bd0..0668655caca0c3a44b641cf74a228696c53bee1f 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_md5.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_md5.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_metadata.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_metadata.html index fd54750567275534535b7549f4deee85d76db0a9..144e578133b81f17cedbb7976cc92dd84716617a 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_metadata.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_metadata.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_get_upload_date.html b/libmongoc/1.24.2/mongoc_gridfs_file_get_upload_date.html index f1a105172bf61d16b482c23a0b21372673cad501..df9a29b0a08dbb02bd3eeaa5660d572966d3c441 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_get_upload_date.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_get_upload_date.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_list_destroy.html b/libmongoc/1.24.2/mongoc_gridfs_file_list_destroy.html index 5c9124784b3c0706e7434e91ccf95d34c8915f51..2b40d5ef13c6e1f3d938af277ba4cd313eddfc9d 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_list_destroy.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_list_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_list_error.html b/libmongoc/1.24.2/mongoc_gridfs_file_list_error.html index 6f56478921ac5ff4b69ffb599cef03dca5920671..82bd3eac07be7352a68b493e624dd9c16652b487 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_list_error.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_list_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_list_next.html b/libmongoc/1.24.2/mongoc_gridfs_file_list_next.html index 14987b9b872cdfe9c439658e53ffafe85c1e95aa..7368a81d196d344fd01cc92603f67bfc4cd269b8 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_list_next.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_list_next.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_list_t.html b/libmongoc/1.24.2/mongoc_gridfs_file_list_t.html index 858bbe79874d8ea0a6d170574bb12c567a975d75..31144a5d71bdc643a7b83c26ff8303c6fec3a957 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_list_t.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_list_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_opt_t.html b/libmongoc/1.24.2/mongoc_gridfs_file_opt_t.html index 39740a8f9319384af7d3ce13c83d9686123567f0..052a4759af4efe5009fee3b968c8b620dd78d096 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_opt_t.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_opt_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_readv.html b/libmongoc/1.24.2/mongoc_gridfs_file_readv.html index 577b351eacca22bd9e9ec6230da74b20cc9f90ba..2e28359efc1f80af037254198edfd2bfc370511a 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_readv.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_readv.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_remove.html b/libmongoc/1.24.2/mongoc_gridfs_file_remove.html index 50863b5fedfc554ca9252a2ba6c221cb5a153a8a..47503943fa2b95a32dfb03024acc9e49a6bbe710 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_remove.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_remove.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_save.html b/libmongoc/1.24.2/mongoc_gridfs_file_save.html index 0c04898de1866f1ba90610d7f04f14b25ed8fe37..1c30425bb6ea62e160790259cebda2e1d87a7dd1 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_save.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_save.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_seek.html b/libmongoc/1.24.2/mongoc_gridfs_file_seek.html index 64c703e5f5fa37f31d6db7eca14052453da48f42..20e78c78ef5b393381bfc67e818ef170f6e3791c 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_seek.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_seek.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_set_aliases.html b/libmongoc/1.24.2/mongoc_gridfs_file_set_aliases.html index 1f5354279b26c1cb1bd951520307a860905ffb45..cd58afcccd8d588b863acc6f80dbd4da62f3a54d 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_set_aliases.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_set_aliases.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_set_content_type.html b/libmongoc/1.24.2/mongoc_gridfs_file_set_content_type.html index 9e7dd80b6400891807e685a3e523b8bb9e450205..7d1402ea08692ac7ada4e9bed2c9d5aebfba567f 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_set_content_type.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_set_content_type.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_set_filename.html b/libmongoc/1.24.2/mongoc_gridfs_file_set_filename.html index 94b6a1983915e99d9d521369eff4c1d6f5d402c6..a25f2cc574322da793419b675e09d1c1622ba5a3 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_set_filename.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_set_filename.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_set_id.html b/libmongoc/1.24.2/mongoc_gridfs_file_set_id.html index 8ad84fd0122408cd9a989a0031ae624c99d02671..6065b77b307be01ea442cdbc1094b6be0fe08487 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_set_id.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_set_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_set_md5.html b/libmongoc/1.24.2/mongoc_gridfs_file_set_md5.html index d5a87fbb74544c2b0ea79888df435186674d23fb..83d6a1c4201a62d0180854356d588fd2f674c9f8 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_set_md5.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_set_md5.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_set_metadata.html b/libmongoc/1.24.2/mongoc_gridfs_file_set_metadata.html index c2a719b90a76a21ff6c61793e2834d86873f553f..b51421b56f43259e5522f17ee19f4a69f5b630cb 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_set_metadata.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_set_metadata.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_t.html b/libmongoc/1.24.2/mongoc_gridfs_file_t.html index 13196d31cdea6eaff273029c0354ab66ee2ae893..deb8cb5b07233ee018507b93d5443bf06b8fb2ad 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_t.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_tell.html b/libmongoc/1.24.2/mongoc_gridfs_file_tell.html index 0e32e2e0e96a259e62832a5b2f3f4795c06b9072..c26e09dedfba81e2597ea6eb166781fec299e30b 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_tell.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_tell.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_file_writev.html b/libmongoc/1.24.2/mongoc_gridfs_file_writev.html index 44f3e9fdbfeadc9fe37135ce4577cb9041a5662d..4fe7b5543375a87c285eb16117b0bd8ba6232624 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_file_writev.html +++ b/libmongoc/1.24.2/mongoc_gridfs_file_writev.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_find.html b/libmongoc/1.24.2/mongoc_gridfs_find.html index 9a7d24fcd5e1af3d1824acb59ef043a646ca43c0..dd6cf4e289aaf2fbf70c7e01fa8f9f0b5b6746ea 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_find.html +++ b/libmongoc/1.24.2/mongoc_gridfs_find.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_find_one.html b/libmongoc/1.24.2/mongoc_gridfs_find_one.html index dc78653572f8abc4b3fecbbc915b62e52dbbf9d6..59756618918d7df96424548b6a7c82a889b39572 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_find_one.html +++ b/libmongoc/1.24.2/mongoc_gridfs_find_one.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_find_one_by_filename.html b/libmongoc/1.24.2/mongoc_gridfs_find_one_by_filename.html index 290b071e52b95ead8a5dbd6afd0225d836b8c3e1..55df0be2e18486f50626f45fda3ec8f3b10832fa 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_find_one_by_filename.html +++ b/libmongoc/1.24.2/mongoc_gridfs_find_one_by_filename.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_find_one_with_opts.html b/libmongoc/1.24.2/mongoc_gridfs_find_one_with_opts.html index 55217794d767720002ba8d98299ba97919b2fdde..cc8cfdb5b957a743e7456f815102bbd85a2ccac3 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_find_one_with_opts.html +++ b/libmongoc/1.24.2/mongoc_gridfs_find_one_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_find_with_opts.html b/libmongoc/1.24.2/mongoc_gridfs_find_with_opts.html index a4c5fec17cc49692065c7718136f7c0959e9f8e7..d6f23a78c835d4aff12162e2c9a6ef72f3b459a0 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_find_with_opts.html +++ b/libmongoc/1.24.2/mongoc_gridfs_find_with_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_get_chunks.html b/libmongoc/1.24.2/mongoc_gridfs_get_chunks.html index bd25f92f61d5c137a9a9154162b16cc13e375dda..b04c023cf9698cbfd03cfdcb5e5984d60759005d 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_get_chunks.html +++ b/libmongoc/1.24.2/mongoc_gridfs_get_chunks.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_get_files.html b/libmongoc/1.24.2/mongoc_gridfs_get_files.html index 3efa624724f001bd42b38fb3521ab012202853e4..2eaa911792a84ba268184e349241ba743b7076d8 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_get_files.html +++ b/libmongoc/1.24.2/mongoc_gridfs_get_files.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_remove_by_filename.html b/libmongoc/1.24.2/mongoc_gridfs_remove_by_filename.html index c176e7668af54d1a22ec2696989c6c6a69f59c7c..d3dac033f371c90233c97f39863705ce8651b51b 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_remove_by_filename.html +++ b/libmongoc/1.24.2/mongoc_gridfs_remove_by_filename.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_gridfs_t.html b/libmongoc/1.24.2/mongoc_gridfs_t.html index a093e65cabd8bed21301d8a598aab73fcde3d6c6..c3a70f83a9c590e92305a1261adbcc9a4212ae07 100644 --- a/libmongoc/1.24.2/mongoc_gridfs_t.html +++ b/libmongoc/1.24.2/mongoc_gridfs_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_handshake_data_append.html b/libmongoc/1.24.2/mongoc_handshake_data_append.html index 0a485d11e29cd40eecb20e1f076f408eead248ca..edabb1f5d9409778f7bfcd69817541de3aa2a24f 100644 --- a/libmongoc/1.24.2/mongoc_handshake_data_append.html +++ b/libmongoc/1.24.2/mongoc_handshake_data_append.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_host_list_t.html b/libmongoc/1.24.2/mongoc_host_list_t.html index 99e49d4292132462e1906b30bb3dfc87359338b7..e478aeb1e3d34a719186b9ef2d9a6c243f847935 100644 --- a/libmongoc/1.24.2/mongoc_host_list_t.html +++ b/libmongoc/1.24.2/mongoc_host_list_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_geo_get_default.html b/libmongoc/1.24.2/mongoc_index_opt_geo_get_default.html index 25cad590a6fe983f8846a6078d396c982d16bd53..47a8162f197fe2bf209809e73069d8bee44dc9e5 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_geo_get_default.html +++ b/libmongoc/1.24.2/mongoc_index_opt_geo_get_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_geo_init.html b/libmongoc/1.24.2/mongoc_index_opt_geo_init.html index 4fd8e79268138921ba1a24b2fd164c35751b0513..1777cabf04ceb17cc1a71a484c7bffed0ec4037b 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_geo_init.html +++ b/libmongoc/1.24.2/mongoc_index_opt_geo_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_geo_t.html b/libmongoc/1.24.2/mongoc_index_opt_geo_t.html index 07c7e75111cd6416aef90252f642e23cf14afdd3..5f400bbcb0658bcdd6acfab2dc7723626bfccf03 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_geo_t.html +++ b/libmongoc/1.24.2/mongoc_index_opt_geo_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_get_default.html b/libmongoc/1.24.2/mongoc_index_opt_get_default.html index 53e5f1d6246e979983e97bda606479ee1adb5269..972a8f3f808b1c8e88d8c17ebd28870427cd0706 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_get_default.html +++ b/libmongoc/1.24.2/mongoc_index_opt_get_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_init.html b/libmongoc/1.24.2/mongoc_index_opt_init.html index 4b8f351107633b663b302bf87e2eb36e00675666..2a6dddcc36bed1bfde9776fecf5c9e211b932e44 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_init.html +++ b/libmongoc/1.24.2/mongoc_index_opt_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_t.html b/libmongoc/1.24.2/mongoc_index_opt_t.html index 524ba37ab5b30e97d51a70798d72a7059739729c..1be2b8350e99fe882b7a8ea0c396d61722cf3d61 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_t.html +++ b/libmongoc/1.24.2/mongoc_index_opt_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_wt_get_default.html b/libmongoc/1.24.2/mongoc_index_opt_wt_get_default.html index 9e301a27f0b07b119dacc8595b0d6c9f3f13e048..f02bfbcc7372301b4a510e462246b36f394962af 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_wt_get_default.html +++ b/libmongoc/1.24.2/mongoc_index_opt_wt_get_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_wt_init.html b/libmongoc/1.24.2/mongoc_index_opt_wt_init.html index acb7a94f8bf760bf8feb08f3c5e87b9c9e9008ce..3764d687c97d804b9c2c2ec7146d98a70a940fdb 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_wt_init.html +++ b/libmongoc/1.24.2/mongoc_index_opt_wt_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_index_opt_wt_t.html b/libmongoc/1.24.2/mongoc_index_opt_wt_t.html index b4b389fb7951c9abde0b690a2186638d47a33236..fec3fbef330bb711afa98daf2f2a0e32309774b5 100644 --- a/libmongoc/1.24.2/mongoc_index_opt_wt_t.html +++ b/libmongoc/1.24.2/mongoc_index_opt_wt_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_init.html b/libmongoc/1.24.2/mongoc_init.html index 5f20c57b5925a7f2cd597ef1deb96759bb2880e9..1f0fa19bd5ffdb60d944fb79587e4aa42a063e8d 100644 --- a/libmongoc/1.24.2/mongoc_init.html +++ b/libmongoc/1.24.2/mongoc_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_insert_flags_t.html b/libmongoc/1.24.2/mongoc_insert_flags_t.html index cd626cd1a827ece0335bd9c220b347ae2fd5b5da..ab041984c701940bb881eb08b465e05d152cd92b 100644 --- a/libmongoc/1.24.2/mongoc_insert_flags_t.html +++ b/libmongoc/1.24.2/mongoc_insert_flags_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_iovec_t.html b/libmongoc/1.24.2/mongoc_iovec_t.html index 3cb9df604f044ade9a41b1d412fa671017cbd7ed..897821111b715565ffff4fa89a60139bc623aa06 100644 --- a/libmongoc/1.24.2/mongoc_iovec_t.html +++ b/libmongoc/1.24.2/mongoc_iovec_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_optional_copy.html b/libmongoc/1.24.2/mongoc_optional_copy.html index a0fbda4526c9be0a572f12a8d709995fb8b6bcc0..b67303e58dcf970ce587c8ade6cdaebd13439661 100644 --- a/libmongoc/1.24.2/mongoc_optional_copy.html +++ b/libmongoc/1.24.2/mongoc_optional_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_optional_init.html b/libmongoc/1.24.2/mongoc_optional_init.html index c6b67e4cccb5b36313914f838117e7202e7824e8..0ea95f491ebb7396aa7f5f12441c6d78425cf042 100644 --- a/libmongoc/1.24.2/mongoc_optional_init.html +++ b/libmongoc/1.24.2/mongoc_optional_init.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_optional_is_set.html b/libmongoc/1.24.2/mongoc_optional_is_set.html index da4e9b447eda51188aa94a86c58062eb73a288ee..b8ef6960cb84c7be941b15ab2fdef80df2dedff0 100644 --- a/libmongoc/1.24.2/mongoc_optional_is_set.html +++ b/libmongoc/1.24.2/mongoc_optional_is_set.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_optional_set_value.html b/libmongoc/1.24.2/mongoc_optional_set_value.html index d5dec42c8dbe35b6cae2034efca7a61431547c33..923afa0713ac8a260852149a692a7e5f81a35faf 100644 --- a/libmongoc/1.24.2/mongoc_optional_set_value.html +++ b/libmongoc/1.24.2/mongoc_optional_set_value.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_optional_t.html b/libmongoc/1.24.2/mongoc_optional_t.html index 3e05efa0fc9c453a941495a93d6c51b69e00ac42..8c1b449f3e7f717a6f16fc1732038cc00781e4a3 100644 --- a/libmongoc/1.24.2/mongoc_optional_t.html +++ b/libmongoc/1.24.2/mongoc_optional_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_optional_value.html b/libmongoc/1.24.2/mongoc_optional_value.html index b62d5a4f952a152efe3d8cef72664a6f1aae2679..2d408c673a75169f2043eebb9fabb2acd3746c32 100644 --- a/libmongoc/1.24.2/mongoc_optional_value.html +++ b/libmongoc/1.24.2/mongoc_optional_value.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_query_flags_t.html b/libmongoc/1.24.2/mongoc_query_flags_t.html index a99000190db00e60040746a3f9ba00730e5bd6aa..ce2327df9af62cf801c5fc895bc51f0c041f8129 100644 --- a/libmongoc/1.24.2/mongoc_query_flags_t.html +++ b/libmongoc/1.24.2/mongoc_query_flags_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_rand.html b/libmongoc/1.24.2/mongoc_rand.html index 98b44f1278b09458f23b6ea0d8ed65d6d75afa17..25553d6942dd26c1ee6c377c4d9d85d11901565d 100644 --- a/libmongoc/1.24.2/mongoc_rand.html +++ b/libmongoc/1.24.2/mongoc_rand.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_rand_add.html b/libmongoc/1.24.2/mongoc_rand_add.html index 4d33966896b88a425263cb922c5fd7b48b1f94e7..0f8844bf3726723b188131273744bb7c96b45184 100644 --- a/libmongoc/1.24.2/mongoc_rand_add.html +++ b/libmongoc/1.24.2/mongoc_rand_add.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_rand_seed.html b/libmongoc/1.24.2/mongoc_rand_seed.html index cd767a583a21f73c131ad0a7b056e5156dd65f18..59d5abf4231c2697ff01ce0090068ccd16cc4914 100644 --- a/libmongoc/1.24.2/mongoc_rand_seed.html +++ b/libmongoc/1.24.2/mongoc_rand_seed.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_rand_status.html b/libmongoc/1.24.2/mongoc_rand_status.html index 34adb281aaed39d0202305f41e394708e1c71f94..348c33aec7cea83854819b4f09187d53ab092a91 100644 --- a/libmongoc/1.24.2/mongoc_rand_status.html +++ b/libmongoc/1.24.2/mongoc_rand_status.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_append.html b/libmongoc/1.24.2/mongoc_read_concern_append.html index c1389bda8505fe6c6aa0b6461717336bdbe71b22..a8b5e5a10a31849514a9328ad22ec6208e1fe08d 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_append.html +++ b/libmongoc/1.24.2/mongoc_read_concern_append.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_copy.html b/libmongoc/1.24.2/mongoc_read_concern_copy.html index ef455e9de2d1d0723319b058a52f9f0796da78a4..766a225d18179e76bc94483d32eb0fb4e5366f3f 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_copy.html +++ b/libmongoc/1.24.2/mongoc_read_concern_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_destroy.html b/libmongoc/1.24.2/mongoc_read_concern_destroy.html index 0f59bf9ab801447b2739a2cbaa2bab05ac9af3c5..d42a82454a341d8d9736aa189888f7e42c72c043 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_destroy.html +++ b/libmongoc/1.24.2/mongoc_read_concern_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_get_level.html b/libmongoc/1.24.2/mongoc_read_concern_get_level.html index 356d4c1042c74ee88a5139ec035136ed042a19f1..502451695ca9ca0ec198041c4717b6300d79913d 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_get_level.html +++ b/libmongoc/1.24.2/mongoc_read_concern_get_level.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_is_default.html b/libmongoc/1.24.2/mongoc_read_concern_is_default.html index ae17ff2b5c99b36e704b259b3a7257a3539f19e5..b315bf09ab3aa463fcb4dfa36f60958d38900a37 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_is_default.html +++ b/libmongoc/1.24.2/mongoc_read_concern_is_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_new.html b/libmongoc/1.24.2/mongoc_read_concern_new.html index 582094a470d5d0d6451585798f0f6535a53ced78..b714c63627275b2b7577430318e4002e03f0cea2 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_new.html +++ b/libmongoc/1.24.2/mongoc_read_concern_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_set_level.html b/libmongoc/1.24.2/mongoc_read_concern_set_level.html index b4572fe7604618d97b29195c21e6808dd5c8e7ae..948df10dbd3a1b39f02a5cf050c463fe71fb1b69 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_set_level.html +++ b/libmongoc/1.24.2/mongoc_read_concern_set_level.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_concern_t.html b/libmongoc/1.24.2/mongoc_read_concern_t.html index 61bea51727d192a02d8fb5e764710c0138660dbb..d6f26d70e6f5eedbe92b1a62ea918246d4cfdcf7 100644 --- a/libmongoc/1.24.2/mongoc_read_concern_t.html +++ b/libmongoc/1.24.2/mongoc_read_concern_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_mode_t.html b/libmongoc/1.24.2/mongoc_read_mode_t.html index 8f2c4bd0e24581d689f6dcc522add2840adfd9fb..3929f5d582244eab282578d3122f94bf4d6c6e72 100644 --- a/libmongoc/1.24.2/mongoc_read_mode_t.html +++ b/libmongoc/1.24.2/mongoc_read_mode_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_add_tag.html b/libmongoc/1.24.2/mongoc_read_prefs_add_tag.html index 755628f6cf01d623fb68fba25eceaa6908617a19..1cd65446d3721334f124e4f2a08fc2e6261a671f 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_add_tag.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_add_tag.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_copy.html b/libmongoc/1.24.2/mongoc_read_prefs_copy.html index a63683c6b2decad19a9ff5748930ad931c5e1c67..968bacdc08ffb257cb3500535832d13e37075364 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_copy.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_destroy.html b/libmongoc/1.24.2/mongoc_read_prefs_destroy.html index 8cd277f46fff8ae0a3501d67124b316174b00b63..2240da0a0653db7b4636046662a017ec297b0f20 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_destroy.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_get_hedge.html b/libmongoc/1.24.2/mongoc_read_prefs_get_hedge.html index 9b590b8865ea50cd6d1202646a56f11f7380bdfc..05656799c401086fd5174a5ca5c6fb68eea4f4cd 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_get_hedge.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_get_hedge.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_get_max_staleness_seconds.html b/libmongoc/1.24.2/mongoc_read_prefs_get_max_staleness_seconds.html index f4765b4c877be1639905bbedf74b518d79cade1e..dce3061a1c2ccef38166e0f85459926a902e5041 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_get_max_staleness_seconds.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_get_max_staleness_seconds.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_get_mode.html b/libmongoc/1.24.2/mongoc_read_prefs_get_mode.html index 8cba5e45eab9f4a31a2c1a2f92f99ca660bac69c..41c9be0f601627e91df965f19228e07cbc84f62c 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_get_mode.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_get_mode.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_get_tags.html b/libmongoc/1.24.2/mongoc_read_prefs_get_tags.html index 8a964192c9d0fd6490880659a869ee6fa7d9ed44..ac81c8d9678633b210f7aba6f470b41cd426dd4b 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_get_tags.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_get_tags.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_is_valid.html b/libmongoc/1.24.2/mongoc_read_prefs_is_valid.html index a087ef45992996e01e40b5daec7563d7accc78fe..1d625820d3d88c76da8216e64d21cfcc7576373b 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_is_valid.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_is_valid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_new.html b/libmongoc/1.24.2/mongoc_read_prefs_new.html index 67cec66915a9abf7b9fddc06be0b8c932b2c2264..9c1028729e79a86779df297f49494ae0a53fecbc 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_new.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_set_hedge.html b/libmongoc/1.24.2/mongoc_read_prefs_set_hedge.html index 7f32d838e7627a674e047c953c6e2ab0a88a88a4..36be9f872acaee5507cf8f0183412863ad1562ba 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_set_hedge.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_set_hedge.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_set_max_staleness_seconds.html b/libmongoc/1.24.2/mongoc_read_prefs_set_max_staleness_seconds.html index edb2376791892a4851caacf59c29f9703a8bfb73..95e25066ec18e6d1520c9f5c50ceb9f4b1796350 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_set_max_staleness_seconds.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_set_max_staleness_seconds.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_set_mode.html b/libmongoc/1.24.2/mongoc_read_prefs_set_mode.html index 2efd9eb47ce786941c27fa76c853c4cd5c58cbc3..5478a4483af33aedc45bf505b8bf94935c8a6d42 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_set_mode.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_set_mode.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_set_tags.html b/libmongoc/1.24.2/mongoc_read_prefs_set_tags.html index 21dbd37d5277db167cf015c0ac55688dd260e8e9..333b5293f69ac93b720730414ae8276ccab63e2a 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_set_tags.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_set_tags.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_read_prefs_t.html b/libmongoc/1.24.2/mongoc_read_prefs_t.html index 975722376b912c493330eb2cda5abdfe905cd925..a1b41253e36fdfd853a78e1114ff3fda0d8a83a0 100644 --- a/libmongoc/1.24.2/mongoc_read_prefs_t.html +++ b/libmongoc/1.24.2/mongoc_read_prefs_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_remove_flags_t.html b/libmongoc/1.24.2/mongoc_remove_flags_t.html index 0ccc30ed7d3e4790aa91a150fa832d16ce31fe04..7f0adbde7223698b52727c96a2f314f235593b80 100644 --- a/libmongoc/1.24.2/mongoc_remove_flags_t.html +++ b/libmongoc/1.24.2/mongoc_remove_flags_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_reply_flags_t.html b/libmongoc/1.24.2/mongoc_reply_flags_t.html index 5ef3ba43508dae7b2d2b1d4fdd556d0ed65239a5..54b6a6380818ae5b8ace0bad84cf9b44560b31ae 100644 --- a/libmongoc/1.24.2/mongoc_reply_flags_t.html +++ b/libmongoc/1.24.2/mongoc_reply_flags_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_copy.html b/libmongoc/1.24.2/mongoc_server_api_copy.html index cbeb31efb88f10273d6ee837a67f65984017a77f..cce8fb2b2a94f954f8d638d455e77724443b83f2 100644 --- a/libmongoc/1.24.2/mongoc_server_api_copy.html +++ b/libmongoc/1.24.2/mongoc_server_api_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_deprecation_errors.html b/libmongoc/1.24.2/mongoc_server_api_deprecation_errors.html index 5a219a28475aa128c802c2c8ee23679274468eac..61fbe743fdf9a14177041e96f76397d1019a41e8 100644 --- a/libmongoc/1.24.2/mongoc_server_api_deprecation_errors.html +++ b/libmongoc/1.24.2/mongoc_server_api_deprecation_errors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_destroy.html b/libmongoc/1.24.2/mongoc_server_api_destroy.html index 9dac2618e98ebf5d48f544c8c28609e2fe7afc9c..927777907277da8be59a14782240510b612f8ff0 100644 --- a/libmongoc/1.24.2/mongoc_server_api_destroy.html +++ b/libmongoc/1.24.2/mongoc_server_api_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_get_deprecation_errors.html b/libmongoc/1.24.2/mongoc_server_api_get_deprecation_errors.html index 96488dd377503f831b4f76b12bd6186127133ea0..6e5a60d5003bf1d1097650227b4f64aeddf354cd 100644 --- a/libmongoc/1.24.2/mongoc_server_api_get_deprecation_errors.html +++ b/libmongoc/1.24.2/mongoc_server_api_get_deprecation_errors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_get_strict.html b/libmongoc/1.24.2/mongoc_server_api_get_strict.html index e0a646701a9540dc5ffadc34e1ea844361cd136d..ba49466aa71c31223b553cf27c73faef5a1b1fc5 100644 --- a/libmongoc/1.24.2/mongoc_server_api_get_strict.html +++ b/libmongoc/1.24.2/mongoc_server_api_get_strict.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_get_version.html b/libmongoc/1.24.2/mongoc_server_api_get_version.html index a63d7f6e068fb18675cfa57d22676b86dac9fdad..4c5f878020d363bd7faf02fd1e32761d8f14ff83 100644 --- a/libmongoc/1.24.2/mongoc_server_api_get_version.html +++ b/libmongoc/1.24.2/mongoc_server_api_get_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_new.html b/libmongoc/1.24.2/mongoc_server_api_new.html index ec07ec69be014c1b407d5caef8c6ed139c693454..c772d6af7a40005fa536425cf046fa575db42f9a 100644 --- a/libmongoc/1.24.2/mongoc_server_api_new.html +++ b/libmongoc/1.24.2/mongoc_server_api_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_strict.html b/libmongoc/1.24.2/mongoc_server_api_strict.html index f6c0ae52683278bb4ecd0fc9ebab07725b783a61..38bb8538f4f2715ab54d9547de8581a69aabf7af 100644 --- a/libmongoc/1.24.2/mongoc_server_api_strict.html +++ b/libmongoc/1.24.2/mongoc_server_api_strict.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_t.html b/libmongoc/1.24.2/mongoc_server_api_t.html index 1f42803a25af055843280d5ffcb1f9055ad6be7d..015e4e08b976bde10edc6065c73d3139ffdb9754 100644 --- a/libmongoc/1.24.2/mongoc_server_api_t.html +++ b/libmongoc/1.24.2/mongoc_server_api_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_version_from_string.html b/libmongoc/1.24.2/mongoc_server_api_version_from_string.html index 760cf58f33ce488b2f24e071d31a5a367d25df7e..08f23490bbac0f0e737fb38b5ab0b29b3f96e1b8 100644 --- a/libmongoc/1.24.2/mongoc_server_api_version_from_string.html +++ b/libmongoc/1.24.2/mongoc_server_api_version_from_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_version_t.html b/libmongoc/1.24.2/mongoc_server_api_version_t.html index 4631c6cff6f5f626ceab242daa770fabb0b5e68a..e69682691ab9a7f9fdda5e96e1f151cd8751c4df 100644 --- a/libmongoc/1.24.2/mongoc_server_api_version_t.html +++ b/libmongoc/1.24.2/mongoc_server_api_version_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_api_version_to_string.html b/libmongoc/1.24.2/mongoc_server_api_version_to_string.html index 3be11ffca854bcff2d17259c02aa8008b7867cfb..38130388c2296afd53a23cc6212605fab19bf920 100644 --- a/libmongoc/1.24.2/mongoc_server_api_version_to_string.html +++ b/libmongoc/1.24.2/mongoc_server_api_version_to_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_destroy.html b/libmongoc/1.24.2/mongoc_server_description_destroy.html index 1f6eb1f8f731ce10d9a87a3fee316408a4d7381c..0bb82078273f7f27207dd532e7afecf4328706c9 100644 --- a/libmongoc/1.24.2/mongoc_server_description_destroy.html +++ b/libmongoc/1.24.2/mongoc_server_description_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_hello_response.html b/libmongoc/1.24.2/mongoc_server_description_hello_response.html index f623b5bd0ec1ff41b9176b3621efc77c27893786..800838b35d02eae183405f1cff0914f091851f30 100644 --- a/libmongoc/1.24.2/mongoc_server_description_hello_response.html +++ b/libmongoc/1.24.2/mongoc_server_description_hello_response.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_host.html b/libmongoc/1.24.2/mongoc_server_description_host.html index b26e06c1c31ec657b51d62389421cc3d83124de5..b0a1c56171ffc1c15f1e5264bbc203e59053bc54 100644 --- a/libmongoc/1.24.2/mongoc_server_description_host.html +++ b/libmongoc/1.24.2/mongoc_server_description_host.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_id.html b/libmongoc/1.24.2/mongoc_server_description_id.html index 6a2f5a5fc69dc429ecfe78b4a0c4a26b72e39d22..92defc6458f74ddcaa7990f261f76b825f3fedf2 100644 --- a/libmongoc/1.24.2/mongoc_server_description_id.html +++ b/libmongoc/1.24.2/mongoc_server_description_id.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_ismaster.html b/libmongoc/1.24.2/mongoc_server_description_ismaster.html index bc3ec8033c088b7ce36a2a8c8e0341b367edfe02..32adf005e1c4193d001d5abd57e2e0795a6c10bf 100644 --- a/libmongoc/1.24.2/mongoc_server_description_ismaster.html +++ b/libmongoc/1.24.2/mongoc_server_description_ismaster.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_last_update_time.html b/libmongoc/1.24.2/mongoc_server_description_last_update_time.html index c78dd62c3ca7de8a9f36944f22ce742bc9933825..6fdc3453ca1e81c8d97fc4c8a87070adabf33779 100644 --- a/libmongoc/1.24.2/mongoc_server_description_last_update_time.html +++ b/libmongoc/1.24.2/mongoc_server_description_last_update_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_new_copy.html b/libmongoc/1.24.2/mongoc_server_description_new_copy.html index f093d9e53a54fb8792c58006084f0bf6597a0105..30a0c9dc98e3d70a2dbe14e5726f6913f06e46e7 100644 --- a/libmongoc/1.24.2/mongoc_server_description_new_copy.html +++ b/libmongoc/1.24.2/mongoc_server_description_new_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_round_trip_time.html b/libmongoc/1.24.2/mongoc_server_description_round_trip_time.html index 7a03cc8c7f10874e50dd5c13a3cf2f2e81673ac7..720b552b687fcbeb5f8fad256bf42f0adc8110f6 100644 --- a/libmongoc/1.24.2/mongoc_server_description_round_trip_time.html +++ b/libmongoc/1.24.2/mongoc_server_description_round_trip_time.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_t.html b/libmongoc/1.24.2/mongoc_server_description_t.html index 6e408cc723f229e00739e179000cf51b66816a20..7a87ca9d4194c0a615d3cce676f7038457c9c3dc 100644 --- a/libmongoc/1.24.2/mongoc_server_description_t.html +++ b/libmongoc/1.24.2/mongoc_server_description_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_description_type.html b/libmongoc/1.24.2/mongoc_server_description_type.html index 737bb9093bfe9d4449beae720898432fcb51a960..4847329e67c0faad5f688b6f876c562bb11ca4bf 100644 --- a/libmongoc/1.24.2/mongoc_server_description_type.html +++ b/libmongoc/1.24.2/mongoc_server_description_type.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_server_descriptions_destroy_all.html b/libmongoc/1.24.2/mongoc_server_descriptions_destroy_all.html index af41c668ed79379ed4edc4925a25f30ee790d672..0a22f04af2eae15cf22437133446d290ffb7da79 100644 --- a/libmongoc/1.24.2/mongoc_server_descriptions_destroy_all.html +++ b/libmongoc/1.24.2/mongoc_server_descriptions_destroy_all.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opt_t.html b/libmongoc/1.24.2/mongoc_session_opt_t.html index 6f1d52791253bc04badedd435639663aeb9ecc27..543c5c13909d2b6eb7f0dcb3253c83f274a1722c 100644 --- a/libmongoc/1.24.2/mongoc_session_opt_t.html +++ b/libmongoc/1.24.2/mongoc_session_opt_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_clone.html b/libmongoc/1.24.2/mongoc_session_opts_clone.html index eaa1881cc8472bcd4176b51ae2db96b6e3f6619b..378dfb35105721c53937834ab9bc0da60d909aaf 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_clone.html +++ b/libmongoc/1.24.2/mongoc_session_opts_clone.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_destroy.html b/libmongoc/1.24.2/mongoc_session_opts_destroy.html index ba38ee7091eb2fe6de0a84476725f1d71be5a63b..c2c68e31c7f2d6a37552e72d404bce5269dff0e7 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_session_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_get_causal_consistency.html b/libmongoc/1.24.2/mongoc_session_opts_get_causal_consistency.html index e2db91123ab622fb6c32407d955306c0366d7db6..0de75a08b4956ffce376242c73a6387b23aaf7ad 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_get_causal_consistency.html +++ b/libmongoc/1.24.2/mongoc_session_opts_get_causal_consistency.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_get_default_transaction_opts.html b/libmongoc/1.24.2/mongoc_session_opts_get_default_transaction_opts.html index 88486f20343028eb14ed39899480ba518bd91036..4a17c73d44123eef6401a58a361c852b7f50fe62 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_get_default_transaction_opts.html +++ b/libmongoc/1.24.2/mongoc_session_opts_get_default_transaction_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_get_snapshot.html b/libmongoc/1.24.2/mongoc_session_opts_get_snapshot.html index 3ad83d3ce94a7024acbb868479c7410342742dde..ec0b4ecab5310ef2611531f787ccf9bf87c464ed 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_get_snapshot.html +++ b/libmongoc/1.24.2/mongoc_session_opts_get_snapshot.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_get_transaction_opts.html b/libmongoc/1.24.2/mongoc_session_opts_get_transaction_opts.html index af0522eedc073c44c6c202ffb641681c84682b4c..633e1e13f8677bcb22ecc5c942d6048d4860713b 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_get_transaction_opts.html +++ b/libmongoc/1.24.2/mongoc_session_opts_get_transaction_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_new.html b/libmongoc/1.24.2/mongoc_session_opts_new.html index d08fc1366f7bb59f780155efb3631fc930ab9ee6..f84c080e9db430163546e93cd2cbd3a04f089e11 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_new.html +++ b/libmongoc/1.24.2/mongoc_session_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_set_causal_consistency.html b/libmongoc/1.24.2/mongoc_session_opts_set_causal_consistency.html index 58055f09b7bb38fb0b1aa682582cad9df5199e44..463b29257a83b691ac7db1edf7301d978208e558 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_set_causal_consistency.html +++ b/libmongoc/1.24.2/mongoc_session_opts_set_causal_consistency.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_set_default_transaction_opts.html b/libmongoc/1.24.2/mongoc_session_opts_set_default_transaction_opts.html index 5412ac66d354cb54879f6f8c9a35c9cfbddde02f..e09dd7b8d98cef9360c0894e7574422ed46a9ed8 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_set_default_transaction_opts.html +++ b/libmongoc/1.24.2/mongoc_session_opts_set_default_transaction_opts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_session_opts_set_snapshot.html b/libmongoc/1.24.2/mongoc_session_opts_set_snapshot.html index 743b249226ccc717e77b66eaa4fd131637c82c2f..6b994d13c8ba49d1ee04f52598640ac45d4da981 100644 --- a/libmongoc/1.24.2/mongoc_session_opts_set_snapshot.html +++ b/libmongoc/1.24.2/mongoc_session_opts_set_snapshot.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_accept.html b/libmongoc/1.24.2/mongoc_socket_accept.html index 591ef2d1e89b98cd789b07afc8e6253c00e386e7..3d6d5c914e115ab328f724bece5549f6c5bddad4 100644 --- a/libmongoc/1.24.2/mongoc_socket_accept.html +++ b/libmongoc/1.24.2/mongoc_socket_accept.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_bind.html b/libmongoc/1.24.2/mongoc_socket_bind.html index 1b9318a0a68d3fcd43fad8d8f2f9c0fa1eae81d2..524fb32215041cc98701a798d518daeb02b7ae1f 100644 --- a/libmongoc/1.24.2/mongoc_socket_bind.html +++ b/libmongoc/1.24.2/mongoc_socket_bind.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_close.html b/libmongoc/1.24.2/mongoc_socket_close.html index 9f1a4712370f146f40b1370057031407cc7a0bca..bed59a06c360c14c74be8b3c8f5c0b4c9e463757 100644 --- a/libmongoc/1.24.2/mongoc_socket_close.html +++ b/libmongoc/1.24.2/mongoc_socket_close.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_connect.html b/libmongoc/1.24.2/mongoc_socket_connect.html index 78f6d6ba8b3c49aedbaaada68181cf8c6480b1c1..7a5af7eb6369c90acddf96f933aea315ece0fe09 100644 --- a/libmongoc/1.24.2/mongoc_socket_connect.html +++ b/libmongoc/1.24.2/mongoc_socket_connect.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_destroy.html b/libmongoc/1.24.2/mongoc_socket_destroy.html index 0ffaa800d4c75c83e306d80997a6dcd444c8dc82..1f9d3cc31e9b3a86f6475b9938d0c6b299eb74f3 100644 --- a/libmongoc/1.24.2/mongoc_socket_destroy.html +++ b/libmongoc/1.24.2/mongoc_socket_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_errno.html b/libmongoc/1.24.2/mongoc_socket_errno.html index 59b25bf4ff745ce64480e29874335278a27a8598..32ec76fd7fbc36223e6000568f0996cfd6c3c772 100644 --- a/libmongoc/1.24.2/mongoc_socket_errno.html +++ b/libmongoc/1.24.2/mongoc_socket_errno.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_getnameinfo.html b/libmongoc/1.24.2/mongoc_socket_getnameinfo.html index 99ed29ac397ac8849617fa852633f8ff00b9f009..2b9d0a1994b7a38138f3969e6ba5ce45c0816830 100644 --- a/libmongoc/1.24.2/mongoc_socket_getnameinfo.html +++ b/libmongoc/1.24.2/mongoc_socket_getnameinfo.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_getsockname.html b/libmongoc/1.24.2/mongoc_socket_getsockname.html index 7df8716717e7eb7482050c735d84c4a5d3796b30..bf44cd0a45872532beb577f0c3ab1b5c538a057c 100644 --- a/libmongoc/1.24.2/mongoc_socket_getsockname.html +++ b/libmongoc/1.24.2/mongoc_socket_getsockname.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_listen.html b/libmongoc/1.24.2/mongoc_socket_listen.html index c59608a55ccd601b36ac4324fa9834295b3ce0ff..b7dfae466de1583afe9f523bd2797d4c79ecca2f 100644 --- a/libmongoc/1.24.2/mongoc_socket_listen.html +++ b/libmongoc/1.24.2/mongoc_socket_listen.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_new.html b/libmongoc/1.24.2/mongoc_socket_new.html index 15f349b2ceb0d6027a57a1c208bf6ccc470eb5b9..de680a4c89f2b32108b84f7bd4ed93570c6e7e36 100644 --- a/libmongoc/1.24.2/mongoc_socket_new.html +++ b/libmongoc/1.24.2/mongoc_socket_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_recv.html b/libmongoc/1.24.2/mongoc_socket_recv.html index 5834a3a45f18d1aaed20e35bd17d187472c3b03e..cdbf36df37a066c493aa21ba8a7bd250b731df6a 100644 --- a/libmongoc/1.24.2/mongoc_socket_recv.html +++ b/libmongoc/1.24.2/mongoc_socket_recv.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_send.html b/libmongoc/1.24.2/mongoc_socket_send.html index 90ebe0c70f5e1baf23e7a6b31acca79746ad188e..d9ee0b6feea7a90b31597667983ce44e383a1072 100644 --- a/libmongoc/1.24.2/mongoc_socket_send.html +++ b/libmongoc/1.24.2/mongoc_socket_send.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_sendv.html b/libmongoc/1.24.2/mongoc_socket_sendv.html index f0088d21d1636043090dfa3858899eae3a155bd8..0db18cee398f296a68e804d4d370986e643904fd 100644 --- a/libmongoc/1.24.2/mongoc_socket_sendv.html +++ b/libmongoc/1.24.2/mongoc_socket_sendv.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_setsockopt.html b/libmongoc/1.24.2/mongoc_socket_setsockopt.html index 3f3d8fe651956cc9c04185a40c4ed47640c51a31..77ea0b2be6b3030d91f1f650b1c42b6592a89b3a 100644 --- a/libmongoc/1.24.2/mongoc_socket_setsockopt.html +++ b/libmongoc/1.24.2/mongoc_socket_setsockopt.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_socket_t.html b/libmongoc/1.24.2/mongoc_socket_t.html index 1a4ee878df2b68abdddc5050ea393e0035788577..80af6794a948a4acb71a88b25010dfc1e28f6b74 100644 --- a/libmongoc/1.24.2/mongoc_socket_t.html +++ b/libmongoc/1.24.2/mongoc_socket_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_ssl_opt_get_default.html b/libmongoc/1.24.2/mongoc_ssl_opt_get_default.html index fba96aa76dfbb4bafd0edfa4157508d748aba998..71759101f2711335b27e6d08f5ee19276521b12a 100644 --- a/libmongoc/1.24.2/mongoc_ssl_opt_get_default.html +++ b/libmongoc/1.24.2/mongoc_ssl_opt_get_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_ssl_opt_t.html b/libmongoc/1.24.2/mongoc_ssl_opt_t.html index 0208943076a171b7c1b97a452a2f10c5eee94132..2406b13b3811d54575e2cc40a2a198a4c4a9c011 100644 --- a/libmongoc/1.24.2/mongoc_ssl_opt_t.html +++ b/libmongoc/1.24.2/mongoc_ssl_opt_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_buffered_new.html b/libmongoc/1.24.2/mongoc_stream_buffered_new.html index 5cf4545d10c37ec3bf976843d1bfa3fd31cb014a..20ea51d9980d1343526f23c8790a1687f15d3fbe 100644 --- a/libmongoc/1.24.2/mongoc_stream_buffered_new.html +++ b/libmongoc/1.24.2/mongoc_stream_buffered_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_buffered_t.html b/libmongoc/1.24.2/mongoc_stream_buffered_t.html index 5ad2b5ef78fba2654ba42e023a7bd1e9c134afce..c878cd8423cb64e11e9ea220c9c3e6623797c3db 100644 --- a/libmongoc/1.24.2/mongoc_stream_buffered_t.html +++ b/libmongoc/1.24.2/mongoc_stream_buffered_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_close.html b/libmongoc/1.24.2/mongoc_stream_close.html index 1913be37e9630a88ae3a3c69b6b364c8234f05b9..d7c50cc675fdf241b999c528d66f4fd51a59cdcf 100644 --- a/libmongoc/1.24.2/mongoc_stream_close.html +++ b/libmongoc/1.24.2/mongoc_stream_close.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_cork.html b/libmongoc/1.24.2/mongoc_stream_cork.html index 95561ab2bb11c50a4f19110ee2ff8fd4f2c4ac74..eb14cf21e98dea30e243367b3226bb22f26968bc 100644 --- a/libmongoc/1.24.2/mongoc_stream_cork.html +++ b/libmongoc/1.24.2/mongoc_stream_cork.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_destroy.html b/libmongoc/1.24.2/mongoc_stream_destroy.html index 6d325358d385c183ecf1af941ef81da1d271b517..06c0b26cca12d615058c109c4f396863561f963f 100644 --- a/libmongoc/1.24.2/mongoc_stream_destroy.html +++ b/libmongoc/1.24.2/mongoc_stream_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_file_get_fd.html b/libmongoc/1.24.2/mongoc_stream_file_get_fd.html index a6ed7bfa9ad61d258bb48a464c0cdc20c6684ac5..a59200f2355d102ee1e4b80745c843e5f7e1c92a 100644 --- a/libmongoc/1.24.2/mongoc_stream_file_get_fd.html +++ b/libmongoc/1.24.2/mongoc_stream_file_get_fd.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_file_new.html b/libmongoc/1.24.2/mongoc_stream_file_new.html index 9e3314ba20f374082e56972a1bad00acd3209cec..994e9b84fea920861dd9492b9bf310abd3dff17d 100644 --- a/libmongoc/1.24.2/mongoc_stream_file_new.html +++ b/libmongoc/1.24.2/mongoc_stream_file_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_file_new_for_path.html b/libmongoc/1.24.2/mongoc_stream_file_new_for_path.html index 51aca9fab55fac9183d2e7f33f360d2e434d31c8..ed2d54c1052be38fc00ce3ec42a43014ca79cbd6 100644 --- a/libmongoc/1.24.2/mongoc_stream_file_new_for_path.html +++ b/libmongoc/1.24.2/mongoc_stream_file_new_for_path.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_file_t.html b/libmongoc/1.24.2/mongoc_stream_file_t.html index 765a51db05e2c7909caeebc6f89a4528bc373c27..314361d1b168283e49b4cdf37f39c13da644425d 100644 --- a/libmongoc/1.24.2/mongoc_stream_file_t.html +++ b/libmongoc/1.24.2/mongoc_stream_file_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_flush.html b/libmongoc/1.24.2/mongoc_stream_flush.html index d8cc3458a35e480fc0c8ee0d1aa0eff828a489c0..9c218ac5420c67e3b625be7b0aea6f5673169eb9 100644 --- a/libmongoc/1.24.2/mongoc_stream_flush.html +++ b/libmongoc/1.24.2/mongoc_stream_flush.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_get_base_stream.html b/libmongoc/1.24.2/mongoc_stream_get_base_stream.html index d7c377c5295259b5aa5db6541260efa5e88ae453..38fe0ef0523713cb8231063c93dfe2f0991be3c6 100644 --- a/libmongoc/1.24.2/mongoc_stream_get_base_stream.html +++ b/libmongoc/1.24.2/mongoc_stream_get_base_stream.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_gridfs_new.html b/libmongoc/1.24.2/mongoc_stream_gridfs_new.html index b761fb7fd8c068edfbe8e61f896148c199bcfb24..fd2d1b5953e214a1a27cdf10ef23fb2982808a68 100644 --- a/libmongoc/1.24.2/mongoc_stream_gridfs_new.html +++ b/libmongoc/1.24.2/mongoc_stream_gridfs_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_read.html b/libmongoc/1.24.2/mongoc_stream_read.html index ee651e2d74bf78c85a287181a2bd4d4100781b76..166f6fd2e16c01b3f313b1a982650a13f1a9c130 100644 --- a/libmongoc/1.24.2/mongoc_stream_read.html +++ b/libmongoc/1.24.2/mongoc_stream_read.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_readv.html b/libmongoc/1.24.2/mongoc_stream_readv.html index 62474c16be3796213a0d1fb94a94e9aaf5c403b8..fbfb988938ce786d79f15a28b8d777e5fc5f4fd0 100644 --- a/libmongoc/1.24.2/mongoc_stream_readv.html +++ b/libmongoc/1.24.2/mongoc_stream_readv.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_setsockopt.html b/libmongoc/1.24.2/mongoc_stream_setsockopt.html index d852990881b7501949292a31a92992af8745531b..a6ee132b65572d47d5735aa29906540a8e82224e 100644 --- a/libmongoc/1.24.2/mongoc_stream_setsockopt.html +++ b/libmongoc/1.24.2/mongoc_stream_setsockopt.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_should_retry.html b/libmongoc/1.24.2/mongoc_stream_should_retry.html index 4a02063eef50324c89435b4dcdcc4c6a67d6b4bc..ef847c1a3784a56d0bfed4344837242faad50d55 100644 --- a/libmongoc/1.24.2/mongoc_stream_should_retry.html +++ b/libmongoc/1.24.2/mongoc_stream_should_retry.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_socket_get_socket.html b/libmongoc/1.24.2/mongoc_stream_socket_get_socket.html index b4cf8876ceb4adff9eac8c0d400c381614302e62..57f61da024561c22d4e115ec7b5695f0035b89a3 100644 --- a/libmongoc/1.24.2/mongoc_stream_socket_get_socket.html +++ b/libmongoc/1.24.2/mongoc_stream_socket_get_socket.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_socket_new.html b/libmongoc/1.24.2/mongoc_stream_socket_new.html index 6a4c1a9f6dd2dcd55afd24897ed531a19b556a6d..76ea9f46a13588fd4e4ea6f5575af4ae1c54aa35 100644 --- a/libmongoc/1.24.2/mongoc_stream_socket_new.html +++ b/libmongoc/1.24.2/mongoc_stream_socket_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_socket_t.html b/libmongoc/1.24.2/mongoc_stream_socket_t.html index 1383eb2dcfbd52df1805dffa1f661b13956c2635..1857fcb79cf8422fefc55c3e90e929cbfcc93c9b 100644 --- a/libmongoc/1.24.2/mongoc_stream_socket_t.html +++ b/libmongoc/1.24.2/mongoc_stream_socket_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_t.html b/libmongoc/1.24.2/mongoc_stream_t.html index df201d314ea2064a223080f5f3ca7b5d1d419cd9..f3588df00b1eadaf23576f588c6ed37b589fe32f 100644 --- a/libmongoc/1.24.2/mongoc_stream_t.html +++ b/libmongoc/1.24.2/mongoc_stream_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_timed_out.html b/libmongoc/1.24.2/mongoc_stream_timed_out.html index e10b1b1f9a0622445515bc45d893bd9d5abc7354..a099b053be6a76fed45a8a4504c71baf4d7f4f49 100644 --- a/libmongoc/1.24.2/mongoc_stream_timed_out.html +++ b/libmongoc/1.24.2/mongoc_stream_timed_out.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_tls_t.html b/libmongoc/1.24.2/mongoc_stream_tls_t.html index d3568eb336b1ec7edaa3198c5eaddc38f94810f9..3e76c434b84d5d45ca9b465108fc861c6cdb5927 100644 --- a/libmongoc/1.24.2/mongoc_stream_tls_t.html +++ b/libmongoc/1.24.2/mongoc_stream_tls_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_uncork.html b/libmongoc/1.24.2/mongoc_stream_uncork.html index d00f309142fa3a76d5b4e094c721eb0e18dd5bd8..e605333b6f568d64d16d1055a37931cce27d6472 100644 --- a/libmongoc/1.24.2/mongoc_stream_uncork.html +++ b/libmongoc/1.24.2/mongoc_stream_uncork.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_write.html b/libmongoc/1.24.2/mongoc_stream_write.html index 0d168546046900f9b53a073a137bca532876d4dc..16da4998b0b4d57de303441a4efe6d1922acfd22 100644 --- a/libmongoc/1.24.2/mongoc_stream_write.html +++ b/libmongoc/1.24.2/mongoc_stream_write.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_stream_writev.html b/libmongoc/1.24.2/mongoc_stream_writev.html index 723d55ceb220d4892cdab285ec7663087cafebec..0eb04bd79380048800fda569866a6ec4ebea4d48 100644 --- a/libmongoc/1.24.2/mongoc_stream_writev.html +++ b/libmongoc/1.24.2/mongoc_stream_writev.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_destroy.html b/libmongoc/1.24.2/mongoc_topology_description_destroy.html index 2753854f6b84998bea4364718b0ada8762d7cde7..6f9744cb2a11fdc69d9fed24dcc48eaabeede670 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_destroy.html +++ b/libmongoc/1.24.2/mongoc_topology_description_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_get_servers.html b/libmongoc/1.24.2/mongoc_topology_description_get_servers.html index 9f9643bf69b3e580c65682103e9c761b33fa6e63..0a44510ae4e5a21471e448852f0e38c164fd1354 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_get_servers.html +++ b/libmongoc/1.24.2/mongoc_topology_description_get_servers.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_has_readable_server.html b/libmongoc/1.24.2/mongoc_topology_description_has_readable_server.html index 4bb767f70c53399c0352b4fdbfd54c61cbb0a1c7..e1cc661edded1ee9bd3170f47d1635e9b0494556 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_has_readable_server.html +++ b/libmongoc/1.24.2/mongoc_topology_description_has_readable_server.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_has_writable_server.html b/libmongoc/1.24.2/mongoc_topology_description_has_writable_server.html index a9129c850fc69a4199ecb43721f0cc15837b683f..dc7470b1ea0ab3d7b7975b2ed9c89a39f005900c 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_has_writable_server.html +++ b/libmongoc/1.24.2/mongoc_topology_description_has_writable_server.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_new_copy.html b/libmongoc/1.24.2/mongoc_topology_description_new_copy.html index ecc36aec147de3c9909320c78158d7bc8a7aab58..3dd47bc1c81c11625a02f42d6588cee08c5ecd69 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_new_copy.html +++ b/libmongoc/1.24.2/mongoc_topology_description_new_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_t.html b/libmongoc/1.24.2/mongoc_topology_description_t.html index 42ae79996936d63c007e972172f8fb0a007c3fcf..42ec3c90900a6162b7bdbf2411bba75b8e29d5b5 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_t.html +++ b/libmongoc/1.24.2/mongoc_topology_description_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_topology_description_type.html b/libmongoc/1.24.2/mongoc_topology_description_type.html index 8d4cb003959b63e9e302cf2868a4034623e6641a..59c958d6277954176ece89d6466bc755a64bfda0 100644 --- a/libmongoc/1.24.2/mongoc_topology_description_type.html +++ b/libmongoc/1.24.2/mongoc_topology_description_type.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opt_t.html b/libmongoc/1.24.2/mongoc_transaction_opt_t.html index 02971b14d89c1916030660eceafe5b089c4bd24a..a058c1cabe2f01c3fd03f62f32dfc3fa0ce29abd 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opt_t.html +++ b/libmongoc/1.24.2/mongoc_transaction_opt_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_clone.html b/libmongoc/1.24.2/mongoc_transaction_opts_clone.html index 7dfaa03812082cbca8e0c695d2baae8fd7a2b74f..d63f535937d41d6950e41c22c25c476b5dbbaac8 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_clone.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_clone.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_destroy.html b/libmongoc/1.24.2/mongoc_transaction_opts_destroy.html index f76e4fdd7fe571ec030c2aafbba1282d272ee469..7aa1143eb3c00912fb40c7e3952a30614e777e94 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_destroy.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_get_max_commit_time_ms.html b/libmongoc/1.24.2/mongoc_transaction_opts_get_max_commit_time_ms.html index bda14aa3769a72254653759e1a2e9af0bc154efa..e1b6577222e6153cd2f84ce0f5008f005704c93e 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_get_max_commit_time_ms.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_get_max_commit_time_ms.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_get_read_concern.html b/libmongoc/1.24.2/mongoc_transaction_opts_get_read_concern.html index 7db97a8abd554013e71e58b4cc38635eb5c6eb3c..ae68e721b458b4242e4bd33276ce1d9f0d4f9deb 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_get_read_concern.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_get_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_get_read_prefs.html b/libmongoc/1.24.2/mongoc_transaction_opts_get_read_prefs.html index 0678c2a49e30a71782e8c7279f1086c293348518..1649f47cec15d39651a4b19c5dae22f7c7aee08e 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_get_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_get_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_get_write_concern.html b/libmongoc/1.24.2/mongoc_transaction_opts_get_write_concern.html index dad1ecd09b8fb50c74b093d7bf36e80f49f19716..db12cbeac91eaf482b6510508dc50d65e2531d49 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_get_write_concern.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_get_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_new.html b/libmongoc/1.24.2/mongoc_transaction_opts_new.html index 9d1cc56c7605b1a31637525b4f5d406ddc4b237a..e455a899f3eaccbc1cc287782f2d1a65b410cb73 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_new.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_set_max_commit_time_ms.html b/libmongoc/1.24.2/mongoc_transaction_opts_set_max_commit_time_ms.html index 39bd875cfe8085ebe97588b01cfbe44842911504..15c56ff26aceede483f724891008db1bbc96a7cc 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_set_max_commit_time_ms.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_set_max_commit_time_ms.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_set_read_concern.html b/libmongoc/1.24.2/mongoc_transaction_opts_set_read_concern.html index a303a09f6568b5acab518af6943de5a7e4e9786a..42d8ee9a03373a99fb965fff6e3405a07cc7aa76 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_set_read_concern.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_set_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_set_read_prefs.html b/libmongoc/1.24.2/mongoc_transaction_opts_set_read_prefs.html index 7942c03b12061e91fd414178583037c4c8294a46..ab8f71bae1caf549d20cdd326bd91caf32a2a1dd 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_set_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_set_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_opts_set_write_concern.html b/libmongoc/1.24.2/mongoc_transaction_opts_set_write_concern.html index 2dfd4ed2ac4f7173b068fb92978e9908b64bc9e2..79737e9b782cf8ebdcc1cb7ad59586026a54ef2f 100644 --- a/libmongoc/1.24.2/mongoc_transaction_opts_set_write_concern.html +++ b/libmongoc/1.24.2/mongoc_transaction_opts_set_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_transaction_state_t.html b/libmongoc/1.24.2/mongoc_transaction_state_t.html index da55cb6bb09be8812888eb8de66f0c82be982c84..90f5002810b676ac53933aa907e5dbe8e82a39e3 100644 --- a/libmongoc/1.24.2/mongoc_transaction_state_t.html +++ b/libmongoc/1.24.2/mongoc_transaction_state_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_update_flags_t.html b/libmongoc/1.24.2/mongoc_update_flags_t.html index ff59fc3818bf5221605670f754ab956c03d766df..d113dea6d09d98508783f81995f37e7fa754d8b8 100644 --- a/libmongoc/1.24.2/mongoc_update_flags_t.html +++ b/libmongoc/1.24.2/mongoc_update_flags_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_copy.html b/libmongoc/1.24.2/mongoc_uri_copy.html index d8d19321cb108896da6cf68f417720e036785884..69f520d0f86bf230b0ec7673f795eda10576d626 100644 --- a/libmongoc/1.24.2/mongoc_uri_copy.html +++ b/libmongoc/1.24.2/mongoc_uri_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_destroy.html b/libmongoc/1.24.2/mongoc_uri_destroy.html index bbe267e673d6aacafa1e047d59812dfd0d0a01b9..a04db0428098853925926d3d134e83b993ac7431 100644 --- a/libmongoc/1.24.2/mongoc_uri_destroy.html +++ b/libmongoc/1.24.2/mongoc_uri_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_auth_mechanism.html b/libmongoc/1.24.2/mongoc_uri_get_auth_mechanism.html index 630a6490b4fdc26035b2c26fac578b68ce952afa..5a72ea8e78dcdded613c73d0c9de9b99f56c3abf 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_auth_mechanism.html +++ b/libmongoc/1.24.2/mongoc_uri_get_auth_mechanism.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_auth_source.html b/libmongoc/1.24.2/mongoc_uri_get_auth_source.html index 6e81df9e840655dc8856c53ee28396664484b7ac..7248c461fe4d5e36aee786d75f5f3207f7897233 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_auth_source.html +++ b/libmongoc/1.24.2/mongoc_uri_get_auth_source.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_compressors.html b/libmongoc/1.24.2/mongoc_uri_get_compressors.html index 3907b3de64a55ff77c4c3dcd4405255da42a786f..1ca910341c5c13f5334938fc94b88668d48e2a5a 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_compressors.html +++ b/libmongoc/1.24.2/mongoc_uri_get_compressors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_database.html b/libmongoc/1.24.2/mongoc_uri_get_database.html index ad3e0cb015db20b4cc564a974f5ac8a5ba967c7f..3392cd6eccb77ddbfb9d6bcacd6cc898df3f632c 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_database.html +++ b/libmongoc/1.24.2/mongoc_uri_get_database.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_hosts.html b/libmongoc/1.24.2/mongoc_uri_get_hosts.html index 1d2160df65f8132a52f848fad3755eb178a26a74..93f91625b148f595f28c97044e62de46bc5862e9 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_hosts.html +++ b/libmongoc/1.24.2/mongoc_uri_get_hosts.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_mechanism_properties.html b/libmongoc/1.24.2/mongoc_uri_get_mechanism_properties.html index 6ba0c2f70b1e8c9375e5cd18d2cbac38de0f218d..13f7f93589aa278dac57f554e5f9128b43aef3fb 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_mechanism_properties.html +++ b/libmongoc/1.24.2/mongoc_uri_get_mechanism_properties.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_option_as_bool.html b/libmongoc/1.24.2/mongoc_uri_get_option_as_bool.html index de6744d30b5f367d7c0fcee71ebf22bb4f9a604f..37777284c9ec4dcb05f5488fdfa4982db0c23d38 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_option_as_bool.html +++ b/libmongoc/1.24.2/mongoc_uri_get_option_as_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_option_as_int32.html b/libmongoc/1.24.2/mongoc_uri_get_option_as_int32.html index 320cc5bff987c4406cec2f7f8910affd4257e53f..cd7ad1d3cb5abbf97f88fe99f9d0b88c1bb67df1 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_option_as_int32.html +++ b/libmongoc/1.24.2/mongoc_uri_get_option_as_int32.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_option_as_int64.html b/libmongoc/1.24.2/mongoc_uri_get_option_as_int64.html index acdc36dfd554eb859379bb7746a4229d9c505e64..a403dbe27c81c3ed943f30d8aeaefccb159ea949 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_option_as_int64.html +++ b/libmongoc/1.24.2/mongoc_uri_get_option_as_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_option_as_utf8.html b/libmongoc/1.24.2/mongoc_uri_get_option_as_utf8.html index e1a3fae06bccb3eee0c122784ccbecb3b05f23ac..fd4bca036c61ff3cb095e11cfce0f284a689f806 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_option_as_utf8.html +++ b/libmongoc/1.24.2/mongoc_uri_get_option_as_utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_options.html b/libmongoc/1.24.2/mongoc_uri_get_options.html index b65f3090736377ccfffeb9fc933384cf35dbce2f..89a0d10e99dbcdffb8dee971eed80c364f28da92 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_options.html +++ b/libmongoc/1.24.2/mongoc_uri_get_options.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_password.html b/libmongoc/1.24.2/mongoc_uri_get_password.html index b5ac6dbe5a50b291d39089b0c964a914ab34c3d8..cb1eb3cb7c3e67e39c46a26ab25a0304d63e62ab 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_password.html +++ b/libmongoc/1.24.2/mongoc_uri_get_password.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_read_concern.html b/libmongoc/1.24.2/mongoc_uri_get_read_concern.html index 5ab528a138b4f3a8e81c45d3253829240bd6c52c..d2a7c525f314dfc3af37e9dbcbab5210afa27779 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_read_concern.html +++ b/libmongoc/1.24.2/mongoc_uri_get_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_read_prefs.html b/libmongoc/1.24.2/mongoc_uri_get_read_prefs.html index 30bd59236ef63ce658fb88ac829293a4602ce106..bcbba41bd6d77f2607eeccbfa3933c264892c8d7 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_read_prefs.html +++ b/libmongoc/1.24.2/mongoc_uri_get_read_prefs.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_read_prefs_t.html b/libmongoc/1.24.2/mongoc_uri_get_read_prefs_t.html index 255aba360ef198b7435c9c837225a95e8330917e..403c7993942c45e4034f17985fca957f8cf246d2 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_read_prefs_t.html +++ b/libmongoc/1.24.2/mongoc_uri_get_read_prefs_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_replica_set.html b/libmongoc/1.24.2/mongoc_uri_get_replica_set.html index aba2610bf632951744530434efc82e4aefa2475d..735be4ab33de90ff48fc1971fa394ac03de090a2 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_replica_set.html +++ b/libmongoc/1.24.2/mongoc_uri_get_replica_set.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_service.html b/libmongoc/1.24.2/mongoc_uri_get_service.html index 0b2ddd1f39f7510a98130290c338875579f47f56..db07de59908c25941071594c9bc5db3713de5e2d 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_service.html +++ b/libmongoc/1.24.2/mongoc_uri_get_service.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_srv_hostname.html b/libmongoc/1.24.2/mongoc_uri_get_srv_hostname.html index 2bfed6f4ff191ab92d879564d986aa8b606b9514..48bd5459b4d1ad2020a3ab2f5ed8283ae3ebb3b8 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_srv_hostname.html +++ b/libmongoc/1.24.2/mongoc_uri_get_srv_hostname.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_srv_service_name.html b/libmongoc/1.24.2/mongoc_uri_get_srv_service_name.html index 354713541890e394a20a1c7f6fac74e250874956..bb51ff53757b5249ae8c91e40e0b90fb3ba90ae6 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_srv_service_name.html +++ b/libmongoc/1.24.2/mongoc_uri_get_srv_service_name.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_ssl.html b/libmongoc/1.24.2/mongoc_uri_get_ssl.html index 0942f95d23e271ca3d93657bde3f84f5690ee57f..9d5842d440d9c10327c17f86ccffdb3c8960c93b 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_ssl.html +++ b/libmongoc/1.24.2/mongoc_uri_get_ssl.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_string.html b/libmongoc/1.24.2/mongoc_uri_get_string.html index 97d2a22a3c2766595f0b323bcbbf9845aa432915..648d43025c89e057617e6dae2e9989ebecb1e84d 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_string.html +++ b/libmongoc/1.24.2/mongoc_uri_get_string.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_tls.html b/libmongoc/1.24.2/mongoc_uri_get_tls.html index 4a307cc57337d8d1d58ae329c1b35a3ee02e9868..a74d9f2d50757a0710fd307c941af9289b65572c 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_tls.html +++ b/libmongoc/1.24.2/mongoc_uri_get_tls.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_username.html b/libmongoc/1.24.2/mongoc_uri_get_username.html index 50c2a0d24c2d27098775007b8783f1747bad793d..6149489150edbd6b2dbc657b1afbaf149e453d38 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_username.html +++ b/libmongoc/1.24.2/mongoc_uri_get_username.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_get_write_concern.html b/libmongoc/1.24.2/mongoc_uri_get_write_concern.html index ec69f150cba1cb4ee54c63c21cdccb6ea2513a5c..c65f50258fa23d68e6e9c8873e702ba436b8627e 100644 --- a/libmongoc/1.24.2/mongoc_uri_get_write_concern.html +++ b/libmongoc/1.24.2/mongoc_uri_get_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_has_option.html b/libmongoc/1.24.2/mongoc_uri_has_option.html index bd80dc3b1166f20031517da9eeae896e3d6d41a2..eb762967bd5e69360d24f434270f62739300e51b 100644 --- a/libmongoc/1.24.2/mongoc_uri_has_option.html +++ b/libmongoc/1.24.2/mongoc_uri_has_option.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_new.html b/libmongoc/1.24.2/mongoc_uri_new.html index a5e67190cb01e73af2f51211369ffcf4e4415982..f997fe70977bf1bdc65436a6e10257f0ef014d2f 100644 --- a/libmongoc/1.24.2/mongoc_uri_new.html +++ b/libmongoc/1.24.2/mongoc_uri_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_new_for_host_port.html b/libmongoc/1.24.2/mongoc_uri_new_for_host_port.html index 3cd706c8aea2269ca4897ac4c99bc8968640f209..f440028da2f8aa47f3ff01551c3d14308f243ba8 100644 --- a/libmongoc/1.24.2/mongoc_uri_new_for_host_port.html +++ b/libmongoc/1.24.2/mongoc_uri_new_for_host_port.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_new_with_error.html b/libmongoc/1.24.2/mongoc_uri_new_with_error.html index ff3d9cb4fe0c570ab087ba0a0d8021d548564f28..fc6db05261512e4da756558e5da35b466a37850c 100644 --- a/libmongoc/1.24.2/mongoc_uri_new_with_error.html +++ b/libmongoc/1.24.2/mongoc_uri_new_with_error.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_option_is_bool.html b/libmongoc/1.24.2/mongoc_uri_option_is_bool.html index c881a059f07c320c9460278fa3ef06b45970fb7f..daea68e562c1e0837dd292e306ddbd8ad7eab92b 100644 --- a/libmongoc/1.24.2/mongoc_uri_option_is_bool.html +++ b/libmongoc/1.24.2/mongoc_uri_option_is_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_option_is_int32.html b/libmongoc/1.24.2/mongoc_uri_option_is_int32.html index 759157c8364685afda90149114470d7d5be7e934..8ea4944f1c58cac1c4514d563bd29fe7fefe5551 100644 --- a/libmongoc/1.24.2/mongoc_uri_option_is_int32.html +++ b/libmongoc/1.24.2/mongoc_uri_option_is_int32.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_option_is_int64.html b/libmongoc/1.24.2/mongoc_uri_option_is_int64.html index 076c12e402a0a0b2e1c4c31a4f76353cbc3b33db..0e439624d408c34fc156b462bb08b1f8356d7d43 100644 --- a/libmongoc/1.24.2/mongoc_uri_option_is_int64.html +++ b/libmongoc/1.24.2/mongoc_uri_option_is_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_option_is_utf8.html b/libmongoc/1.24.2/mongoc_uri_option_is_utf8.html index 5e949efdf9376ee9eba5239338bfcc691fe98a0a..7f1443bce8d2f8eae040d9d549e49d459b885ca7 100644 --- a/libmongoc/1.24.2/mongoc_uri_option_is_utf8.html +++ b/libmongoc/1.24.2/mongoc_uri_option_is_utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_auth_mechanism.html b/libmongoc/1.24.2/mongoc_uri_set_auth_mechanism.html index e15bcaf6d07cd395d1064027b005b4f2e4486522..2f351ddb0ba1e255d8d75de837f140981c4055ad 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_auth_mechanism.html +++ b/libmongoc/1.24.2/mongoc_uri_set_auth_mechanism.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_auth_source.html b/libmongoc/1.24.2/mongoc_uri_set_auth_source.html index f9e6e8e46358796cc577564874e3e483ff1c463b..3f09fab3f00bb5de4d88695a813de1ab0779e9e8 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_auth_source.html +++ b/libmongoc/1.24.2/mongoc_uri_set_auth_source.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_compressors.html b/libmongoc/1.24.2/mongoc_uri_set_compressors.html index 2cff9a16020010c3be307b15b2068b08d3a2382d..a9abcdb4761c92a325bd9b5c51c1f17d391ed26e 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_compressors.html +++ b/libmongoc/1.24.2/mongoc_uri_set_compressors.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_database.html b/libmongoc/1.24.2/mongoc_uri_set_database.html index 06b99cb2567b1ba3ca18399998b816401d08683d..4c559efbb45b1a45fa3e8770d84ac571ea7af6b0 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_database.html +++ b/libmongoc/1.24.2/mongoc_uri_set_database.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_mechanism_properties.html b/libmongoc/1.24.2/mongoc_uri_set_mechanism_properties.html index 36ec89b6a91efc79b9af8ea8855168abb968a319..e7e482fd4fc279e3d309302e5630502f90cce662 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_mechanism_properties.html +++ b/libmongoc/1.24.2/mongoc_uri_set_mechanism_properties.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_option_as_bool.html b/libmongoc/1.24.2/mongoc_uri_set_option_as_bool.html index ca62e90c2143d7126202ddb505d05f795f8aeaa5..87ce946252d78e91d04485dc0f1777b6a81c5501 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_option_as_bool.html +++ b/libmongoc/1.24.2/mongoc_uri_set_option_as_bool.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_option_as_int32.html b/libmongoc/1.24.2/mongoc_uri_set_option_as_int32.html index 1fcdc2f245427102e2a747d4bedae0e8aaa35f2b..006d09700d0f15dc34fd984628c9ae86651dc20b 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_option_as_int32.html +++ b/libmongoc/1.24.2/mongoc_uri_set_option_as_int32.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_option_as_int64.html b/libmongoc/1.24.2/mongoc_uri_set_option_as_int64.html index 76d8e93d50b6cf22d21a2e793e9c8619933b21b0..b102f3afa3d2835eda0ee8c249b2cd866f046fda 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_option_as_int64.html +++ b/libmongoc/1.24.2/mongoc_uri_set_option_as_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_option_as_utf8.html b/libmongoc/1.24.2/mongoc_uri_set_option_as_utf8.html index 93f7d0fd70e18820e68d25728a1d4b632311e650..2927861c0b6dd44a6c9bd7769c18233ee97bf7e8 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_option_as_utf8.html +++ b/libmongoc/1.24.2/mongoc_uri_set_option_as_utf8.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_password.html b/libmongoc/1.24.2/mongoc_uri_set_password.html index 44fa9a179e1e72ef0f17df276d65dc3b6294a9ea..64ccdb0e76f9bbd302c8e76c786e9e7df8452b9c 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_password.html +++ b/libmongoc/1.24.2/mongoc_uri_set_password.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_read_concern.html b/libmongoc/1.24.2/mongoc_uri_set_read_concern.html index 6d12d446c19c9fe3ff9a6cc3232d4cc3366793fc..731d6cebbc827fb73df2e0d632d366cf6610d044 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_read_concern.html +++ b/libmongoc/1.24.2/mongoc_uri_set_read_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_read_prefs_t.html b/libmongoc/1.24.2/mongoc_uri_set_read_prefs_t.html index 9025bb1f216f80661ae5f11b21566dd1792323a9..06679f0fba30eff5eedafe686b55d6d73f7a1ee0 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_read_prefs_t.html +++ b/libmongoc/1.24.2/mongoc_uri_set_read_prefs_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_username.html b/libmongoc/1.24.2/mongoc_uri_set_username.html index 0f9ebc231fa07250ae3ab9f59306b6ae44891549..40bf0b228f04babde7c392a246b23de20334b5e2 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_username.html +++ b/libmongoc/1.24.2/mongoc_uri_set_username.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_set_write_concern.html b/libmongoc/1.24.2/mongoc_uri_set_write_concern.html index 1a0e17495f573ead68b75792021a57fe28e251a4..1d65e0383a76a1635fac94c24076625e8797a1c3 100644 --- a/libmongoc/1.24.2/mongoc_uri_set_write_concern.html +++ b/libmongoc/1.24.2/mongoc_uri_set_write_concern.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_t.html b/libmongoc/1.24.2/mongoc_uri_t.html index c0fa799215d79d0dba81727459510cefe5cdc9ef..1e6d20d6650d3c89bc3a05fbf38188ea7d197fc7 100644 --- a/libmongoc/1.24.2/mongoc_uri_t.html +++ b/libmongoc/1.24.2/mongoc_uri_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_uri_unescape.html b/libmongoc/1.24.2/mongoc_uri_unescape.html index cbc7e11fc5769906d766110b9a59ffc80251b533..16eade0c036cb13b00e335350f03212beb930c66 100644 --- a/libmongoc/1.24.2/mongoc_uri_unescape.html +++ b/libmongoc/1.24.2/mongoc_uri_unescape.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_version.html b/libmongoc/1.24.2/mongoc_version.html index 7307ff277fcb1f2d231f74ea473b81d40c2f090b..d4f4c6c17fb6f29c39ebf30039a28886e21b6ddd 100644 --- a/libmongoc/1.24.2/mongoc_version.html +++ b/libmongoc/1.24.2/mongoc_version.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_append.html b/libmongoc/1.24.2/mongoc_write_concern_append.html index 4727fa0b3f4cb6cb1b36014f597ab4e1c9f71530..d26183ab3817cc6be88a8b3c776e56f22ad5a133 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_append.html +++ b/libmongoc/1.24.2/mongoc_write_concern_append.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_copy.html b/libmongoc/1.24.2/mongoc_write_concern_copy.html index 35d517c569b983692145d05e64294d3bc46d6292..dab3e7516670b9fe3ba1258a6542fafc54640ac0 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_copy.html +++ b/libmongoc/1.24.2/mongoc_write_concern_copy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_destroy.html b/libmongoc/1.24.2/mongoc_write_concern_destroy.html index 54301509079e3b5905d619ae407bd35c27af4cfa..041d0402e4e54c7d49a747d09ba789738be9cb6e 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_destroy.html +++ b/libmongoc/1.24.2/mongoc_write_concern_destroy.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_fsync.html b/libmongoc/1.24.2/mongoc_write_concern_get_fsync.html index 81ff50b85b243c12e4e2323be009df07c631ad9e..fed56c83d56f2569a60fa56ce355fc74e0ddeb03 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_fsync.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_fsync.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_journal.html b/libmongoc/1.24.2/mongoc_write_concern_get_journal.html index 1d460e6d51a5595ab781ad641843707d0b9fc4f4..25166209be9edaa4bb08587d93ef703430b7a86e 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_journal.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_journal.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_w.html b/libmongoc/1.24.2/mongoc_write_concern_get_w.html index 8c93fa3a37fded6eeebcd0be4860732433ba06f9..916114005ac5a46749146bebfbf45ae83db6a5b3 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_w.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_w.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_wmajority.html b/libmongoc/1.24.2/mongoc_write_concern_get_wmajority.html index 3a1e0b023cc2dec052226359ebcbea99052953b9..1dd58c521925d2af27dfca1c270ee5f67224547b 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_wmajority.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_wmajority.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_wtag.html b/libmongoc/1.24.2/mongoc_write_concern_get_wtag.html index d855e822a331006407ce8a66803fcecbb9d979f5..f2af52e5281254890549ab1abfa2e9ebaec064ca 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_wtag.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_wtag.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout.html b/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout.html index 456430e3695c8e9d2ea85b273aa348518ab18e18..67e04042b77a6a011913800761132ec8fc1ecbdb 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout_int64.html b/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout_int64.html index 8e10a154ec765b74195f979911d4994d2c9de809..a75b0b36da2022a55d5b18c37b2d0e347dbeb85a 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout_int64.html +++ b/libmongoc/1.24.2/mongoc_write_concern_get_wtimeout_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_is_acknowledged.html b/libmongoc/1.24.2/mongoc_write_concern_is_acknowledged.html index 7f757c47a94bb68f328c2b579212f962ba9134f4..1fb4ce367fca9ebc586b6e44a119e2f595191817 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_is_acknowledged.html +++ b/libmongoc/1.24.2/mongoc_write_concern_is_acknowledged.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_is_default.html b/libmongoc/1.24.2/mongoc_write_concern_is_default.html index ce529843f66bc3bcc7dc94c993391a6a1b5e93f4..12b506fbb843ab171656cceacc9ad59da4e4039a 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_is_default.html +++ b/libmongoc/1.24.2/mongoc_write_concern_is_default.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_is_valid.html b/libmongoc/1.24.2/mongoc_write_concern_is_valid.html index 16d3f53a925bc995301fd7face49ab6096630f45..e97c619f13d13ad2af95bf49883cfc274dce4206 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_is_valid.html +++ b/libmongoc/1.24.2/mongoc_write_concern_is_valid.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_journal_is_set.html b/libmongoc/1.24.2/mongoc_write_concern_journal_is_set.html index 060d297407e71b8601b42faaf9f167db904bae4b..4f7aaf866bb29d6ef9064d26abd9c162edb2bd9d 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_journal_is_set.html +++ b/libmongoc/1.24.2/mongoc_write_concern_journal_is_set.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_new.html b/libmongoc/1.24.2/mongoc_write_concern_new.html index d89ebfbf118475e28da45d6f3fa749f1e3b55076..6e376156c3493daf8bf542d792410ee18c356493 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_new.html +++ b/libmongoc/1.24.2/mongoc_write_concern_new.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_fsync.html b/libmongoc/1.24.2/mongoc_write_concern_set_fsync.html index 149aacdf47b78c9bcfef7cb11b289542107dba64..e90dde4a353e222454a90bee2667328927c8c67a 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_fsync.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_fsync.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_journal.html b/libmongoc/1.24.2/mongoc_write_concern_set_journal.html index 17071cb24864c6cfe2dd88d871f7b0280905964a..723499a4f7792e41094c5bab8fc306a165932b62 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_journal.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_journal.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_w.html b/libmongoc/1.24.2/mongoc_write_concern_set_w.html index 2cbac82895dac1cda6fd0a849669716c23997e2e..194a4934c98783c32f04661ca0d48024eac0131f 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_w.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_w.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_wmajority.html b/libmongoc/1.24.2/mongoc_write_concern_set_wmajority.html index 70bdb6aacd664980eaf4882b4c6ddad345a50a28..c3c52f0ef4895b2143e4aea009fa221f37157a91 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_wmajority.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_wmajority.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_wtag.html b/libmongoc/1.24.2/mongoc_write_concern_set_wtag.html index 1bf1978f8fe2cdccfc88e1cf6e3af8f374c7d457..471cb38bcb04386f10abe4c961764e81aab3b697 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_wtag.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_wtag.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout.html b/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout.html index ed416cbc28274e4ed1172d11611c11932e452fb6..4d93fc5295d55dbc2d14882f1582f49fa90fe623 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout_int64.html b/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout_int64.html index 670145f170407772c7b62fb1184183c118bcbad7..5aed55361b7b3aef41585ab1da4b44aa4aaa4792 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout_int64.html +++ b/libmongoc/1.24.2/mongoc_write_concern_set_wtimeout_int64.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/mongoc_write_concern_t.html b/libmongoc/1.24.2/mongoc_write_concern_t.html index 55b31d0036d6870184829224b34c54c9a3401216..14356654df778b33019ffeb06aad25a934f649a3 100644 --- a/libmongoc/1.24.2/mongoc_write_concern_t.html +++ b/libmongoc/1.24.2/mongoc_write_concern_t.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/queryable-encryption.html b/libmongoc/1.24.2/queryable-encryption.html index 7fe4ca637cc2574e1e86d34b30ab835190eefba2..b62b3339e4168329b3736d533c61b5c683fbc30b 100644 --- a/libmongoc/1.24.2/queryable-encryption.html +++ b/libmongoc/1.24.2/queryable-encryption.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/search.html b/libmongoc/1.24.2/search.html index 7d48488340df1ea9e880544824a8da311fad7219..3365dab719e7eaad4317d157662aadc8bef7341a 100644 --- a/libmongoc/1.24.2/search.html +++ b/libmongoc/1.24.2/search.html @@ -43,6 +43,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/tutorial.html b/libmongoc/1.24.2/tutorial.html index cc87146c086ed7009befa93cdcbf8b82616702b9..fdba453d1e9ca65807c01dc2774fb7242e126603 100644 --- a/libmongoc/1.24.2/tutorial.html +++ b/libmongoc/1.24.2/tutorial.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.2/visual-studio-guide.html b/libmongoc/1.24.2/visual-studio-guide.html index 88865dfde68e83f988a70850435ed783efd40508..f97e026bbe633ac9ce2e9ecda08eed267927d58e 100644 --- a/libmongoc/1.24.2/visual-studio-guide.html +++ b/libmongoc/1.24.2/visual-studio-guide.html @@ -37,6 +37,12 @@ +
    + This is an outdated version of the documentation. + + See the current version of this page. +
    diff --git a/libmongoc/1.24.3/.nojekyll b/libmongoc/1.24.3/.nojekyll new file mode 100644 index 0000000000000000000000000000000000000000..19102815663d23f8b75a47e7a01965dcdc96468c --- /dev/null +++ b/libmongoc/1.24.3/.nojekyll @@ -0,0 +1 @@ +foo \ No newline at end of file diff --git a/libmongoc/1.24.3/CMakeLists.txt b/libmongoc/1.24.3/CMakeLists.txt new file mode 100644 index 0000000000000000000000000000000000000000..202daf7bc716d73f8e8ace2890c0af6889b1f658 --- /dev/null +++ b/libmongoc/1.24.3/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.3/_images/msvc-add-dependencies-static.png b/libmongoc/1.24.3/_images/msvc-add-dependencies-static.png new file mode 100644 index 0000000000000000000000000000000000000000..b70984e5b94463f3292966ed74d2fb4fc7a92343 Binary files /dev/null and b/libmongoc/1.24.3/_images/msvc-add-dependencies-static.png differ diff --git a/libmongoc/1.24.3/_images/msvc-add-dependencies.png b/libmongoc/1.24.3/_images/msvc-add-dependencies.png new file mode 100644 index 0000000000000000000000000000000000000000..3fe2c7ae74660fb2096f6442aba0972d42f77aec Binary files /dev/null and b/libmongoc/1.24.3/_images/msvc-add-dependencies.png differ diff --git a/libmongoc/1.24.3/_images/msvc-add-include-directories.png b/libmongoc/1.24.3/_images/msvc-add-include-directories.png new file mode 100644 index 0000000000000000000000000000000000000000..afd181272db5fc0d6457868e0c4849628a17a12b Binary files /dev/null and b/libmongoc/1.24.3/_images/msvc-add-include-directories.png differ diff --git a/libmongoc/1.24.3/_images/msvc-create-project.png b/libmongoc/1.24.3/_images/msvc-create-project.png new file mode 100644 index 0000000000000000000000000000000000000000..8c7f749c65be2289f93a0e5ddbc0568fe9b982ab Binary files /dev/null and b/libmongoc/1.24.3/_images/msvc-create-project.png differ diff --git a/libmongoc/1.24.3/_images/msvc-set-path.png b/libmongoc/1.24.3/_images/msvc-set-path.png new file mode 100644 index 0000000000000000000000000000000000000000..c135b1a014a61186b2873a9caf80b972d2384c5e Binary files /dev/null and b/libmongoc/1.24.3/_images/msvc-set-path.png differ diff --git a/libmongoc/1.24.3/_images/msvc-switch-architecture.png b/libmongoc/1.24.3/_images/msvc-switch-architecture.png new file mode 100644 index 0000000000000000000000000000000000000000..fdc52d1590a958d565d0a1f13aeb17f5bec62e4d Binary files /dev/null and b/libmongoc/1.24.3/_images/msvc-switch-architecture.png differ diff --git a/libmongoc/1.24.3/_static/ajax-loader.gif b/libmongoc/1.24.3/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 Binary files /dev/null and b/libmongoc/1.24.3/_static/ajax-loader.gif differ diff --git a/libmongoc/1.24.3/_static/basic.css b/libmongoc/1.24.3/_static/basic.css new file mode 100644 index 0000000000000000000000000000000000000000..19ced1057aebf39d3dac6f6a5d864491231a3e33 --- /dev/null +++ b/libmongoc/1.24.3/_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.3/_static/comment-bright.png b/libmongoc/1.24.3/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..15e27edb12ac25701ac0ac21b97b52bb4e45415e Binary files /dev/null and b/libmongoc/1.24.3/_static/comment-bright.png differ diff --git a/libmongoc/1.24.3/_static/comment-close.png b/libmongoc/1.24.3/_static/comment-close.png new file mode 100644 index 0000000000000000000000000000000000000000..4d91bcf57de866a901a89a2a68c0f36af1114841 Binary files /dev/null and b/libmongoc/1.24.3/_static/comment-close.png differ diff --git a/libmongoc/1.24.3/_static/comment.png b/libmongoc/1.24.3/_static/comment.png new file mode 100644 index 0000000000000000000000000000000000000000..dfbc0cbd512bdeefcb1984c99d8e577efb77f006 Binary files /dev/null and b/libmongoc/1.24.3/_static/comment.png differ diff --git a/libmongoc/1.24.3/_static/doctools.js b/libmongoc/1.24.3/_static/doctools.js new file mode 100644 index 0000000000000000000000000000000000000000..d8928926bf24bb081d91a12f7b92e1b2d8b142b6 --- /dev/null +++ b/libmongoc/1.24.3/_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); + $('

    ' + _('Hide Search Matches') + '

    ') + .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.3/_static/documentation_options.js b/libmongoc/1.24.3/_static/documentation_options.js new file mode 100644 index 0000000000000000000000000000000000000000..bc12cb35cdbb5228850f6e53832f07a9febac8ed --- /dev/null +++ b/libmongoc/1.24.3/_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.3/_static/down-pressed.png b/libmongoc/1.24.3/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..5756c8cad8854722893dc70b9eb4bb0400343a39 Binary files /dev/null and b/libmongoc/1.24.3/_static/down-pressed.png differ diff --git a/libmongoc/1.24.3/_static/down.png b/libmongoc/1.24.3/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..1b3bdad2ceffae91cee61b32f3295f9bbe646e48 Binary files /dev/null and b/libmongoc/1.24.3/_static/down.png differ diff --git a/libmongoc/1.24.3/_static/file.png b/libmongoc/1.24.3/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 Binary files /dev/null and b/libmongoc/1.24.3/_static/file.png differ diff --git a/libmongoc/1.24.3/_static/jquery-3.2.1.js b/libmongoc/1.24.3/_static/jquery-3.2.1.js new file mode 100644 index 0000000000000000000000000000000000000000..d2d8ca4790e52b0537f3cbb7dcd766099b789583 --- /dev/null +++ b/libmongoc/1.24.3/_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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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)

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/aggregate.html b/libmongoc/1.24.3/aggregate.html new file mode 100644 index 0000000000000000000000000000000000000000..f236c71875e21df5e52946fb6d8f96659c125a95 --- /dev/null +++ b/libmongoc/1.24.3/aggregate.html @@ -0,0 +1,335 @@ + + + + + + + + + + + + + + Aggregation Framework Examples — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/api.html b/libmongoc/1.24.3/api.html new file mode 100644 index 0000000000000000000000000000000000000000..6634dd2cf87857ef16d66206c774ed4a1950387c --- /dev/null +++ b/libmongoc/1.24.3/api.html @@ -0,0 +1,246 @@ + + + + + + + + + + + + + + API Reference — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    API Reference

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/application-performance-monitoring.html b/libmongoc/1.24.3/application-performance-monitoring.html new file mode 100644 index 0000000000000000000000000000000000000000..622da97a083669d08f21f487d92521995f2b78b4 --- /dev/null +++ b/libmongoc/1.24.3/application-performance-monitoring.html @@ -0,0 +1,709 @@ + + + + + + + + + + + + + + Application Performance Monitoring (APM) — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/authentication.html b/libmongoc/1.24.3/authentication.html new file mode 100644 index 0000000000000000000000000000000000000000..2d86801f467a1e2c676cd2351fc4b48266e2cf22 --- /dev/null +++ b/libmongoc/1.24.3/authentication.html @@ -0,0 +1,345 @@ + + + + + + + + + + + + + + Authentication — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/basic-troubleshooting.html b/libmongoc/1.24.3/basic-troubleshooting.html new file mode 100644 index 0000000000000000000000000000000000000000..c9f7157929b10768671a58a6bbd71d9c96eb5bb0 --- /dev/null +++ b/libmongoc/1.24.3/basic-troubleshooting.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + Basic Troubleshooting — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/bulk.html b/libmongoc/1.24.3/bulk.html new file mode 100644 index 0000000000000000000000000000000000000000..3caa6ab35c1419952cb35aa93376144a3bfd9c26 --- /dev/null +++ b/libmongoc/1.24.3/bulk.html @@ -0,0 +1,992 @@ + + + + + + + + + + + + + + Bulk Write Operations — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/client-side-field-level-encryption.html b/libmongoc/1.24.3/client-side-field-level-encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..dff665b8624430ad51d95aef28c0599b4eb743e1 --- /dev/null +++ b/libmongoc/1.24.3/client-side-field-level-encryption.html @@ -0,0 +1,1194 @@ + + + + + + + + + + + + + + Client-Side Field Level Encryption — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/configuring_tls.html b/libmongoc/1.24.3/configuring_tls.html new file mode 100644 index 0000000000000000000000000000000000000000..b601608579549e62fc3ebb02c63394d9359c8ad3 --- /dev/null +++ b/libmongoc/1.24.3/configuring_tls.html @@ -0,0 +1,250 @@ + + + + + + + + + + + + + + Configuring TLS — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +

    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.

      • +
    +
    +
    +
    + + +
    +
    +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/connection-pooling.html b/libmongoc/1.24.3/connection-pooling.html new file mode 100644 index 0000000000000000000000000000000000000000..9a2150d1293aecf3d457dc2181bab14af9b30dee --- /dev/null +++ b/libmongoc/1.24.3/connection-pooling.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + Connection Pooling — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/cursors.html b/libmongoc/1.24.3/cursors.html new file mode 100644 index 0000000000000000000000000000000000000000..3301a41fe2e0f484ab3ba9467a052c97a1f74c73 --- /dev/null +++ b/libmongoc/1.24.3/cursors.html @@ -0,0 +1,342 @@ + + + + + + + + + + + + + + Cursors — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_cursor_set_max_await_time_ms().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/debugging.html b/libmongoc/1.24.3/debugging.html new file mode 100644 index 0000000000000000000000000000000000000000..789bd3ef08e8cec0d51f61f3c169617c1ed5acda --- /dev/null +++ b/libmongoc/1.24.3/debugging.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + Aids for Debugging — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/distinct-mapreduce.html b/libmongoc/1.24.3/distinct-mapreduce.html new file mode 100644 index 0000000000000000000000000000000000000000..fa40379bf152dc08de4d9aa8074424270b8ac58e --- /dev/null +++ b/libmongoc/1.24.3/distinct-mapreduce.html @@ -0,0 +1,580 @@ + + + + + + + + + + + + + + “distinct” and “mapReduce” — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    “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 }
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/errors.html b/libmongoc/1.24.3/errors.html new file mode 100644 index 0000000000000000000000000000000000000000..a4fb3189e9cef8f95ef4d004d072f79fe25d3e25 --- /dev/null +++ b/libmongoc/1.24.3/errors.html @@ -0,0 +1,361 @@ + + + + + + + + + + + + + + Error Reporting — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +

    « 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

    +
    +
    Handling Errors in libbson.
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    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

    +
    +
    MongoDB Server Error Codes
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/full_index.html b/libmongoc/1.24.3/full_index.html new file mode 100644 index 0000000000000000000000000000000000000000..2a3d571b6745b5cf603a5ee40ad1589085083036 --- /dev/null +++ b/libmongoc/1.24.3/full_index.html @@ -0,0 +1,940 @@ + + + + + + + + + + + + + + Index — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Index

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/gridfs.html b/libmongoc/1.24.3/gridfs.html new file mode 100644 index 0000000000000000000000000000000000000000..60a60a9aa07a7daacd0c1f952973bf1d5cd298a7 --- /dev/null +++ b/libmongoc/1.24.3/gridfs.html @@ -0,0 +1,187 @@ + + + + + + + + + + + + + + GridFS — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/guides.html b/libmongoc/1.24.3/guides.html new file mode 100644 index 0000000000000000000000000000000000000000..eeaa61c897241a9ef9a0d3f1066a127f3b1ae7df --- /dev/null +++ b/libmongoc/1.24.3/guides.html @@ -0,0 +1,150 @@ + + + + + + + + + + + + + + Guides — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    Guides

    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/in-use-encryption.html b/libmongoc/1.24.3/in-use-encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..9cee1310b8fa61edf6c7072142d5243fd0be003b --- /dev/null +++ b/libmongoc/1.24.3/in-use-encryption.html @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + In-Use Encryption — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/index.html b/libmongoc/1.24.3/index.html new file mode 100644 index 0000000000000000000000000000000000000000..57ba195dfdcbe770b958e78079910c20a8882029 --- /dev/null +++ b/libmongoc/1.24.3/index.html @@ -0,0 +1,287 @@ + + + + + + + + + + + + + + libmongoc — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + +
    + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/init-cleanup.html b/libmongoc/1.24.3/init-cleanup.html new file mode 100644 index 0000000000000000000000000000000000000000..23e1e999899a69a27fce2ead8b373b99fbaecca5 --- /dev/null +++ b/libmongoc/1.24.3/init-cleanup.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + Initialization and cleanup — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/installing.html b/libmongoc/1.24.3/installing.html new file mode 100644 index 0000000000000000000000000000000000000000..7b71700b513be330fcfb83a0fe3245c980580ef4 --- /dev/null +++ b/libmongoc/1.24.3/installing.html @@ -0,0 +1,370 @@ + + + + + + + + + + + + + + Installing the MongoDB C Driver (libmongoc) and BSON library (libbson) — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.3/mongo-c-driver-1.24.3.tar.gz
+$ tar xzf mongo-c-driver-1.24.3.tar.gz
+$ cd mongo-c-driver-1.24.3
+$ 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.3/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.3  # 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.3
+$ 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).

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/lifecycle.html b/libmongoc/1.24.3/lifecycle.html new file mode 100644 index 0000000000000000000000000000000000000000..49a81fc8efcf8c21bd47ae8f0527a20654e1ce3a --- /dev/null +++ b/libmongoc/1.24.3/lifecycle.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + Object Lifecycle — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/logging.html b/libmongoc/1.24.3/logging.html new file mode 100644 index 0000000000000000000000000000000000000000..6bdd4eb3b2828fe7d49849b32d947f973d519e26 --- /dev/null +++ b/libmongoc/1.24.3/logging.html @@ -0,0 +1,297 @@ + + + + + + + + + + + + + + Logging — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/manage-collection-indexes.html b/libmongoc/1.24.3/manage-collection-indexes.html new file mode 100644 index 0000000000000000000000000000000000000000..99961e8d80ba1764b0e04b6a0bdcfe7b1a028e37 --- /dev/null +++ b/libmongoc/1.24.3/manage-collection-indexes.html @@ -0,0 +1,182 @@ + + + + + + + + + + + + + + Manage Collection Indexes — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc-common-task-examples.html b/libmongoc/1.24.3/mongoc-common-task-examples.html new file mode 100644 index 0000000000000000000000000000000000000000..92876b3dd2686acec52c4daba1da03d2e6b41c41 --- /dev/null +++ b/libmongoc/1.24.3/mongoc-common-task-examples.html @@ -0,0 +1,431 @@ + + + + + + + + + + + + + + Common Tasks — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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"
+   }
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_callbacks_destroy.html b/libmongoc/1.24.3/mongoc_apm_callbacks_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5c27a5c474f70834707758613b3f121af0a5a37a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_callbacks_destroy.html @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + mongoc_apm_callbacks_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_callbacks_destroy()

    +
    +

    Synopsis

    +
    void
+mongoc_apm_callbacks_destroy (mongoc_apm_callbacks_t *callbacks);
+
    +
    +

    Free a mongoc_apm_callbacks_t. Does nothing if callbacks is NULL.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_callbacks_new.html b/libmongoc/1.24.3/mongoc_apm_callbacks_new.html new file mode 100644 index 0000000000000000000000000000000000000000..9a5cbd9d36f2113732e2de2643bc8b5c6e3ade7a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_callbacks_new.html @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + mongoc_apm_callbacks_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_callbacks_t.html b/libmongoc/1.24.3/mongoc_apm_callbacks_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c49f7a0e192e10b68f462c836c068bc9dba6b2d2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_callbacks_t.html @@ -0,0 +1,169 @@ + + + + + + + + + + + + + + mongoc_apm_callbacks_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_callbacks_t

    +

    Notification callbacks

    +
    +

    Synopsis

    +

    Used to receive notification of events, such as when a MongoDB command begins, succeeds, or fails.

    +

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

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_command_name.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_command_name.html new file mode 100644 index 0000000000000000000000000000000000000000..d38ba10058083a582871a29162fb91b292d1286b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_command_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_command_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_context.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..8afb14e5b0055b94f580dc761730a6cb8f880a56 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_command_failed_get_context (
+   const mongoc_apm_command_failed_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_duration.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..cc92f2d11e6825da2ca5b5b9507412014384c143 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_duration() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_error.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_error.html new file mode 100644 index 0000000000000000000000000000000000000000..4f21640541ab347769dfb4b22497f4f527842314 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_error.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_host.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..c89a8e878b9242bb3637aaeb859b3ccc8782ce3e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_operation_id.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_operation_id.html new file mode 100644 index 0000000000000000000000000000000000000000..f6d6be6d22d0987791278f84ca4dd6ca25a4084b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_operation_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_operation_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_reply.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..7c0795f989ab009b0e7362289869ca48447e8f4b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_reply.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_reply() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_request_id.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_request_id.html new file mode 100644 index 0000000000000000000000000000000000000000..bb108384e73f69a4c7d978423ee00fd5a4f00cd2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_request_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_request_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_connection_id.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_connection_id.html new file mode 100644 index 0000000000000000000000000000000000000000..2e6692340ad887c09edbe2f2e74a5ef37f878ab9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_connection_id.html @@ -0,0 +1,175 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_server_connection_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_connection_id_int64.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_connection_id_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..dcd4736814315ff93f690e4b7bdeafb099a9ce67 --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_id.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..6873ee12b71c33a24fff8d3d9b4044bd91172842 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_server_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_server_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_get_service_id.html b/libmongoc/1.24.3/mongoc_apm_command_failed_get_service_id.html new file mode 100644 index 0000000000000000000000000000000000000000..55c958f139c4fefa08fb4f7f2bedaa445a09c952 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_get_service_id.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_get_service_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_failed_t.html b/libmongoc/1.24.3/mongoc_apm_command_failed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ee683fbf5dab66dc3e448aaa56a8afda4fd3de46 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_failed_t.html @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + mongoc_apm_command_failed_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_failed_t

    +

    Command-failed event

    +
    +

    Synopsis

    +

    An event notification sent when the driver fails to execute a MongoDB command.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_command.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_command.html new file mode 100644 index 0000000000000000000000000000000000000000..c44a485db6815570fc904b597478f91e8936fec1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_command.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_command() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_command_name.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_command_name.html new file mode 100644 index 0000000000000000000000000000000000000000..33c2dbecbdb6a92dda15cf09c6d904e7eb70fdf0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_command_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_command_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_context.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..723b43ff535dfa95335c734541e4f18774bba054 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_command_started_get_context (
+   const mongoc_apm_command_started_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_database_name.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_database_name.html new file mode 100644 index 0000000000000000000000000000000000000000..0b7b11158dfd2b771282c9c474ed6a737625924d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_database_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_database_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_host.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..064087f756f69632011148bd6bd30d41c5526c9f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_operation_id.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_operation_id.html new file mode 100644 index 0000000000000000000000000000000000000000..fd6fb449327e921eb0b55f7494c119982ac16edf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_operation_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_operation_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_request_id.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_request_id.html new file mode 100644 index 0000000000000000000000000000000000000000..12fe69ee07705c99b0faed0e28e093d26a93abb3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_request_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_request_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_server_connection_id.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_server_connection_id.html new file mode 100644 index 0000000000000000000000000000000000000000..77514003e6b14fc9833cc3978a00fb307cd2349d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_server_connection_id.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_server_connection_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_server_connection_id_int64.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_server_connection_id_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..0a2fd3655bb3598488b1ace9ad902580648b44c7 --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_server_id.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..14856f077ad2ccd39401271d631fc9983ae7cd02 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_server_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_server_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_get_service_id.html b/libmongoc/1.24.3/mongoc_apm_command_started_get_service_id.html new file mode 100644 index 0000000000000000000000000000000000000000..ec5631f19da4b4f5907ed44065e00c4dda468fda --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_get_service_id.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_get_service_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_started_t.html b/libmongoc/1.24.3/mongoc_apm_command_started_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a43129ebfafb2eaee25fb3bf8127d17304ac5439 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_started_t.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + mongoc_apm_command_started_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_started_t

    +

    Command-started event

    +
    +

    Synopsis

    +

    An event notification sent when the driver begins executing a MongoDB command.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_command_name.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_command_name.html new file mode 100644 index 0000000000000000000000000000000000000000..791bbc3c3fcc0e132b2d74c25f7dabda5166b33f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_command_name.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_command_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_context.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..171f28ab2360b091a3309ac50fef16dd3a45570b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_command_succeeded_get_context (
+   const mongoc_apm_command_succeeded_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_duration.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..faeffaa20942439ea267792b7ed8f999d6c21ba3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_duration() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_host.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..cef7465e6e3d81540909dd63932049c5c45e3da9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_operation_id.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_operation_id.html new file mode 100644 index 0000000000000000000000000000000000000000..b0a63fed44995e05cf2f20161a5deb7c35d67e54 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_operation_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_operation_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_reply.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..0bbf859a73280dca338a8b0fdd4d09359414131d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_reply.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_reply() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_request_id.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_request_id.html new file mode 100644 index 0000000000000000000000000000000000000000..654aea2b38eba16b41c2564b3bc7dd9238ea0233 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_request_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_request_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_connection_id.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_connection_id.html new file mode 100644 index 0000000000000000000000000000000000000000..6bdb0889e5cebcb17ba7bbb1cc5d34ec7e720626 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_connection_id.html @@ -0,0 +1,174 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_server_connection_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_connection_id_int64.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_connection_id_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..fc92334d9c570266646956456b71b5a8b902287d --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_id.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..709f3d5769029c38841af3841828e4925a6a4885 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_server_id.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_server_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_service_id.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_service_id.html new file mode 100644 index 0000000000000000000000000000000000000000..7ad2c05af73aadd7be356ba52476fd63a71b6dc0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_get_service_id.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_get_service_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_command_succeeded_t.html b/libmongoc/1.24.3/mongoc_apm_command_succeeded_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1fbff1b5e6e263100fc1701b44711f1b34dbbe0b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_command_succeeded_t.html @@ -0,0 +1,165 @@ + + + + + + + + + + + + + + mongoc_apm_command_succeeded_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_command_succeeded_t

    +

    Command-succeeded event

    +
    +

    Synopsis

    +

    An event notification sent when the driver successfully executes a MongoDB command.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_changed_get_context.html b/libmongoc/1.24.3/mongoc_apm_server_changed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..c10fe5cdf7de0133942e688b50af5a6d6edf1a8c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_changed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_changed_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_server_changed_get_context (
+   const mongoc_apm_server_changed_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_changed_get_host.html b/libmongoc/1.24.3/mongoc_apm_server_changed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..a2bddb459586ae9c63eaba58add93a54b96e81f9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_changed_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_changed_get_new_description.html b/libmongoc/1.24.3/mongoc_apm_server_changed_get_new_description.html new file mode 100644 index 0000000000000000000000000000000000000000..0f5381513df061386028fb2f6e326e7f9763602d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_changed_get_new_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_new_description() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_changed_get_previous_description.html b/libmongoc/1.24.3/mongoc_apm_server_changed_get_previous_description.html new file mode 100644 index 0000000000000000000000000000000000000000..40fa238c9157839202aa00aa2859fcfd29689ca3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_changed_get_previous_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_previous_description() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_changed_get_topology_id.html b/libmongoc/1.24.3/mongoc_apm_server_changed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..b96a8d3f4e46f3f66d3463086a41dee98eec9849 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_changed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_get_topology_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_changed_t.html b/libmongoc/1.24.3/mongoc_apm_server_changed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..aaf8cb08cb7b008b25e2079b236d0a8192715eb9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_changed_t.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_changed_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_changed_t

    +

    Server-changed event

    +
    +

    Synopsis

    +

    An event notification sent when the driver observes a change in status of a server it is connected to.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_closed_get_context.html b/libmongoc/1.24.3/mongoc_apm_server_closed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..15473483a4f36cc179877c50075f75e143951df4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_closed_get_context.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_closed_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_server_closed_get_context (const mongoc_apm_server_closed_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_closed_get_host.html b/libmongoc/1.24.3/mongoc_apm_server_closed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..58935e2eff4ba23ffeb7cbdebd52d3b20ea185a1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_closed_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_closed_get_topology_id.html b/libmongoc/1.24.3/mongoc_apm_server_closed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..7f939a00280fec040483e39cf35c45a38090baa4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_closed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_get_topology_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_closed_t.html b/libmongoc/1.24.3/mongoc_apm_server_closed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..12243e4e634e30c01cc7e4f635c031bcb29034ae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_closed_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_server_closed_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_closed_t

    +

    Server-closed event

    +
    +

    Synopsis

    +

    An event notification sent when the driver stops monitoring a server and removes its mongoc_server_description_t.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_awaited.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_awaited.html new file mode 100644 index 0000000000000000000000000000000000000000..8c8cc6d073b70aa016d3c09e0c4739e109340f00 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_awaited.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_awaited() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_context.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..b96938ee720643eddf82b0502512152d5a0e9f58 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_failed_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_server_heartbeat_failed_get_context (
+   const mongoc_apm_server_heartbeat_failed_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_duration.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..5b54bc19426e26186000b3ae318b7ba8f691ded6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_duration() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_error.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_error.html new file mode 100644 index 0000000000000000000000000000000000000000..843bf2d2a6c33f2f71496d2d841c30397a829872 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_error.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_host.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..44065a12a6598afd53679ed61a1343cea88ae5d8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_t.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1bf41dad1c7161102aad472ce6425678315a592a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_failed_t.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_failed_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_failed_t

    +

    Heartbeat-failed event

    +
    +

    Synopsis

    +

    An event notification sent when the driver failed to send a “hello” command to check the status of a server.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_awaited.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_awaited.html new file mode 100644 index 0000000000000000000000000000000000000000..12079b1bad85e29f8233797ed2ae2a509848a7d6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_awaited.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_get_awaited() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_context.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..18e8a81df8bb45d24f3f60d647a696d36a93bd3d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_started_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_server_heartbeat_started_get_context (
+   const mongoc_apm_server_heartbeat_started_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_host.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..84fa89e60adaa7ae80ff7aeb0ad153d6286ad146 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_t.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_t.html new file mode 100644 index 0000000000000000000000000000000000000000..adfd49c8635ee4be446bd84e2f9f268dc71c8cd6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_started_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_started_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_started_t

    +

    Heartbeat-started event

    +
    +

    Synopsis

    +

    An event notification sent when the driver begins executing a “hello” command to check the status of a server.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_awaited.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_awaited.html new file mode 100644 index 0000000000000000000000000000000000000000..3edc53fe30f7f63c855083fe83c1cbb2aa682528 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_awaited.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_awaited() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_context.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..564b722107280ec3b377f3c343bc0bb9d02812c7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_succeeded_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_server_heartbeat_succeeded_get_context (
+   const mongoc_apm_server_heartbeat_succeeded_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_duration.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_duration.html new file mode 100644 index 0000000000000000000000000000000000000000..a6b3ed70cc16075e80edb90aaa5eb1238111c47d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_duration.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_duration() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_host.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..a10acb879357de5c629e845f9cd2162f8fa2a9ab --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_host.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_reply.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..c7d3bb4c024f5e5d1b8dbadad15159a17407764d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_get_reply.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_get_reply() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_t.html b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_t.html new file mode 100644 index 0000000000000000000000000000000000000000..928420598ea5fea0c45661e87e44acb187d5bd5f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_heartbeat_succeeded_t.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_server_heartbeat_succeeded_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_heartbeat_succeeded_t

    +

    Heartbeat-succeeded event

    +
    +

    Synopsis

    +

    An event notification sent when the driver completes a “hello” command to check the status of a server.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_opening_get_context.html b/libmongoc/1.24.3/mongoc_apm_server_opening_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..58f3d6121ad58495c14d1a821914c7937b37c0d5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_opening_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_opening_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_server_opening_get_context (
+   const mongoc_apm_server_opening_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_opening_get_host.html b/libmongoc/1.24.3/mongoc_apm_server_opening_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..ca18e6197d340cfecc4b91abb237d376fd69c233 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_opening_get_host.html @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_opening_get_topology_id.html b/libmongoc/1.24.3/mongoc_apm_server_opening_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..3f8bc0e4964ddb14d3119fe3db9a5d6914627349 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_opening_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_get_topology_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_server_opening_t.html b/libmongoc/1.24.3/mongoc_apm_server_opening_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3bf701cb468ed848b7cb5d8340600aff4e9e89b9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_server_opening_t.html @@ -0,0 +1,157 @@ + + + + + + + + + + + + + + mongoc_apm_server_opening_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_server_opening_t

    +

    Server-opening event

    +
    +

    Synopsis

    +

    An event notification sent when the driver adds a mongoc_server_description_t for a new server it was not monitoring before.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_command_failed_cb.html b/libmongoc/1.24.3/mongoc_apm_set_command_failed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..c6f98663dbd78ae04155ef9e36028d3e34185248 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_command_failed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_command_failed_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_command_started_cb.html b/libmongoc/1.24.3/mongoc_apm_set_command_started_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..984eb8a9ef0691b934e38987cbfc2cd9a036fefd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_command_started_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_command_started_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_command_succeeded_cb.html b/libmongoc/1.24.3/mongoc_apm_set_command_succeeded_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..2c283ee32d7782ce1345793344e9bbe1b7fda19d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_command_succeeded_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_command_succeeded_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_server_changed_cb.html b/libmongoc/1.24.3/mongoc_apm_set_server_changed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..73df9e3c92c6759ac71e0805d5a6738e08711015 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_server_changed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_changed_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_server_closed_cb.html b/libmongoc/1.24.3/mongoc_apm_set_server_closed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..00bde41d161d6d140c60bc375d06677007e7aa49 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_server_closed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_closed_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_failed_cb.html b/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_failed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..4f4fcc89c5a05d3bff39d178793ee13aaa377d9a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_failed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_heartbeat_failed_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_started_cb.html b/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_started_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..7f688b4a0ecb9f507f35d041092c2e9e49b31f8c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_started_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_heartbeat_started_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_succeeded_cb.html b/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_succeeded_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..3da948fbb0219ec4e52d27f586cb6bb6d0de083a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_server_heartbeat_succeeded_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_heartbeat_succeeded_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_server_opening_cb.html b/libmongoc/1.24.3/mongoc_apm_set_server_opening_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..2c7024d40798536f71ecc5370bae9f74cf3d7fa7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_server_opening_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_server_opening_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_topology_changed_cb.html b/libmongoc/1.24.3/mongoc_apm_set_topology_changed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..9712bbc7afb6a61bc8bcc3292c43fdf6ccb41e49 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_topology_changed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_topology_changed_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_topology_closed_cb.html b/libmongoc/1.24.3/mongoc_apm_set_topology_closed_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..b75298e03157ce01ed998e8509a9b81cf2a94f4e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_topology_closed_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_topology_closed_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_set_topology_opening_cb.html b/libmongoc/1.24.3/mongoc_apm_set_topology_opening_cb.html new file mode 100644 index 0000000000000000000000000000000000000000..e4b9f56f5fae4ba31d942192757fb8520e8fd32a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_set_topology_opening_cb.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_set_topology_opening_cb() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_changed_get_context.html b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..1307a3be939ae9482009a86b6306e51c43e96a5f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_changed_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_topology_changed_get_context (
+   const mongoc_apm_topology_changed_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_changed_get_new_description.html b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_new_description.html new file mode 100644 index 0000000000000000000000000000000000000000..1c857a960cda00a11189dfe4b7cd2b07f0af1561 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_new_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_new_description() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_changed_get_previous_description.html b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_previous_description.html new file mode 100644 index 0000000000000000000000000000000000000000..466f47425a6704340cca07cdee5e0f69bc4f1697 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_previous_description.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_previous_description() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_changed_get_topology_id.html b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..4dc61e9405dae66a828497c65b2210a6f77f20c0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_changed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_get_topology_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_changed_t.html b/libmongoc/1.24.3/mongoc_apm_topology_changed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..b39e5a4e2e0a83adca330cb6a489fd7cef4920c9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_changed_t.html @@ -0,0 +1,158 @@ + + + + + + + + + + + + + + mongoc_apm_topology_changed_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_changed_t

    +

    Topology-changed event

    +
    +

    Synopsis

    +

    An event notification sent when the driver observes a change in any of the servers it is connected to or a change in the overall server topology.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_closed_get_context.html b/libmongoc/1.24.3/mongoc_apm_topology_closed_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..e505c4c2a3d33b007dcfaac04e617a42784bbd16 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_closed_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_closed_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_closed_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_topology_closed_get_context (
+   const mongoc_apm_topology_closed_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_closed_get_topology_id.html b/libmongoc/1.24.3/mongoc_apm_topology_closed_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..a07b6ad148d3ab9eb26cddc609faa13968752341 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_closed_get_topology_id.html @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + mongoc_apm_topology_closed_get_topology_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_closed_t.html b/libmongoc/1.24.3/mongoc_apm_topology_closed_t.html new file mode 100644 index 0000000000000000000000000000000000000000..afdde0364d68eed28d845eebb2b6edd16d8923ae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_closed_t.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + mongoc_apm_topology_closed_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_closed_t

    +

    Topology-closed event

    +
    +

    Synopsis

    +

    An event notification sent when the driver stops monitoring a server topology and destroys its mongoc_topology_description_t.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_opening_get_context.html b/libmongoc/1.24.3/mongoc_apm_topology_opening_get_context.html new file mode 100644 index 0000000000000000000000000000000000000000..6ce8fd1f1106172b9a847cdc6a8b6dd4768127fd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_opening_get_context.html @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + mongoc_apm_topology_opening_get_context() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_opening_get_context()

    +
    +

    Synopsis

    +
    void *
+mongoc_apm_topology_opening_get_context (
+   const mongoc_apm_topology_opening_t *event);
+
    +
    +

    Returns this event’s context.

    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    The pointer passed with mongoc_client_set_apm_callbacks() or mongoc_client_pool_set_apm_callbacks().

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_opening_get_topology_id.html b/libmongoc/1.24.3/mongoc_apm_topology_opening_get_topology_id.html new file mode 100644 index 0000000000000000000000000000000000000000..7f11c7826e82e0d59129e8fdab12ab02476ce404 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_opening_get_topology_id.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + mongoc_apm_topology_opening_get_topology_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_apm_topology_opening_t.html b/libmongoc/1.24.3/mongoc_apm_topology_opening_t.html new file mode 100644 index 0000000000000000000000000000000000000000..8ddd2c83a16abd7bbb5e9194a7815e922c61e41d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_apm_topology_opening_t.html @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + mongoc_apm_topology_opening_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_apm_topology_opening_t

    +

    Topology-opening event

    +
    +

    Synopsis

    +

    An event notification sent when the driver initializes a mongoc_topology_description_t.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_destroy.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..cf79af023b645c9efe9cf60fcb99c3b781ec9578 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_destroy.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_auto_encryption_opts_new()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_new.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..646b14ba67164d2425a354ec99d897ab04427f19 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_new.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_auto_encryption_opts_destroy()
    +
    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..3a5afd851f5497878cc753c5cd339c59ec3cc0a9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_bypass_auto_encryption.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_bypass_auto_encryption() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_bypass_query_analysis.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_bypass_query_analysis.html new file mode 100644 index 0000000000000000000000000000000000000000..e5b7ad5175710e13302fb7be39d5430ecbcabdf8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_bypass_query_analysis.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_bypass_query_analysis() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_encrypted_fields_map.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_encrypted_fields_map.html new file mode 100644 index 0000000000000000000000000000000000000000..28f327e4104da77de1b4a94674dac79d8add47a4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_encrypted_fields_map.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_encrypted_fields_map() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_extra.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_extra.html new file mode 100644 index 0000000000000000000000000000000000000000..0a3ddcc755045125e8eb11556403a68c0d73f317 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_extra.html @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_extra() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    MongoDB Manual documentation for crypt_shared: Automatic Encryption Shared Library
    +
    +
    +
    MongoDB Manual documentation for mongocryptd: Install and Configure mongocryptd
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_client.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_client.html new file mode 100644 index 0000000000000000000000000000000000000000..802731b63ba58f64fa5923e13cfbfb0ff4e10890 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_client.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_keyvault_client() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    mongoc_auto_encryption_opts_set_keyvault_client_pool()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_client_pool.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_client_pool.html new file mode 100644 index 0000000000000000000000000000000000000000..3d43ff15c4a48c1fda364d1970c9e9a89482c742 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_client_pool.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_keyvault_client_pool() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_pool_enable_auto_encryption()
    +
    +
    +
    mongoc_auto_encryption_opts_set_keyvault_client()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_namespace.html new file mode 100644 index 0000000000000000000000000000000000000000..b616ab5fa8713c9a4f3cb7c251bc97201a8e4881 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_keyvault_namespace.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_keyvault_namespace() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_kms_credential_provider_callback.html new file mode 100644 index 0000000000000000000000000000000000000000..74bc20ab51e5c911e5e58da559e6a9912152c0da --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +

    See also

    +

    mongoc_client_encryption_opts_set_kms_credential_provider_callback ()

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_kms_providers.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_kms_providers.html new file mode 100644 index 0000000000000000000000000000000000000000..b150017448e9afd543e93190f4961698bc31e78e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_kms_providers.html @@ -0,0 +1,245 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_kms_providers() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_schema_map.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_schema_map.html new file mode 100644 index 0000000000000000000000000000000000000000..1e66c2be1effe20ef867519517c18214cd4ad1cb --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_schema_map.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_schema_map() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_tls_opts.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_tls_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..6047c66318842877af6f085e944967393b2377d5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_set_tls_opts.html @@ -0,0 +1,237 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_set_tls_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_auto_encryption_opts_t.html b/libmongoc/1.24.3/mongoc_auto_encryption_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..8e6da87c378e70d1ada81880f0944e170461a405 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_auto_encryption_opts_t.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_auto_encryption_opts_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_auto_encryption_opts_t

    +

    Options for enabling automatic encryption and decryption for In-Use Encryption.

    +
    +

    Synopsis

    +
    typedef struct _mongoc_auto_encryption_opts_t mongoc_auto_encryption_opts_t;
+
    +
    +
    +

    See also

    +
    +
    In-Use Encryption
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_delete.html b/libmongoc/1.24.3/mongoc_bulk_operation_delete.html new file mode 100644 index 0000000000000000000000000000000000000000..e1f9448bd1d5af6e1cb22bcbc656b4a345060626 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_delete.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_delete() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove_many_with_opts()
    +
    +
    +
    mongoc_bulk_operation_remove_one_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_delete_one.html b/libmongoc/1.24.3/mongoc_bulk_operation_delete_one.html new file mode 100644 index 0000000000000000000000000000000000000000..c7339e9e067e4772b7f44b98084af71241c29191 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_delete_one.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_delete_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove_one_with_opts()
    +
    +
    +
    mongoc_bulk_operation_remove_many_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_destroy.html b/libmongoc/1.24.3/mongoc_bulk_operation_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..acf38794ba4fdbeb910ca99cd98169545397b90c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_execute.html b/libmongoc/1.24.3/mongoc_bulk_operation_execute.html new file mode 100644 index 0000000000000000000000000000000000000000..311e068f6e86fc9f3029a0370d227fed29fd95f1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_execute.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_execute() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Bulk Write Operations
    +
    +
    +
    mongoc_bulk_operation_get_hint(), which gets the id of the server used even if the operation failed.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_get_hint.html b/libmongoc/1.24.3/mongoc_bulk_operation_get_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..d04aea54c7829fa406ec7d8c6abaa4846ded56f9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_get_hint.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_get_hint() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_get_write_concern.html b/libmongoc/1.24.3/mongoc_bulk_operation_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..e351ac19b205d20def4e0e1eb5e0882f2f539e7a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_get_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_get_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_insert.html b/libmongoc/1.24.3/mongoc_bulk_operation_insert.html new file mode 100644 index 0000000000000000000000000000000000000000..ab464a9d89b63f050425b9421b8ac50cd22c71f3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_insert.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_insert() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Bulk Write Operations
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_insert_with_opts.html b/libmongoc/1.24.3/mongoc_bulk_operation_insert_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..894c170e1b87a11810fc6bff04fd2603f26f7c54 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_insert_with_opts.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_insert_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_remove.html b/libmongoc/1.24.3/mongoc_bulk_operation_remove.html new file mode 100644 index 0000000000000000000000000000000000000000..4cd8e0c38239615146f15ec985911b58888a5d06 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_remove.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove_one()
    +
    +
    +
    mongoc_bulk_operation_remove_one_with_opts()
    +
    +
    +
    mongoc_bulk_operation_remove_many_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_remove_many_with_opts.html b/libmongoc/1.24.3/mongoc_bulk_operation_remove_many_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..6a42f6effeea94b6e9260450bf862baaad4967f2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_remove_many_with_opts.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove_many_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove()
    +
    +
    +
    mongoc_bulk_operation_remove_one_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_remove_one.html b/libmongoc/1.24.3/mongoc_bulk_operation_remove_one.html new file mode 100644 index 0000000000000000000000000000000000000000..8d7d1001ad060859d8d3b187fe96123c3b1d048e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_remove_one.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove_one_with_opts()
    +
    +
    +
    mongoc_bulk_operation_remove_many_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_remove_one_with_opts.html b/libmongoc/1.24.3/mongoc_bulk_operation_remove_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..af48482010498932892dab16631b016b9b96a436 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_remove_one_with_opts.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_remove_one_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove_one()
    +
    +
    +
    mongoc_bulk_operation_remove_many_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_replace_one.html b/libmongoc/1.24.3/mongoc_bulk_operation_replace_one.html new file mode 100644 index 0000000000000000000000000000000000000000..da79f9f4f821bdbb8539ab8ce50dc16d7b568ace --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_replace_one.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_replace_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_replace_one_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_replace_one_with_opts.html b/libmongoc/1.24.3/mongoc_bulk_operation_replace_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..caf9dfd3f346141675ffbbd7971df347dfca92a8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_replace_one_with_opts.html @@ -0,0 +1,233 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_replace_one_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_remove_many_with_opts()
    +
    +
    +
    mongoc_bulk_operation_insert()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_set_bypass_document_validation.html b/libmongoc/1.24.3/mongoc_bulk_operation_set_bypass_document_validation.html new file mode 100644 index 0000000000000000000000000000000000000000..a6cbbc392acad861e89e2d05e74bc291b99d4414 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_set_bypass_document_validation.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_bypass_document_validation() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Bulk Operation Bypassing Document Validation
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_set_client_session.html b/libmongoc/1.24.3/mongoc_bulk_operation_set_client_session.html new file mode 100644 index 0000000000000000000000000000000000000000..0184184c7b92dc2614bb1d02d0c2616c82038deb --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_set_client_session.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_client_session() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_start_session()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_set_comment.html b/libmongoc/1.24.3/mongoc_bulk_operation_set_comment.html new file mode 100644 index 0000000000000000000000000000000000000000..c06a0d723da69701076c3e5d32400e5eaec892d3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_set_comment.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_comment() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_set_hint.html b/libmongoc/1.24.3/mongoc_bulk_operation_set_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..dc9e4cd3d76c8314427f3a879df04bede8440c13 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_set_hint.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_hint() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_set_let.html b/libmongoc/1.24.3/mongoc_bulk_operation_set_let.html new file mode 100644 index 0000000000000000000000000000000000000000..b3a5f281502142565403b0401d67892df5539085 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_set_let.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_set_let() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_t.html b/libmongoc/1.24.3/mongoc_bulk_operation_t.html new file mode 100644 index 0000000000000000000000000000000000000000..68ea6c5b1dbeba28a76ebc08c6f78e5e72934757 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_t.html @@ -0,0 +1,232 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Bulk Write Operations
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_update.html b/libmongoc/1.24.3/mongoc_bulk_operation_update.html new file mode 100644 index 0000000000000000000000000000000000000000..9823642d326a1da8bc8986e940e33a7b103f003d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_update.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_update_one_with_opts()
    +
    +
    +
    mongoc_bulk_operation_update_many_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_update_many_with_opts.html b/libmongoc/1.24.3/mongoc_bulk_operation_update_many_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..c4c0c195981e2f14feb1a18694354089ef15496f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_update_many_with_opts.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update_many_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_update_one_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_update_one.html b/libmongoc/1.24.3/mongoc_bulk_operation_update_one.html new file mode 100644 index 0000000000000000000000000000000000000000..f3e32b481a3f176ba63579ea02d4f6d252ca4dd0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_update_one.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +

    See also

    +
    +
    mongoc_bulk_operation_update()
    +
    +
    +
    mongoc_bulk_operation_update_one_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_bulk_operation_update_one_with_opts.html b/libmongoc/1.24.3/mongoc_bulk_operation_update_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..ad3e48e73056703e1345d251830d526422058b86 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_bulk_operation_update_one_with_opts.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_bulk_operation_update_one_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_bulk_operation_update_many_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_change_stream_destroy.html b/libmongoc/1.24.3/mongoc_change_stream_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..40e5dfcb094cc8c840b61269c30551436c975b3a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_change_stream_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_change_stream_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_change_stream_destroy()

    +
    +

    Synopsis

    +
    void
+mongoc_change_stream_destroy (mongoc_change_stream_t *stream);
+
    +
    +

    Destroys a change stream and associated data.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_change_stream_error_document.html b/libmongoc/1.24.3/mongoc_change_stream_error_document.html new file mode 100644 index 0000000000000000000000000000000000000000..acc20fb84452902f8f881e3e5339264d311e1c87 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_change_stream_error_document.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_change_stream_error_document() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_change_stream_get_resume_token.html b/libmongoc/1.24.3/mongoc_change_stream_get_resume_token.html new file mode 100644 index 0000000000000000000000000000000000000000..3f65a48f18b1e0f8cb7e1d00f2a5427593a5d6f6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_change_stream_get_resume_token.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_change_stream_get_resume_token() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_change_stream_next.html b/libmongoc/1.24.3/mongoc_change_stream_next.html new file mode 100644 index 0000000000000000000000000000000000000000..c99c72ea203ec6693a6c6ecb0531c9b989a5b9da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_change_stream_next.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_change_stream_next() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_change_stream_t.html b/libmongoc/1.24.3/mongoc_change_stream_t.html new file mode 100644 index 0000000000000000000000000000000000000000..8262be9eefd839a98f1869226a93f9307fe1fb77 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_change_stream_t.html @@ -0,0 +1,578 @@ + + + + + + + + + + + + + + mongoc_change_stream_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_check_version.html b/libmongoc/1.24.3/mongoc_check_version.html new file mode 100644 index 0000000000000000000000000000000000000000..4f9916b1fc402a38c76ff1063d10b954d24182bf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_check_version.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_check_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cleanup.html b/libmongoc/1.24.3/mongoc_cleanup.html new file mode 100644 index 0000000000000000000000000000000000000000..1bda988235e2c60c8665f84f519328671dc14baf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cleanup.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_cleanup() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_command.html b/libmongoc/1.24.3/mongoc_client_command.html new file mode 100644 index 0000000000000000000000000000000000000000..47ffd3d555b25a7ad7fa24f2e06fa8c0cece6409 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_command.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_client_command() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_command_simple.html b/libmongoc/1.24.3/mongoc_client_command_simple.html new file mode 100644 index 0000000000000000000000000000000000000000..87ee02c5bb045644fd1c2b15c87df34f8f140798 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_command_simple.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_client_command_simple() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_command_simple_with_server_id.html b/libmongoc/1.24.3/mongoc_client_command_simple_with_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..5490f9bcc9f63aed886fa815e1ab3b10c779e27e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_command_simple_with_server_id.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_command_simple_with_server_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_command_with_opts.html b/libmongoc/1.24.3/mongoc_client_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4de0758bd9a4f504423a757ead43bad7ba5c5086 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_command_with_opts.html @@ -0,0 +1,259 @@ + + + + + + + + + + + + + + mongoc_client_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_destroy.html b/libmongoc/1.24.3/mongoc_client_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..86911ceb6a08cb06b8b1f6d7c26e2bd85a83a8ef --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_destroy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_client_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_enable_auto_encryption.html b/libmongoc/1.24.3/mongoc_client_enable_auto_encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..828602a9e6486e1a046e88152a565eded888d153 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_enable_auto_encryption.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_client_enable_auto_encryption() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_auto_encryption_opts_t
    +
    +
    +
    mongoc_client_pool_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption for libmongoc
    +
    +
    +
    The MongoDB Manual for Client-Side Field Level Encryption
    +
    +
    +
    The MongoDB Manual for Queryable Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_add_key_alt_name.html b/libmongoc/1.24.3/mongoc_client_encryption_add_key_alt_name.html new file mode 100644 index 0000000000000000000000000000000000000000..dbe7c06bed5d1d5cbeec4089f71bcee4d882f85e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_add_key_alt_name.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_client_encryption_add_key_alt_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_client_encryption_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_create_datakey.html b/libmongoc/1.24.3/mongoc_client_encryption_create_datakey.html new file mode 100644 index 0000000000000000000000000000000000000000..23454e0f6d3b697562a7b1466778d51f42a86c67 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_create_datakey.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_client_encryption_create_datakey() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_datakey_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_create_encrypted_collection.html b/libmongoc/1.24.3/mongoc_client_encryption_create_encrypted_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..4e4ff6842bf516bc8985a2205750789ff4ed1973 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_create_encrypted_collection.html @@ -0,0 +1,270 @@ + + + + + + + + + + + + + + mongoc_client_encryption_create_encrypted_collection() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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. +

    2. 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. +

      2. The ID of \(K_f\) will be used to replace the "keyId": null element +within \(F\).

        3. +
      +
      3. +

    3. A collection will be created using the options \(O\).

      4. +

    4. If out_options is not NULL, \(O\) will be written to +out_options.

      5. +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_destroy.html b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..ed3fe8133638a8542a6bb2fa65afbcb0d0f5e7c8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_new.html b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..5eab5a0e8f0d8b00658cf34c7f40ec099304efae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_keyaltnames.html b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_keyaltnames.html new file mode 100644 index 0000000000000000000000000000000000000000..db2657c7a96821adc2861b63170010b2afdbc1ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_keyaltnames.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_set_keyaltnames() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_opts_set_keyaltname()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_keymaterial.html b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_keymaterial.html new file mode 100644 index 0000000000000000000000000000000000000000..c7ab588ffcb6bf5ca32a6c13b43e0b09be9595e6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_keymaterial.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_set_keymaterial() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_masterkey.html b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_masterkey.html new file mode 100644 index 0000000000000000000000000000000000000000..32c7c4f58bc80c1bd1140721bf707de595c6196b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_set_masterkey.html @@ -0,0 +1,239 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_set_masterkey() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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. */
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_t.html b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..24412d43e586aeeaa175de6a9a9e5a1425a44369 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_datakey_opts_t.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_encryption_datakey_opts_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_encryption_create_datakey()
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_decrypt.html b/libmongoc/1.24.3/mongoc_client_encryption_decrypt.html new file mode 100644 index 0000000000000000000000000000000000000000..3ce21a71c0cbf4cab0138d9e2ab59cb99adf2f26 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_decrypt.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_decryption_decrypt() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    mongoc_client_encryption_encrypt()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_delete_key.html b/libmongoc/1.24.3/mongoc_client_encryption_delete_key.html new file mode 100644 index 0000000000000000000000000000000000000000..ea31097579719f234584539a08aab6275430c2e0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_delete_key.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_encryption_delete_key() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_t
    +
    mongoc_client_encryption_create_datakey()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_destroy.html b/libmongoc/1.24.3/mongoc_client_encryption_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5a4732ee599b128e809cd2318decc14c3bccf990 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_destroy.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_client_encryption_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt.html new file mode 100644 index 0000000000000000000000000000000000000000..9ae7f5927cec6124b819f3d74697958baffe3c62 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_opts_t
    +
    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    mongoc_client_decryption_decrypt()
    +
    +
    +
    mongoc_client_encryption_encrypt_expression()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_expression.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_expression.html new file mode 100644 index 0000000000000000000000000000000000000000..43ff22fae095018236a8213e5cf312fa4cfd495b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_expression.html @@ -0,0 +1,257 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_expression() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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. +

    2. 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>"]}]
+
      +
      +
      3. +
    +
    +
    +

    Parameters

    + +
    +
    +

    Returns

    +

    Returns true if successful. Returns false and sets error otherwise.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_opts_t
    +
    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    mongoc_client_decryption_decrypt()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_destroy.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..43717acc66994c88f4badfd530979bf96eeed910 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_new.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..7ce7ddb8c060094c55eb36d5090eda7502f8d704 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_algorithm.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_algorithm.html new file mode 100644 index 0000000000000000000000000000000000000000..37b7d80bbd69a36d24a91ecbfb06e0f309c94f4a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_algorithm.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_algorithm() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_contention_factor.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_contention_factor.html new file mode 100644 index 0000000000000000000000000000000000000000..77bf58c0a627f8033b9e5ac247c8a66b136d272e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_contention_factor.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_contention_factor() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_keyaltname.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_keyaltname.html new file mode 100644 index 0000000000000000000000000000000000000000..19f8abddaa9a25f0205834854ac3c389e6eaf30b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_keyaltname.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_keyaltname() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_opts_set_keyid()
    +
    +
    +
    mongoc_client_encryption_datakey_opts_set_keyaltnames()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_keyid.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_keyid.html new file mode 100644 index 0000000000000000000000000000000000000000..c6a4fc0d8139e3ffa9b1008e733e4475f3b47c6e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_keyid.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_keyid() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_opts_set_keyaltname()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_query_type.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_query_type.html new file mode 100644 index 0000000000000000000000000000000000000000..d0f15644b3945bd415c71117a599b23cb9c5f37f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_query_type.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_query_type() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_range_opts.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_range_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..3569863c4bea239890bcc87e0b986f34ad6c9f38 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_set_range_opts.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_set_range_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_new()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_t.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2aa2234ccf493e5faa4ac14c851029e07f6ffabf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_opts_t.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_opts_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_encrypt_opts_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_encryption_encrypt_opts_t mongoc_client_encryption_encrypt_opts_t;
+
    +
    +

    Used to set options for mongoc_client_encryption_encrypt().

    +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt()
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_destroy.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..1cb56232f282b7328ae828fa0e6b2a2b3578bb33 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_destroy.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_new.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..03b11e0c6e6dd3ee58e8ebe140029a25ff81322b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_new.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_t
    +
    mongoc_client_encryption_encrypt_range_opts_destroy()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_max.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_max.html new file mode 100644 index 0000000000000000000000000000000000000000..bcce63edcda8f0b355aa18f5c06711679b4271a4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_max.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_max() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_set_precision()
    +
    mongoc_client_encryption_encrypt_range_opts_set_min()
    +
    mongoc_client_encryption_encrypt_range_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_min.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_min.html new file mode 100644 index 0000000000000000000000000000000000000000..d32a295495d12bc5d8320dc4a5ef0952dfe6e5ca --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_min.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_min() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_set_precision()
    +
    mongoc_client_encryption_encrypt_range_opts_set_max()
    +
    mongoc_client_encryption_encrypt_range_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_precision.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_precision.html new file mode 100644 index 0000000000000000000000000000000000000000..05b8bc631c4316f584008e22c9d943fdf4ae8b1e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_precision.html @@ -0,0 +1,224 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_precision() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_set_min()
    +
    mongoc_client_encryption_encrypt_range_opts_set_max()
    +
    mongoc_client_encryption_encrypt_range_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html new file mode 100644 index 0000000000000000000000000000000000000000..1b1c63040afbec1a16fe90a541937e3fee1cc5e0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_set_sparsity.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_set_sparsity() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt_range_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_t.html b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7fc3366c48ce290da38e74851f4d1b3081a7686c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_encrypt_range_opts_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_client_encryption_encrypt_range_opts_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_encrypt()
    +
    mongoc_client_encryption_encrypt_opts_t
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_get_crypt_shared_version.html b/libmongoc/1.24.3/mongoc_client_encryption_get_crypt_shared_version.html new file mode 100644 index 0000000000000000000000000000000000000000..d0b7ad10f23479f6088a9b1e20b1718018921859 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_get_crypt_shared_version.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_crypt_shared_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_get_key.html b/libmongoc/1.24.3/mongoc_client_encryption_get_key.html new file mode 100644 index 0000000000000000000000000000000000000000..3bd5c2c5b9db4ebe4e2c05eefbcaa2f7c90bca63 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_get_key.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_key() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_client_encryption_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_get_key_by_alt_name.html b/libmongoc/1.24.3/mongoc_client_encryption_get_key_by_alt_name.html new file mode 100644 index 0000000000000000000000000000000000000000..84be45ef6762d666ee8d8bb760215b41eb4cbd36 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_get_key_by_alt_name.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_key_by_alt_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_client_encryption_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_get_keys.html b/libmongoc/1.24.3/mongoc_client_encryption_get_keys.html new file mode 100644 index 0000000000000000000000000000000000000000..ad3ddad9c5a2f21c360176c54dbc74b1ca1735b6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_get_keys.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_get_keys() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_client_encryption_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_new.html b/libmongoc/1.24.3/mongoc_client_encryption_new.html new file mode 100644 index 0000000000000000000000000000000000000000..9f68f144cb043bcecccfd6f77f764209744aa161 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_new.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_encryption_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_t
    +
    +
    +
    mongoc_client_encryption_opts_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_destroy.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..f901a3eba5cc35d707a70063532ebd04a26ef2ee --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_new.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..97c89f34f6f3ca860dac0f8bdb358c341dee859b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_set_keyvault_client.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_keyvault_client.html new file mode 100644 index 0000000000000000000000000000000000000000..070c089f5fb7fc7634e2f2126ca9b8159ae5a949 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_keyvault_client.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_keyvault_client() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_new()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_set_keyvault_namespace.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_keyvault_namespace.html new file mode 100644 index 0000000000000000000000000000000000000000..885b6753c3843bcd1c8ed31ee1f1daa39360d974 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_keyvault_namespace.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_keyvault_namespace() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_encryption_new()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_kms_credential_provider_callback.html new file mode 100644 index 0000000000000000000000000000000000000000..dd0f777ab94876a1f90ae3c9c2048006fc32dbc1 --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +

    See also

    +

    mongoc_auto_encryption_opts_set_kms_credential_provider_callback()

    +
    +

    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.

    +
    +
    +
    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_set_kms_providers.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_kms_providers.html new file mode 100644 index 0000000000000000000000000000000000000000..67c82df278cf5a4308ee5bbc8840cdfa46d3e6a0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_kms_providers.html @@ -0,0 +1,245 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_kms_providers() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +

    See also

    +
    +
    mongoc_client_encryption_new()
    +
    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_set_tls_opts.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_tls_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..551e25ee41ff13c513e31a024e4fc7a8fca9810c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_set_tls_opts.html @@ -0,0 +1,234 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_set_tls_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    In-Use Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_opts_t.html b/libmongoc/1.24.3/mongoc_client_encryption_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2a5c43a18c95507730e58f0ed52c1db838c4d88f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_opts_t.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_encryption_opts_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_opts_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_encryption_opts_t mongoc_client_encryption_opts_t;
+
    +
    +

    Used to set options for mongoc_client_encryption_new().

    +
    +

    See also

    +
    +
    mongoc_client_encryption_new()
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_remove_key_alt_name.html b/libmongoc/1.24.3/mongoc_client_encryption_remove_key_alt_name.html new file mode 100644 index 0000000000000000000000000000000000000000..d7c654bc220ed5d81fa341d7a7be13e847f7f446 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_remove_key_alt_name.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_encryption_remove_key_alt_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_client_encryption_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey.html b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey.html new file mode 100644 index 0000000000000000000000000000000000000000..3303f3e33e67ea2de0967f533edf282b4e1dc61c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_rewrap_many_datakey_result_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..c0c70b3f1faf371aa6e7fac1c0f571c66109fdc4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_destroy.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_get_bulk_write_result.html new file mode 100644 index 0000000000000000000000000000000000000000..660f6e59bac236e1759ec02acda4397b8f19f5d8 --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_encryption_rewrap_many_datakey()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_new.html b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_new.html new file mode 100644 index 0000000000000000000000000000000000000000..7b67a78e78517fc9cd1a9671f3e4238686dd589d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_new.html @@ -0,0 +1,196 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_t.html b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_t.html new file mode 100644 index 0000000000000000000000000000000000000000..0022275b0e4c923d7e342c51e82ec6b996737267 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_rewrap_many_datakey_result_t.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_client_encryption_rewrap_many_datakey_result_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_encryption_rewrap_many_datakey()
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_encryption_t.html b/libmongoc/1.24.3/mongoc_client_encryption_t.html new file mode 100644 index 0000000000000000000000000000000000000000..5551a1b40d53e584e3c5c2a8237c85373766025a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_encryption_t.html @@ -0,0 +1,238 @@ + + + + + + + + + + + + + + mongoc_client_encryption_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_client_encryption_t

    +
    +

    Synopsis

    +
    typedef struct _mongoc_client_encryption_t mongoc_client_encryption_t;
+
    +
    +

    mongoc_client_encryption_t provides utility functions for In-Use Encryption.

    +
    +
    +

    Thread Safety

    +

    mongoc_client_encryption_t is NOT thread-safe and should only be used in the same thread as the mongoc_client_t that is configured via mongoc_client_encryption_opts_set_keyvault_client().

    +
    +
    +

    Lifecycle

    +

    The key vault client, configured via mongoc_client_encryption_opts_set_keyvault_client(), must outlive the mongoc_client_encryption_t.

    +
    +

    See also

    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    mongoc_client_pool_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption for libmongoc
    +
    +
    +
    The MongoDB Manual for Client-Side Field Level Encryption
    +
    +
    +
    The MongoDB Manual for Queryable Encryption
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_find_databases_with_opts.html b/libmongoc/1.24.3/mongoc_client_find_databases_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..b8868e13716fbee3036b0633a9744a6201b17b80 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_find_databases_with_opts.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_client_find_databases_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_collection.html b/libmongoc/1.24.3/mongoc_client_get_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..70424ca8ebbb5d8d327d95461431fa3e7e188061 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_collection.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_client_get_collection() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_crypt_shared_version.html b/libmongoc/1.24.3/mongoc_client_get_crypt_shared_version.html new file mode 100644 index 0000000000000000000000000000000000000000..f4d8a24770525043f704a481527e0abf561d06b9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_crypt_shared_version.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_get_crypt_shared_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_database.html b/libmongoc/1.24.3/mongoc_client_get_database.html new file mode 100644 index 0000000000000000000000000000000000000000..6309331494b152e6d9b6077e78664e378b486637 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_database.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_get_database() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_database_names.html b/libmongoc/1.24.3/mongoc_client_get_database_names.html new file mode 100644 index 0000000000000000000000000000000000000000..1678ecda8127f1892fbbe4e30730d48482fb7854 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_database_names.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_client_get_database_names() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_database_names_with_opts.html b/libmongoc/1.24.3/mongoc_client_get_database_names_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..604337614c4e0de5e0ba75ea30a5b7911a981c1b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_database_names_with_opts.html @@ -0,0 +1,239 @@ + + + + + + + + + + + + + + mongoc_client_get_database_names_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+   }
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_default_database.html b/libmongoc/1.24.3/mongoc_client_get_default_database.html new file mode 100644 index 0000000000000000000000000000000000000000..337c612d5d3424d96f1e90d99ada11820eeee243 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_default_database.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_client_get_default_database() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_gridfs.html b/libmongoc/1.24.3/mongoc_client_get_gridfs.html new file mode 100644 index 0000000000000000000000000000000000000000..5330006542ba61e29c5110df8ece3fc8efb9cb39 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_gridfs.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_client_get_gridfs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_handshake_description.html b/libmongoc/1.24.3/mongoc_client_get_handshake_description.html new file mode 100644 index 0000000000000000000000000000000000000000..b554f2fab47c26775e93007719965dc50df49c95 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_handshake_description.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_client_get_handshake_description() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_read_concern.html b/libmongoc/1.24.3/mongoc_client_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..99651c92fe645d8fc84f5b7ac2904171f5955cd5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_read_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_read_prefs.html b/libmongoc/1.24.3/mongoc_client_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..0e87fd35cd6cc2b4a9c3ce3682c55019e57daad8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_read_prefs.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_server_description.html b/libmongoc/1.24.3/mongoc_client_get_server_description.html new file mode 100644 index 0000000000000000000000000000000000000000..37e33cc2b95059c08e5097fabae46410b3463661 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_server_description.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_client_get_server_description() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_server_descriptions.html b/libmongoc/1.24.3/mongoc_client_get_server_descriptions.html new file mode 100644 index 0000000000000000000000000000000000000000..5ecfd632f56a99fc7b2461d7229f85459bbf69b4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_server_descriptions.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_client_get_server_descriptions() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_server_status.html b/libmongoc/1.24.3/mongoc_client_get_server_status.html new file mode 100644 index 0000000000000000000000000000000000000000..64177d23dd92b83051f03ed1c55e4c90cbf3e948 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_server_status.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_client_get_server_status() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_uri.html b/libmongoc/1.24.3/mongoc_client_get_uri.html new file mode 100644 index 0000000000000000000000000000000000000000..f65ee93a265d4d9a49d806a64fb4dcc63f3e7354 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_uri.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_uri() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_get_write_concern.html b/libmongoc/1.24.3/mongoc_client_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..413b4338bd91907122ab31f3c3377c8ef08134ae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_get_write_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_get_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_new.html b/libmongoc/1.24.3/mongoc_client_new.html new file mode 100644 index 0000000000000000000000000000000000000000..20c10b02c5277b5b53ad53dac52b4fb6441c6c96 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_new.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_new_from_uri()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_new_from_uri.html b/libmongoc/1.24.3/mongoc_client_new_from_uri.html new file mode 100644 index 0000000000000000000000000000000000000000..11ea00432fc2e89272fae2752315399ff8b996bf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_new_from_uri.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_new_from_uri() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_new_from_uri_with_error()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_new_from_uri_with_error.html b/libmongoc/1.24.3/mongoc_client_new_from_uri_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..305f6282869b8a31ee15d4ef524cde040570f237 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_new_from_uri_with_error.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_client_new_from_uri_with_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_destroy.html b/libmongoc/1.24.3/mongoc_client_pool_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..396e9c08711e3711736bc73b0258a253a3cc0a99 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_destroy.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_client_pool_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_enable_auto_encryption.html b/libmongoc/1.24.3/mongoc_client_pool_enable_auto_encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..959e47336a6ce715cd51dc8bf162894039d489df --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_enable_auto_encryption.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_client_pool_enable_auto_encryption() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_auto_encryption_opts_t
    +
    +
    +
    mongoc_client_enable_auto_encryption()
    +
    +
    +
    In-Use Encryption for libmongoc
    +
    +
    +
    The MongoDB Manual for Client-Side Field Level Encryption
    +
    +
    +
    The MongoDB Manual for Queryable Encryption
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_max_size.html b/libmongoc/1.24.3/mongoc_client_pool_max_size.html new file mode 100644 index 0000000000000000000000000000000000000000..fab2b34cb148a300f0e9cf65a2f387f4e7c1e58b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_max_size.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_client_pool_max_size() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_min_size.html b/libmongoc/1.24.3/mongoc_client_pool_min_size.html new file mode 100644 index 0000000000000000000000000000000000000000..7598e15105102b1d63a2c1778dbbbd8f7c701789 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_min_size.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_pool_min_size() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_new.html b/libmongoc/1.24.3/mongoc_client_pool_new.html new file mode 100644 index 0000000000000000000000000000000000000000..6bfacdfa2eb27cbcbbc33a09cef59f205d33d0c1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_new.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_pool_new_with_error()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_new_with_error.html b/libmongoc/1.24.3/mongoc_client_pool_new_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..754a172639ab22d1b1f1f5dd9bd2198841b40e6f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_new_with_error.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_client_pool_new_with_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_pop.html b/libmongoc/1.24.3/mongoc_client_pool_pop.html new file mode 100644 index 0000000000000000000000000000000000000000..c617c0487c609e5a87a6bce6617456b472bd7849 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_pop.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_pop() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_push.html b/libmongoc/1.24.3/mongoc_client_pool_push.html new file mode 100644 index 0000000000000000000000000000000000000000..86b656417434b88e97b85032e165ff4583f788fd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_push.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_pool_push() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_set_apm_callbacks.html b/libmongoc/1.24.3/mongoc_client_pool_set_apm_callbacks.html new file mode 100644 index 0000000000000000000000000000000000000000..53ab49e63aa0959c9212d202e55775a41f350a94 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_set_apm_callbacks.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_apm_callbacks() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_set_appname.html b/libmongoc/1.24.3/mongoc_client_pool_set_appname.html new file mode 100644 index 0000000000000000000000000000000000000000..195ef150e9f530e0a4f40860700fbec545b976b0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_set_appname.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_appname() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_set_error_api.html b/libmongoc/1.24.3/mongoc_client_pool_set_error_api.html new file mode 100644 index 0000000000000000000000000000000000000000..435632e20ce5b7343b4d72d2d1ae11d448e5c33a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_set_error_api.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_error_api() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_set_server_api.html b/libmongoc/1.24.3/mongoc_client_pool_set_server_api.html new file mode 100644 index 0000000000000000000000000000000000000000..9242fc4f4ca53b61fac947b609c6a832e222b892 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_set_server_api.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_server_api() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_set_ssl_opts.html b/libmongoc/1.24.3/mongoc_client_pool_set_ssl_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..666695a1eebd32a3f243f4cce67f0c3d80b5ec74 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_set_ssl_opts.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_client_pool_set_ssl_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_t.html b/libmongoc/1.24.3/mongoc_client_pool_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1b418065c9206d92f569bca6e6b9bfe9d07c7ffc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_t.html @@ -0,0 +1,322 @@ + + + + + + + + + + + + + + mongoc_client_pool_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_pool_try_pop.html b/libmongoc/1.24.3/mongoc_client_pool_try_pop.html new file mode 100644 index 0000000000000000000000000000000000000000..bf3eda3903b24ed0679fe88fad5aec8b92ba00fb --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_pool_try_pop.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_client_pool_try_pop() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_read_command_with_opts.html b/libmongoc/1.24.3/mongoc_client_read_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a503a815cacb51049cbfd471e92fce64ee4905ed --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_read_command_with_opts.html @@ -0,0 +1,412 @@ + + + + + + + + + + + + + + mongoc_client_read_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_read_write_command_with_opts.html b/libmongoc/1.24.3/mongoc_client_read_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..41df09247f4ba8094d9347592b3981d28c997e54 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_read_write_command_with_opts.html @@ -0,0 +1,260 @@ + + + + + + + + + + + + + + mongoc_client_read_write_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_reset.html b/libmongoc/1.24.3/mongoc_client_reset.html new file mode 100644 index 0000000000000000000000000000000000000000..fe89f7d2c28ac85f316544a41d8213734e8ee49f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_reset.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_reset() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_select_server.html b/libmongoc/1.24.3/mongoc_client_select_server.html new file mode 100644 index 0000000000000000000000000000000000000000..57cff9d224b8c6520d8ce17e4d7ec13313eb45bf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_select_server.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_client_select_server() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_abort_transaction.html b/libmongoc/1.24.3/mongoc_client_session_abort_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..c1ec3688f9120a8e5b3d510355156735c6051d96 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_abort_transaction.html @@ -0,0 +1,306 @@ + + + + + + + + + + + + + + mongoc_client_session_abort_transaction() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_advance_cluster_time.html b/libmongoc/1.24.3/mongoc_client_session_advance_cluster_time.html new file mode 100644 index 0000000000000000000000000000000000000000..1738eab2655033619db51620d993035bce9ae0ef --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_advance_cluster_time.html @@ -0,0 +1,303 @@ + + + + + + + + + + + + + + mongoc_client_session_advance_cluster_time() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_advance_operation_time.html b/libmongoc/1.24.3/mongoc_client_session_advance_operation_time.html new file mode 100644 index 0000000000000000000000000000000000000000..17ea55750dae8caf1f12ae4c305bec4b1132de56 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_advance_operation_time.html @@ -0,0 +1,305 @@ + + + + + + + + + + + + + + mongoc_client_session_advance_operation_time() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_append.html b/libmongoc/1.24.3/mongoc_client_session_append.html new file mode 100644 index 0000000000000000000000000000000000000000..498179d3607aee32fc45f372834b49c2942c40ae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_append.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_client_session_append() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_commit_transaction.html b/libmongoc/1.24.3/mongoc_client_session_commit_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..1d3f50dc117a5334302ecfbf55191dd9eb6374a5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_commit_transaction.html @@ -0,0 +1,309 @@ + + + + + + + + + + + + + + mongoc_client_session_commit_transaction() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_destroy.html b/libmongoc/1.24.3/mongoc_client_session_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5164842de8d51c6d3282c0e2f7b973899c0659f6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_destroy.html @@ -0,0 +1,301 @@ + + + + + + + + + + + + + + mongoc_client_session_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_client.html b/libmongoc/1.24.3/mongoc_client_session_get_client.html new file mode 100644 index 0000000000000000000000000000000000000000..3ac1eaf028a210e1be9dd80b80da33e3f9911e8f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_client.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_client() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_cluster_time.html b/libmongoc/1.24.3/mongoc_client_session_get_cluster_time.html new file mode 100644 index 0000000000000000000000000000000000000000..abc730a5671c4c33e22ebaaf391f4545eea1ed39 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_cluster_time.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_cluster_time() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_dirty.html b/libmongoc/1.24.3/mongoc_client_session_get_dirty.html new file mode 100644 index 0000000000000000000000000000000000000000..c6ce2ef76514924bcb3efdc5a15e823f80a8d448 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_dirty.html @@ -0,0 +1,308 @@ + + + + + + + + + + + + + + mongoc_client_session_get_dirty() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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”.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_lsid.html b/libmongoc/1.24.3/mongoc_client_session_get_lsid.html new file mode 100644 index 0000000000000000000000000000000000000000..502661aa97517d0dbf64e0b9aeea3f0cf5b41d17 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_lsid.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_lsid() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_operation_time.html b/libmongoc/1.24.3/mongoc_client_session_get_operation_time.html new file mode 100644 index 0000000000000000000000000000000000000000..0a5dc1cbede0398d36aed9a415048a56675db89c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_operation_time.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_operation_time() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_opts.html b/libmongoc/1.24.3/mongoc_client_session_get_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..7356682d5b9d025b2eee7c569efbc3227b66dd09 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_opts.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_server_id.html b/libmongoc/1.24.3/mongoc_client_session_get_server_id.html new file mode 100644 index 0000000000000000000000000000000000000000..09b9d4a39169cf1bb9f5981c296e6b3d9edb8778 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_server_id.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_client_session_get_server_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_get_transaction_state.html b/libmongoc/1.24.3/mongoc_client_session_get_transaction_state.html new file mode 100644 index 0000000000000000000000000000000000000000..ecc098c816c4a26fccebd5885e9915ea9f39dd08 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_get_transaction_state.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_session_get_transaction_state() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_in_transaction.html b/libmongoc/1.24.3/mongoc_client_session_in_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..0897b8ddc13cde35a2294fca1f39705a1fa38bea --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_in_transaction.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_session_in_transaction() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_start_transaction.html b/libmongoc/1.24.3/mongoc_client_session_start_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..7e81d48a640687023704ec0b1838490e0cfce95f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_start_transaction.html @@ -0,0 +1,498 @@ + + + + + + + + + + + + + + mongoc_client_session_start_transaction() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_t.html b/libmongoc/1.24.3/mongoc_client_session_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7c303c4fbb459139416f9c32c9b6b622c74adfff --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_t.html @@ -0,0 +1,368 @@ + + + + + + + + + + + + + + mongoc_client_session_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_with_transaction.html b/libmongoc/1.24.3/mongoc_client_session_with_transaction.html new file mode 100644 index 0000000000000000000000000000000000000000..7c6eb18791784dcbd537e62553e2575fd0db2f0d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_with_transaction.html @@ -0,0 +1,408 @@ + + + + + + + + + + + + + + mongoc_client_session_with_transaction() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_session_with_transaction_cb_t.html b/libmongoc/1.24.3/mongoc_client_session_with_transaction_cb_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ae8bf38de159da1ac0367d7b505f1a50ca4ebb5f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_session_with_transaction_cb_t.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_session_with_transaction_cb_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_with_transaction()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_apm_callbacks.html b/libmongoc/1.24.3/mongoc_client_set_apm_callbacks.html new file mode 100644 index 0000000000000000000000000000000000000000..bd517c8d6bc359c7d3ec4f03b10f1471ba72591b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_apm_callbacks.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_client_set_apm_callbacks() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_appname.html b/libmongoc/1.24.3/mongoc_client_set_appname.html new file mode 100644 index 0000000000000000000000000000000000000000..a8c4ee558be4e778543fe87bf2d4075e5808f021 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_appname.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_client_set_appname() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_error_api.html b/libmongoc/1.24.3/mongoc_client_set_error_api.html new file mode 100644 index 0000000000000000000000000000000000000000..1da0d4d41422699030aafd487667067de1449438 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_error_api.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_client_set_error_api() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_read_concern.html b/libmongoc/1.24.3/mongoc_client_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..4c042d47129337923998769c537882c4c3d1b68f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_read_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_set_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_read_prefs.html b/libmongoc/1.24.3/mongoc_client_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..e8d05e58e8720ec79f7799f8a217dde163fcf8c5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_read_prefs.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_set_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_server_api.html b/libmongoc/1.24.3/mongoc_client_set_server_api.html new file mode 100644 index 0000000000000000000000000000000000000000..89f41f0501b8f974619b0ccdb1b25dd36a633c2a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_server_api.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_client_set_server_api() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_ssl_opts.html b/libmongoc/1.24.3/mongoc_client_set_ssl_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4df11031627fedbea7c0e0b10dd494478f146bc5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_ssl_opts.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_client_set_ssl_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_stream_initiator.html b/libmongoc/1.24.3/mongoc_client_set_stream_initiator.html new file mode 100644 index 0000000000000000000000000000000000000000..7184494b5f35828e3bd6205111c8e66b1ca9a487 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_stream_initiator.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_client_set_stream_initiator() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_set_write_concern.html b/libmongoc/1.24.3/mongoc_client_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..6686ef1e652fad123b92c9d2064dd2e647a17f64 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_set_write_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_client_set_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_start_session.html b/libmongoc/1.24.3/mongoc_client_start_session.html new file mode 100644 index 0000000000000000000000000000000000000000..781c9efa73ff2039752477f2ab199bc0816bb6df --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_start_session.html @@ -0,0 +1,316 @@ + + + + + + + + + + + + + + mongoc_client_start_session() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_t.html b/libmongoc/1.24.3/mongoc_client_t.html new file mode 100644 index 0000000000000000000000000000000000000000..42a475f25c495d34921494bb153db2ab2e0c7f85 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_t.html @@ -0,0 +1,341 @@ + + + + + + + + + + + + + + mongoc_client_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_watch.html b/libmongoc/1.24.3/mongoc_client_watch.html new file mode 100644 index 0000000000000000000000000000000000000000..62ab628f3907575be385cac71e3f5e45131cf70e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_watch.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_client_watch() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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. Available 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.

    +
    +

    See also

    +
    +
    mongoc_database_watch()
    +
    +
    +
    mongoc_collection_watch()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_client_write_command_with_opts.html b/libmongoc/1.24.3/mongoc_client_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..5e54dd042447f75b1e0839cab187b4f465e9a346 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_client_write_command_with_opts.html @@ -0,0 +1,405 @@ + + + + + + + + + + + + + + mongoc_client_write_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_aggregate.html b/libmongoc/1.24.3/mongoc_collection_aggregate.html new file mode 100644 index 0000000000000000000000000000000000000000..978883a3b224a60483589daee7753dc80493f467 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_aggregate.html @@ -0,0 +1,320 @@ + + + + + + + + + + + + + + mongoc_collection_aggregate() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_command.html b/libmongoc/1.24.3/mongoc_collection_command.html new file mode 100644 index 0000000000000000000000000000000000000000..46eb08bc7d497f840105cedeb969060ece5b6f6c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_command.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_collection_command() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_command_simple.html b/libmongoc/1.24.3/mongoc_collection_command_simple.html new file mode 100644 index 0000000000000000000000000000000000000000..1ca40f3b77ee3ccbfff3eba5b845b7b02254a89a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_command_simple.html @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + mongoc_collection_command_simple() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_command_with_opts.html b/libmongoc/1.24.3/mongoc_collection_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..efe6ee5359e5c557dc24ad8256eb40893fd159b1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_command_with_opts.html @@ -0,0 +1,257 @@ + + + + + + + + + + + + + + mongoc_collection_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_copy.html b/libmongoc/1.24.3/mongoc_collection_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..533652cd8e34d70653ba201555e91575de5e92b3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_copy.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_collection_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_count.html b/libmongoc/1.24.3/mongoc_collection_count.html new file mode 100644 index 0000000000000000000000000000000000000000..9b1230a382e5f7b6cb405dd4892b0abd3a60100d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_count.html @@ -0,0 +1,261 @@ + + + + + + + + + + + + + + mongoc_collection_count() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+   }
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_count_documents.html b/libmongoc/1.24.3/mongoc_collection_count_documents.html new file mode 100644 index 0000000000000000000000000000000000000000..b01b5a47cfe12e5ec217c741b61613b517d60213 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_count_documents.html @@ -0,0 +1,289 @@ + + + + + + + + + + + + + + mongoc_collection_count_documents() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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+

    +
    +

    See also

    +
    +
    mongoc_collection_estimated_document_count()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_count_with_opts.html b/libmongoc/1.24.3/mongoc_collection_count_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..81d3bcaba463c3caf2f55ed0d27c50d7b7140bfe --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_count_with_opts.html @@ -0,0 +1,320 @@ + + + + + + + + + + + + + + mongoc_collection_count_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+   }
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_create_bulk_operation.html b/libmongoc/1.24.3/mongoc_collection_create_bulk_operation.html new file mode 100644 index 0000000000000000000000000000000000000000..56e45a90ead924adfa0739773bbe948e56c2bc83 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_create_bulk_operation.html @@ -0,0 +1,237 @@ + + + + + + + + + + + + + + mongoc_collection_create_bulk_operation() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +

    See also

    +
    +
    Bulk Write Operations
    +
    +

    mongoc_bulk_operation_t

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_create_bulk_operation_with_opts.html b/libmongoc/1.24.3/mongoc_collection_create_bulk_operation_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..c7fe46d77b598fd97710355ab0f0983683cd248e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_create_bulk_operation_with_opts.html @@ -0,0 +1,233 @@ + + + + + + + + + + + + + + mongoc_collection_create_bulk_operation_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +

    See also

    +
    +
    Bulk Write Operations
    +
    +
    +
    mongoc_bulk_operation_t
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_create_index.html b/libmongoc/1.24.3/mongoc_collection_create_index.html new file mode 100644 index 0000000000000000000000000000000000000000..b31dbff3b1aea723c45c218069d4ee577d89a4d8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_create_index.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_collection_create_index() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_create_index_with_opts.html b/libmongoc/1.24.3/mongoc_collection_create_index_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..15f483ea591d5f0c75ff73da82cd0f74170667cd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_create_index_with_opts.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_collection_create_index_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_create_indexes_with_opts.html b/libmongoc/1.24.3/mongoc_collection_create_indexes_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..0f74f04d9b3411b0db76f740c89d1d910a7c91dc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_create_indexes_with_opts.html @@ -0,0 +1,249 @@ + + + + + + + + + + + + + + mongoc_collection_create_indexes_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Manage Collection Indexes.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_delete.html b/libmongoc/1.24.3/mongoc_collection_delete.html new file mode 100644 index 0000000000000000000000000000000000000000..df4b397f25ccf0ee3710c8fa7ae67e50315362b2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_delete.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_delete() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_delete_many.html b/libmongoc/1.24.3/mongoc_collection_delete_many.html new file mode 100644 index 0000000000000000000000000000000000000000..f2849dc02c8a849fdd1e0717b364b6963020ebff --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_delete_many.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_delete_many() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_delete_one.html b/libmongoc/1.24.3/mongoc_collection_delete_one.html new file mode 100644 index 0000000000000000000000000000000000000000..1bd4340e9666836c2bf826a1d15d52efd9143544 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_delete_one.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_delete_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_destroy.html b/libmongoc/1.24.3/mongoc_collection_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..cae33de3d35d3f973a0e6177554de62eb7e537da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_destroy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_drop.html b/libmongoc/1.24.3/mongoc_collection_drop.html new file mode 100644 index 0000000000000000000000000000000000000000..d9a189a5e5169f656425ff999a016c658b5b415c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_drop.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_collection_drop() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_drop_index.html b/libmongoc/1.24.3/mongoc_collection_drop_index.html new file mode 100644 index 0000000000000000000000000000000000000000..75973412ab5d686bc0ef0687fa4128ed61d6e47c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_drop_index.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_drop_index() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_drop_index_with_opts.html b/libmongoc/1.24.3/mongoc_collection_drop_index_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..d07b793005feb22fb7e956cc5542a99f3df84b75 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_drop_index_with_opts.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_drop_index_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Manage Collection Indexes.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_drop_with_opts.html b/libmongoc/1.24.3/mongoc_collection_drop_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..add30a30af29d28ad198815e27f5496d50066703 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_drop_with_opts.html @@ -0,0 +1,247 @@ + + + + + + + + + + + + + + mongoc_collection_drop_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_ensure_index.html b/libmongoc/1.24.3/mongoc_collection_ensure_index.html new file mode 100644 index 0000000000000000000000000000000000000000..b337372a6c4179e4e039df42af9d6892fe796d7c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_ensure_index.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_collection_ensure_index() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_estimated_document_count.html b/libmongoc/1.24.3/mongoc_collection_estimated_document_count.html new file mode 100644 index 0000000000000000000000000000000000000000..d33e6a3e31fa36dd103bba56aacf6d9d62ddfff8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_estimated_document_count.html @@ -0,0 +1,270 @@ + + + + + + + + + + + + + + mongoc_collection_estimated_document_count() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_collection_count_documents()
    +
    Count: Behavior in the MongoDB Manual
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_find.html b/libmongoc/1.24.3/mongoc_collection_find.html new file mode 100644 index 0000000000000000000000000000000000000000..8f26a2447b985beece4aec1638819b586735f319 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_find.html @@ -0,0 +1,356 @@ + + + + + + + + + + + + + + mongoc_collection_find() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_find_and_modify.html b/libmongoc/1.24.3/mongoc_collection_find_and_modify.html new file mode 100644 index 0000000000000000000000000000000000000000..dd69708171c55fad19ef17c5ae83552a682c8334 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_find_and_modify.html @@ -0,0 +1,332 @@ + + + + + + + + + + + + + + mongoc_collection_find_and_modify() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_collection_find_and_modify_with_opts().
    +
    +
    +
    +
    +

    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;
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_find_and_modify_with_opts.html b/libmongoc/1.24.3/mongoc_collection_find_and_modify_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..e2da34804137904985a8cc712f2c43c8276a5ca5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_find_and_modify_with_opts.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_collection_find_and_modify_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_find_indexes.html b/libmongoc/1.24.3/mongoc_collection_find_indexes.html new file mode 100644 index 0000000000000000000000000000000000000000..cb574ddb7e8201f1692c9d0c7fa3728844294b89 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_find_indexes.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_collection_find_indexes() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_find_indexes_with_opts.html b/libmongoc/1.24.3/mongoc_collection_find_indexes_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..f152ac48e86b261c32dc345bbf830cf819ae73c5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_find_indexes_with_opts.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_collection_find_indexes_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Manage Collection Indexes.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_find_with_opts.html b/libmongoc/1.24.3/mongoc_collection_find_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..ab04f6efed5859b21dc986440d8e0817f82e17ba --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_find_with_opts.html @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + mongoc_collection_find_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_get_last_error.html b/libmongoc/1.24.3/mongoc_collection_get_last_error.html new file mode 100644 index 0000000000000000000000000000000000000000..3be024d7f70746a3e6b85680cce745201ffaf24b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_get_last_error.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_collection_get_last_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_get_name.html b/libmongoc/1.24.3/mongoc_collection_get_name.html new file mode 100644 index 0000000000000000000000000000000000000000..6b6a8123e6045d8bc78a23159b0d1002690b4e9e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_get_name.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_get_read_concern.html b/libmongoc/1.24.3/mongoc_collection_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..62e2b47cd6abe530aedea902bc3b6ceb06ed082f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_get_read_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_get_read_prefs.html b/libmongoc/1.24.3/mongoc_collection_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..9a59d5cf3a4a6014a0de1f9fad79201de71a0125 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_get_read_prefs.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_get_write_concern.html b/libmongoc/1.24.3/mongoc_collection_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..46089a08d411658e8f102dd1942f4469d83cfc7f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_get_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_get_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_insert.html b/libmongoc/1.24.3/mongoc_collection_insert.html new file mode 100644 index 0000000000000000000000000000000000000000..dc11dc0d66e60cea23683ad9957da6272d97a77f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_insert.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_collection_insert() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_insert_bulk.html b/libmongoc/1.24.3/mongoc_collection_insert_bulk.html new file mode 100644 index 0000000000000000000000000000000000000000..e5a700a97cdb3ddbd971c976d20e72c62d22d33e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_insert_bulk.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_insert_bulk() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_insert_many.html b/libmongoc/1.24.3/mongoc_collection_insert_many.html new file mode 100644 index 0000000000000000000000000000000000000000..b793cd863adbad8a9036ec80d429555b247e7046 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_insert_many.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_collection_insert_many() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_insert_one.html b/libmongoc/1.24.3/mongoc_collection_insert_one.html new file mode 100644 index 0000000000000000000000000000000000000000..bc7dfa5c3d197e6474c35658fe2dc6c9c0a6e838 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_insert_one.html @@ -0,0 +1,228 @@ + + + + + + + + + + + + + + mongoc_collection_insert_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_keys_to_index_string.html b/libmongoc/1.24.3/mongoc_collection_keys_to_index_string.html new file mode 100644 index 0000000000000000000000000000000000000000..802f3124b6d3352b9660e2373ff8bb7878f265ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_keys_to_index_string.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_collection_keys_to_index_string() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_read_command_with_opts.html b/libmongoc/1.24.3/mongoc_collection_read_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..d126319dd061bc433a652b9cbde68b97dc1505fa --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_read_command_with_opts.html @@ -0,0 +1,259 @@ + + + + + + + + + + + + + + mongoc_collection_read_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_read_write_command_with_opts.html b/libmongoc/1.24.3/mongoc_collection_read_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..2d3863e3748af920a4006356e38212d0c69031ba --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_read_write_command_with_opts.html @@ -0,0 +1,258 @@ + + + + + + + + + + + + + + mongoc_collection_read_write_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_remove.html b/libmongoc/1.24.3/mongoc_collection_remove.html new file mode 100644 index 0000000000000000000000000000000000000000..d4d89627f027d5b2dfff9b9c89a8bd42924f6299 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_remove.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_collection_remove() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_rename.html b/libmongoc/1.24.3/mongoc_collection_rename.html new file mode 100644 index 0000000000000000000000000000000000000000..10f776e7a60bcf29272d1fa8445899eb6b096ac2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_rename.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_collection_rename() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_rename_with_opts.html b/libmongoc/1.24.3/mongoc_collection_rename_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4550f332d0eaf9cf938922bee2c45e9ae59dcf85 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_rename_with_opts.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_collection_rename_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_replace_one.html b/libmongoc/1.24.3/mongoc_collection_replace_one.html new file mode 100644 index 0000000000000000000000000000000000000000..ede16b4b95c5b2b3c1bbd59ec8ed75e3bbd5a5a1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_replace_one.html @@ -0,0 +1,244 @@ + + + + + + + + + + + + + + mongoc_collection_replace_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    mongoc_collection_update_one()
    +
    +
    +
    mongoc_collection_update_many()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_save.html b/libmongoc/1.24.3/mongoc_collection_save.html new file mode 100644 index 0000000000000000000000000000000000000000..2f01041e2b536ddb852df9fd6a9d1fdca214b2a5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_save.html @@ -0,0 +1,226 @@ + + + + + + + + + + + + + + mongoc_collection_save() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_set_read_concern.html b/libmongoc/1.24.3/mongoc_collection_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..242cde395dc1f78492b3a13c86d879889c949e8f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_set_read_concern.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_collection_set_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_set_read_prefs.html b/libmongoc/1.24.3/mongoc_collection_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..a65c81763727b4a5b059d6352ce8ab91afbb3eb2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_set_read_prefs.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_set_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_set_write_concern.html b/libmongoc/1.24.3/mongoc_collection_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..a45672b350e6d8f2ef30bb018432dc7747f83da7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_set_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_collection_set_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_stats.html b/libmongoc/1.24.3/mongoc_collection_stats.html new file mode 100644 index 0000000000000000000000000000000000000000..3f4f78596af514387c82b51af44c84d95d911864 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_stats.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_collection_stats() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_t.html b/libmongoc/1.24.3/mongoc_collection_t.html new file mode 100644 index 0000000000000000000000000000000000000000..49cea207faff809a7b0e72d4c9b19e864cfd23aa --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_t.html @@ -0,0 +1,256 @@ + + + + + + + + + + + + + + mongoc_collection_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_update.html b/libmongoc/1.24.3/mongoc_collection_update.html new file mode 100644 index 0000000000000000000000000000000000000000..29959ae9e5bcb668307ebeef69c916d2ce08acae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_update.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_collection_update() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_update_many.html b/libmongoc/1.24.3/mongoc_collection_update_many.html new file mode 100644 index 0000000000000000000000000000000000000000..1b823d5de57dc827ad98733b00eb3dbad6fa4ba4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_update_many.html @@ -0,0 +1,243 @@ + + + + + + + + + + + + + + mongoc_collection_update_many() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    mongoc_collection_update_one()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_update_one.html b/libmongoc/1.24.3/mongoc_collection_update_one.html new file mode 100644 index 0000000000000000000000000000000000000000..81761f0dfc29d811188624c5ed67e3b697c79e70 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_update_one.html @@ -0,0 +1,323 @@ + + + + + + + + + + + + + + mongoc_collection_update_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    mongoc_collection_update_many()
    +
    +
    +
    mongoc_collection_replace_one()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_validate.html b/libmongoc/1.24.3/mongoc_collection_validate.html new file mode 100644 index 0000000000000000000000000000000000000000..340eeca3769ab37f611ce1ac34c7d7d7732d0b9e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_validate.html @@ -0,0 +1,224 @@ + + + + + + + + + + + + + + mongoc_collection_validate() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_watch.html b/libmongoc/1.24.3/mongoc_collection_watch.html new file mode 100644 index 0000000000000000000000000000000000000000..d7bc31d943298c7bcc3f3360600c13c6931eb885 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_watch.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_collection_watch() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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. Available 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.

    +
    +

    See also

    +
    +
    mongoc_client_watch()
    +
    +
    +
    mongoc_database_watch()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_collection_write_command_with_opts.html b/libmongoc/1.24.3/mongoc_collection_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..eff28f1a35ff6fdd30b1d128f481c8e950807343 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_collection_write_command_with_opts.html @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + mongoc_collection_write_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_clone.html b/libmongoc/1.24.3/mongoc_cursor_clone.html new file mode 100644 index 0000000000000000000000000000000000000000..83eb3f6b8400906fdb95d462eb3e8ddfb95ef9ca --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_clone.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_cursor_clone() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_current.html b/libmongoc/1.24.3/mongoc_cursor_current.html new file mode 100644 index 0000000000000000000000000000000000000000..898e92a1e92e245f3aa8423bec5893701a5e3a45 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_current.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_cursor_current() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_destroy.html b/libmongoc/1.24.3/mongoc_cursor_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..d3843f875e2be1aafb54bb17f0fd8426f53a95dd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_cursor_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_error.html b/libmongoc/1.24.3/mongoc_cursor_error.html new file mode 100644 index 0000000000000000000000000000000000000000..b8575541267acb62d9825affe3530d41c2c5ee6a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_error.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_cursor_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_cursor_error()
    +
    +
    +
    mongoc_cursor_error_document()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_error_document.html b/libmongoc/1.24.3/mongoc_cursor_error_document.html new file mode 100644 index 0000000000000000000000000000000000000000..b34f0067da7fa86125fcb63c48cf1eadc130ff52 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_error_document.html @@ -0,0 +1,313 @@ + + + + + + + + + + + + + + mongoc_cursor_error_document() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +

    See also

    +
    +
    mongoc_cursor_error()
    +
    +
    +
    mongoc_cursor_error_document()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_get_batch_size.html b/libmongoc/1.24.3/mongoc_cursor_get_batch_size.html new file mode 100644 index 0000000000000000000000000000000000000000..268310c6e80ed7515b8f50a0f8e4e9092657f19d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_get_batch_size.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_cursor_get_batch_size() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_get_hint.html b/libmongoc/1.24.3/mongoc_cursor_get_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..e7d323815bfa979853dd039ea822128c4f9c7b2c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_get_hint.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_cursor_get_hint() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_get_host.html b/libmongoc/1.24.3/mongoc_cursor_get_host.html new file mode 100644 index 0000000000000000000000000000000000000000..e134ddfd365e601be604164076e3aeabb6e8b72f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_get_host.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_cursor_get_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_get_id.html b/libmongoc/1.24.3/mongoc_cursor_get_id.html new file mode 100644 index 0000000000000000000000000000000000000000..bc38767c9a2d58893987864e2a3d4735ebea3043 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_get_id.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_cursor_get_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_get_limit.html b/libmongoc/1.24.3/mongoc_cursor_get_limit.html new file mode 100644 index 0000000000000000000000000000000000000000..8ff0944c863dfdee78ff5577e9e9fea7a21d4dd6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_get_limit.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_cursor_get_limit() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_get_max_await_time_ms.html b/libmongoc/1.24.3/mongoc_cursor_get_max_await_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..42a2dd6199f284c6813b5b3b0175cab569844087 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_get_max_await_time_ms.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_cursor_get_max_await_time_ms() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_is_alive.html b/libmongoc/1.24.3/mongoc_cursor_is_alive.html new file mode 100644 index 0000000000000000000000000000000000000000..54b0526aa39b52ce82cfa12aa43847ce5c354fb1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_is_alive.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_cursor_is_alive() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_more.html b/libmongoc/1.24.3/mongoc_cursor_more.html new file mode 100644 index 0000000000000000000000000000000000000000..6fce03b830c59943cf68ea889df4cfa8a97c9e09 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_more.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_cursor_more() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Tailable Cursor Example
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_new_from_command_reply.html b/libmongoc/1.24.3/mongoc_cursor_new_from_command_reply.html new file mode 100644 index 0000000000000000000000000000000000000000..724b0c1e5f3f7a3f55a862ba145ebb3f3ba88102 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_new_from_command_reply.html @@ -0,0 +1,236 @@ + + + + + + + + + + + + + + mongoc_cursor_new_from_command_reply() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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), server_id may be 0. If the cursor response is not completed (i.e. with non-zero cursor id), pass the server_id of the server used to create the cursor.

    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_new_from_command_reply_with_opts.html b/libmongoc/1.24.3/mongoc_cursor_new_from_command_reply_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..e89eace726effb5f87c6d30f4e33dcea0bcf7053 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_new_from_command_reply_with_opts.html @@ -0,0 +1,237 @@ + + + + + + + + + + + + + + mongoc_cursor_new_from_command_reply_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +

    When synthesizing a completed cursor response that has no more batches (i.e. with cursor id 0), serverId may be 0. If the cursor response is not completed (i.e. with non-zero cursor id), pass the serverId of the server used to create the cursor.

    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_next.html b/libmongoc/1.24.3/mongoc_cursor_next.html new file mode 100644 index 0000000000000000000000000000000000000000..1592d55e593acce5ae8290eba3b10a4ea72a7aae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_next.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_cursor_next() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_set_batch_size.html b/libmongoc/1.24.3/mongoc_cursor_set_batch_size.html new file mode 100644 index 0000000000000000000000000000000000000000..de75748b362710cc925b10fd32c160097729d06f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_set_batch_size.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_cursor_set_batch_size() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_set_hint.html b/libmongoc/1.24.3/mongoc_cursor_set_hint.html new file mode 100644 index 0000000000000000000000000000000000000000..0bab096c28de606fedda92313f92ccfe4086ebdd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_set_hint.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_cursor_set_hint() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_set_limit.html b/libmongoc/1.24.3/mongoc_cursor_set_limit.html new file mode 100644 index 0000000000000000000000000000000000000000..aacfd5821ec4e04bcc0597f117fccd50b470ea90 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_set_limit.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_cursor_set_limit() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_set_max_await_time_ms.html b/libmongoc/1.24.3/mongoc_cursor_set_max_await_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..d04efebdd50cea65946d6e5305268544588bbab6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_set_max_await_time_ms.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_cursor_set_max_await_time_ms() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    Tailable Cursors.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_cursor_t.html b/libmongoc/1.24.3/mongoc_cursor_t.html new file mode 100644 index 0000000000000000000000000000000000000000..0645d493e7f5dad339c2e7c2bc6bf78875db0fd5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_cursor_t.html @@ -0,0 +1,316 @@ + + + + + + + + + + + + + + mongoc_cursor_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_add_user.html b/libmongoc/1.24.3/mongoc_database_add_user.html new file mode 100644 index 0000000000000000000000000000000000000000..34cecd24eb4c140fdc61e6b945fbad0b1d2c4244 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_add_user.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_database_add_user() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_aggregate.html b/libmongoc/1.24.3/mongoc_database_aggregate.html new file mode 100644 index 0000000000000000000000000000000000000000..02b3f8437e05db212bdad9043ed5d56b04df8ff4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_aggregate.html @@ -0,0 +1,297 @@ + + + + + + + + + + + + + + mongoc_database_aggregate() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_command.html b/libmongoc/1.24.3/mongoc_database_command.html new file mode 100644 index 0000000000000000000000000000000000000000..fbd6e13b3c6d4fc52b328700df3540d4a53138ec --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_command.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_database_command() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_command_simple.html b/libmongoc/1.24.3/mongoc_database_command_simple.html new file mode 100644 index 0000000000000000000000000000000000000000..458303b071d322f2de8689e4308e20fa79ed7765 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_command_simple.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_database_command_simple() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_command_with_opts.html b/libmongoc/1.24.3/mongoc_database_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..25ec7d5a06d9f738b312c81fb457982ac7a561fd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_command_with_opts.html @@ -0,0 +1,257 @@ + + + + + + + + + + + + + + mongoc_database_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_copy.html b/libmongoc/1.24.3/mongoc_database_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..30bc3196d2d1202757c3456e6fd43ea3bf1f4334 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_copy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_database_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_create_collection.html b/libmongoc/1.24.3/mongoc_database_create_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..3a7f9dc9e62589f6a49d9091aa0fce103d657c4d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_create_collection.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_database_create_collection() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_destroy.html b/libmongoc/1.24.3/mongoc_database_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..21c85592d7a1b1fe53b3c7abfc44923623d26959 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_database_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_drop.html b/libmongoc/1.24.3/mongoc_database_drop.html new file mode 100644 index 0000000000000000000000000000000000000000..406c93d80a5c566a687323ce1a51996878a306da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_drop.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_drop() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_drop_with_opts.html b/libmongoc/1.24.3/mongoc_database_drop_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..6ddb3109a5c8c67eeb781193f324ed6d651b0a56 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_drop_with_opts.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_database_drop_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_find_collections.html b/libmongoc/1.24.3/mongoc_database_find_collections.html new file mode 100644 index 0000000000000000000000000000000000000000..df4b526a25af8732a01eb2f4c9c196088e8549d4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_find_collections.html @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + mongoc_database_find_collections() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_find_collections_with_opts.html b/libmongoc/1.24.3/mongoc_database_find_collections_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..5e501eda3ad1ab8352747fa30d8dff33073d1773 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_find_collections_with_opts.html @@ -0,0 +1,263 @@ + + + + + + + + + + + + + + mongoc_database_find_collections_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +

    See also

    +
    +
    mongoc_database_get_collection_names_with_opts()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_collection.html b/libmongoc/1.24.3/mongoc_database_get_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..309c5553840fb80d76566fdc0f14b8d9a7678c31 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_collection.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_database_get_collection() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_collection_names.html b/libmongoc/1.24.3/mongoc_database_get_collection_names.html new file mode 100644 index 0000000000000000000000000000000000000000..3991c92e9e62b40e94844b6d9d31ebeda92e4c2f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_collection_names.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_database_get_collection_names() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_collection_names_with_opts.html b/libmongoc/1.24.3/mongoc_database_get_collection_names_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..f0eae2f8d4f1ff733312768c5ee8b58e88245171 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_collection_names_with_opts.html @@ -0,0 +1,249 @@ + + + + + + + + + + + + + + mongoc_database_get_collection_names_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_name.html b/libmongoc/1.24.3/mongoc_database_get_name.html new file mode 100644 index 0000000000000000000000000000000000000000..7eb7e5af25df15b1ae179e0ee9f9e6f9b6175dae --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_name.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_read_concern.html b/libmongoc/1.24.3/mongoc_database_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..61e6b9a051c67524092b904dcfc182acc0e920dc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_read_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_read_prefs.html b/libmongoc/1.24.3/mongoc_database_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..dff1d3b22349010b15d4956a1d25c56065fc5d8f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_read_prefs.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_get_write_concern.html b/libmongoc/1.24.3/mongoc_database_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..c81372c624d45b0263c63fdb8a6d1d7176a68e1f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_get_write_concern.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_get_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_has_collection.html b/libmongoc/1.24.3/mongoc_database_has_collection.html new file mode 100644 index 0000000000000000000000000000000000000000..9b72ff40915c6e0237490467a46719c556f3e5ea --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_has_collection.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_database_has_collection() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_read_command_with_opts.html b/libmongoc/1.24.3/mongoc_database_read_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..87f5a40e974c10e92d36f7265e4f2f0815bc7e88 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_read_command_with_opts.html @@ -0,0 +1,259 @@ + + + + + + + + + + + + + + mongoc_database_read_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_read_write_command_with_opts.html b/libmongoc/1.24.3/mongoc_database_read_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..45d7213fdf21a1b9640c1c3bb5dfb565ddfa5658 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_read_write_command_with_opts.html @@ -0,0 +1,258 @@ + + + + + + + + + + + + + + mongoc_database_read_write_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_remove_all_users.html b/libmongoc/1.24.3/mongoc_database_remove_all_users.html new file mode 100644 index 0000000000000000000000000000000000000000..ea9c16443c78673c90965a6ad8b23f3882a5c0df --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_remove_all_users.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_database_remove_all_users() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_remove_user.html b/libmongoc/1.24.3/mongoc_database_remove_user.html new file mode 100644 index 0000000000000000000000000000000000000000..4231680c1f192934a0fa3d050fdf6945ad839979 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_remove_user.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_database_remove_user() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_set_read_concern.html b/libmongoc/1.24.3/mongoc_database_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..810b1600fc746a15f3addff596d136e74055553b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_set_read_concern.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_database_set_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_set_read_prefs.html b/libmongoc/1.24.3/mongoc_database_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..229a62ac7e41e825cf00f2db18c2ebffa7480e17 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_set_read_prefs.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_database_set_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_set_write_concern.html b/libmongoc/1.24.3/mongoc_database_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..6e597faa1a6b0d3bf31b9c37a47d5e47e7bc6a1c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_set_write_concern.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_database_set_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_t.html b/libmongoc/1.24.3/mongoc_database_t.html new file mode 100644 index 0000000000000000000000000000000000000000..72298700f0085c235bd0ff083840efb0c75d9ed4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_t.html @@ -0,0 +1,253 @@ + + + + + + + + + + + + + + mongoc_database_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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;
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_watch.html b/libmongoc/1.24.3/mongoc_database_watch.html new file mode 100644 index 0000000000000000000000000000000000000000..99f7abb485b4884d066429e14da90c72a82b5428 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_watch.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_database_watch() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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. Available 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.

    +
    +

    See also

    +
    +
    mongoc_client_watch()
    +
    +
    +
    mongoc_collection_watch()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_database_write_command_with_opts.html b/libmongoc/1.24.3/mongoc_database_write_command_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..4aa3a4c737f5b53af359f70a3bf6888f79132888 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_database_write_command_with_opts.html @@ -0,0 +1,253 @@ + + + + + + + + + + + + + + mongoc_database_write_command_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_delete_flags_t.html b/libmongoc/1.24.3/mongoc_delete_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f37630b279943a142d0162f31572d687a15b64a5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_delete_flags_t.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_delete_flags_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_error_has_label.html b/libmongoc/1.24.3/mongoc_error_has_label.html new file mode 100644 index 0000000000000000000000000000000000000000..1eb525fed4ed92423e5c5ee96d789a517a91d040 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_error_has_label.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_error_has_label() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_append.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_append.html new file mode 100644 index 0000000000000000000000000000000000000000..261813c967cfafc4199641db9dcc2969affc031d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_append.html @@ -0,0 +1,282 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_append() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_destroy.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..c87410565270ad6c0824cc53df01883c3f2e208c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_destroy.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_bypass_document_validation.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_bypass_document_validation.html new file mode 100644 index 0000000000000000000000000000000000000000..f939041ba94a25c585fa11a91b4d552630fb3e3a --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_fields.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_fields.html new file mode 100644 index 0000000000000000000000000000000000000000..56adf07a6d155f6bd427495ee319b0190e1a11d4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_fields.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_fields() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_flags.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_flags.html new file mode 100644 index 0000000000000000000000000000000000000000..59bded65a7226f6cad5ba885eb316e3df201fb5c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_flags.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_flags() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_max_time_ms.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_max_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..9116cda5cbaaa58b59f180c94f8f22d843d4a0ca --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_sort.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_sort.html new file mode 100644 index 0000000000000000000000000000000000000000..bd8009fd4fea76eeeb810fc4959b1d45f68c6ea9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_sort.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_sort() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_update.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_update.html new file mode 100644 index 0000000000000000000000000000000000000000..96d49fdd5a28f67a816b86d71c486d5c9dba6a4b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_get_update.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_get_update() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_new.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..71d68a17ccc5436424e186c7ac9755768e1ad1ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_bypass_document_validation.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_bypass_document_validation.html new file mode 100644 index 0000000000000000000000000000000000000000..84af3c73f34302999c2e2f42f9245a5bd8eefdb5 --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_fields.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_fields.html new file mode 100644 index 0000000000000000000000000000000000000000..8020d10d222336afe8e1d0490f0941e91b085432 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_fields.html @@ -0,0 +1,275 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_fields() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_flags.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_flags.html new file mode 100644 index 0000000000000000000000000000000000000000..e0e571747c6416ee2c13fd60658728fd3dfd8cf8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_flags.html @@ -0,0 +1,301 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_flags() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_max_time_ms.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_max_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..8e70a4e77de7e2f01bacb5298f4da65396fed7b0 --- /dev/null +++ b/libmongoc/1.24.3/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.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_sort.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_sort.html new file mode 100644 index 0000000000000000000000000000000000000000..3b3f56f73a2027dfd07fed8e5619c2795d1f1097 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_sort.html @@ -0,0 +1,278 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_sort() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_update.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_update.html new file mode 100644 index 0000000000000000000000000000000000000000..1dfb9a8948292fba7a313599a8292d307ac3be51 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_set_update.html @@ -0,0 +1,277 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_set_update() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_find_and_modify_opts_t.html b/libmongoc/1.24.3/mongoc_find_and_modify_opts_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3bba5c682ecadd530a71ecbcbbe1db3558fb70da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_find_and_modify_opts_t.html @@ -0,0 +1,701 @@ + + + + + + + + + + + + + + mongoc_find_and_modify_opts_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_get_major_version.html b/libmongoc/1.24.3/mongoc_get_major_version.html new file mode 100644 index 0000000000000000000000000000000000000000..ceb46edd47f9cfbc8f27f4e8add98c3ec4df98c5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_get_major_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_major_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_major_version()

    +
    +

    Synopsis

    +
    int
+mongoc_get_major_version (void);
+
    +
    +
    +
    +

    Returns

    +

    The value of MONGOC_MAJOR_VERSION when libmongoc was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_get_micro_version.html b/libmongoc/1.24.3/mongoc_get_micro_version.html new file mode 100644 index 0000000000000000000000000000000000000000..7df455e3b201dcf3d501e46292ff29aca04dfe0b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_get_micro_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_micro_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_micro_version()

    +
    +

    Synopsis

    +
    int
+mongoc_get_micro_version (void);
+
    +
    +
    +
    +

    Returns

    +

    The value of MONGOC_MICRO_VERSION when libmongoc was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_get_minor_version.html b/libmongoc/1.24.3/mongoc_get_minor_version.html new file mode 100644 index 0000000000000000000000000000000000000000..d617afe749bff19f9030bed322389f5216e53088 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_get_minor_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_minor_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_get_minor_version()

    +
    +

    Synopsis

    +
    int
+mongoc_get_minor_version (void);
+
    +
    +
    +
    +

    Returns

    +

    The value of MONGOC_MINOR_VERSION when libmongoc was compiled.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_get_version.html b/libmongoc/1.24.3/mongoc_get_version.html new file mode 100644 index 0000000000000000000000000000000000000000..493f1a7464283d4648107f21e640fc14e08324d3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_get_version.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_get_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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”.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_abort_upload.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_abort_upload.html new file mode 100644 index 0000000000000000000000000000000000000000..f2c4c63d41b29ab80ba5e80039847d24cc2695c0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_abort_upload.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_abort_upload() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_gridfs_bucket_open_upload_stream()
    +
    +
    +
    mongoc_gridfs_bucket_open_upload_stream_with_id()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_delete_by_id.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_delete_by_id.html new file mode 100644 index 0000000000000000000000000000000000000000..3637355625934e6030f8119737f8e02d07064e01 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_delete_by_id.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_delete_by_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_destroy.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..cb09ee172193a8bd606da79136c6066f1225543f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_download_to_stream.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_download_to_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..5fa6ecaf9b67ee6cd236a7d840269945a77771a1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_download_to_stream.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_download_to_stream() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_find.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_find.html new file mode 100644 index 0000000000000000000000000000000000000000..4761fa4ec00250defd08e169ca6df3fa31c2e550 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_find.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_find() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_new.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_new.html new file mode 100644 index 0000000000000000000000000000000000000000..551985511a5c65e13e6a9518e5fdb5d8a02c8f5d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_new.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_open_download_stream.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_open_download_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..5c49d41bd7f4b4e356b27f6295b1edb4b447381b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_open_download_stream.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_open_download_stream() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_gridfs_bucket_stream_error()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_open_upload_stream.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_open_upload_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..d9a6c4d2137015721c67ed99d8468199ab3d4b97 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_open_upload_stream.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_open_upload_stream() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_gridfs_bucket_open_upload_stream_with_id()
    +
    +
    +
    mongoc_gridfs_bucket_stream_error()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_open_upload_stream_with_id.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_open_upload_stream_with_id.html new file mode 100644 index 0000000000000000000000000000000000000000..c4b3732d74f18e6bb1efacbf2c066696e3c7072f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_open_upload_stream_with_id.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_open_upload_stream_with_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_gridfs_bucket_open_upload_stream()
    +
    +
    +
    mongoc_gridfs_bucket_stream_error()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_stream_error.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_stream_error.html new file mode 100644 index 0000000000000000000000000000000000000000..94f7174d5e454a2017bb4541b0da4aaded578516 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_stream_error.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_stream_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_gridfs_bucket_open_upload_stream()
    +
    +
    +
    mongoc_gridfs_bucket_open_upload_stream_with_id()
    +
    +
    +
    mongoc_gridfs_bucket_open_download_stream()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_t.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_t.html new file mode 100644 index 0000000000000000000000000000000000000000..fa505b61bc4526c8bbf4b9163ab95832ec517084 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_t.html @@ -0,0 +1,333 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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 MongoDB GridFS specification.
    +
    +
    +
    The non spec-compliant mongoc_gridfs_t.
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_upload_from_stream.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_upload_from_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..f0d49ca6b14c1aa53817c146f6819c57eb2b3cd6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_upload_from_stream.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_upload_from_stream() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_bucket_upload_from_stream_with_id.html b/libmongoc/1.24.3/mongoc_gridfs_bucket_upload_from_stream_with_id.html new file mode 100644 index 0000000000000000000000000000000000000000..daeb504f82c3a59b801881488a2e2f66ad62e94f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_bucket_upload_from_stream_with_id.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_gridfs_bucket_upload_from_stream_with_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_create_file.html b/libmongoc/1.24.3/mongoc_gridfs_create_file.html new file mode 100644 index 0000000000000000000000000000000000000000..2f1cec19ed24e17a8a0f15da2828e704c04c77a3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_create_file.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_gridfs_create_file() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_create_file_from_stream.html b/libmongoc/1.24.3/mongoc_gridfs_create_file_from_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..d9363340cc1742fe4bf0adbf6270e15d2b97b3c5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_create_file_from_stream.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_gridfs_create_file_from_stream() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_destroy.html b/libmongoc/1.24.3/mongoc_gridfs_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..5505b1d4d8ae132d6ca8f7753f6ea64057de0f95 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_drop.html b/libmongoc/1.24.3/mongoc_gridfs_drop.html new file mode 100644 index 0000000000000000000000000000000000000000..c864e8d74799f570d16093cbe30c64fa868b885c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_drop.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_drop() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_destroy.html b/libmongoc/1.24.3/mongoc_gridfs_file_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..27996140dc1cdb2900042f4a55ad396d5bcf128c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_error.html b/libmongoc/1.24.3/mongoc_gridfs_file_error.html new file mode 100644 index 0000000000000000000000000000000000000000..02b7465c24c7a3bd0586858860f84ce52c35416b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_error.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_aliases.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_aliases.html new file mode 100644 index 0000000000000000000000000000000000000000..e401fded7d76f333cf540cb5fbba3e5484ea384d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_aliases.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_aliases() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_chunk_size.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_chunk_size.html new file mode 100644 index 0000000000000000000000000000000000000000..61433836166104b63aab3a91dd567e1a2dc75d95 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_chunk_size.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_chunk_size() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_content_type.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_content_type.html new file mode 100644 index 0000000000000000000000000000000000000000..c1eb047cd24182c35dd7ecf036e5fa6d539e2ca9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_content_type.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_content_type() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_filename.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..1ffe15d48893d4b974b8ea53c0580e74f02796cd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_filename.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_filename() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_id.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_id.html new file mode 100644 index 0000000000000000000000000000000000000000..eda9da37e7ab02302f1c78603576b880dfa28338 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_id.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_length.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_length.html new file mode 100644 index 0000000000000000000000000000000000000000..ccda8c37f82757134a2bf65c2be047afdc839f0d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_length.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_length() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_md5.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_md5.html new file mode 100644 index 0000000000000000000000000000000000000000..ffe1452bfee3ab6596265ee2a04b1eb2ede8a8b9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_md5.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_md5() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_metadata.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_metadata.html new file mode 100644 index 0000000000000000000000000000000000000000..fca4d44cb39273ddae5e6bb1820a0407f4b56ff6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_metadata.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_metadata() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_get_upload_date.html b/libmongoc/1.24.3/mongoc_gridfs_file_get_upload_date.html new file mode 100644 index 0000000000000000000000000000000000000000..033b710bebdeda6b7cb89fcb92a46aa3e823d095 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_get_upload_date.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_get_upload_date() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_list_destroy.html b/libmongoc/1.24.3/mongoc_gridfs_file_list_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..09bbfa5291da88dbcd5b8734af559b2e62f05ee8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_list_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_list_error.html b/libmongoc/1.24.3/mongoc_gridfs_file_list_error.html new file mode 100644 index 0000000000000000000000000000000000000000..5325e53256e48754621c1d7415ab5dd61a084ed2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_list_error.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_list_next.html b/libmongoc/1.24.3/mongoc_gridfs_file_list_next.html new file mode 100644 index 0000000000000000000000000000000000000000..d78b2de7866461bb96b96cca632898e5f3c8eb56 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_list_next.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_next() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_list_t.html b/libmongoc/1.24.3/mongoc_gridfs_file_list_t.html new file mode 100644 index 0000000000000000000000000000000000000000..abc62d67fbed576c4ff2ff6f10710561416cba7e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_list_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_list_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_opt_t.html b/libmongoc/1.24.3/mongoc_gridfs_file_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f34d644bb6e924a556f854c348043f77758d3068 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_opt_t.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_opt_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_readv.html b/libmongoc/1.24.3/mongoc_gridfs_file_readv.html new file mode 100644 index 0000000000000000000000000000000000000000..34ca6f033efb49e7988dad382fded7f9506c2f86 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_readv.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_readv() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_remove.html b/libmongoc/1.24.3/mongoc_gridfs_file_remove.html new file mode 100644 index 0000000000000000000000000000000000000000..3e6900eae1ed3e250d9c904a2cbce6c05f2f7ca2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_remove.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_remove() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_save.html b/libmongoc/1.24.3/mongoc_gridfs_file_save.html new file mode 100644 index 0000000000000000000000000000000000000000..9bb7b0eead410fefdb3aa4ad401a821c88afe329 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_save.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_save() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_seek.html b/libmongoc/1.24.3/mongoc_gridfs_file_seek.html new file mode 100644 index 0000000000000000000000000000000000000000..24815b9f0740384d0ecd7fb120fe428bd0e97d2a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_seek.html @@ -0,0 +1,234 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_seek() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_set_aliases.html b/libmongoc/1.24.3/mongoc_gridfs_file_set_aliases.html new file mode 100644 index 0000000000000000000000000000000000000000..56d1f881b3fe4b1da849da1b84139f3f39653e3c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_set_aliases.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_aliases() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_set_content_type.html b/libmongoc/1.24.3/mongoc_gridfs_file_set_content_type.html new file mode 100644 index 0000000000000000000000000000000000000000..8f6264a4032e44be8810e7ab3ea6c3079950ca1f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_set_content_type.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_content_type() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_set_filename.html b/libmongoc/1.24.3/mongoc_gridfs_file_set_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..94e5b2a1d691d65be53c5d36f038378477fecb06 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_set_filename.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_filename() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_set_id.html b/libmongoc/1.24.3/mongoc_gridfs_file_set_id.html new file mode 100644 index 0000000000000000000000000000000000000000..1e5a9a800204885a5cbe3bcd487f092cc23e3bbc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_set_id.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_set_md5.html b/libmongoc/1.24.3/mongoc_gridfs_file_set_md5.html new file mode 100644 index 0000000000000000000000000000000000000000..ac615305c4ff66ebfcaecef41f865057767f26fd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_set_md5.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_md5() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_set_metadata.html b/libmongoc/1.24.3/mongoc_gridfs_file_set_metadata.html new file mode 100644 index 0000000000000000000000000000000000000000..0ee95f9375604818fc3a79d2a4b91b4e131a7872 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_set_metadata.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_set_metadata() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_t.html b/libmongoc/1.24.3/mongoc_gridfs_file_t.html new file mode 100644 index 0000000000000000000000000000000000000000..aa0ce7d29e08c6682323caa5bb5d08c8fe838b09 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_t.html @@ -0,0 +1,242 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    + +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_tell.html b/libmongoc/1.24.3/mongoc_gridfs_file_tell.html new file mode 100644 index 0000000000000000000000000000000000000000..66e92a6b671cf9cc0d5b282d8c20fa251468c438 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_tell.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_tell() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_file_writev.html b/libmongoc/1.24.3/mongoc_gridfs_file_writev.html new file mode 100644 index 0000000000000000000000000000000000000000..795a2f4a2b19debd827dece7d586aff3a01a9bef --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_file_writev.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_gridfs_file_writev() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_find.html b/libmongoc/1.24.3/mongoc_gridfs_find.html new file mode 100644 index 0000000000000000000000000000000000000000..bf95f891a170bfc71244a70311634a90e43d3d0c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_find.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_gridfs_find() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_find_one.html b/libmongoc/1.24.3/mongoc_gridfs_find_one.html new file mode 100644 index 0000000000000000000000000000000000000000..44a85563d8d524f7fce24247bcfc03bdc483a9a3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_find_one.html @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_one() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_find_one_by_filename.html b/libmongoc/1.24.3/mongoc_gridfs_find_one_by_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..03f6b74e050190d17a9afa86f67409e3ed2b9615 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_find_one_by_filename.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_one_by_filename() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_find_one_with_opts.html b/libmongoc/1.24.3/mongoc_gridfs_find_one_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..cd7010f7683bdf6679331fe29a149217cb4c4029 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_find_one_with_opts.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_one_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_find_with_opts.html b/libmongoc/1.24.3/mongoc_gridfs_find_with_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..1a248b31a80e27bcda277132af366a3b594661f9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_find_with_opts.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_gridfs_find_with_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_get_chunks.html b/libmongoc/1.24.3/mongoc_gridfs_get_chunks.html new file mode 100644 index 0000000000000000000000000000000000000000..36430ede2ddeceef95780e24db079b3564295757 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_get_chunks.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_get_chunks() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_get_files.html b/libmongoc/1.24.3/mongoc_gridfs_get_files.html new file mode 100644 index 0000000000000000000000000000000000000000..57313782840545f3c0d6a56905476ca75b624db5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_get_files.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_gridfs_get_files() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_remove_by_filename.html b/libmongoc/1.24.3/mongoc_gridfs_remove_by_filename.html new file mode 100644 index 0000000000000000000000000000000000000000..2d6cb604072e4e6e8efd9232f0acbb3cbe5513ce --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_remove_by_filename.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_gridfs_remove_by_filename() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_gridfs_t.html b/libmongoc/1.24.3/mongoc_gridfs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..1d7de48556dc2f53f31b7d43d5fbc1be6ec08b1a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_gridfs_t.html @@ -0,0 +1,403 @@ + + + + + + + + + + + + + + mongoc_gridfs_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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 MongoDB GridFS specification.
    +
    +
    +
    The spec-compliant mongoc_gridfs_bucket_t.
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_handshake_data_append.html b/libmongoc/1.24.3/mongoc_handshake_data_append.html new file mode 100644 index 0000000000000000000000000000000000000000..f89dc6eb7cb5491affed3553ffce1e35167cc2e1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_handshake_data_append.html @@ -0,0 +1,255 @@ + + + + + + + + + + + + + + mongoc_handshake_data_append() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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"
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_host_list_t.html b/libmongoc/1.24.3/mongoc_host_list_t.html new file mode 100644 index 0000000000000000000000000000000000000000..5ac8c61f930134f91bf1dd0757020e341c2f5c8f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_host_list_t.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_host_list_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_uri_get_hosts() and mongoc_cursor_get_host().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_geo_get_default.html b/libmongoc/1.24.3/mongoc_index_opt_geo_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..d435715a6cc279234cc49eeadd1d61dc3bdc2c43 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_geo_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_index_opt_geo_get_default() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_geo_init.html b/libmongoc/1.24.3/mongoc_index_opt_geo_init.html new file mode 100644 index 0000000000000000000000000000000000000000..04b0a97108fa5c6f5d7f108a083902ffc21cf013 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_geo_init.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_index_opt_geo_init() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_geo_t.html b/libmongoc/1.24.3/mongoc_index_opt_geo_t.html new file mode 100644 index 0000000000000000000000000000000000000000..4116125537e00332fb973f6d4ae653943839bdd7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_geo_t.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_index_opt_geo_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_index_opt_t
    +
    +
    +
    mongoc_index_opt_wt_t
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_get_default.html b/libmongoc/1.24.3/mongoc_index_opt_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..004432951e8d9a265fa6534f976a36d778393d56 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_index_opt_get_default() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_init.html b/libmongoc/1.24.3/mongoc_index_opt_init.html new file mode 100644 index 0000000000000000000000000000000000000000..ee4fd4e60c4d18ba22d7832c9ef96895befe88d6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_init.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_index_opt_init() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_t.html b/libmongoc/1.24.3/mongoc_index_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..970486c2d4d69c81710e649a52b6f8262df16415 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_t.html @@ -0,0 +1,270 @@ + + + + + + + + + + + + + + mongoc_index_opt_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+}
+
    +
    +
    +

    See also

    +
    +
    mongoc_index_opt_geo_t
    +
    +
    +
    mongoc_index_opt_wt_t
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_wt_get_default.html b/libmongoc/1.24.3/mongoc_index_opt_wt_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..5cd93530034eba29e76a02b863842c7d864c108d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_wt_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_index_opt_wt_get_default() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_wt_init.html b/libmongoc/1.24.3/mongoc_index_opt_wt_init.html new file mode 100644 index 0000000000000000000000000000000000000000..e397aa4baa5a4d34c71bc13b47a4f10e06359edf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_wt_init.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_index_opt_wt_init() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_index_opt_wt_t.html b/libmongoc/1.24.3/mongoc_index_opt_wt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..af92732d41a3b3353dc788a34cbf65bee3c35742 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_index_opt_wt_t.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_index_opt_wt_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_index_opt_t
    +
    +
    +
    mongoc_index_opt_geo_t
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_init.html b/libmongoc/1.24.3/mongoc_init.html new file mode 100644 index 0000000000000000000000000000000000000000..5d7400c164ba1f6b47b7f90edf3d3380ad780724 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_init.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_init() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_insert_flags_t.html b/libmongoc/1.24.3/mongoc_insert_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..65a87ed08e36287ecc1ad615636c3e2c58513695 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_insert_flags_t.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_insert_flags_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_iovec_t.html b/libmongoc/1.24.3/mongoc_iovec_t.html new file mode 100644 index 0000000000000000000000000000000000000000..103181da4871be0c26e38cc9a556867067a74a31 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_iovec_t.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_iovec_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_optional_copy.html b/libmongoc/1.24.3/mongoc_optional_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..31ed0e87f82aea926489a8c028c51915673df280 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_optional_copy.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_optional_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_optional_init.html b/libmongoc/1.24.3/mongoc_optional_init.html new file mode 100644 index 0000000000000000000000000000000000000000..17ea3f407682c22f075d07e38d201af93ceeb798 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_optional_init.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_optional_init() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    mongoc_optional_init()

    +
    +

    Synopsis

    +
    void
+mongoc_optional_init (mongoc_optional_t *opt);
+
    +
    +

    Initializes values for a mongoc_optional_t.

    +
    +
    +

    Parameters

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_optional_is_set.html b/libmongoc/1.24.3/mongoc_optional_is_set.html new file mode 100644 index 0000000000000000000000000000000000000000..dfeef7cccd2eca7f7e283ee0eccbe28c7f88ce5d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_optional_is_set.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_optional_is_set() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_optional_set_value.html b/libmongoc/1.24.3/mongoc_optional_set_value.html new file mode 100644 index 0000000000000000000000000000000000000000..e092f25b5191472803f2d96605c4b47dd4a83246 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_optional_set_value.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_optional_set_value() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_optional_t.html b/libmongoc/1.24.3/mongoc_optional_t.html new file mode 100644 index 0000000000000000000000000000000000000000..d663919abe2622569c114399424c5178a3a82cda --- /dev/null +++ b/libmongoc/1.24.3/mongoc_optional_t.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_optional_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_optional_value.html b/libmongoc/1.24.3/mongoc_optional_value.html new file mode 100644 index 0000000000000000000000000000000000000000..e8b0e6172ac7edc2dd2176e024657c30a513c4ce --- /dev/null +++ b/libmongoc/1.24.3/mongoc_optional_value.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_optional_value() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_query_flags_t.html b/libmongoc/1.24.3/mongoc_query_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..122c76d056236c1908754145c3fc046b7ee720d5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_query_flags_t.html @@ -0,0 +1,235 @@ + + + + + + + + + + + + + + mongoc_query_flags_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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).

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_rand.html b/libmongoc/1.24.3/mongoc_rand.html new file mode 100644 index 0000000000000000000000000000000000000000..d596a54f82e0109f8ab429f868a247421d0304ea --- /dev/null +++ b/libmongoc/1.24.3/mongoc_rand.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_rand — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_rand_add.html b/libmongoc/1.24.3/mongoc_rand_add.html new file mode 100644 index 0000000000000000000000000000000000000000..6149289416b82252467c77e37f2d759eac0fa957 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_rand_add.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_rand_add() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_rand_seed.html b/libmongoc/1.24.3/mongoc_rand_seed.html new file mode 100644 index 0000000000000000000000000000000000000000..d09844c6d6e32a388a40deb8119e860a1dce7db5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_rand_seed.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_rand_seed() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_rand_status.html b/libmongoc/1.24.3/mongoc_rand_status.html new file mode 100644 index 0000000000000000000000000000000000000000..43515239fd6a05d9a7a85d8d94c71c622dfd742e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_rand_status.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_rand_status() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_append.html b/libmongoc/1.24.3/mongoc_read_concern_append.html new file mode 100644 index 0000000000000000000000000000000000000000..073899607a1b1514b7112052a19f241bb8ffb42d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_append.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_read_concern_append() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_copy.html b/libmongoc/1.24.3/mongoc_read_concern_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..4db57f246339b255c113523cb5b6c272cf87a9ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_concern_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_destroy.html b/libmongoc/1.24.3/mongoc_read_concern_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..f885362c9c315fe1df5648ade11f93acfdae41da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_concern_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_get_level.html b/libmongoc/1.24.3/mongoc_read_concern_get_level.html new file mode 100644 index 0000000000000000000000000000000000000000..71cb742b11aa0f30b6cf3809852a4bcc5ea6f202 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_get_level.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_concern_get_level() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_is_default.html b/libmongoc/1.24.3/mongoc_read_concern_is_default.html new file mode 100644 index 0000000000000000000000000000000000000000..5660988ea1b33f27754b47f109c3340ecdd605e4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_is_default.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_concern_is_default() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_new.html b/libmongoc/1.24.3/mongoc_read_concern_new.html new file mode 100644 index 0000000000000000000000000000000000000000..b1cc4a3ad376a04f0c73cef248d4680f1649cebe --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_read_concern_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_set_level.html b/libmongoc/1.24.3/mongoc_read_concern_set_level.html new file mode 100644 index 0000000000000000000000000000000000000000..0b361420c60fe716433f66ed11f67ecc69c55878 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_set_level.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_read_concern_set_level() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_concern_t.html b/libmongoc/1.24.3/mongoc_read_concern_t.html new file mode 100644 index 0000000000000000000000000000000000000000..670f840d95ed834bde51a6fa25b93d99b09bc195 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_concern_t.html @@ -0,0 +1,241 @@ + + + + + + + + + + + + + + mongoc_read_concern_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_mode_t.html b/libmongoc/1.24.3/mongoc_read_mode_t.html new file mode 100644 index 0000000000000000000000000000000000000000..de458335e4c9df357b56ff7352e9a605a3eb8c08 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_mode_t.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_mode_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_add_tag.html b/libmongoc/1.24.3/mongoc_read_prefs_add_tag.html new file mode 100644 index 0000000000000000000000000000000000000000..ac9b72e84980881d40714a55602ad910d6f7dd8c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_add_tag.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_read_prefs_add_tag() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_copy.html b/libmongoc/1.24.3/mongoc_read_prefs_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..5b8cf02f23144d53b2ec49331b6e6cf558c7769a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_prefs_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_destroy.html b/libmongoc/1.24.3/mongoc_read_prefs_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..2234ff733c6c85fbc252c9a2cda979d30ca63bd2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_read_prefs_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_get_hedge.html b/libmongoc/1.24.3/mongoc_read_prefs_get_hedge.html new file mode 100644 index 0000000000000000000000000000000000000000..019dbc2bfdfa81909e02bb8daf95748037fbe685 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_get_hedge.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_hedge() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_get_max_staleness_seconds.html b/libmongoc/1.24.3/mongoc_read_prefs_get_max_staleness_seconds.html new file mode 100644 index 0000000000000000000000000000000000000000..eb90275ccb50c4722a910af13e289e65a95dff63 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_get_max_staleness_seconds.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_max_staleness_seconds() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_get_mode.html b/libmongoc/1.24.3/mongoc_read_prefs_get_mode.html new file mode 100644 index 0000000000000000000000000000000000000000..4ad2dff6145e79cfae0ddc7e80a05a50d6a3be69 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_get_mode.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_mode() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_get_tags.html b/libmongoc/1.24.3/mongoc_read_prefs_get_tags.html new file mode 100644 index 0000000000000000000000000000000000000000..1142c256dfc52a8a1e66dd5e0590bda0fd9868d6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_get_tags.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_read_prefs_get_tags() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_is_valid.html b/libmongoc/1.24.3/mongoc_read_prefs_is_valid.html new file mode 100644 index 0000000000000000000000000000000000000000..a02208b5cc0ef7b39fa4263d8ef9bf39e882f74a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_is_valid.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_prefs_is_valid() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_new.html b/libmongoc/1.24.3/mongoc_read_prefs_new.html new file mode 100644 index 0000000000000000000000000000000000000000..8ee6c078615604b8f72864b7c8972bc1b7973ebc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_new.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_read_prefs_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_set_hedge.html b/libmongoc/1.24.3/mongoc_read_prefs_set_hedge.html new file mode 100644 index 0000000000000000000000000000000000000000..af864c3538ab2f5f9986d06d3626fbba3ec4d6ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_set_hedge.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_hedge() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_set_max_staleness_seconds.html b/libmongoc/1.24.3/mongoc_read_prefs_set_max_staleness_seconds.html new file mode 100644 index 0000000000000000000000000000000000000000..0f620b95342980b4c9fb3468da854c85befc4a0e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_set_max_staleness_seconds.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_max_staleness_seconds() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_set_mode.html b/libmongoc/1.24.3/mongoc_read_prefs_set_mode.html new file mode 100644 index 0000000000000000000000000000000000000000..d44024e56f699d341ae4b0d4f0c218098d1275b5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_set_mode.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_mode() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_set_tags.html b/libmongoc/1.24.3/mongoc_read_prefs_set_tags.html new file mode 100644 index 0000000000000000000000000000000000000000..503997e31d88193536fbdf67c1d9e93c874f79bd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_set_tags.html @@ -0,0 +1,272 @@ + + + + + + + + + + + + + + mongoc_read_prefs_set_tags() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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();
+}
+
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_read_prefs_t.html b/libmongoc/1.24.3/mongoc_read_prefs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..d0858be6c855f8d578e697385124e942e43f8516 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_read_prefs_t.html @@ -0,0 +1,271 @@ + + + + + + + + + + + + + + mongoc_read_prefs_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_remove_flags_t.html b/libmongoc/1.24.3/mongoc_remove_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..63013ff78258af280869600b5b6d2c6769fc0d53 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_remove_flags_t.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_remove_flags_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_reply_flags_t.html b/libmongoc/1.24.3/mongoc_reply_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..803665dffcacd26d3f9da00c265a239f3c6dfd3e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_reply_flags_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_reply_flags_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_copy.html b/libmongoc/1.24.3/mongoc_server_api_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..165cbfed58b296e33a20b61be77439cf040f94e0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_copy.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_server_api_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_deprecation_errors.html b/libmongoc/1.24.3/mongoc_server_api_deprecation_errors.html new file mode 100644 index 0000000000000000000000000000000000000000..fb19e686ce9b4cbc67cbf4c53ba2eaf46b6e8fb0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_deprecation_errors.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_server_api_deprecation_errors() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_destroy.html b/libmongoc/1.24.3/mongoc_server_api_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..181979a875311d3472b88595e4dd23c2a9f2a384 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_destroy.html @@ -0,0 +1,192 @@ + + + + + + + + + + + + + + mongoc_server_api_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_get_deprecation_errors.html b/libmongoc/1.24.3/mongoc_server_api_get_deprecation_errors.html new file mode 100644 index 0000000000000000000000000000000000000000..cebc12296a2c38834e3ef8555d306f1b72ecddb1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_get_deprecation_errors.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_get_deprecation_errors() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_get_strict.html b/libmongoc/1.24.3/mongoc_server_api_get_strict.html new file mode 100644 index 0000000000000000000000000000000000000000..a082cf9d2d38bfc9967476662b33439b2d297b91 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_get_strict.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_get_strict() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_get_version.html b/libmongoc/1.24.3/mongoc_server_api_get_version.html new file mode 100644 index 0000000000000000000000000000000000000000..90f1b7518fba581db15959610e077643f98d3ab8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_get_version.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_get_version() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_new.html b/libmongoc/1.24.3/mongoc_server_api_new.html new file mode 100644 index 0000000000000000000000000000000000000000..811ca9e209e32bf48f155bd308d6481717791c64 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_new.html @@ -0,0 +1,197 @@ + + + + + + + + + + + + + + mongoc_server_api_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_strict.html b/libmongoc/1.24.3/mongoc_server_api_strict.html new file mode 100644 index 0000000000000000000000000000000000000000..191fce8b96a90b291dfef3ff67a77901264db2b4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_strict.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_server_api_strict() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_t.html b/libmongoc/1.24.3/mongoc_server_api_t.html new file mode 100644 index 0000000000000000000000000000000000000000..7b854588096de1e4e1e85309a7f40e1dd40649e0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_t.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_server_api_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_version_from_string.html b/libmongoc/1.24.3/mongoc_server_api_version_from_string.html new file mode 100644 index 0000000000000000000000000000000000000000..a4b88ba0515c269b27040d24551a0ea080daa435 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_version_from_string.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + mongoc_server_api_version_from_string() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_version_t.html b/libmongoc/1.24.3/mongoc_server_api_version_t.html new file mode 100644 index 0000000000000000000000000000000000000000..bc70ab1f28466c697442daa17b4a14a891b1bdf9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_version_t.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_server_api_version_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_api_version_to_string.html b/libmongoc/1.24.3/mongoc_server_api_version_to_string.html new file mode 100644 index 0000000000000000000000000000000000000000..8e265927fbcd0283b5f2695106e987de344cba02 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_api_version_to_string.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_api_version_to_string() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_destroy.html b/libmongoc/1.24.3/mongoc_server_description_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..de64965f21886a33715c1d1c3a5d8e9c2face78a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_server_description_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_hello_response.html b/libmongoc/1.24.3/mongoc_server_description_hello_response.html new file mode 100644 index 0000000000000000000000000000000000000000..81c317f9703b0b590816700ff06507863cd6a52b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_hello_response.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_server_description_hello_response() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_host.html b/libmongoc/1.24.3/mongoc_server_description_host.html new file mode 100644 index 0000000000000000000000000000000000000000..2cf2250177c413e2959ffb72e9d4c1d1ac5c41f7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_host.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_server_description_host() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_id.html b/libmongoc/1.24.3/mongoc_server_description_id.html new file mode 100644 index 0000000000000000000000000000000000000000..fbbf20e697ec5a2c47960bf19b751b2105a5b2c4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_id.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_server_description_id() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_ismaster.html b/libmongoc/1.24.3/mongoc_server_description_ismaster.html new file mode 100644 index 0000000000000000000000000000000000000000..5bd9d14c0b1d8eb875d8d3f3a898a9e26b246831 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_ismaster.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_server_description_ismaster() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_last_update_time.html b/libmongoc/1.24.3/mongoc_server_description_last_update_time.html new file mode 100644 index 0000000000000000000000000000000000000000..7751318e60b740799b26f8d3d048281df0063c42 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_last_update_time.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_server_description_last_update_time() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_new_copy.html b/libmongoc/1.24.3/mongoc_server_description_new_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..4b348ba1472dcd52c51c22bb5b0d7ff3bd0237c3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_new_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_server_description_new_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_round_trip_time.html b/libmongoc/1.24.3/mongoc_server_description_round_trip_time.html new file mode 100644 index 0000000000000000000000000000000000000000..a46e57752e7947868b1974798049718d7622a1da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_round_trip_time.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_server_description_round_trip_time() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_t.html b/libmongoc/1.24.3/mongoc_server_description_t.html new file mode 100644 index 0000000000000000000000000000000000000000..ee62c4c11a379012fc427844b364dfae0a2077c3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_t.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_server_description_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_get_server_descriptions().
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_description_type.html b/libmongoc/1.24.3/mongoc_server_description_type.html new file mode 100644 index 0000000000000000000000000000000000000000..7821aa63c1ad4393ef4248b85132817778740efc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_description_type.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_server_description_type() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_server_descriptions_destroy_all.html b/libmongoc/1.24.3/mongoc_server_descriptions_destroy_all.html new file mode 100644 index 0000000000000000000000000000000000000000..04051c94787f321627f2613dfde08c2f67c2b52b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_server_descriptions_destroy_all.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_server_descriptions_destroy_all() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opt_t.html b/libmongoc/1.24.3/mongoc_session_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..9bec89bd7c6a1732f0683eda5aa736863a9cecad --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opt_t.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_session_opt_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_clone.html b/libmongoc/1.24.3/mongoc_session_opts_clone.html new file mode 100644 index 0000000000000000000000000000000000000000..fdef01bf5cfa3ace384cd0309ee92ec5d55bdf65 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_clone.html @@ -0,0 +1,305 @@ + + + + + + + + + + + + + + mongoc_session_opts_clone() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_destroy.html b/libmongoc/1.24.3/mongoc_session_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..b56b32838a5bee1e0cebc866f5d80130bbea6d2e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_destroy.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_session_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_get_causal_consistency.html b/libmongoc/1.24.3/mongoc_session_opts_get_causal_consistency.html new file mode 100644 index 0000000000000000000000000000000000000000..09de87ccf760d8074003fe54758156c597df9b6b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_get_causal_consistency.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_causal_consistency() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_get_default_transaction_opts.html b/libmongoc/1.24.3/mongoc_session_opts_get_default_transaction_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..1ac1ad8a07db8e3262fb22b4968714478bbce3d0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_get_default_transaction_opts.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_default_transaction_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_get_snapshot.html b/libmongoc/1.24.3/mongoc_session_opts_get_snapshot.html new file mode 100644 index 0000000000000000000000000000000000000000..e075afd092de2042c92e8f401b525fe082c3a390 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_get_snapshot.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_snapshot() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_get_transaction_opts.html b/libmongoc/1.24.3/mongoc_session_opts_get_transaction_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..884ce5145b29c7724e203e8e9eb56939ca06fba9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_get_transaction_opts.html @@ -0,0 +1,306 @@ + + + + + + + + + + + + + + mongoc_session_opts_get_transaction_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_new.html b/libmongoc/1.24.3/mongoc_session_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..9385c05c39e7e9beae13f9c70e288edcbce3e604 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_new.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_session_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_set_causal_consistency.html b/libmongoc/1.24.3/mongoc_session_opts_set_causal_consistency.html new file mode 100644 index 0000000000000000000000000000000000000000..2cc92816372b827e24fc92719007a12d6f2d0532 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_set_causal_consistency.html @@ -0,0 +1,346 @@ + + + + + + + + + + + + + + mongoc_session_opts_set_causal_consistency() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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 ();
+}
+
    +
    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_set_default_transaction_opts.html b/libmongoc/1.24.3/mongoc_session_opts_set_default_transaction_opts.html new file mode 100644 index 0000000000000000000000000000000000000000..a2b55efe3f90139b3a111d058677958561b50410 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_set_default_transaction_opts.html @@ -0,0 +1,309 @@ + + + + + + + + + + + + + + mongoc_session_opts_set_default_transaction_opts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_session_opts_set_snapshot.html b/libmongoc/1.24.3/mongoc_session_opts_set_snapshot.html new file mode 100644 index 0000000000000000000000000000000000000000..d930487fefaaca4a4d5d2af1a8aa3d13a05245df --- /dev/null +++ b/libmongoc/1.24.3/mongoc_session_opts_set_snapshot.html @@ -0,0 +1,343 @@ + + + + + + + + + + + + + + mongoc_session_opts_set_snapshot() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_accept.html b/libmongoc/1.24.3/mongoc_socket_accept.html new file mode 100644 index 0000000000000000000000000000000000000000..eb1c871ca0c5515c690bb5b9772e58a076b252a1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_accept.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_socket_accept() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_bind.html b/libmongoc/1.24.3/mongoc_socket_bind.html new file mode 100644 index 0000000000000000000000000000000000000000..521c34482b30d135e2b131a2eb7048e37b04f1eb --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_bind.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_socket_bind() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_close.html b/libmongoc/1.24.3/mongoc_socket_close.html new file mode 100644 index 0000000000000000000000000000000000000000..6b32e0a5c2a546c3c2b078d49acd6129dbb6b969 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_close.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_socket_close() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_connect.html b/libmongoc/1.24.3/mongoc_socket_connect.html new file mode 100644 index 0000000000000000000000000000000000000000..5775a0cb6a83abe0d9af041ea7f671b4394736bf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_connect.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_socket_connect() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_destroy.html b/libmongoc/1.24.3/mongoc_socket_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..4472c0a743794626e7de58486eb4fc44540eaacb --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_socket_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_errno.html b/libmongoc/1.24.3/mongoc_socket_errno.html new file mode 100644 index 0000000000000000000000000000000000000000..8907d385f7e76c45d9a0eac55e40a9364d461e89 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_errno.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_socket_errno() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_getnameinfo.html b/libmongoc/1.24.3/mongoc_socket_getnameinfo.html new file mode 100644 index 0000000000000000000000000000000000000000..58619a814e54a01ab0de74282f3c3918a981cad2 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_getnameinfo.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_socket_getnameinfo() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_getsockname.html b/libmongoc/1.24.3/mongoc_socket_getsockname.html new file mode 100644 index 0000000000000000000000000000000000000000..e4549243af4649f63b62c27d84673febf0a43795 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_getsockname.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_socket_getsockname() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_listen.html b/libmongoc/1.24.3/mongoc_socket_listen.html new file mode 100644 index 0000000000000000000000000000000000000000..29591eea04017986210ddf1071cd6c57e7f2dc6b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_listen.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_socket_listen() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_new.html b/libmongoc/1.24.3/mongoc_socket_new.html new file mode 100644 index 0000000000000000000000000000000000000000..26fd1c0364c9bdcf39ba7371d7d6721a381e75ee --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_new.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_socket_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_recv.html b/libmongoc/1.24.3/mongoc_socket_recv.html new file mode 100644 index 0000000000000000000000000000000000000000..0b61af09e2ac1c8ab4fa9e5b14c374a5259bfb72 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_recv.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_socket_recv() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_send.html b/libmongoc/1.24.3/mongoc_socket_send.html new file mode 100644 index 0000000000000000000000000000000000000000..35a264e61380514b556f14f8507526299cbef7cc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_send.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_socket_send() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_sendv.html b/libmongoc/1.24.3/mongoc_socket_sendv.html new file mode 100644 index 0000000000000000000000000000000000000000..55489fd2f1a155bd70c6812af49784eb8e9cd7e3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_sendv.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_socket_sendv() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_setsockopt.html b/libmongoc/1.24.3/mongoc_socket_setsockopt.html new file mode 100644 index 0000000000000000000000000000000000000000..8c88b05a8d43ba9d19c4d432b0e81f32af16c7b1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_setsockopt.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_socket_setsockopt() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_socket_t.html b/libmongoc/1.24.3/mongoc_socket_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2bc2ac8298fd971c68268e666568909cca120e7c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_socket_t.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_socket_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_ssl_opt_get_default.html b/libmongoc/1.24.3/mongoc_ssl_opt_get_default.html new file mode 100644 index 0000000000000000000000000000000000000000..03ec072c0c93358bd2891bab0f79b8301e27e6b1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_ssl_opt_get_default.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_ssl_opt_get_default() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_ssl_opt_t.html b/libmongoc/1.24.3/mongoc_ssl_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..2caf4abc7f124f78e004cd299d144e941543ebd7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_ssl_opt_t.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_ssl_opt_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Configuring TLS
    +
    +
    +
    mongoc_client_set_ssl_opts()
    +
    +
    +
    mongoc_client_pool_set_ssl_opts()
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_buffered_new.html b/libmongoc/1.24.3/mongoc_stream_buffered_new.html new file mode 100644 index 0000000000000000000000000000000000000000..0583d207643fc8602c81c2b0315195010c386f28 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_buffered_new.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_stream_buffered_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_buffered_t.html b/libmongoc/1.24.3/mongoc_stream_buffered_t.html new file mode 100644 index 0000000000000000000000000000000000000000..72ddcf0b2c1277f0b40143e5a210390611b9f466 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_buffered_t.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_stream_buffered_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_buffered_new()
    +
    +
    +
    mongoc_stream_destroy()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_close.html b/libmongoc/1.24.3/mongoc_stream_close.html new file mode 100644 index 0000000000000000000000000000000000000000..e60f1e0ee279411892125df2296297eadbb4eb1e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_close.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_stream_close() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    +
    mongoc_stream_destroy()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_cork.html b/libmongoc/1.24.3/mongoc_stream_cork.html new file mode 100644 index 0000000000000000000000000000000000000000..fc1c759a9101cb100df557e14be85ab740acf022 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_cork.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_stream_cork() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_buffered_new().
    +
    +
    +
    mongoc_stream_uncork().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_destroy.html b/libmongoc/1.24.3/mongoc_stream_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..8537d62566389fb5589c68b5a2e00d30be0b6393 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_destroy.html @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + mongoc_stream_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_file_get_fd.html b/libmongoc/1.24.3/mongoc_stream_file_get_fd.html new file mode 100644 index 0000000000000000000000000000000000000000..389c1268dc26804e8254ec98cfc8ba20d401ee47 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_file_get_fd.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_stream_file_get_fd() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_file_new.html b/libmongoc/1.24.3/mongoc_stream_file_new.html new file mode 100644 index 0000000000000000000000000000000000000000..33fa8b086dba3084fae2c205571c7118f1a463ff --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_file_new.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_stream_file_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_file_new_for_path.html b/libmongoc/1.24.3/mongoc_stream_file_new_for_path.html new file mode 100644 index 0000000000000000000000000000000000000000..55c8be00f51d9f45195324ccd0c168382eaabfe1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_file_new_for_path.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_stream_file_new_for_path() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_file_t.html b/libmongoc/1.24.3/mongoc_stream_file_t.html new file mode 100644 index 0000000000000000000000000000000000000000..02efe7ba7eced22bbda921df70052524bb14f10e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_file_t.html @@ -0,0 +1,200 @@ + + + + + + + + + + + + + + mongoc_stream_file_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_flush.html b/libmongoc/1.24.3/mongoc_stream_flush.html new file mode 100644 index 0000000000000000000000000000000000000000..c58cdf01ee26875bd6c73415c582bb81e38937aa --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_flush.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_stream_flush() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_get_base_stream.html b/libmongoc/1.24.3/mongoc_stream_get_base_stream.html new file mode 100644 index 0000000000000000000000000000000000000000..a7d301c089921b78e41281fcd0759e2f581502f9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_get_base_stream.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_stream_get_base_stream() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_gridfs_new.html b/libmongoc/1.24.3/mongoc_stream_gridfs_new.html new file mode 100644 index 0000000000000000000000000000000000000000..1aa6f602879e96fa99828322735d41c9c0b872e8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_gridfs_new.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_stream_gridfs_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_read.html b/libmongoc/1.24.3/mongoc_stream_read.html new file mode 100644 index 0000000000000000000000000000000000000000..f4c09665f6bfea7826d9d2c87b4b94179d0f5af5 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_read.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_stream_read() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_readv()
    +
    +
    +
    mongoc_stream_write()
    +
    +
    +
    mongoc_stream_writev()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_readv.html b/libmongoc/1.24.3/mongoc_stream_readv.html new file mode 100644 index 0000000000000000000000000000000000000000..cc5d52e7b3a2653260831ea23e7bb8a04db3f0f1 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_readv.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_stream_readv() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_read()
    +
    +
    +
    mongoc_stream_write()
    +
    +
    +
    mongoc_stream_writev()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_setsockopt.html b/libmongoc/1.24.3/mongoc_stream_setsockopt.html new file mode 100644 index 0000000000000000000000000000000000000000..6cbc66db241f00ef350faec99af167add339d62a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_setsockopt.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_stream_setsockopt() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_should_retry.html b/libmongoc/1.24.3/mongoc_stream_should_retry.html new file mode 100644 index 0000000000000000000000000000000000000000..a92bfefdbbc14fbaa1cb43fc843616ff0a027770 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_should_retry.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_stream_should_retry() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_socket_get_socket.html b/libmongoc/1.24.3/mongoc_stream_socket_get_socket.html new file mode 100644 index 0000000000000000000000000000000000000000..636de43b11985ee8ba008e938ee16c82558328ff --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_socket_get_socket.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_stream_socket_get_socket() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_socket_new.html b/libmongoc/1.24.3/mongoc_stream_socket_new.html new file mode 100644 index 0000000000000000000000000000000000000000..b14a95bb68687bcaed374f81754b577ef2f12156 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_socket_new.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_stream_socket_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_socket_t.html b/libmongoc/1.24.3/mongoc_stream_socket_t.html new file mode 100644 index 0000000000000000000000000000000000000000..3ad1b351b1192d95ba18de09001c11a18256d362 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_socket_t.html @@ -0,0 +1,199 @@ + + + + + + + + + + + + + + mongoc_stream_socket_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_t.html b/libmongoc/1.24.3/mongoc_stream_t.html new file mode 100644 index 0000000000000000000000000000000000000000..96d516a12c76b6a9a7e9192e2711007b97f2d779 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_t.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_stream_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_buffered_t
    +
    +
    +
    mongoc_stream_file_t
    +
    +
    +
    mongoc_stream_socket_t
    +
    +
    +
    mongoc_stream_tls_t
    +
    +
    +
    +
    +

    Functions

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_timed_out.html b/libmongoc/1.24.3/mongoc_stream_timed_out.html new file mode 100644 index 0000000000000000000000000000000000000000..2117ec1ad8e483ecc51f938d62ee82854b33a9a8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_timed_out.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_stream_timed_out() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_tls_t.html b/libmongoc/1.24.3/mongoc_stream_tls_t.html new file mode 100644 index 0000000000000000000000000000000000000000..546ac4b8c2a75bf08b7fc387b6dffe980d7e51a4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_tls_t.html @@ -0,0 +1,190 @@ + + + + + + + + + + + + + + mongoc_stream_tls_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_uncork.html b/libmongoc/1.24.3/mongoc_stream_uncork.html new file mode 100644 index 0000000000000000000000000000000000000000..80be1329ba235da5ed62d0688354f3230369ffe6 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_uncork.html @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + mongoc_stream_uncork() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_buffered_new().
    +
    +
    +
    mongoc_stream_cork().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_write.html b/libmongoc/1.24.3/mongoc_stream_write.html new file mode 100644 index 0000000000000000000000000000000000000000..364fc8abd51bd63057d995a0cf48f2281479f08a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_write.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_stream_write() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_stream_read()
    +
    +
    +
    mongoc_stream_readv()
    +
    +
    +
    mongoc_stream_writev()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_stream_writev.html b/libmongoc/1.24.3/mongoc_stream_writev.html new file mode 100644 index 0000000000000000000000000000000000000000..268fbd6fe3e10ba6ab964c7e54223223af4ef549 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_stream_writev.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_stream_writev() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_destroy.html b/libmongoc/1.24.3/mongoc_topology_description_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..7d592fdbb856bf98b66eedb3f76c01334e1604b7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_topology_description_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_get_servers.html b/libmongoc/1.24.3/mongoc_topology_description_get_servers.html new file mode 100644 index 0000000000000000000000000000000000000000..bd6a459842d409267163e482186b67342947a1cb --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_get_servers.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_topology_description_get_servers() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_has_readable_server.html b/libmongoc/1.24.3/mongoc_topology_description_has_readable_server.html new file mode 100644 index 0000000000000000000000000000000000000000..86adda14c29fbed24cc3ea0916754f5e76e31e37 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_has_readable_server.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_topology_description_has_readable_server() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_has_writable_server.html b/libmongoc/1.24.3/mongoc_topology_description_has_writable_server.html new file mode 100644 index 0000000000000000000000000000000000000000..744d0f20bd0cc27eb592eb4bc4b9144c9f5b4d48 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_has_writable_server.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_topology_description_has_writable_server() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Introduction to Application Performance Monitoring
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_new_copy.html b/libmongoc/1.24.3/mongoc_topology_description_new_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..e25ea22bf16c46ca7e3bc1b87f57dfbd7185bcbd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_new_copy.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_topology_description_new_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_t.html b/libmongoc/1.24.3/mongoc_topology_description_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f32c91c9a818a05f4d400a8a4bcd3bee07bc626a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_t.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_topology_description_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_topology_description_type.html b/libmongoc/1.24.3/mongoc_topology_description_type.html new file mode 100644 index 0000000000000000000000000000000000000000..286194656a2810751005b08c60021023afdafb00 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_topology_description_type.html @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + mongoc_topology_description_type() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

      • +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opt_t.html b/libmongoc/1.24.3/mongoc_transaction_opt_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f3903b736cdc4ffae10d31279956e01bd0868a89 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opt_t.html @@ -0,0 +1,405 @@ + + + + + + + + + + + + + + mongoc_transaction_opt_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_clone.html b/libmongoc/1.24.3/mongoc_transaction_opts_clone.html new file mode 100644 index 0000000000000000000000000000000000000000..c4d4ee06a4097de2350e137f925703ce6e41cec8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_clone.html @@ -0,0 +1,305 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_clone() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_destroy.html b/libmongoc/1.24.3/mongoc_transaction_opts_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..196b4614b064a6053b60fe93da64380025a4c95d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_destroy.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_get_max_commit_time_ms.html b/libmongoc/1.24.3/mongoc_transaction_opts_get_max_commit_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..d54d42a2ee6e3a86116d3c49996fd15af4d47501 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_get_max_commit_time_ms.html @@ -0,0 +1,300 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_max_commit_time_ms() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_get_read_concern.html b/libmongoc/1.24.3/mongoc_transaction_opts_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..3456105f800dfb2f86124f0ad61d08d81959f36a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_get_read_concern.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_get_read_prefs.html b/libmongoc/1.24.3/mongoc_transaction_opts_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..aa191bc48628d916fd7d4d7562c56132aa6052fd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_get_read_prefs.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_get_write_concern.html b/libmongoc/1.24.3/mongoc_transaction_opts_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..496a7dac98cf432ceab1dfd17633e181923fa324 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_get_write_concern.html @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_get_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_new.html b/libmongoc/1.24.3/mongoc_transaction_opts_new.html new file mode 100644 index 0000000000000000000000000000000000000000..dd677fa45bc7a79c9e0d9437bf38cb0903b25c30 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_new.html @@ -0,0 +1,298 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_set_max_commit_time_ms.html b/libmongoc/1.24.3/mongoc_transaction_opts_set_max_commit_time_ms.html new file mode 100644 index 0000000000000000000000000000000000000000..16eeeece7f727d386b88e091566016b711ace8ef --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_set_max_commit_time_ms.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_max_commit_time_ms() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_set_read_concern.html b/libmongoc/1.24.3/mongoc_transaction_opts_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..0bcc851d512d36be7aff1a92ed464150988c1107 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_set_read_concern.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_set_read_prefs.html b/libmongoc/1.24.3/mongoc_transaction_opts_set_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..8dc888ff791a58e4cc975aab2e98c6d569e1c030 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_set_read_prefs.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_opts_set_write_concern.html b/libmongoc/1.24.3/mongoc_transaction_opts_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..a156e67cee417025257096d05b9321851a0cbde0 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_opts_set_write_concern.html @@ -0,0 +1,302 @@ + + + + + + + + + + + + + + mongoc_transaction_opts_set_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    + +
    +

    See also

    +
    +
    mongoc_client_session_abort_transaction()
    +
    +
    +
    mongoc_client_session_advance_cluster_time()
    +
    +
    +
    mongoc_client_session_advance_operation_time()
    +
    +
    +
    mongoc_client_session_commit_transaction()
    +
    +
    +
    mongoc_client_session_destroy()
    +
    +
    +
    mongoc_client_session_get_client()
    +
    +
    +
    mongoc_client_session_get_cluster_time()
    +
    +
    +
    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_start_transaction()
    +
    +
    +
    mongoc_client_session_t
    +
    +
    +
    mongoc_client_start_session()
    +
    +
    +
    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_transaction_opts()
    +
    +
    +
    mongoc_session_opts_new()
    +
    +
    +
    mongoc_session_opts_set_causal_consistency()
    +
    +
    +
    mongoc_session_opts_set_default_transaction_opts()
    +
    +
    +
    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()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_transaction_state_t.html b/libmongoc/1.24.3/mongoc_transaction_state_t.html new file mode 100644 index 0000000000000000000000000000000000000000..f0cd4d55c4fe2f91fcc7f36a28bba2188aabab47 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_transaction_state_t.html @@ -0,0 +1,222 @@ + + + + + + + + + + + + + + mongoc_transaction_state_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_update_flags_t.html b/libmongoc/1.24.3/mongoc_update_flags_t.html new file mode 100644 index 0000000000000000000000000000000000000000..81248f40a2125eb9c74014de66f9d12df0f4da6c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_update_flags_t.html @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + mongoc_update_flags_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_copy.html b/libmongoc/1.24.3/mongoc_uri_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..3d9b7402c33f505620affcc54a8192c532925811 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_copy.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_destroy.html b/libmongoc/1.24.3/mongoc_uri_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..83dd7e7c07e3aec796f46cc4ce700142d091a1ef --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_uri_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_auth_mechanism.html b/libmongoc/1.24.3/mongoc_uri_get_auth_mechanism.html new file mode 100644 index 0000000000000000000000000000000000000000..d934e4205b56e03719b3fe77e38b93ad6330f574 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_auth_mechanism.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_uri_get_auth_mechanism() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_auth_source.html b/libmongoc/1.24.3/mongoc_uri_get_auth_source.html new file mode 100644 index 0000000000000000000000000000000000000000..fb874a4fe5ad1721cb7b021968910de6475a749a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_auth_source.html @@ -0,0 +1,229 @@ + + + + + + + + + + + + + + mongoc_uri_get_auth_source() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_compressors.html b/libmongoc/1.24.3/mongoc_uri_get_compressors.html new file mode 100644 index 0000000000000000000000000000000000000000..d9375c1988a0c44784b0abcd1c62a6c1d748fe68 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_compressors.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + mongoc_uri_get_compressors() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_database.html b/libmongoc/1.24.3/mongoc_uri_get_database.html new file mode 100644 index 0000000000000000000000000000000000000000..dc80619292f198c0c9620b5cc18c85015494f883 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_database.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_database() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_hosts.html b/libmongoc/1.24.3/mongoc_uri_get_hosts.html new file mode 100644 index 0000000000000000000000000000000000000000..04977adff56ec3a6eaaa44557da871b620061d59 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_hosts.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_hosts() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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://”.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_mechanism_properties.html b/libmongoc/1.24.3/mongoc_uri_get_mechanism_properties.html new file mode 100644 index 0000000000000000000000000000000000000000..4a78d6325e6504370f6a43840dce4dc38a9935ba --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_mechanism_properties.html @@ -0,0 +1,254 @@ + + + + + + + + + + + + + + mongoc_uri_get_mechanism_properties() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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" }
+
    +
    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_option_as_bool.html b/libmongoc/1.24.3/mongoc_uri_get_option_as_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..9694684883e758fc0697ea19cf41b1d47b4f1bc7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_option_as_bool.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_bool() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_option_as_int32.html b/libmongoc/1.24.3/mongoc_uri_get_option_as_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..6881a59444af14eda11ff26672b0a1db45f9952b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_option_as_int32.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_int32() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_uri_get_option_as_int64()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_option_as_int64.html b/libmongoc/1.24.3/mongoc_uri_get_option_as_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..83bab4695ca12930523f15b54a4886ae19e4349b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_option_as_int64.html @@ -0,0 +1,216 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_int64() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_uri_get_option_as_int32()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_option_as_utf8.html b/libmongoc/1.24.3/mongoc_uri_get_option_as_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..ef0c061753cf94ba5519d159ece36ad6b34b393b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_option_as_utf8.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_option_as_utf8() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_options.html b/libmongoc/1.24.3/mongoc_uri_get_options.html new file mode 100644 index 0000000000000000000000000000000000000000..a6a308d82ea8204f40d92fa456d38c413b7646ad --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_options.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_options() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_password.html b/libmongoc/1.24.3/mongoc_uri_get_password.html new file mode 100644 index 0000000000000000000000000000000000000000..ba5e2ba8053fcdba3c1874559527965e94aebfb9 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_password.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_password() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_read_concern.html b/libmongoc/1.24.3/mongoc_uri_get_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..89d950291dce906ac811ac2e199f7c75434a867c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_read_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_read_prefs.html b/libmongoc/1.24.3/mongoc_uri_get_read_prefs.html new file mode 100644 index 0000000000000000000000000000000000000000..8d9332fbf83d6cf781cb5263bc57048ec797ae0e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_read_prefs.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_uri_get_read_prefs() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_read_prefs_t.html b/libmongoc/1.24.3/mongoc_uri_get_read_prefs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..c7e9ffe281079a290a1a306be69bd23bc349b01a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_read_prefs_t.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_read_prefs_t() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_replica_set.html b/libmongoc/1.24.3/mongoc_uri_get_replica_set.html new file mode 100644 index 0000000000000000000000000000000000000000..574eab452575003e48ccfea1e7cb8531d437e0bc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_replica_set.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_replica_set() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_service.html b/libmongoc/1.24.3/mongoc_uri_get_service.html new file mode 100644 index 0000000000000000000000000000000000000000..d5e26d12d306bc2ebecabdee3d16c2a36ece64f3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_service.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_uri_get_service() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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://”.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_srv_hostname.html b/libmongoc/1.24.3/mongoc_uri_get_srv_hostname.html new file mode 100644 index 0000000000000000000000000000000000000000..ec5faf4a2b22610bf7a794148e30253d4c758ac3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_srv_hostname.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_srv_hostname() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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://”.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_srv_service_name.html b/libmongoc/1.24.3/mongoc_uri_get_srv_service_name.html new file mode 100644 index 0000000000000000000000000000000000000000..73938d8ec2c50785b3ddefb12ef25c17c35a8643 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_srv_service_name.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_srv_service_name() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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”.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_ssl.html b/libmongoc/1.24.3/mongoc_uri_get_ssl.html new file mode 100644 index 0000000000000000000000000000000000000000..b528fc173073420bdfbff868517bbfc102e9dd39 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_ssl.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_uri_get_ssl() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_string.html b/libmongoc/1.24.3/mongoc_uri_get_string.html new file mode 100644 index 0000000000000000000000000000000000000000..31861bdbde02c60b64a5acbc710adf0e600124cd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_string.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_string() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_tls.html b/libmongoc/1.24.3/mongoc_uri_get_tls.html new file mode 100644 index 0000000000000000000000000000000000000000..cd24d8a8198e606a1d6911a6b295c7fb5391a2da --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_tls.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_tls() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_username.html b/libmongoc/1.24.3/mongoc_uri_get_username.html new file mode 100644 index 0000000000000000000000000000000000000000..5db521b6003fecf18bb3376ab5c0667151096003 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_username.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_username() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_get_write_concern.html b/libmongoc/1.24.3/mongoc_uri_get_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..d3222b5fa6d4c1299191ead1c2eb4489724e7382 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_get_write_concern.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_get_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_has_option.html b/libmongoc/1.24.3/mongoc_uri_has_option.html new file mode 100644 index 0000000000000000000000000000000000000000..45b3b241118098d9ce3584a4425dce0bbae976b4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_has_option.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_uri_has_option() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_new.html b/libmongoc/1.24.3/mongoc_uri_new.html new file mode 100644 index 0000000000000000000000000000000000000000..a0c05769e1e282b4bfbac53e9bebc0c5b62cda8c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_new.html @@ -0,0 +1,210 @@ + + + + + + + + + + + + + + mongoc_uri_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_new_for_host_port.html b/libmongoc/1.24.3/mongoc_uri_new_for_host_port.html new file mode 100644 index 0000000000000000000000000000000000000000..accbd1f352df5ce618bc702311b40be9badea765 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_new_for_host_port.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_uri_new_for_host_port() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_new_with_error.html b/libmongoc/1.24.3/mongoc_uri_new_with_error.html new file mode 100644 index 0000000000000000000000000000000000000000..6db089f53f11e1855f2239fdcfe67fae82fbbbbf --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_new_with_error.html @@ -0,0 +1,225 @@ + + + + + + + + + + + + + + mongoc_uri_new_with_error() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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"

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_option_is_bool.html b/libmongoc/1.24.3/mongoc_uri_option_is_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..344a6d0a2097b5f8cf5415aefa5e62c21c8651ea --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_option_is_bool.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_bool() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_option_is_int32.html b/libmongoc/1.24.3/mongoc_uri_option_is_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..02711e87e4ec931e8a04ea88f847f7ae988a9880 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_option_is_int32.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_int32() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_uri_option_is_int64()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_option_is_int64.html b/libmongoc/1.24.3/mongoc_uri_option_is_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..489ff12c290129a3b666b8cc94afc79df394341a --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_option_is_int64.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_int64() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_uri_option_is_int32()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_option_is_utf8.html b/libmongoc/1.24.3/mongoc_uri_option_is_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..d8eeb5ca2326b46a21eb55d40fd6ca6dc2548e9e --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_option_is_utf8.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_uri_option_is_utf8() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_auth_mechanism.html b/libmongoc/1.24.3/mongoc_uri_set_auth_mechanism.html new file mode 100644 index 0000000000000000000000000000000000000000..d8333481c99cc7cd3caeb7c3a0f98302bd32b4ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_auth_mechanism.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_uri_set_auth_mechanism() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_auth_source.html b/libmongoc/1.24.3/mongoc_uri_set_auth_source.html new file mode 100644 index 0000000000000000000000000000000000000000..e9366410400ff393efe15a6088b9141df43e18e4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_auth_source.html @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + mongoc_uri_set_auth_source() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_compressors.html b/libmongoc/1.24.3/mongoc_uri_set_compressors.html new file mode 100644 index 0000000000000000000000000000000000000000..6ffd55519004b31fbc7c3a53e77f5142ba537b19 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_compressors.html @@ -0,0 +1,221 @@ + + + + + + + + + + + + + + mongoc_uri_set_compressors() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_database.html b/libmongoc/1.24.3/mongoc_uri_set_database.html new file mode 100644 index 0000000000000000000000000000000000000000..eaa59eef9df91e92f2f13f0ac62f3c647db8f431 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_database.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_uri_set_database() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_mechanism_properties.html b/libmongoc/1.24.3/mongoc_uri_set_mechanism_properties.html new file mode 100644 index 0000000000000000000000000000000000000000..0dc48e7ffe42f72912ee8d30138ada5ccb75a771 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_mechanism_properties.html @@ -0,0 +1,250 @@ + + + + + + + + + + + + + + mongoc_uri_set_mechanism_properties() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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);
+
    +
    +
    +

    See also

    +
    +
    Authentication
    +
    +
    +
    mongoc_uri_get_auth_mechanism()
    +
    +
    +
    mongoc_uri_get_auth_source()
    +
    +
    +
    mongoc_uri_get_mechanism_properties()
    +
    +
    +
    mongoc_uri_set_auth_mechanism()
    +
    +
    +
    mongoc_uri_set_auth_source()
    +
    +
    +
    mongoc_uri_set_mechanism_properties()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_option_as_bool.html b/libmongoc/1.24.3/mongoc_uri_set_option_as_bool.html new file mode 100644 index 0000000000000000000000000000000000000000..0da7359f6c4d0f2c95033e0ee27a1e8731fdf6fd --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_option_as_bool.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_bool() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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).

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_option_as_int32.html b/libmongoc/1.24.3/mongoc_uri_set_option_as_int32.html new file mode 100644 index 0000000000000000000000000000000000000000..8a60ca3ebfd326b12f79848460f7526eccfde1ab --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_option_as_int32.html @@ -0,0 +1,217 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_int32() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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).

    +
    +

    See also

    +
    +
    mongoc_uri_set_option_as_int64()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_option_as_int64.html b/libmongoc/1.24.3/mongoc_uri_set_option_as_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..7fca6bf126658eb30d098db21fd67e713ca4d624 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_option_as_int64.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_int64() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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).

    +
    +

    See also

    +
    +
    mongoc_uri_option_is_int64()
    +
    +
    +
    mongoc_uri_set_option_as_int32()
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_option_as_utf8.html b/libmongoc/1.24.3/mongoc_uri_set_option_as_utf8.html new file mode 100644 index 0000000000000000000000000000000000000000..d011fe5fcfceefd99075a4d9afec5998fba966df --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_option_as_utf8.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_uri_set_option_as_utf8() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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).

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_password.html b/libmongoc/1.24.3/mongoc_uri_set_password.html new file mode 100644 index 0000000000000000000000000000000000000000..ddc3226168bae56db51fabecfc810b5b4008eebc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_password.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_uri_set_password() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_read_concern.html b/libmongoc/1.24.3/mongoc_uri_set_read_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..3530de97f1100c2ec589e6994ceea5ed11aaed53 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_read_concern.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_uri_set_read_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_read_prefs_t.html b/libmongoc/1.24.3/mongoc_uri_set_read_prefs_t.html new file mode 100644 index 0000000000000000000000000000000000000000..a2ebb99355874137e58ed33b3a81969a8f4afc73 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_read_prefs_t.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_uri_set_read_prefs_t() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_username.html b/libmongoc/1.24.3/mongoc_uri_set_username.html new file mode 100644 index 0000000000000000000000000000000000000000..ce5b986f11e354ec7372e09518ee66a6635d4632 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_username.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_uri_set_username() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_set_write_concern.html b/libmongoc/1.24.3/mongoc_uri_set_write_concern.html new file mode 100644 index 0000000000000000000000000000000000000000..39657f680708e23539ee78a9b8422882ec2f3a54 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_set_write_concern.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_uri_set_write_concern() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_t.html b/libmongoc/1.24.3/mongoc_uri_t.html new file mode 100644 index 0000000000000000000000000000000000000000..210c6d657783550c43eed285f2c34a67e63b357d --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_t.html @@ -0,0 +1,610 @@ + + + + + + + + + + + + + + mongoc_uri_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +

    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. +

    2. An optional username and password.

      3. +

    3. The only required part of the uri. This specifies either a hostname, IPv4 address, IPv6 address enclosed in “[” and “]”, or UNIX domain socket.

      4. +

    4. An optional port number. Defaults to :27017.

      5. +

    5. Extra optional hosts and ports. You would specify multiple hosts, for example, for connections to replica sets.

      6. +

    6. 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.

      7. +

    7. Connection specific options.

      8. +
    +
    +

    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. +

    2. 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.

      3. +

    3. 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.

      4. +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_uri_unescape.html b/libmongoc/1.24.3/mongoc_uri_unescape.html new file mode 100644 index 0000000000000000000000000000000000000000..a5d45c96138a30552f2c952680e115f7637bf1de --- /dev/null +++ b/libmongoc/1.24.3/mongoc_uri_unescape.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_uri_unescape() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_version.html b/libmongoc/1.24.3/mongoc_version.html new file mode 100644 index 0000000000000000000000000000000000000000..f2276a58b29b5f6e6895b66a4bcbd28d1281ac1f --- /dev/null +++ b/libmongoc/1.24.3/mongoc_version.html @@ -0,0 +1,220 @@ + + + + + + + + + + + + + + Version Checks — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_append.html b/libmongoc/1.24.3/mongoc_write_concern_append.html new file mode 100644 index 0000000000000000000000000000000000000000..b25a57748383cb8855bb5bd863e3075ec450c0ac --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_append.html @@ -0,0 +1,211 @@ + + + + + + + + + + + + + + mongoc_write_concern_append() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_copy.html b/libmongoc/1.24.3/mongoc_write_concern_copy.html new file mode 100644 index 0000000000000000000000000000000000000000..0eaaa3e711d94dbfd0a55a2181b5e04d02f8e2ab --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_copy.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_write_concern_copy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_destroy.html b/libmongoc/1.24.3/mongoc_write_concern_destroy.html new file mode 100644 index 0000000000000000000000000000000000000000..593c0623106a5c627e7ab45e32ac8d15c2fbc4d8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_destroy.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_write_concern_destroy() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_fsync.html b/libmongoc/1.24.3/mongoc_write_concern_get_fsync.html new file mode 100644 index 0000000000000000000000000000000000000000..a37902ff25d8643171ca4e7075fcab1ee3b54597 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_fsync.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_fsync() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_journal.html b/libmongoc/1.24.3/mongoc_write_concern_get_journal.html new file mode 100644 index 0000000000000000000000000000000000000000..e97d79821d48c7e18c4d5acff85ce67086e6c030 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_journal.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_journal() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_w.html b/libmongoc/1.24.3/mongoc_write_concern_get_w.html new file mode 100644 index 0000000000000000000000000000000000000000..c05ccc1ceed50cb5f9b5af9b5d7a430fbfab5096 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_w.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_w() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_wmajority.html b/libmongoc/1.24.3/mongoc_write_concern_get_wmajority.html new file mode 100644 index 0000000000000000000000000000000000000000..a1ecd0ce09bfe6e240b1c799257c083f67786a29 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_wmajority.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wmajority() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_wtag.html b/libmongoc/1.24.3/mongoc_write_concern_get_wtag.html new file mode 100644 index 0000000000000000000000000000000000000000..5e67163d6864895e0acd3e0e3ca2f680188067e7 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_wtag.html @@ -0,0 +1,205 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wtag() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_wtimeout.html b/libmongoc/1.24.3/mongoc_write_concern_get_wtimeout.html new file mode 100644 index 0000000000000000000000000000000000000000..199800ee75c0e9a83a4f478c652e04fb67605061 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_wtimeout.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wtimeout() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_write_concern_set_wtimeout() and mongoc_write_concern_get_wtimeout_int64().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_get_wtimeout_int64.html b/libmongoc/1.24.3/mongoc_write_concern_get_wtimeout_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..f2abe303c912decb8ba0a0d199befa4f827ccf8b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_get_wtimeout_int64.html @@ -0,0 +1,212 @@ + + + + + + + + + + + + + + mongoc_write_concern_get_wtimeout_int64() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_write_concern_set_wtimeout_int64().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_is_acknowledged.html b/libmongoc/1.24.3/mongoc_write_concern_is_acknowledged.html new file mode 100644 index 0000000000000000000000000000000000000000..e51d1b7369c8519f77fe8fa2ce69acef7b4a5734 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_is_acknowledged.html @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + mongoc_write_concern_is_acknowledged() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.)

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_is_default.html b/libmongoc/1.24.3/mongoc_write_concern_is_default.html new file mode 100644 index 0000000000000000000000000000000000000000..8f70e19f637ea9e572e622f1de31be5fc9c84da3 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_is_default.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_write_concern_is_default() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

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

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_is_valid.html b/libmongoc/1.24.3/mongoc_write_concern_is_valid.html new file mode 100644 index 0000000000000000000000000000000000000000..9a6384de76b57b07ff32722b47190ed9797d9804 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_is_valid.html @@ -0,0 +1,201 @@ + + + + + + + + + + + + + + mongoc_write_concern_is_valid() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_journal_is_set.html b/libmongoc/1.24.3/mongoc_write_concern_journal_is_set.html new file mode 100644 index 0000000000000000000000000000000000000000..1bb97cdcd759b3d54ecb0ebb2ca2d1d37ef504bc --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_journal_is_set.html @@ -0,0 +1,202 @@ + + + + + + + + + + + + + + mongoc_write_concern_journal_is_set() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_new.html b/libmongoc/1.24.3/mongoc_write_concern_new.html new file mode 100644 index 0000000000000000000000000000000000000000..135c39f97fce0cc4c66cc8e4380ffdcf253c0e84 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_new.html @@ -0,0 +1,195 @@ + + + + + + + + + + + + + + mongoc_write_concern_new() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_fsync.html b/libmongoc/1.24.3/mongoc_write_concern_set_fsync.html new file mode 100644 index 0000000000000000000000000000000000000000..050597078a6b258d7a5dcd0132d27775987f3f21 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_fsync.html @@ -0,0 +1,214 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_fsync() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_journal.html b/libmongoc/1.24.3/mongoc_write_concern_set_journal.html new file mode 100644 index 0000000000000000000000000000000000000000..c59dc31877cd9f2be71a4f8a71c7df477cd8c9a4 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_journal.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_journal() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_w.html b/libmongoc/1.24.3/mongoc_write_concern_set_w.html new file mode 100644 index 0000000000000000000000000000000000000000..e80412bb4549d8a1840e0aa0bd134f3ea8668ba8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_w.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_w() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_wmajority.html b/libmongoc/1.24.3/mongoc_write_concern_set_wmajority.html new file mode 100644 index 0000000000000000000000000000000000000000..ab2061be864ba171ecf9e6cb62bfb56b1cc8d1c8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_wmajority.html @@ -0,0 +1,208 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wmajority() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_wtag.html b/libmongoc/1.24.3/mongoc_write_concern_set_wtag.html new file mode 100644 index 0000000000000000000000000000000000000000..fef828cc1d583a42f0f2ea476763a1105dff541c --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_wtag.html @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wtag() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_wtimeout.html b/libmongoc/1.24.3/mongoc_write_concern_set_wtimeout.html new file mode 100644 index 0000000000000000000000000000000000000000..eb915a91cdac8600992fe27f1e1b83b36b779f3b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_wtimeout.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wtimeout() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_write_concern_get_wtimeout() and mongoc_write_concern_set_wtimeout_int64().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_set_wtimeout_int64.html b/libmongoc/1.24.3/mongoc_write_concern_set_wtimeout_int64.html new file mode 100644 index 0000000000000000000000000000000000000000..5994423ff6488928c058da030c765b0b058b0d0b --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_set_wtimeout_int64.html @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + mongoc_write_concern_set_wtimeout_int64() — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +

    See also

    +
    +
    mongoc_write_concern_get_wtimeout_int64().
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/mongoc_write_concern_t.html b/libmongoc/1.24.3/mongoc_write_concern_t.html new file mode 100644 index 0000000000000000000000000000000000000000..41fb7630075d73af5dbe15429b8f76cca0ef3dc8 --- /dev/null +++ b/libmongoc/1.24.3/mongoc_write_concern_t.html @@ -0,0 +1,254 @@ + + + + + + + + + + + + + + mongoc_write_concern_t — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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

    +
    + +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/objects.inv b/libmongoc/1.24.3/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..cf2661d10f9d98c1201035cca297b8b181658a06 Binary files /dev/null and b/libmongoc/1.24.3/objects.inv differ diff --git a/libmongoc/1.24.3/queryable-encryption.html b/libmongoc/1.24.3/queryable-encryption.html new file mode 100644 index 0000000000000000000000000000000000000000..496644a1bf00d944feb7530a5afd736fcd0e6371 --- /dev/null +++ b/libmongoc/1.24.3/queryable-encryption.html @@ -0,0 +1,160 @@ + + + + + + + + + + + + + + Queryable Encryption — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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
    +
    +
    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/search.html b/libmongoc/1.24.3/search.html new file mode 100644 index 0000000000000000000000000000000000000000..7154cc9c085bc6e5115e079d3a680badefa11f6e --- /dev/null +++ b/libmongoc/1.24.3/search.html @@ -0,0 +1,126 @@ + + + + + + + + + + + + + Search — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +

    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. +

    +
    + + + +
    + +
    + +
    + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/searchindex.js b/libmongoc/1.24.3/searchindex.js new file mode 100644 index 0000000000000000000000000000000000000000..b9f5e52f60659006457c1b25276b74705712ec5b --- /dev/null +++ b/libmongoc/1.24.3/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, 359, 360, 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, 360, 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, 360, 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, 359, 360, 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, 360, 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, 360, 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, 287, 296, 318, 344, 395, 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, 359, 360, 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, 360, 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, 360, 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, 360, 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, 359, 360, 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, 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], "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, 360, 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.3/tutorial.html b/libmongoc/1.24.3/tutorial.html new file mode 100644 index 0000000000000000000000000000000000000000..dc70f30f6d40b9b5bba031d1385bd7dd8de4eefe --- /dev/null +++ b/libmongoc/1.24.3/tutorial.html @@ -0,0 +1,1109 @@ + + + + + + + + + + + + + + Tutorial — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/1.24.3/visual-studio-guide.html b/libmongoc/1.24.3/visual-studio-guide.html new file mode 100644 index 0000000000000000000000000000000000000000..34becb6f9fe503b52762fc32304e7e85372e28a3 --- /dev/null +++ b/libmongoc/1.24.3/visual-studio-guide.html @@ -0,0 +1,186 @@ + + + + + + + + + + + + + + Using libmongoc in a Microsoft Visual Studio project — libmongoc 1.24.3 + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    + +
    +

    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.

    +
    +
    + + +
    +
    +
    + +
    +
    +
    + © Copyright 2017-present, MongoDB, Inc. + Created using Sphinx 5.3.0. +
    + + + \ No newline at end of file diff --git a/libmongoc/_static/documentation_options.js b/libmongoc/_static/documentation_options.js index db3c2d90eb65d7de854ebea94cb777e9c1f8e46e..c264ead4e26ab9dd3aff569935b1a2a35ae7bdac 100644 --- a/libmongoc/_static/documentation_options.js +++ b/libmongoc/_static/documentation_options.js @@ -1,7 +1,7 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '1.24.2', - LANGUAGE: 'None', + VERSION: '1.24.3', + LANGUAGE: 'en', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: false, diff --git a/libmongoc/_static/searchtools.js b/libmongoc/_static/searchtools.js index 41b8336776442fbc64332ffbd3d2c1ddd8b3b9c2..024ac7c430a70907a6715006dc263b4f6d1976ba 100644 --- a/libmongoc/_static/searchtools.js +++ b/libmongoc/_static/searchtools.js @@ -227,105 +227,11 @@ var Scorer = { - - -var splitChars = (function() { - var result = {}; - var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648, - 1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702, - 2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971, - 2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345, - 3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761, - 3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823, - 4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125, - 8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695, - 11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587, - 43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141]; - var i, j, start, end; - for (i = 0; i < singles.length; i++) { - result[singles[i]] = true; - } - var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709], - [722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161], - [1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568], - [1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807], - [1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047], - [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383], - [2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450], - [2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547], - [2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673], - [2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820], - [2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946], - [2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023], - [3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173], - [3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332], - [3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481], - [3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718], - [3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791], - [3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095], - [4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205], - [4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687], - [4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968], - [4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869], - [5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102], - [6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271], - [6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592], - [6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822], - [6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167], - [7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959], - [7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143], - [8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318], - [8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483], - [8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101], - [10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567], - [11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292], - [12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444], - [12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783], - [12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311], - [19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511], - [42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774], - [42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071], - [43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263], - [43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519], - [43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647], - [43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967], - [44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295], - [57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274], - [64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007], - [65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381], - [65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]]; - for (i = 0; i < ranges.length; i++) { - start = ranges[i][0]; - end = ranges[i][1]; - for (j = start; j <= end; j++) { - result[j] = true; - } - } - return result; -})(); - function splitQuery(query) { - var result = []; - var start = -1; - for (var i = 0; i < query.length; i++) { - if (splitChars[query.charCodeAt(i)]) { - if (start !== -1) { - result.push(query.slice(start, i)); - start = -1; - } - } else if (start === -1) { - start = i; - } - } - if (start !== -1) { - result.push(query.slice(start)); - } - return result; + return query.split(/\s+/); } - - /** * Search Module */ @@ -417,7 +323,7 @@ var Search = { */ query : function(query) { var i; - var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]; + var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; // stem the searchterms and add them to the correct list var stemmer = new Stemmer(); diff --git a/libmongoc/current b/libmongoc/current index 0b4c970ea2c7b506f928cbe70c316cd3fee29fe4..95587e55b3bd11b5874af3b55d681964e0f2fdcf 120000 --- a/libmongoc/current +++ b/libmongoc/current @@ -1 +1 @@ -1.24.2 \ No newline at end of file +1.24.3 \ No newline at end of file diff --git a/libmongoc/index.html b/libmongoc/index.html index f8c6c1df89502985853d7db6d056f3d598a05094..048f662c22290686f1b70863c87f7dda1412622d 100644 --- a/libmongoc/index.html +++ b/libmongoc/index.html @@ -1,11 +1,10 @@ - + - + - - + + - libmongoc Releases — MongoDB C Driver 1.24.2 + libmongoc Releases — MongoDB C Driver 1.24.3 + + + + - + @@ -49,7 +52,7 @@
  • previous |
    • -
  • MongoDB C Driver 1.24.2 »
    • +
  • MongoDB C Driver 1.24.3 »
    • @@ -57,111 +60,112 @@
    -
    -

    libmongoc Releases

    -

    Latest Release (1.24.2)

    +
    +

    libmongoc Releases

    +

    Latest Release (1.24.3)

    Current Development (master)

    -
    +
    @@ -170,7 +174,7 @@
    © Copyright 2017, MongoDB, Inc. - Created using Sphinx 1.8.0. + Created using Sphinx 5.3.0.
    diff --git a/objects.inv b/objects.inv index 8254d5574acc9d50d62a7701250f5333a9954cf9..534a5bae888d7e13459ea496cde7a9583f8006eb 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/search.html b/search.html index 7bba6d2a69f056452b38440a73233d734a4cc57d..40d720155b700dbec3bda4d152ee9fa9df3ce261 100644 --- a/search.html +++ b/search.html @@ -1,11 +1,9 @@ - + - + - - + - Search — MongoDB C Driver 1.24.2 + Search — MongoDB C Driver 1.24.3 + + + + - +