1MONGOC_GRIDFS_FIND_WITH_OPTS(3) libmongoc MONGOC_GRIDFS_FIND_WITH_OPTS(3)
2
3
4
6 mongoc_gridfs_find_with_opts - mongoc_gridfs_find_with_opts()
7
9 mongoc_gridfs_file_list_t *
10 mongoc_gridfs_find_with_opts (mongoc_gridfs_t *gridfs,
11 const bson_t *filter,
12 const bson_t *opts) BSON_GNUC_WARN_UNUSED_RESULT;
13
15 • gridfs: A mongoc_gridfs_t.
16
17 • filter: A bson_t containing the query to execute.
18
19 • opts: A bson_t query options, including sort order and which fields
20 to return. Can be NULL.
21
23 Finds all gridfs files matching filter. You can iterate the matched
24 gridfs files with the resulting file list.
25
26 See mongoc_collection_find_with_opts() for a description of the filter
27 and opts parameters.
28
29 This function is considered a retryable read operation. Upon a tran‐
30 sient error (a network error, errors due to replica set failover, etc.)
31 the operation is safely retried once. If retryreads is false in the
32 URI (see mongoc_uri_t) the retry behavior does not apply.
33
35 A newly allocated mongoc_gridfs_file_list_t that should be freed with
36 mongoc_gridfs_file_list_destroy() when no longer in use.
37
39 MongoDB, Inc
40
42 2017-present, MongoDB, Inc
43
44
45
46
471.23.1 Oct 20, 2022 MONGOC_GRIDFS_FIND_WITH_OPTS(3)