@InterfaceAudience.Public public class SimplePositionedByteRange extends AbstractPositionedByteRange
SimpleMutableByteRange
implementation with position support and it is a
readonly version. position
is considered transient, not fundamental to the definition of
the range, and does not participate in AbstractByteRange.compareTo(ByteRange)
, AbstractByteRange.hashCode()
, or
AbstractByteRange.equals(Object)
. Position
is retained by copy operations.limit, position
bytes, hash, length, offset, UNSET_HASH_VALUE
Constructor and Description |
---|
SimplePositionedByteRange()
Create a new
PositionedByteRange lacking a backing array and with an undefined
viewport. |
SimplePositionedByteRange(byte[] bytes)
Create a new
PositionedByteRange over the provided bytes . |
SimplePositionedByteRange(byte[] bytes,
int offset,
int length)
Create a new
PositionedByteRange over the provided bytes . |
SimplePositionedByteRange(int capacity)
Create a new
PositionedByteRange over a new backing array of size capacity . |
Modifier and Type | Method and Description |
---|---|
PositionedByteRange |
deepCopy()
Create a new
ByteRange with new backing byte[] containing a copy of the content from
this range's window. |
PositionedByteRange |
get(int index,
byte[] dst)
Fill
dst with bytes from the range, starting from index . |
PositionedByteRange |
get(int index,
byte[] dst,
int offset,
int length)
Fill
dst with bytes from the range, starting from index . |
PositionedByteRange |
put(byte val)
Store
val at the next position in this range. |
PositionedByteRange |
put(byte[] val)
Store the content of
val in this range, starting at the next position. |
PositionedByteRange |
put(byte[] val,
int offset,
int length)
Store
length bytes from val into this range. |
PositionedByteRange |
put(int index,
byte val)
Store
val at index . |
PositionedByteRange |
put(int index,
byte[] val)
Store
val at index . |
PositionedByteRange |
put(int index,
byte[] val,
int offset,
int length)
Store
length bytes from val into this range, starting at index . |
PositionedByteRange |
putInt(int val)
Store int
val at the next position in this range. |
PositionedByteRange |
putInt(int index,
int val)
Store the int value at
index |
PositionedByteRange |
putLong(int index,
long val)
Store the long value at
index |
PositionedByteRange |
putLong(long val)
Store long
val at the next position in this range. |
PositionedByteRange |
putShort(int index,
short val)
Store the short value at
index |
PositionedByteRange |
putShort(short val)
Store short
val at the next position in this range. |
int |
putVLong(int index,
long val)
Store the long value at
index as a VLong |
int |
putVLong(long val)
Store the long
val at the next position as a VLong |
PositionedByteRange |
set(byte[] bytes)
Reuse this
ByteRange over a new byte[]. |
PositionedByteRange |
set(byte[] bytes,
int offset,
int length)
Reuse this
ByteRange over a new byte[]. |
PositionedByteRange |
set(int capacity)
Reuse this
ByteRange over a new byte[]. |
PositionedByteRange |
setLimit(int limit)
Limits the byte range upto a specified value.
|
PositionedByteRange |
shallowCopy()
Create a new
ByteRange that points at this range's byte[]. |
PositionedByteRange |
shallowCopySubRange(int innerOffset,
int copyLength)
Create a new
ByteRange that points at this range's byte[]. |
PositionedByteRange |
unset()
Nullifies this ByteRange.
|
get, get, get, getInt, getLimit, getLong, getPosition, getRemaining, getShort, getVLong, peek, setLength, setOffset, setPosition
clearHashCache, compareTo, deepCopySubRangeTo, deepCopyTo, deepCopyToNewArray, equals, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, getVLongSize, hashCode, isEmpty, isEmpty, isHashCached, toString
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
deepCopySubRangeTo, deepCopyTo, deepCopyToNewArray, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, isEmpty
compareTo
public SimplePositionedByteRange()
PositionedByteRange
lacking a backing array and with an undefined
viewport.public SimplePositionedByteRange(int capacity)
PositionedByteRange
over a new backing array of size capacity
. The
range's offset and length are 0 and capacity
, respectively.capacity
- the size of the backing array.public SimplePositionedByteRange(byte[] bytes)
PositionedByteRange
over the provided bytes
.bytes
- The array to wrap.public SimplePositionedByteRange(byte[] bytes, int offset, int length)
PositionedByteRange
over the provided bytes
.bytes
- The array to wrap.offset
- The offset into bytes
considered the beginning of this range.length
- The length of this range.public PositionedByteRange set(int capacity)
ByteRange
ByteRange
over a new byte[]. offset
is set to 0 and length
is set to capacity
.set
in interface ByteRange
set
in interface PositionedByteRange
set
in class AbstractPositionedByteRange
capacity
- the size of a new byte[]. npublic PositionedByteRange set(byte[] bytes)
ByteRange
ByteRange
over a new byte[]. offset
is set to 0 and length
is set to bytes.length
. A null bytes
IS supported, in which case this method
will behave equivalently to ByteRange.unset()
.set
in interface ByteRange
set
in interface PositionedByteRange
set
in class AbstractPositionedByteRange
bytes
- the array to wrap. npublic PositionedByteRange set(byte[] bytes, int offset, int length)
ByteRange
ByteRange
over a new byte[]. A null bytes
IS supported, in which
case this method will behave equivalently to ByteRange.unset()
, regardless of the values of
offset
and length
.set
in interface ByteRange
set
in interface PositionedByteRange
set
in class AbstractPositionedByteRange
bytes
- The array to wrap.offset
- The offset into bytes
considered the beginning of this range.length
- The length of this range.public PositionedByteRange put(byte val)
PositionedByteRange
val
at the next position in this range.val
- the new value.public PositionedByteRange putShort(short val)
PositionedByteRange
val
at the next position in this range.val
- the new value.public PositionedByteRange putInt(int val)
PositionedByteRange
val
at the next position in this range.val
- the new value.public PositionedByteRange putLong(long val)
PositionedByteRange
val
at the next position in this range.val
- the new value.public int putVLong(long val)
PositionedByteRange
val
at the next position as a VLongval
- the value to storepublic PositionedByteRange put(byte[] val)
PositionedByteRange
val
in this range, starting at the next position.val
- the new value.public PositionedByteRange put(byte[] val, int offset, int length)
PositionedByteRange
length
bytes from val
into this range. Bytes from val
are copied
starting at offset
into the range, starting at the current position.val
- the new value.offset
- the offset in val
from which to start copying.length
- the number of bytes to copy from val
.public PositionedByteRange get(int index, byte[] dst)
ByteRange
dst
with bytes from the range, starting from index
.get
in interface ByteRange
get
in interface PositionedByteRange
get
in class AbstractPositionedByteRange
index
- zero-based index into this range.dst
- the destination of the copy.public PositionedByteRange get(int index, byte[] dst, int offset, int length)
ByteRange
dst
with bytes from the range, starting from index
. length
bytes
are copied into dst
, starting at offset
.get
in interface ByteRange
get
in interface PositionedByteRange
get
in class AbstractPositionedByteRange
index
- zero-based index into this range.dst
- the destination of the copy.offset
- the offset into dst
to start the copy.length
- the number of bytes to copy into dst
.public PositionedByteRange put(int index, byte val)
ByteRange
val
at index
.index
- the index in the range where val
is stored.val
- the value to store.public PositionedByteRange putShort(int index, short val)
ByteRange
index
index
- the index in the range where val
is storedval
- the value to store npublic PositionedByteRange putInt(int index, int val)
ByteRange
index
index
- the index in the range where val
is storedval
- the value to store npublic int putVLong(int index, long val)
ByteRange
index
as a VLongindex
- the index in the range where val
is storedval
- the value to storepublic PositionedByteRange putLong(int index, long val)
ByteRange
index
index
- the index in the range where val
is storedval
- the value to store npublic PositionedByteRange put(int index, byte[] val)
ByteRange
val
at index
.index
- the index in the range where val
is stored.val
- the value to store.public PositionedByteRange put(int index, byte[] val, int offset, int length)
ByteRange
length
bytes from val
into this range, starting at index
. Bytes
from val
are copied starting at offset
into the range.index
- position in this range to start the copy.val
- the value to store.offset
- the offset in val
from which to start copying.length
- the number of bytes to copy from val
.public PositionedByteRange deepCopy()
ByteRange
ByteRange
with new backing byte[] containing a copy of the content from
this
range's window.public PositionedByteRange shallowCopy()
ByteRange
ByteRange
that points at this range's byte[]. Modifying the shallowCopy
will modify the bytes in this range's array. Pass over the hash code if it is already cached.ByteRange
object referencing this range's byte[].public PositionedByteRange shallowCopySubRange(int innerOffset, int copyLength)
ByteRange
ByteRange
that points at this range's byte[]. The new range can have
different values for offset and length, but modifying the shallowCopy will modify the bytes in
this range's array. Pass over the hash code if it is already cached.innerOffset
- First byte of clone will be this.offset + copyOffset.copyLength
- Number of bytes in the clone.ByteRange
object referencing this range's byte[].public PositionedByteRange setLimit(int limit)
PositionedByteRange
setLimit
in interface PositionedByteRange
setLimit
in class AbstractPositionedByteRange
public PositionedByteRange unset()
ByteRange
Copyright © 2007–2020 The Apache Software Foundation. All rights reserved.