java.nio
Class ReadOnlyIntArrayBuffer

java.lang.Object
  java.nio.Buffer
      java.nio.IntBuffer
          java.nio.IntArrayBuffer
              java.nio.ReadOnlyIntArrayBuffer

All Implemented Interfaces:

Comparable<IntBuffer>

final class ReadOnlyIntArrayBuffer
extends IntArrayBuffer

IntArrayBuffer, ReadWriteIntArrayBuffer and ReadOnlyIntArrayBuffer compose the implementation of array based int buffers.

ReadOnlyIntArrayBuffer extends IntArrayBuffer with all the write methods throwing read only exception.

This class is marked final for runtime performance.

Field Summary

Fields inherited from class java.nio.IntArrayBuffer

backingArray, offset

Fields inherited from class java.nio.Buffer

_elementSizeShift, capacity, limit, mark, position, UNSET_MARK

Constructor Summary

ReadOnlyIntArrayBuffer(int capacity, int[] backingArray, int arrayOffset)

Method Summary

IntBuffer	asReadOnlyBuffer() Returns a readonly buffer that shares content with this buffer.
IntBuffer	compact() Compacts this int buffer.
(package private) static ReadOnlyIntArrayBuffer	copy(IntArrayBuffer other, int markOfOther)
IntBuffer	duplicate() Returns a duplicated buffer that shares content with this buffer.
boolean	isReadOnly() Returns whether this buffer is readonly or not.
protected int[]	protectedArray() Child class implements this method to realize array().
protected int	protectedArrayOffset() Child class implements this method to realize arrayOffset().
protected boolean	protectedHasArray() Child class implements this method to realize hasArray().
IntBuffer	put(int c) Writes the given int to the current position and increase the position by 1.
IntBuffer	put(int[] src, int off, int len) Writes ints in the given int array, starting from the specified offset, to the current position and increase the position by the number of ints written.
IntBuffer	put(IntBuffer buf) Writes all the remaining ints of the src int buffer to this buffer's current position, and increase both buffers' position by the number of ints copied.
IntBuffer	put(int index, int c) Write a int to the specified index of this buffer and the position is not changed.
IntBuffer	slice() Returns a sliced buffer that shares content with this buffer.

Methods inherited from class java.nio.IntArrayBuffer

get, get, get, isDirect, order

Methods inherited from class java.nio.IntBuffer

_array, _arrayOffset, allocate, array, arrayOffset, compareTo, equals, get, hasArray, hashCode, put, toString, wrap, wrap

Methods inherited from class java.nio.Buffer

capacity, clear, flip, hasRemaining, limit, limit, mark, position, position, remaining, reset, rewind

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ReadOnlyIntArrayBuffer

ReadOnlyIntArrayBuffer(int capacity,
                       int[] backingArray,
                       int arrayOffset)

Method Detail

copy

static ReadOnlyIntArrayBuffer copy(IntArrayBuffer other,
                                   int markOfOther)

asReadOnlyBuffer

public IntBuffer asReadOnlyBuffer()

Description copied from class: IntBuffer

Returns a readonly buffer that shares content with this buffer.

The returned buffer is guaranteed to be a new instance, even this buffer is readonly itself. The new buffer's position, limit, capacity and mark are the same as this buffer.

The new buffer shares content with this buffer, which means this buffer's change of content will be visible to the new buffer. The two buffer's position, limit and mark are independent.

Specified by:

asReadOnlyBuffer in class IntBuffer

Returns:

A readonly version of this buffer.

compact

public IntBuffer compact()

Description copied from class: IntBuffer

Compacts this int buffer.

The remaining ints will be moved to the head of the buffer, staring from position zero. Then the position is set to remaining(); the limit is set to capacity; the mark is cleared.

Specified by:

compact in class IntBuffer

Returns:

This buffer

duplicate

public IntBuffer duplicate()

Description copied from class: IntBuffer

Returns a duplicated buffer that shares content with this buffer.

The duplicated buffer's position, limit, capacity and mark are the same as this buffer. The duplicated buffer's readonly property and byte order are same as this buffer too.

The new buffer shares content with this buffer, which means either buffer's change of content will be visible to the other. The two buffer's position, limit and mark are independent.

Specified by:

duplicate in class IntBuffer

Returns:

A duplicated buffer that shares content with this buffer.

isReadOnly

public boolean isReadOnly()

Description copied from class: Buffer

Returns whether this buffer is readonly or not.

Specified by:

isReadOnly in class Buffer

Returns:

Whether this buffer is readonly or not.

protectedArray

protected int[] protectedArray()

Description copied from class: IntBuffer

Child class implements this method to realize array().

Specified by:

protectedArray in class IntBuffer

Returns:

see array()

protectedArrayOffset

protected int protectedArrayOffset()

Description copied from class: IntBuffer

Child class implements this method to realize arrayOffset().

Specified by:

protectedArrayOffset in class IntBuffer

Returns:

see arrayOffset()

protectedHasArray

protected boolean protectedHasArray()

Description copied from class: IntBuffer

Child class implements this method to realize hasArray().

Specified by:

protectedHasArray in class IntBuffer

Returns:

see hasArray()

put

public IntBuffer put(int c)

Description copied from class: IntBuffer

Writes the given int to the current position and increase the position by 1.

Specified by:

put in class IntBuffer

Parameters:

c - The int to write

Returns:

This buffer

put

public IntBuffer put(int index,
                     int c)

Description copied from class: IntBuffer

Write a int to the specified index of this buffer and the position is not changed.

Specified by:

put in class IntBuffer

Parameters:

index - The index, must be no less than zero and less than the limit

c - The int to write

Returns:

This buffer

put

public IntBuffer put(IntBuffer buf)

Description copied from class: IntBuffer

Writes all the remaining ints of the src int buffer to this buffer's current position, and increase both buffers' position by the number of ints copied.

Overrides:

put in class IntBuffer

Parameters:

buf - The source int buffer

Returns:

This buffer

put

public final IntBuffer put(int[] src,
                           int off,
                           int len)

Description copied from class: IntBuffer

Writes ints in the given int array, starting from the specified offset, to the current position and increase the position by the number of ints written.

Overrides:

put in class IntBuffer

Parameters:

src - The source int array

off - The offset of int array, must be no less than zero and no greater than src.length

len - The number of ints to write, must be no less than zero and no greater than src.length - off

Returns:

This buffer

slice

public IntBuffer slice()

Description copied from class: IntBuffer

Returns a sliced buffer that shares content with this buffer.

The sliced buffer's capacity will be this buffer's remaining(), and its zero position will correspond to this buffer's current position. The new buffer's position will be 0, limit will be its capacity, and its mark is unset. The new buffer's readonly property and byte order are same as this buffer.

The new buffer shares content with this buffer, which means either buffer's change of content will be visible to the other. The two buffer's position, limit and mark are independent.

Specified by:

slice in class IntBuffer

Returns:

A sliced buffer that shares content with this buffer.