SliceOutput (leveldb 0.11 API)

java.lang.Object
- java.io.OutputStream
- - org.iq80.leveldb.util.SliceOutput

All Implemented Interfaces:

Closeable, DataOutput, Flushable, AutoCloseable

Direct Known Subclasses:

BasicSliceOutput, DynamicSliceOutput
```
public abstract class SliceOutput
extends OutputStream
implements DataOutput
```

Constructor Summary

Constructors
Constructor and Description

SliceOutput()

Constructors
Constructor and Description
`SliceOutput()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract boolean`	`isWritable()` Returns `true` if and only if `(this.capacity - this.writerIndex)` is greater than `0`.
`abstract void`	`reset()` Resets this stream to the initial position.
`abstract int`	`size()` Returns the `writerIndex` of this buffer.
`abstract Slice`	`slice()` Returns a slice of this buffer's readable bytes.
`abstract ByteBuffer`	`toByteBuffer()` Converts this buffer's readable bytes into a NIO buffer.
`abstract String`	`toString(Charset charset)` Decodes this buffer's readable bytes into a string with the specified character set name.
`abstract int`	`writableBytes()` Returns the number of writable bytes which is equal to `(this.capacity - this.writerIndex)`.
`void`	`write(byte[] source)`
`void`	`write(byte[] source, int sourceIndex, int length)`
`void`	`write(int value)`
`void`	`writeBoolean(boolean value)`
`abstract void`	`writeByte(int value)` Sets the specified byte at the current `writerIndex` and increases the `writerIndex` by `1` in this buffer.
`abstract void`	`writeBytes(byte[] source)` Transfers the specified source array's data to this buffer starting at the current `writerIndex` and increases the `writerIndex` by the number of the transferred bytes (= `source.length`).
`abstract void`	`writeBytes(byte[] source, int sourceIndex, int length)` Transfers the specified source array's data to this buffer starting at the current `writerIndex` and increases the `writerIndex` by the number of the transferred bytes (= `length`).
`abstract void`	`writeBytes(ByteBuffer source)` Transfers the specified source buffer's data to this buffer starting at the current `writerIndex` until the source buffer's position reaches its limit, and increases the `writerIndex` by the number of the transferred bytes.
`abstract int`	`writeBytes(FileChannel in, int position, int length)`
`abstract int`	`writeBytes(InputStream in, int length)` Transfers the content of the specified stream to this buffer starting at the current `writerIndex` and increases the `writerIndex` by the number of the transferred bytes.
`abstract int`	`writeBytes(ScatteringByteChannel in, int length)` Transfers the content of the specified channel to this buffer starting at the current `writerIndex` and increases the `writerIndex` by the number of the transferred bytes.
`abstract void`	`writeBytes(Slice source)` Transfers the specified source buffer's data to this buffer starting at the current `writerIndex` until the source buffer becomes unreadable, and increases the `writerIndex` by the number of the transferred bytes.
`abstract void`	`writeBytes(SliceInput source, int length)` Transfers the specified source buffer's data to this buffer starting at the current `writerIndex` and increases the `writerIndex` by the number of the transferred bytes (= `length`).
`abstract void`	`writeBytes(Slice source, int sourceIndex, int length)` Transfers the specified source buffer's data to this buffer starting at the current `writerIndex` and increases the `writerIndex` by the number of the transferred bytes (= `length`).
`void`	`writeBytes(String s)` Unsupported operation
`void`	`writeChar(int value)` Unsupported operation
`void`	`writeChars(String s)` Unsupported operation
`void`	`writeDouble(double v)` Unsupported operation
`void`	`writeFloat(float v)` Unsupported operation
`abstract void`	`writeInt(int value)` Sets the specified 32-bit integer at the current `writerIndex` and increases the `writerIndex` by `4` in this buffer.
`abstract void`	`writeLong(long value)` Sets the specified 64-bit long integer at the current `writerIndex` and increases the `writerIndex` by `8` in this buffer.
`abstract void`	`writeShort(int value)` Sets the specified 16-bit short integer at the current `writerIndex` and increases the `writerIndex` by `2` in this buffer.
`void`	`writeUTF(String s)` Unsupported operation
`abstract void`	`writeZero(int length)` Fills this buffer with `NUL (0x00)` starting at the current `writerIndex` and increases the `writerIndex` by the specified `length`.

Methods inherited from class java.io.OutputStream
close, flush

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SliceOutput
```
public SliceOutput()
```
- Method Detail
  - reset
```
public abstract void reset()
```
    Resets this stream to the initial position.
  - size
```
public abstract int size()
```
    Returns the writerIndex of this buffer.
  - writableBytes
```
public abstract int writableBytes()
```
    Returns the number of writable bytes which is equal to (this.capacity - this.writerIndex).
  - isWritable
