Methods' Summary |
waitForCompletion |
waits for the completion of any previous calls to
com::sun::star::io::XOutputStream::writeBytes(),
and reports potentially pending errors.
|
Methods' Details |
waitForCompletion
- 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 specifically does not guarantee that any
data have safely 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).
|
|
Top of Page
Copyright © 2020, The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache Software Foundation. Other names may be trademarks of their respective owners.