void |
waitForCompletion() |
raises( |
::com::sun::star::io::IOException ); |
- Description
-
waits for the completion of any previous calls to
::com::sun::star::io::XOutputStream::writeBytes ,
and reports potentially pending errors.
Calling this method is potentially expensive (even if the associated
::com::sun::star::io::XOutputStream represents a local
file not accessed via NFS, for example). This method has a similar
description to
::com::sun::star::io::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 ::com::sun::star::io::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 ::com::sun::star::io::XOutputStream::writeBytes encountered
such an error, but has not yet reported it (in cases where
writeBytes operates asynchronously).
|