Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
MONGOC_GRIDFS...LOAD_TO_STREAM(3)   libmongoc  MONGOC_GRIDFS...LOAD_TO_STREAM(3)

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
     * bucket: A mongoc_gridfs_bucket_t.

     * file_id: A bson_value_t of the id of the file to download.

     * destination:  A	mongoc_stream_t  which receives data from the downloaded
       file.

     * error: A bson_error_t to receive any error or NULL.

DESCRIPTION
     Reads from the GridFS file and writes to the destination stream.

     Writes the full contents of the file to the destination stream.  The desti-
     nation	 stream      is       not	closed	     after	 calling
     mongoc_gridfs_bucket_download_to_stream();  call  mongoc_stream_close() af-
     ter.

     This function is considered a retryable read operation.  Upon  a  transient
     error (a network error, errors due to replica set failover, etc.) the oper-
     ation  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.

AUTHOR
     MongoDB, Inc

COPYRIGHT
     2009-present, MongoDB, Inc.

1.30.8				  Aug 27, 2026 MONGOC_GRIDFS...LOAD_TO_STREAM(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mongoc_gridfs_bucket_download_to_stream&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help