net.sourceforge.javaflacencoder

Class FLACStreamOutputStream

java.lang.Object

net.sourceforge.javaflacencoder.FLACStreamOutputStream

All Implemented Interfaces:

Closeable, AutoCloseable, FLACOutputStream

public class FLACStreamOutputStream
extends Object
implements FLACOutputStream, Closeable

This class provides basic OutputStream support for writing from a FLACEncoder.

Author:

Preston Lacey

Constructor Summary

Constructors

Constructor and Description
FLACStreamOutputStream(OutputStream out) Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	canSeek() Test whether this stream is seekable.
void	close() Close OutputStream owned by this object.
long	getPos() Get the current write position of this stream.
long	seek(long pos) Attempt to seek to the given location within this stream.
long	size() Get the number of bytes that have been written by this object.
void	write(byte data) Write a byte to this stream.
int	write(byte[] data, int offset, int count) Write the given number of bytes from the byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

FLACStreamOutputStream

public FLACStreamOutputStream(OutputStream out)
                       throws IOException

Constructor. Create a FLACStreamOutputStream using the given OutputStream.

Parameters:

out - OutputStream to write the FLAC stream to.

Throws:

IOException

Method Detail

seek

public long seek(long pos)

Attempt to seek to the given location within this stream. It is not guaranteed that all implementations can or will support seeking. Use the method canSeek()

Specified by:

seek in interface FLACOutputStream

Parameters:

pos - target position to seek to.

Returns:

current position after seek attempt.

write

public void write(byte data)
           throws IOException

Write a byte to this stream.

Specified by:

write in interface FLACOutputStream

Parameters:

data - byte to write.

Throws:

IOException - IOException will be raised if an error occurred while writing.

write

public int write(byte[] data,
                 int offset,
                 int count)
          throws IOException

Write the given number of bytes from the byte array. Return number of bytes written.

Specified by:

write in interface FLACOutputStream

Parameters:

data - array containing bytes to be written.

offset - start index of array to begin reading from.

count - number of bytes to write.

Returns:

number of bytes written.

Throws:

IOException - IOException upon a write error.

size

public long size()

Get the number of bytes that have been written by this object.

Specified by:

size in interface FLACOutputStream

Returns:

total length written.

canSeek

public boolean canSeek()

Test whether this stream is seekable.

Specified by:

canSeek in interface FLACOutputStream

Returns:

true if stream is seekable, false otherwise

getPos

public long getPos()

Get the current write position of this stream. If this stream cannot seek, this will return 0;

Specified by:

getPos in interface FLACOutputStream

Returns:

current write position.

close

public void close()
           throws IOException

Close OutputStream owned by this object.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface FLACOutputStream

Throws:

IOException