loci.common

Class RandomAccessOutputStream

java.lang.Object

java.io.OutputStream

loci.common.RandomAccessOutputStream

All Implemented Interfaces:

java.io.Closeable, java.io.DataOutput, java.io.Flushable, java.lang.AutoCloseable

public class RandomAccessOutputStream
extends java.io.OutputStream
implements java.io.DataOutput, java.io.Closeable

RandomAccessOutputStream provides methods for writing to files and byte arrays.

Source code:

Trac, Gitweb

Constructor Summary

Constructors

Constructor and Description
RandomAccessOutputStream(IRandomAccess handle) Constructs a random access stream around the given handle.
RandomAccessOutputStream(java.lang.String file) Constructs a random access stream around the given file.

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
void	flush()
long	getFilePointer() Returns the current offset within the stream.
boolean	isLittleEndian() Gets the endianness of the stream.
long	length() Returns the length of the file.
void	order(boolean little) Sets the endianness of the stream.
void	seek(long pos) Seeks to the given offset within the stream.
void	skipBytes(int skip) Advances the current offset by the given number of bytes.
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(java.nio.ByteBuffer b) Writes bytes to the stream from the given buffer.
void	write(java.nio.ByteBuffer b, int off, int len)
void	write(int b)
void	writeBoolean(boolean v)
void	writeByte(int v)
void	writeBytes(java.lang.String s)
void	writeChar(int v)
void	writeChars(java.lang.String s)
void	writeDouble(double v)
void	writeFloat(float v)
void	writeInt(int v)
void	writeLine(java.lang.String s) Writes the given string followed by a newline character.
void	writeLong(long v)
void	writeShort(int v)
void	writeUTF(java.lang.String str)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RandomAccessOutputStream

public RandomAccessOutputStream(java.lang.String file)
                         throws java.io.IOException

Constructs a random access stream around the given file.

Parameters:

file - Filename to open the stream for.

Throws:

java.io.IOException - If there is a problem opening the file.

RandomAccessOutputStream

public RandomAccessOutputStream(IRandomAccess handle)

Constructs a random access stream around the given handle.

Parameters:

handle - Handle to open the stream for.

Method Detail

seek

public void seek(long pos)
          throws java.io.IOException

Seeks to the given offset within the stream.

Throws:

java.io.IOException

getFilePointer

public long getFilePointer()
                    throws java.io.IOException

Returns the current offset within the stream.

Throws:

java.io.IOException

length

public long length()
            throws java.io.IOException

Returns the length of the file.

Throws:

java.io.IOException

skipBytes

public void skipBytes(int skip)
               throws java.io.IOException

Advances the current offset by the given number of bytes.

Throws:

java.io.IOException

order

public void order(boolean little)

Sets the endianness of the stream.

isLittleEndian

public boolean isLittleEndian()

Gets the endianness of the stream.

writeLine

public void writeLine(java.lang.String s)
               throws java.io.IOException

Writes the given string followed by a newline character.

Throws:

java.io.IOException

write

public void write(byte[] b)
           throws java.io.IOException

Specified by:

write in interface java.io.DataOutput

Overrides:

write in class java.io.OutputStream

Throws:

java.io.IOException

write

public void write(byte[] b,
         int off,
         int len)
           throws java.io.IOException

Specified by:

write in interface java.io.DataOutput

Overrides:

write in class java.io.OutputStream

Throws:

java.io.IOException

write

public void write(java.nio.ByteBuffer b)
           throws java.io.IOException

Writes bytes to the stream from the given buffer.

Parameters:

b - Source buffer to read data from.

Throws:

java.io.IOException - If there is an error writing to the stream.

write

public void write(java.nio.ByteBuffer b,
         int off,
         int len)
           throws java.io.IOException

Parameters:

b - Source buffer to read data from.

off - Offset within the buffer to start reading from.

len - Number of bytes to read.

Throws:

java.io.IOException - If there is an error writing to the stream.

write

public void write(int b)
           throws java.io.IOException

Specified by:

write in interface java.io.DataOutput

Specified by:

write in class java.io.OutputStream

Throws:

java.io.IOException

writeBoolean

public void writeBoolean(boolean v)
                  throws java.io.IOException

Specified by:

writeBoolean in interface java.io.DataOutput

Throws:

java.io.IOException

writeByte

public void writeByte(int v)
               throws java.io.IOException

Specified by:

writeByte in interface java.io.DataOutput

Throws:

java.io.IOException

writeBytes

public void writeBytes(java.lang.String s)
                throws java.io.IOException

Specified by:

writeBytes in interface java.io.DataOutput

Throws:

java.io.IOException

writeChar

public void writeChar(int v)
               throws java.io.IOException

Specified by:

writeChar in interface java.io.DataOutput

Throws:

java.io.IOException

writeChars

public void writeChars(java.lang.String s)
                throws java.io.IOException

Specified by:

writeChars in interface java.io.DataOutput

Throws:

java.io.IOException

writeDouble

public void writeDouble(double v)
                 throws java.io.IOException

Specified by:

writeDouble in interface java.io.DataOutput

Throws:

java.io.IOException

writeFloat

public void writeFloat(float v)
                throws java.io.IOException

Specified by:

writeFloat in interface java.io.DataOutput

Throws:

java.io.IOException

writeInt

public void writeInt(int v)
              throws java.io.IOException

Specified by:

writeInt in interface java.io.DataOutput

Throws:

java.io.IOException

writeLong

public void writeLong(long v)
               throws java.io.IOException

Specified by:

writeLong in interface java.io.DataOutput

Throws:

java.io.IOException

writeShort

public void writeShort(int v)
                throws java.io.IOException

Specified by:

writeShort in interface java.io.DataOutput

Throws:

java.io.IOException

writeUTF

public void writeUTF(java.lang.String str)
              throws java.io.IOException

Specified by:

writeUTF in interface java.io.DataOutput

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.OutputStream

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Specified by:

flush in interface java.io.Flushable

Overrides:

flush in class java.io.OutputStream

Throws:

java.io.IOException