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