```
public abstract boolean isWritable()
```
    Returns true if and only if (this.capacity - this.writerIndex) is greater than 0.
  - writeBoolean
```
public final void writeBoolean(boolean value)
```
    Specified by:
    
    writeBoolean in interface DataOutput
  - write
```
public final void write(int value)
```
    Specified by:
    
    write in interface DataOutput
    
    Specified by:
    
    write in class OutputStream
  - writeByte
```
public abstract void writeByte(int value)
```
    Sets the specified byte at the current writerIndex and increases the writerIndex by 1 in this buffer. The 24 high-order bits of the specified value are ignored.
    
    Specified by:
    
    writeByte in interface DataOutput
    
    Throws:
    
    IndexOutOfBoundsException - if this.writableBytes is less than 1
  - writeShort
```
public abstract void writeShort(int value)
```
    Sets the specified 16-bit short integer at the current writerIndex and increases the writerIndex by 2 in this buffer. The 16 high-order bits of the specified value are ignored.
    
    Specified by:
    
    writeShort in interface DataOutput
    
    Throws:
    
    IndexOutOfBoundsException - if this.writableBytes is less than 2
  - writeInt
```
public abstract void writeInt(int value)
```
    Sets the specified 32-bit integer at the current writerIndex and increases the writerIndex by 4 in this buffer.
    
    Specified by:
    
    writeInt in interface DataOutput
    
    Throws:
    
    IndexOutOfBoundsException - if this.writableBytes is less than 4
  - writeLong
```
public abstract void writeLong(long value)
```
    Sets the specified 64-bit long integer at the current writerIndex and increases the writerIndex by 8 in this buffer.
    
    Specified by:
    
    writeLong in interface DataOutput
    
    Throws:
    
    IndexOutOfBoundsException - if this.writableBytes is less than 8
  - writeBytes
```
public abstract void writeBytes(Slice source)
```
    Transfers the specified source buffer's data to this buffer starting at the current writerIndex until the source buffer becomes unreadable, and increases the writerIndex by the number of the transferred bytes. This method is basically same with writeBytes(Slice, int, int), except that this method increases the readerIndex of the source buffer by the number of the transferred bytes while writeBytes(Slice, int, int) does not.
    
    Throws:
    
    IndexOutOfBoundsException - if source.readableBytes is greater than this.writableBytes
  - writeBytes
```
public abstract void writeBytes(SliceInput source,
                                int length)
```
    Transfers the specified source buffer's data to this buffer starting at the current writerIndex and increases the writerIndex by the number of the transferred bytes (= length). This method is basically same with writeBytes(Slice, int, int), except that this method increases the readerIndex of the source buffer by the number of the transferred bytes (= length) while writeBytes(Slice, int, int) does not.
    
    Parameters:
    
    length - the number of bytes to transfer
    
    Throws:
    
    IndexOutOfBoundsException - if length is greater than this.writableBytes or if length is greater then source.readableBytes
  - writeBytes
```
public abstract void writeBytes(Slice source,
                                int sourceIndex,
                                int length)
```
    Transfers the specified source buffer's data to this buffer starting at the current writerIndex and increases the writerIndex by the number of the transferred bytes (= length).
    
    Parameters:
    
    sourceIndex - the first index of the source
    
    length - the number of bytes to transfer
    
    Throws:
    
    IndexOutOfBoundsException - if the specified sourceIndex is less than 0, if sourceIndex + length is greater than source.capacity, or if length is greater than this.writableBytes
  - write
```
public final void write(byte[] source)
                 throws IOException
```
    Specified by:
    
    write in interface DataOutput
    
    Overrides:
    
    write in class OutputStream
    
    Throws:
    
    IOException
  - writeBytes
```
public abstract void writeBytes(byte[] source)
```
    Transfers the specified source array's data to this buffer starting at the current writerIndex and increases the writerIndex by the number of the transferred bytes (= source.length).
    
    Throws:
    
    IndexOutOfBoundsException - if source.length is greater than this.writableBytes
  - write
```
public final void write(byte[] source,
                        int sourceIndex,
                        int length)
```
    Specified by:
    
    write in interface DataOutput
    
    Overrides:
    
    write in class OutputStream
  - writeBytes
```
public abstract void writeBytes(byte[] source,
                                int sourceIndex,
                                int length)
```
    Transfers the specified source array's data to this buffer starting at the current writerIndex and increases the writerIndex by the number of the transferred bytes (= length).
    
    Parameters:
    
    sourceIndex - the first index of the source
    
    length - the number of bytes to transfer
    
    Throws:
    
    IndexOutOfBoundsException - if the specified sourceIndex is less than 0, if sourceIndex + length is greater than source.length, or if length is greater than this.writableBytes
  - writeBytes
