@InterfaceAudience.Public @InterfaceStability.Evolving 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
Object.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, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, getVLongSize, hashCode, isEmpty, isEmpty, isHashCached, toString
clone, equals, 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[].public 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.public 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.put
in interface PositionedByteRange
put
in class AbstractPositionedByteRange
val
- the new value.public PositionedByteRange putShort(short val)
PositionedByteRange
val
at the next position in this range.putShort
in interface PositionedByteRange
putShort
in class AbstractPositionedByteRange
val
- the new value.public PositionedByteRange putInt(int val)
PositionedByteRange
val
at the next position in this range.putInt
in interface PositionedByteRange
putInt
in class AbstractPositionedByteRange
val
- the new value.public PositionedByteRange putLong(long val)
PositionedByteRange
val
at the next position in this range.putLong
in interface PositionedByteRange
putLong
in class AbstractPositionedByteRange
val
- the new value.public int putVLong(long val)
PositionedByteRange
val
at the next position as a VLongputVLong
in interface PositionedByteRange
putVLong
in class AbstractPositionedByteRange
val
- the value to storepublic PositionedByteRange put(byte[] val)
PositionedByteRange
val
in this range, starting at the next position.put
in interface PositionedByteRange
put
in class AbstractPositionedByteRange
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.put
in interface PositionedByteRange
put
in class AbstractPositionedByteRange
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
.put
in interface ByteRange
put
in interface PositionedByteRange
put
in class AbstractPositionedByteRange
index
- the index in the range where val
is stored.val
- the value to store.public PositionedByteRange putShort(int index, short val)
ByteRange
index
putShort
in interface ByteRange
putShort
in interface PositionedByteRange
putShort
in class AbstractPositionedByteRange
index
- the index in the range where val
is storedval
- the value to storepublic PositionedByteRange putInt(int index, int val)
ByteRange
index
putInt
in interface ByteRange
putInt
in interface PositionedByteRange
putInt
in class AbstractPositionedByteRange
index
- the index in the range where val
is storedval
- the value to storepublic int putVLong(int index, long val)
ByteRange
index
as a VLongputVLong
in interface ByteRange
putVLong
in class AbstractPositionedByteRange
index
- the index in the range where val
is storedval
- the value to storepublic PositionedByteRange putLong(int index, long val)
ByteRange
index
putLong
in interface ByteRange
putLong
in interface PositionedByteRange
putLong
in class AbstractPositionedByteRange
index
- the index in the range where val
is storedval
- the value to storepublic PositionedByteRange put(int index, byte[] val)
ByteRange
val
at index
.put
in interface ByteRange
put
in interface PositionedByteRange
put
in class AbstractPositionedByteRange
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.put
in interface ByteRange
put
in interface PositionedByteRange
put
in class AbstractPositionedByteRange
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.deepCopy
in interface ByteRange
deepCopy
in interface PositionedByteRange
deepCopy
in class AbstractPositionedByteRange
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.shallowCopy
in interface ByteRange
shallowCopy
in interface PositionedByteRange
shallowCopy
in class AbstractPositionedByteRange
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.shallowCopySubRange
in interface ByteRange
shallowCopySubRange
in interface PositionedByteRange
shallowCopySubRange
in class AbstractPositionedByteRange
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
unset
in interface ByteRange
unset
in interface PositionedByteRange
unset
in class AbstractPositionedByteRange
Copyright © 2007–2019 The Apache Software Foundation. All rights reserved.