mongoc_gridfs_file_writev()#

Synopsis#

ssize_t
mongoc_gridfs_file_writev (mongoc_gridfs_file_t *file,
                           const mongoc_iovec_t *iov,
                           size_t iovcnt,
                           uint32_t timeout_msec);

Parameters#

file: A mongoc_gridfs_file_t.
iov: An array of mongoc_iovec_t.
iovcnt: The number of elements in iov.
timeout_msec: Unused.

Description#

Performs a gathered write to the underlying gridfs file.

The timeout_msec parameter is unused.

Modifying GridFS files is NOT thread-safe. Only one thread or process can access a GridFS file while it is being modified.

Returns#

Returns the number of bytes written, or -1 on failure. Use mongoc_gridfs_file_error() to retrieve error details.