1MONGOC_GRIDFS_FIND(3) libmongoc MONGOC_GRIDFS_FIND(3)
2
3
4
6 mongoc_gridfs_find - mongoc_gridfs_find()
7
8 WARNING:
9 Deprecated since version 1.5.0: This function is deprecated, use
10 mongoc_gridfs_find_with_opts() instead.
11
12
14 mongoc_gridfs_file_list_t *
15 mongoc_gridfs_find (mongoc_gridfs_t *gridfs,
16 const bson_t *query) BSON_GNUC_WARN_UNUSED_RESULT
17 BSON_GNUC_DEPRECATED_FOR (mongoc_gridfs_find_with_opts);
18
20 • gridfs: A mongoc_gridfs_t.
21
22 • query: A bson_t.
23
25 Finds all gridfs files matching query. You can iterate the matched
26 gridfs files with the resulting file list.
27
28 This function is considered a retryable read operation. Upon a tran‐
29 sient error (a network error, errors due to replica set failover, etc.)
30 the operation is safely retried once. If retryreads is false in the
31 URI (see mongoc_uri_t) the retry behavior does not apply.
32
34 A newly allocated mongoc_gridfs_file_list_t that should be freed with
35 mongoc_gridfs_file_list_destroy() when no longer in use.
36
38 MongoDB, Inc
39
41 2017-present, MongoDB, Inc
42
43
44
45
461.24.3 Aug 17, 2023 MONGOC_GRIDFS_FIND(3)