| java.lang.Object
 java.nio.Buffer
java.nio.LongBuffer
All known Subclasses: java.nio.LongToByteBufferAdapter, java.nio.LongArrayBuffer,
| LongBuffer | | abstract public class LongBuffer extends Buffer implements Comparable<LongBuffer>(Code) | | A buffer of longs.
A long buffer can be created in either of the following ways:
|
| Constructor Summary | |
| | LongBuffer(int capacity)
Constructs a LongBuffer with given capacity. |
| Method Summary | |
| public static LongBuffer | allocate(int capacity)
Creates a long buffer based on a new allocated long array. | | final public long[] | array()
Returns the long array which this buffer is based on, if there's one. | | final public int | arrayOffset()
Returns the offset of the long array which this buffer is based on, if
there's one. | | abstract public LongBuffer | asReadOnlyBuffer()
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. | | abstract public LongBuffer | compact()
Compacts this long buffer.
The remaining longs will be moved to the head of the
buffer, staring from position zero. | | public int | compareTo(LongBuffer otherBuffer)
Compare the remaining longs of this buffer to another
long buffer's remaining longs. | | abstract public LongBuffer | duplicate()
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. | | public boolean | equals(Object other)
Tests whether this long buffer equals to another object.
If other is not a long buffer, then false is returned.
Two long buffers are equals if, and only if, their remaining
longs are exactly the same. | | abstract public long | get()
Returns the long at the current position and increase the position by 1. | | public LongBuffer | get(long[] dest)
Reads longs from the current position into the specified
long array and increase the position by the number of longs
read. | | public LongBuffer | get(long[] dest, int off, int len)
Reads longs from the current position into the specified
long array, starting from the specified offset, and increase the position
by the number of longs read. | | abstract public long | get(int index)
Returns a long at the specified index, and the position is not changed. | | final public boolean | hasArray()
Returns whether this buffer is based on a long array and is read/write. | | public int | hashCode()
Hash code is calculated from the remaining longs. | | abstract public boolean | isDirect()
Returns true if this buffer is direct. | | abstract public ByteOrder | order()
Returns the byte order used by this buffer when converting
longs from/to bytes. | | abstract long[] | protectedArray()
Child class implements this method to realize array(). | | abstract int | protectedArrayOffset()
Child class implements this method to realize arrayOffset(). | | abstract boolean | protectedHasArray()
Child class implements this method to realize hasArray(). | | abstract public LongBuffer | put(long l)
Writes the given long to the current position and increase the position
by 1. | | final public LongBuffer | put(long[] src)
Writes longs in the given long array to the current
position and increase the position by the number of longs
written. | | public LongBuffer | put(long[] src, int off, int len)
Writes longs in the given long array, starting from the
specified offset, to the current position and increase the position by
the number of longs written. | | public LongBuffer | put(LongBuffer src)
Writes all the remaining longs of the src
long buffer to this buffer's current position, and increase both buffers'
position by the number of longs copied. | | abstract public LongBuffer | put(int index, long l)
Write a long to the specified index of this buffer and the position is
not changed. | | abstract public LongBuffer | slice()
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. | | public String | toString()
Returns a string represents the state of this long buffer. | | public static LongBuffer | wrap(long[] array)
Creates a new long buffer by wrapping the given long array. | | public static LongBuffer | wrap(long[] array, int start, int len)
Creates new a long buffer by wrapping the given long array. |
| LongBuffer | | LongBuffer(int capacity)(Code) | | Constructs a LongBuffer with given capacity.
Parameters:
capacity - The capacity of the buffer |
| allocate | | public static LongBuffer allocate(int capacity)(Code) | | Creates a long buffer based on a new allocated long array.
Parameters:
capacity - The capacity of the new buffer The created long buffer
throws:
IllegalArgumentException - If capacity is less than zero |
| array | | final public long[] array()(Code) | | Returns the long array which this buffer is based on, if there's one.
The long array which this buffer is based on
exception:
ReadOnlyBufferException - If this buffer is based on an array, but it is readonly
exception:
UnsupportedOperationException - If this buffer is not based on an array |
| arrayOffset | | final public int arrayOffset()(Code) | | Returns the offset of the long array which this buffer is based on, if
there's one.
The offset is the index of the array corresponds to the zero position of
the buffer.
The offset of the long array which this buffer is based on
exception:
ReadOnlyBufferException - If this buffer is based on an array, but it is readonly
exception:
UnsupportedOperationException - If this buffer is not based on an array |
| asReadOnlyBuffer | | abstract public LongBuffer asReadOnlyBuffer()(Code) | | 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.
A readonly version of this buffer. |
| compact | | abstract public LongBuffer compact()(Code) | | Compacts this long buffer.
The remaining longs 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.
This buffer
exception:
ReadOnlyBufferException - If no changes may be made to the contents of this buffer |
| compareTo | | public int compareTo(LongBuffer otherBuffer)(Code) | | Compare the remaining longs of this buffer to another
long buffer's remaining longs.
Parameters:
otherBuffer - Another long buffer a negative value if this is less than other; 0 ifthis equals to other; a positive value if this isgreater than other
exception:
ClassCastException - If other is not a long buffer |
| duplicate | | abstract public LongBuffer duplicate()(Code) | | 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.
A duplicated buffer that shares content with this buffer. |
| equals | | public boolean equals(Object other)(Code) | | Tests whether this long buffer equals to another object.
If other is not a long buffer, then false is returned.
Two long buffers are equals if, and only if, their remaining
longs are exactly the same. Position, limit, capacity and
mark are not considered.
Parameters:
other - the object to be compared against Whether this long buffer equals to another object. |
| get | | abstract public long get()(Code) | | Returns the long at the current position and increase the position by 1.
The long at the current position.
exception:
BufferUnderflowException - If the position is equal or greater than limit |
| get | | public LongBuffer get(long[] dest)(Code) | | Reads longs from the current position into the specified
long array and increase the position by the number of longs
read.
Calling this method has the same effect as
get(dest, 0, dest.length).
Parameters:
dest - The destination long array This buffer
exception:
BufferUnderflowException - if dest.length is greater thanremaining() |
| get | | public LongBuffer get(long[] dest, int off, int len)(Code) | | Reads longs from the current position into the specified
long array, starting from the specified offset, and increase the position
by the number of longs read.
Parameters:
dest - The target long array
Parameters:
off - The offset of the long array, must be no less than zero and nogreater than dest.length
Parameters:
len - The number of longs to read, must be no lessthan zero and no greater than dest.length - off This buffer
exception:
IndexOutOfBoundsException - If either off or len isinvalid
exception:
BufferUnderflowException - If len is greater thanremaining() |
| get | | abstract public long get(int index)(Code) | | Returns a long at the specified index, and the position is not changed.
Parameters:
index - The index, must be no less than zero and less than limit A long at the specified index.
exception:
IndexOutOfBoundsException - If index is invalid |
| hasArray | | final public boolean hasArray()(Code) | | Returns whether this buffer is based on a long array and is read/write.
If this buffer is readonly, then false is returned.
Whether this buffer is based on a long array and is read/write. |
| hashCode | | public int hashCode()(Code) | | Hash code is calculated from the remaining longs.
Position, limit, capacity and mark don't affect the hash code.
The hash code calculated from the remaining longs. |
| isDirect | | abstract public boolean isDirect()(Code) | | Returns true if this buffer is direct.
A direct buffer will try its best to take advantage of native memory APIs
and it may not stay in java heap, thus not affected by GC.
A long buffer is direct, if it is based on a byte buffer and the byte
buffer is direct.
True if this buffer is direct. |
| order | | abstract public ByteOrder order()(Code) | | Returns the byte order used by this buffer when converting
longs from/to bytes.
If this buffer is not based on a byte buffer, then always return the
platform's native byte order.
The byte order used by this buffer when convertinglongs from/to bytes. |
| protectedArray | | abstract long[] protectedArray()(Code) | | Child class implements this method to realize array().
see array() |
| protectedArrayOffset | | abstract int protectedArrayOffset()(Code) | | Child class implements this method to realize arrayOffset().
see arrayOffset() |
| protectedHasArray | | abstract boolean protectedHasArray()(Code) | | Child class implements this method to realize hasArray().
see hasArray() |
| put | | abstract public LongBuffer put(long l)(Code) | | Writes the given long to the current position and increase the position
by 1.
Parameters:
l - The long to write This buffer
exception:
BufferOverflowException - If position is equal or greater than limit
exception:
ReadOnlyBufferException - If no changes may be made to the contents of this buffer |
| put | | final public LongBuffer put(long[] src)(Code) | | Writes longs in the given long array to the current
position and increase the position by the number of longs
written.
Calling this method has the same effect as
put(src, 0, src.length).
Parameters:
src - The source long array This buffer
exception:
BufferOverflowException - If remaining() is less thansrc.length
exception:
ReadOnlyBufferException - If no changes may be made to the contents of this buffer |
| put | | public LongBuffer put(long[] src, int off, int len)(Code) | | Writes longs in the given long array, starting from the
specified offset, to the current position and increase the position by
the number of longs written.
Parameters:
src - The source long array
Parameters:
off - The offset of long array, must be no less than zero and nogreater than src.length
Parameters:
len - The number of longs to write, must be no lessthan zero and no greater than src.length - off This buffer
exception:
BufferOverflowException - If remaining() is less thanlen
exception:
IndexOutOfBoundsException - If either off or len isinvalid
exception:
ReadOnlyBufferException - If no changes may be made to the contents of this buffer |
| put | | public LongBuffer put(LongBuffer src)(Code) | | Writes all the remaining longs of the src
long buffer to this buffer's current position, and increase both buffers'
position by the number of longs copied.
Parameters:
src - The source long buffer This buffer
exception:
BufferOverflowException - If src.remaining() is greater than thisbuffer's remaining()
exception:
IllegalArgumentException - If src is this buffer
exception:
ReadOnlyBufferException - If no changes may be made to the contents of this buffer |
| put | | abstract public LongBuffer put(int index, long l)(Code) | | Write a long to the specified index of this buffer and the position is
not changed.
Parameters:
index - The index, must be no less than zero and less than the limit
Parameters:
l - The long to write This buffer
exception:
IndexOutOfBoundsException - If index is invalid
exception:
ReadOnlyBufferException - If no changes may be made to the contents of this buffer |
| slice | | abstract public LongBuffer slice()(Code) | | 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.
A sliced buffer that shares content with this buffer. |
| toString | | public String toString()(Code) | | Returns a string represents the state of this long buffer.
A string represents the state of this long buffer. |
| wrap | | public static LongBuffer wrap(long[] array)(Code) | | Creates a new long buffer by wrapping the given long array.
Calling this method has the same effect as
wrap(array, 0, array.length).
Parameters:
array - The long array which the new buffer will be based on The created long buffer |
| wrap | | public static LongBuffer wrap(long[] array, int start, int len)(Code) | | Creates new a long buffer by wrapping the given long array.
The new buffer's position will be start, limit will be
start + len, capacity will be the length of the array.
Parameters:
array - The long array which the new buffer will be based on
Parameters:
start - The start index, must be no less than zero and no greater thanarray.length
Parameters:
len - The length, must be no less than zero and no greater thanarray.length - start The created long buffer
exception:
IndexOutOfBoundsException - If either start or len isinvalid |
|
|