An optional companion interface to
XOutputStream that supports scenarios
where XOutputStream::writeBytes
operates asynchronously and does not necessarily report any errors.
waits for the completion of any previous calls to
XOutputStream::writeBytes,
and reports potentially pending errors.
Calling this method is potentially expensive (even if the associated
XOutputStream represents a local
file not accessed via NFS, for example). This method has a similar
description to
XOutputStream::flush.
However, where the semantics of flush are rather vague,
waitForCompletion has very specific semantics—it just
blocks long enough so that any errors encountered during previous calls
to XOutputStream::writeBytes
can reliably be reported. It specificially does not guarantee that any
data have savely been stored on a stable physical medium, like a hard
disk (and it is completely unspecified whether flush should
give this guarantee).
Throws
com::sun::star::io::IOException
if any previous call to XOutputStream::writeBytes encountered
such an error, but has not yet reported it (in cases where
writeBytes operates asynchronously).
