mirror of https://github.com/toss/es-toolkit.git synced 2024-11-24 11:45:26 +03:00

feat(initial): add initial (#188 )

* add initial function

* add initial test case

* add initial bench mark

* add initial docs

2024-07-14 15:54:17 +09:00

1.0 KiB

Raw Blame History

initial

Returns a new array containing all elements except the last one from the input array.

For an empty array or an array with a length of 1, it returns an empty array ([]).

Signature

function initial<T>(arr: T[]): T[];

Parameters

arr (T[]): The array from which to return all elements except the last one.

Returns

(T[]): A new array containing all elements except the last one from the input array. For an empty array or an array with a length of 1, it returns an empty array ([]).

Examples

const arr1 = [1, 2, 3];
const result = initial(arr1);
// result is [1, 2].

const arr2: number[] = [];
const result = initial(arr2);
// result is [].

const arr3: number[] = [1];
const result = initial(arr3);
// result is [].

const largeArray = Array(1000)
  .fill(0)
  .map((_, i) => i);
const result = initial(largeArray);
// result is [0, 1, 2 ..., 998].

const nestedArray = [
  [3, 1],
  [3, 2],
  [3, 3],
];
const result = initial(nestedArray);
// result is [[3, 1], [3, 2]].

1.0 KiB Raw Blame History