Method slice

data_structures/unstable_2d_array.ts:168–188

* Slice the 2D array. Like slice on a normal array, this will create a new D2Array. * If no arguments are specified, it will slice the entire D2Array. * * @example Usage * ```ts * import { D2Array } from "@std/data-structures/unstable-2d-array"; * import { assertEquals } from "@std

(
    x: number = 0,
    y: number = 0,
    width?: number,
    height?: number,
  )

   * @returns A new {@linkcode D2Array} containing the sliced values.
   */
  slice(
    x: number = 0,
    y: number = 0,
    width?: number,
    height?: number,
  ): D2Array<T> {
    const actualHeight = Math.min(height ?? Infinity, this.raw.length - y);
    const actualWidth = Math.min(width ?? Infinity, this.raw[0]!.length - x);

    assert((actualWidth as number) > 0, "Width must be greater than 0");
    assert((actualHeight as number) > 0, "Height must be greater than 0");

    const out: T[][] = [];

    for (let i = y; i < y + actualHeight; i++) {
      const row = this.raw[i]!;
      out.push(row.slice(x, x + actualWidth));
    }

    return new D2Array(out, this.initialValue);
  }

  /**
   * Resize the 2D array.