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