Package io.deephaven.vector

Class ByteVectorDirect

java.lang.Object
io.deephaven.vector.ByteVectorDirect
All Implemented Interfaces:
LongSizedDataStructure, ByteVector, Vector<ByteVector>, Serializable, Comparable<ByteVector>, Iterable<Byte>
public final class ByteVectorDirect extends Object implements ByteVector
A ByteVector backed by an array.
See Also:

  • Field Details

    • ZERO_LENGTH_VECTOR

      public static final ByteVector ZERO_LENGTH_VECTOR

  • Constructor Details

    • ByteVectorDirect

      public ByteVectorDirect(@NotNull @org.jetbrains.annotations.NotNull byte... data)

  • Method Details

    • get

      public byte get(long index)
      Description copied from interface: ByteVector
      Get the element of this ByteVector at offset index. If index is not within range [0, size()), will return the null byte.
      Specified by:
      get in interface ByteVector
      Parameters:
      index - An offset into this ByteVector
      Returns:
      The element at the specified offset, or the null byte

    • subVector

      public ByteVector subVector(long fromIndexInclusive, long toIndexExclusive)
      Description copied from interface: Vector
      Get a Vector that represents a slice of this Vector.
      Specified by:
      subVector in interface ByteVector
      Specified by:
      subVector in interface Vector<ByteVector>
      Parameters:
      fromIndexInclusive - The first offset into this Vector to include in the result; if negative, the result will have a range of null values at offsets in [0, -fromIndexInclusive)
      toIndexExclusive - The first offset into this Vector to not include in the result; if larger than size(), the result will have a range of null values at the corresponding offsets
      Returns:
      The sub-Vector specified by [fromIndexInclusive, toIndexExclusive)

    • subVectorByPositions

      public ByteVector subVectorByPositions(long[] positions)
      Description copied from interface: Vector
      Get a Vector that represents a set of offset positions in this Vector.
      Specified by:
      subVectorByPositions in interface ByteVector
      Specified by:
      subVectorByPositions in interface Vector<ByteVector>
      Parameters:
      positions - The offsets to include; if not within [0, size()), the corresponding offset in the result will contain the appropriate null value
      Returns:
      The sub-Vector specified by positions

    • toArray

      public byte[] toArray()
      Description copied from interface: Vector
      Get an array representation of the elements of this Vector. Callers must not mutate the result, as implementations may choose to return their backing array in some cases.
      Specified by:
      toArray in interface ByteVector
      Specified by:
      toArray in interface Vector<ByteVector>
      Returns:
      An array representation of the elements of this Vector that must not be mutated

    • copyToArray

      public byte[] copyToArray()
      Description copied from interface: Vector
      Get an array representation of the elements of this Vector. Callers may freely mutate the result, as it is guaranteed to be freshly-allocated and belongs to the caller upon return.
      Specified by:
      copyToArray in interface ByteVector
      Specified by:
      copyToArray in interface Vector<ByteVector>
      Returns:
      An array representation of the elements of this Vector that may be freely mutated

    • iterator

      public ValueIteratorOfByte iterator(long fromIndexInclusive, long toIndexExclusive)
      Description copied from interface: ByteVector
      Returns an iterator over a slice of this vector, with equivalent semantics to subVector(fromIndexInclusive, toIndexExclusive).iterator().
      Specified by:
      iterator in interface ByteVector
      Parameters:
      fromIndexInclusive - The first position to include
      toIndexExclusive - The first position after fromIndexInclusive to not include
      Returns:
      An iterator over the requested slice

    • size

      public long size()
      Description copied from interface: LongSizedDataStructure
      The size of this data structure.
      Specified by:
      size in interface LongSizedDataStructure
      Returns:
      The size

    • getDirect

      public ByteVectorDirect getDirect()
      Specified by:
      getDirect in interface ByteVector
      Specified by:
      getDirect in interface Vector<ByteVector>
      Returns:
      A version of this Vector that is flattened out to only reference memory

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object

    • compareTo

      public int compareTo(ByteVector o)
      Description copied from interface: ByteVector

      Compare this vector with another vector.

      The vectors are ordered lexicographically using Deephaven sorting rules.

      Specified by:
      compareTo in interface ByteVector
      Specified by:
      compareTo in interface Comparable<ByteVector>

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object