:: com :: sun :: star :: io ::

interface XAsyncOutputMonitor

Methods' Summary
waitForCompletion waits for the completion of any previous calls to XOutputStream::writeBytes, and reports potentially pending errors.  
Methods' Details
waitForCompletion
void
waitForCompletion()
raises( IOException );

Description
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).
Top of Page