writev_all
Description:
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 |