Package civitas.celestis.util.tuple

Interface LongTuple

All Superinterfaces:
BaseTuple<Long>, Serializable
All Known Implementing Classes:
Long1, Long2, Long3, Long4, LongArrayTuple
public interface LongTuple extends BaseTuple<Long>
A specialized tuple which holds the primitive type long. Long tuples can be converted to their boxed form by calling boxed().
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    long[]
    array()
    Returns an array containing the components of this tuple in their proper order.
    Tuple<Long>
    boxed()
    Returns a tuple containing the components of this tuple in their boxed form.
    boolean
    contains(long v)
    Checks if this tuple contains the provided value v.
    boolean
    containsAll(Iterable<Long> i)
    Checks if this tuple contains multiple values.
    static LongTuple
    empty()
    Returns an empty tuple.
    boolean
    equals(Object obj)
    Checks for equality between this tuple and the provided object obj.
    long
    get(int i)
    Returns the ith component of this tuple.
    boolean
    isZero()
    Returns whether this tuple represents zero.
    List<Long>
    list()
    Returns an unmodifiable list containing the components of this tuple in their proper order.
    default LongArray
    longArray()
    Returns a long array containing the components of this tuple in their proper order.
    LongTuple
    map(LongUnaryOperator f)
    Applies the provided mapper function f to each component of this tuple, then returns a new tuple containing the return values of the function f.
    <F> Tuple<F>
    mapToObj(LongFunction<? extends F> f)
    Applies the provided mapper function f to each component of this tuple, then returns a new tuple containing the return values of the function f.
    static LongTuple
    of(long... components)
    Creates a new long tuple from the provided array of components.
    int
    size()
    Returns the size of this tuple.
    LongStream
    stream()
    Returns a stream whose source is the elements of this tuple.
    String
    toString()
    Serializes this tuple into a string.

  • Method Details

    • of

      @Nonnull static LongTuple of(@Nonnull long... components)
      Creates a new long tuple from the provided array of components.
      Parameters:
      components - The components of which to construct the tuple from
      Returns:
      A tuple constructed from the provided components

    • empty

      @Nonnull static LongTuple empty()
      Returns an empty tuple.
      Returns:
      An empty tuple

    • size

      int size()
      Returns the size of this tuple. (the number of components it has)
      Specified by:
      size in interface BaseTuple<Long>
      Returns:
      The number of components this tuple has

    • isZero

      boolean isZero()
      Returns whether this tuple represents zero. (whether every component is zero)
      Returns:
      true if every component of this tuple is zero

    • contains

      boolean contains(long v)
      Checks if this tuple contains the provided value v.
      Parameters:
      v - The value of which to check for containment
      Returns:
      true if at least one component of this tuple is equal to the provided value v

    • containsAll

      boolean containsAll(@Nonnull Iterable<Long> i)
      Checks if this tuple contains multiple values.
      Parameters:
      i - The iterable object of which to check for containment
      Returns:
      true if this tuple contains every component of the iterable object

    • get

      long get(int i) throws IndexOutOfBoundsException
      Returns the ith component of this tuple.
      Parameters:
      i - The index of the component to get
      Returns:
      The ith component of this tuple
      Throws:
      IndexOutOfBoundsException - When the index i is out of bounds

    • map

      @Nonnull LongTuple map(@Nonnull LongUnaryOperator f)
      Applies the provided mapper function f to each component of this tuple, then returns a new tuple containing the return values of the function f.
      Parameters:
      f - The function of which to apply to each component of this tuple
      Returns:
      The resulting tuple

    • mapToObj

      @Nonnull <F> Tuple<F> mapToObj(@Nonnull LongFunction<? extends F> f)
      Applies the provided mapper function f to each component of this tuple, then returns a new tuple containing the return values of the function f.
      Type Parameters:
      F - The type of component to map this tuple to
      Parameters:
      f - The function of which to apply to each component of this tuple
      Returns:
      The resulting tuple

    • array

      @Nonnull long[] array()
      Returns an array containing the components of this tuple in their proper order.
      Returns:
      The array representation of this tuple

    • longArray

      @Nonnull default LongArray longArray()
      Returns a long array containing the components of this tuple in their proper order.
      Returns:
      The array representation of this tuple
      See Also:

    • stream

      @Nonnull LongStream stream()
      Returns a stream whose source is the elements of this tuple.
      Returns:
      A stream whose source is the elements of this tuple
      See Also:

    • list

      @Nonnull List<Long> list()
      Returns an unmodifiable list containing the components of this tuple in their proper order.
      Specified by:
      list in interface BaseTuple<Long>
      Returns:
      The list representation of this tuple
      See Also:

    • boxed

      @Nonnull Tuple<Long> boxed()
      Returns a tuple containing the components of this tuple in their boxed form.
      Returns:
      The boxed object representation of this tuple
      See Also:

    • equals

      boolean equals(@Nullable Object obj)
      Checks for equality between this tuple and the provided object obj.
      Overrides:
      equals in class Object
      Parameters:
      obj - The object to compare to
      Returns:
      true if the other object is also a long tuple, and the number of components, the order of the components, and the components' values are all equal

    • toString

      @Nonnull String toString()
      Serializes this tuple into a string.
      Overrides:
      toString in class Object
      Returns:
      The string representation of this tuple