```
public abstract void writeBytes(ByteBuffer source)
```
    Transfers the specified source buffer's data to this buffer starting at the current writerIndex until the source buffer's position reaches its limit, and increases the writerIndex by the number of the transferred bytes.
    
    Throws:
    
    IndexOutOfBoundsException - if source.remaining() is greater than this.writableBytes
  - writeBytes
```
public abstract int writeBytes(InputStream in,
                               int length)
                        throws IOException
```
    Transfers the content of the specified stream to this buffer starting at the current writerIndex and increases the writerIndex by the number of the transferred bytes.
    
    Parameters:
    
    length - the number of bytes to transfer
    
    Returns:
    
    the actual number of bytes read in from the specified stream
    
    Throws:
    
    IndexOutOfBoundsException - if length is greater than this.writableBytes
    
    IOException - if the specified stream threw an exception during I/O
  - writeBytes
```
public abstract int writeBytes(ScatteringByteChannel in,
                               int length)
                        throws IOException
```
    Transfers the content of the specified channel to this buffer starting at the current writerIndex and increases the writerIndex by the number of the transferred bytes.
    
    Parameters:
    
    length - the maximum number of bytes to transfer
    
    Returns:
    
    the actual number of bytes read in from the specified channel
    
    Throws:
    
    IndexOutOfBoundsException - if length is greater than this.writableBytes
    
    IOException - if the specified channel threw an exception during I/O
  - writeBytes
```
public abstract int writeBytes(FileChannel in,
                               int position,
                               int length)
                        throws IOException
```
    Throws:
    
    IOException
  - writeZero
```
public abstract void writeZero(int length)
```
    Fills this buffer with NUL (0x00) starting at the current writerIndex and increases the writerIndex by the specified length.
    
    Parameters:
    
    length - the number of NULs to write to the buffer
    
    Throws:
    
    IndexOutOfBoundsException - if length is greater than this.writableBytes
  - slice
```
public abstract Slice slice()
```
    Returns a slice of this buffer's readable bytes. Modifying the content of the returned buffer or this buffer affects each other's content while they maintain separate indexes and marks. This method is identical to buf.slice(buf.readerIndex(), buf.readableBytes()). This method does not modify readerIndex or writerIndex of this buffer.
  - toByteBuffer
```
public abstract ByteBuffer toByteBuffer()
```
    Converts this buffer's readable bytes into a NIO buffer. The returned buffer might or might not share the content with this buffer, while they have separate indexes and marks. This method is identical to buf.toByteBuffer(buf.readerIndex(), buf.readableBytes()). This method does not modify readerIndex or writerIndex of this buffer.
  - toString
```
public abstract String toString(Charset charset)
```
    Decodes this buffer's readable bytes into a string with the specified character set name. This method is identical to buf.toString(buf.readerIndex(), buf.readableBytes(), charsetName). This method does not modify readerIndex or writerIndex of this buffer.
    
    Throws:
    
    UnsupportedCharsetException - if the specified character set name is not supported by the current VM
  - writeChar
```
public void writeChar(int value)
```
    Unsupported operation
    
    Specified by:
    
    writeChar in interface DataOutput
    
    Throws:
    
    UnsupportedOperationException - always
  - writeFloat
```
public void writeFloat(float v)
```
    Unsupported operation
    
    Specified by:
    
    writeFloat in interface DataOutput
    
    Throws:
    
    UnsupportedOperationException - always
  - writeDouble
```
public void writeDouble(double v)
```
    Unsupported operation
    
    Specified by:
    
    writeDouble in interface DataOutput
    
    Throws:
    
    UnsupportedOperationException - always
  - writeChars
```
public void writeChars(String s)
```
    Unsupported operation
    
    Specified by:
    
    writeChars in interface DataOutput
    
    Throws:
    
    UnsupportedOperationException - always
  - writeUTF
```
public void writeUTF(String s)
```
    Unsupported operation
    
    Specified by:
    
    writeUTF in interface DataOutput
    
    Throws:
    
    UnsupportedOperationException - always
  - writeBytes
```
public void writeBytes(String s)
```
    Unsupported operation
    
    Specified by:
    
    writeBytes in interface DataOutput
    
    Throws:
    
    UnsupportedOperationException - always

Class SliceOutput

Constructor Summary

Method Summary

Methods inherited from class java.io.OutputStream

Methods inherited from class java.lang.Object

Constructor Detail

SliceOutput

Method Detail

reset

size

writableBytes

isWritable

writeBoolean

write

writeByte

writeShort

writeInt

writeLong

writeBytes

writeBytes

writeBytes

write

writeBytes

write

writeBytes

writeBytes

writeBytes

writeBytes

writeBytes

writeZero

slice

toByteBuffer

toString

writeChar

writeFloat

writeDouble

writeChars

writeUTF

writeBytes