writev_all


Description:

[ Version ( since = "2.60" ) ]
public bool writev_all (OutputVector[] vectors, out size_t bytes_written, Cancellable? cancellable = null) throws Error

Tries to write the bytes contained in the vectors.length vectors into the stream.

Will block during the operation.

This function is similar to writev, except it tries to write as many bytes as requested, only stopping on an error.

On a successful write of all vectors.length vectors, true is returned, and bytes_written is set to the sum of all the sizes of vectors.

If there is an error during the operation false is returned and throws is set to indicate the error status.

As a special exception to the normal conventions for functions that use Error, if this function returns false (and sets throws) then bytes_written will be set to the number of bytes that were successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around write.

The content of the individual elements of vectors might be changed by this function.

Parameters:

this

a OutputStream.

vectors

the buffer containing the OutputVectors to write.

bytes_written

location to store the number of bytes that were written to the stream

cancellable

optional Cancellable object, null to ignore.

n_vectors

the number of vectors to write

Returns:

true on success, false if there was an error