write_all


Description:

public bool write_all (uint8[] buffer, out size_t bytes_written, Cancellable? cancellable = null) throws IOError

Tries to write buffer.length bytes from buffer into the stream.

Will block during the operation.

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

On a successful write of buffer.length bytes, true is returned, and bytes_written is set to buffer.length.

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.

Parameters:

this

a OutputStream.

buffer

the buffer containing the data to write.

bytes_written

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

cancellable

optional Cancellable object, null to ignore.

count

the number of bytes to write

Returns:

true on success, false if there was an error