Interface LongVector

All Superinterfaces:
Iterable<Long>, LongSizedDataStructure, Serializable, Vector<LongVector>
All Known Implementing Classes:
LongRingBufferVectorWrapper, LongSegmentedSortedMultiset, LongSubVector, LongVector.Indirect, LongVectorColumnWrapper, LongVectorDirect, LongVectorSlice

public interface LongVector extends Vector<LongVector>, Iterable<Long>
A Vector of primitive longs.
  • Field Details

  • Method Details

    • type

    • get

      long get(long index)
      Get the element of this LongVector at offset index. If index is not within range [0, size()), will return the null long.
      Parameters:
      index - An offset into this LongVector
      Returns:
      The element at the specified offset, or the null long
    • subVector

      LongVector 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 Vector<LongVector>
      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

      LongVector 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 Vector<LongVector>
      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

      long[] 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 Vector<LongVector>
      Returns:
      An array representation of the elements of this Vector that must not be mutated
    • copyToArray

      long[] 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 Vector<LongVector>
      Returns:
      An array representation of the elements of this Vector that may be freely mutated
    • getDirect

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

      Specified by:
      iterator in interface Iterable<Long>
    • iterator

      default CloseablePrimitiveIteratorOfLong iterator(long fromIndexInclusive, long toIndexExclusive)
      Returns an iterator over a slice of this vector, with equivalent semantics to subVector(fromIndexInclusive, toIndexExclusive).iterator().
      Parameters:
      fromIndexInclusive - The first position to include
      toIndexExclusive - The first position after fromIndexInclusive to not include
      Returns:
      An iterator over the requested slice
    • getComponentType

      @FinalDefault default Class<?> getComponentType()
      Specified by:
      getComponentType in interface Vector<LongVector>
      Returns:
      The type of elements contained by this Vector
    • toString

      @FinalDefault default String toString(int prefixLength)
      Description copied from interface: Vector
      Get a String representation of a prefix of this Vector.
      Specified by:
      toString in interface Vector<LongVector>
      Parameters:
      prefixLength - The number of elements to include
      Returns:
      The specified prefix String representation
    • longValToString

      static String longValToString(Object val)
    • primitiveLongValToString

      static String primitiveLongValToString(long val)
    • toString

      static String toString(@NotNull @NotNull LongVector vector, int prefixLength)
      Helper method for implementing Object.toString().
      Parameters:
      vector - The LongVector to convert to a String
      prefixLength - The maximum prefix of vector to convert
      Returns:
      The String representation of vector
    • equals

      static boolean equals(@NotNull @NotNull LongVector aVector, @Nullable @Nullable Object bObj)
      Helper method for implementing Object.equals(Object).
      Parameters:
      aVector - The LHS of the equality test (always a LongVector)
      bObj - The RHS of the equality test
      Returns:
      Whether the two inputs are equal
    • hashCode

      static int hashCode(@NotNull @NotNull LongVector vector)
      Helper method for implementing Object.hashCode(). Follows the pattern in Arrays.hashCode(long[]).
      Parameters:
      vector - The LongVector to hash
      Returns:
      The hash code