1MONGOC_GRIDFS_FIND_ONE(3) MongoDB C Driver MONGOC_GRIDFS_FIND_ONE(3)
2
3
4
6 mongoc_gridfs_find_one - mongoc_gridfs_find_one()
7
9 This function is deprecated, use mongoc_gridfs_find_one_with_opts
10 instead.
11
13 mongoc_gridfs_file_t *
14 mongoc_gridfs_find_one (mongoc_gridfs_t *gridfs,
15 const bson_t *query,
16 bson_error_t *error)
17 BSON_GNUC_DEPRECATED_FOR (mongoc_gridfs_find_one_with_opts);
18
20 · gridfs: A mongoc_gridfs_t.
21
22 · query: A bson_t.
23
24 · error: An optional location for a bson_error_t or NULL.
25
27 This function shall execute a query on the underlying gridfs implemen‐
28 tation. The first file matching query will be returned. If there is an
29 error, NULL is returned and error is filled out; if there is no error
30 but no matching file is found, NULL is returned and the error code and
31 domain are 0.
32
34 Errors are propagated via the error parameter.
35
37 A newly allocated mongoc_gridfs_file_t or NULL if no file could be
38 found. You must free the resulting file with mon‐
39 goc_gridfs_file_destroy() if non-NULL.
40
42 MongoDB, Inc
43
45 2017-present, MongoDB, Inc
46
47
48
49
501.13.1 Jan 24, 2019 MONGOC_GRIDFS_FIND_ONE(3)