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

FreeBSD Manual Pages

  
 
  

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

SYNOPSIS
	  bool
	  mongoc_gridfs_bucket_upload_from_stream (mongoc_gridfs_bucket_t *bucket,
						   const char *filename,
						   mongoc_stream_t *source,
						   const bson_t	*opts,
						   bson_value_t	*file_id,
						   bson_error_t	*error);

PARAMETERS
        bucket: A mongoc_gridfs_bucket_t.

        filename: The name of the file	to create.

        source: A mongoc_stream_t used	as the source of the data to upload.

        opts: A bson_t	or NULL.

        file_id:  A  bson_value_t  to receive the generated id	of the file or
	 NULL.

        error:	A bson_error_t to receive any error or NULL.

       opts may	be NULL	or a BSON document with	additional command options:

        chunkSizeBytes: An int32 chunk	size to	use for	this  file.  Overrides
	 the chunkSizeBytes set	on bucket.

        metadata: A bson_t representing metadata to include with the file.

DESCRIPTION
       Reads  from  the	 source	stream and writes to a new file	in GridFS. The
       file id is generated automatically.  To specify an  explicit  file  id,
       use mongoc_gridfs_bucket_upload_from_stream_with_id().

       Reads  from  the	source stream using mongoc_stream_read() until the re-
       turn value indicates end-of-file.  The source stream is not closed  af-
       ter     calling	   mongoc_gridfs_bucket_upload_from_stream();	  call
       mongoc_stream_close() after.

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	source stream from a file.

AUTHOR
       MongoDB,	Inc

COPYRIGHT
       2009-present, MongoDB, Inc.

1.30.2				 Apr 12, 2025MONGOC_GRIDFS...AD_FROM_STREAM(3)

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

home | help