java.nio
public abstract class Buffer extends Object
Since: 1.4
Method Summary | |
---|---|
abstract Object | array()
Returns the backing array of this buffer, if this buffer has one.
|
abstract int | arrayOffset()
For buffers that are backed by a Java array, this returns the offset
into that array at which the buffer content starts.
|
int | capacity()
Retrieves the capacity of the buffer.
|
Buffer | clear()
Clears the buffer.
|
Buffer | flip()
Flips the buffer.
|
abstract boolean | hasArray()
Returns true if this buffer can provide a backing array,
false otherwise. |
boolean | hasRemaining()
Tells whether the buffer has remaining data to read or not.
|
abstract boolean | isDirect()
Returns true when this buffer is direct, false
otherwise. |
abstract boolean | isReadOnly()
Tells whether this buffer is read only or not.
|
int | limit()
Retrieves the current limit of the buffer.
|
Buffer | limit(int newLimit)
Sets this buffer's limit.
|
Buffer | mark()
Sets this buffer's mark at its position.
|
int | position()
Retrieves the current position of this buffer.
|
Buffer | position(int newPosition)
Sets this buffer's position. |
int | remaining()
Returns the number of elements between the current position and the limit.
|
Buffer | reset()
Resets this buffer's position to the previously-marked position.
|
Buffer | rewind()
Rewinds this buffer. |
If this is a read-only buffer, then a ReadOnlyBufferException is thrown because exposing the array would allow to circumvent the read-only property. If this buffer doesn't have an array, then an UnsupportedOperationException is thrown. Applications should check if this buffer supports a backing array by calling Buffer first.
Returns: the backing array of this buffer
Throws: ReadOnlyBufferException when this buffer is read only UnsupportedOperationException when this buffer does not provide a backing array
Since: 1.6
Returns: the offset into the backing array at which the buffer content starts
Throws: ReadOnlyBufferException when this buffer is read only UnsupportedOperationException when this buffer does not provide a backing array
Since: 1.6
Returns: the capacity of the buffer
Returns: this buffer
Returns: this buffer
true
if this buffer can provide a backing array,
false
otherwise. When true
, application code
can call array to access this backing array.
Returns: true
if this buffer can provide a backing array,
false
otherwise
Since: 1.6
Returns: true if the buffer contains remaining data to read, false otherwise
true
when this buffer is direct, false
otherwise. A direct buffer is usually backed by a raw memory area instead
of a Java array.
Returns: true
when this buffer is direct, false
otherwise
Since: 1.6
Returns: true if the buffer is read only, false otherwise
Returns: the limit of the buffer
Parameters: newLimit The new limit value; must be non-negative and no larger than this buffer's capacity.
Returns: this buffer
Throws: IllegalArgumentException If the preconditions on newLimit do not hold.
Returns: this buffer
Returns: the current position of this buffer
Parameters: newPosition The new position value; must be non-negative and no larger than the current limit.
Returns: this buffer
Throws: IllegalArgumentException If the preconditions on newPosition do not hold
Returns: the number of remaining elements
Returns: this buffer
Throws: InvalidMarkException If the mark has not been set.
Returns: this buffer