Returns an open output stream on the contents of this file. The caller is responsible for closing the provided stream when it is no longer needed. This file need not exist in the underlying file system at the time this method is called.
The returned stream is not guaranteed to be buffered efficiently. When writing large blocks of data to the stream, a BufferedOutputStream
wrapper should be used, or some other form of content buffering.
The {@link EFS#APPEND} update flag controls whereoutput is written to the file. If this flag is specified, content written to the stream will be appended to the end of the file. If this flag is not specified, the contents of the existing file, if any, is truncated to zero and the new output will be written from the start of the file.
@param options bit-wise or of option flag constants ({@link EFS#APPEND}).
@param monitor a progress monitor, or
null
if progressreporting and cancellation are not desired
@return An output stream on the contents of this file.
@exception CoreException if this method fails. Reasons include:
- This store represents a directory.
- The parent of this store does not exist.