(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.
Overview Module Use Devguide Index
Methods' Summary Attributes' Summary Methods' Details Attributes' Details

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

interface XMarkableStream
Description
makes it possible to set and remove seekable marks to a stream.
Methods' Summary
createMark creates a mark of the current postion and returns an identifier to it.  
deleteMark deletes the mark that you previously created with XMarkableStream::createMark.  
jumpToMark jumps to a previously created mark.  
jumpToFurthest jumps to the furthest position of the stream.  
offsetToMark  
Methods' Details
createMark
long
createMark()
raises( IOException );
Description
creates a mark of the current postion and returns an identifier to it.
deleteMark
void
deleteMark( [in] long  Mark )
raises( IOException,
::com::sun::star::lang::IllegalArgumentException );
Description
deletes the mark that you previously created with XMarkableStream::createMark.

It is an error to delete a mark if other marks after this exist. In this case, for reasons of robustness, the implementation must delete this mark and all others after this mark.

jumpToMark
void
jumpToMark( [in] long  nMark )
raises( IOException,
::com::sun::star::lang::IllegalArgumentException );
Description
jumps to a previously created mark.
jumpToFurthest
void
jumpToFurthest()
raises( IOException );
Description
jumps to the furthest position of the stream.

In the inputstream case, a subsequent read call returns data, that was never read or skipped over before. In the outputstream case, a subsequent write call will add new data at the end of the stream without overwriting existing data.

offsetToMark
long
offsetToMark( [in] long  nMark )
raises( IOException,
::com::sun::star::lang::IllegalArgumentException );
Returns
the offset from the current stream position to the mark ("current position" - "mark position").
Parameter nMark
identifies the mark which is used as a base to calculate the offset of the current position.
Throws
IllegalArgumentException if the mark does not exist or is deleted.
Throws
IOException if an I/O error has occurred.
Top of Page

Copyright © 1995, 2010, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.