UnsafeMutableLongArray.java

package javasabr.rlib.collections.array;

/**
 * An unsafe mutable view of a long array providing direct modification operations.
 * Use with caution as modifications may violate array invariants.
 *
 * @since 10.0.0
 */
public interface UnsafeMutableLongArray extends UnsafeLongArray, MutableLongArray {

  /**
   * Prepares internal storage for the expected size to avoid reallocations.
   *
   * @param expectedSize the expected number of elements
   * @return this for method chaining
   * @since 10.0.0
   */
  UnsafeMutableLongArray prepareForSize(int expectedSize);

  /**
   * Adds a value without triggering safety mechanisms.
   *
   * @param value the value to add
   * @return this for method chaining
   * @since 10.0.0
   */
  UnsafeMutableLongArray unsafeAdd(long value);

  /**
   * Removes the element at the specified index without bounds checking.
   *
   * @param index the index of the element to remove
   * @return the removed value
   * @since 10.0.0
   */
  long unsafeRemoveByIndex(int index);

  /**
   * Sets the value at the specified index without bounds checking.
   *
   * @param index the index of the value to set
   * @param value the new value
   * @return this for method chaining
   * @since 10.0.0
   */
  UnsafeMutableLongArray unsafeSet(int index, long value);

  /**
   * Trims the internal storage to match the current size.
   *
   * @return this for method chaining
   * @since 10.0.0
   */
  UnsafeMutableLongArray trimToSize();
}