24 lines
1.0 KiB
JavaScript
24 lines
1.0 KiB
JavaScript
|
//#region src/array/toFilled.ts
|
||
|
|
/**
|
||
|
|
* Creates a new array filled with the specified value from the start position up to, but not including, the end position.
|
||
|
|
* This function does not mutate the original array.
|
||
|
|
*
|
||
|
|
* @template T - The type of elements in the original array.
|
||
|
|
* @template U - The type of the value to fill the new array with.
|
||
|
|
* @param {Array<T>} arr - The array to base the new array on.
|
||
|
|
* @param {U} value - The value to fill the new array with.
|
||
|
|
* @param {number} [start=0] - The start position. Defaults to 0.
|
||
|
|
* @param {number} [end=arr.length] - The end position. Defaults to the array's length.
|
||
|
|
* @returns {Array<T | U>} The new array with the filled values.
|
||
|
|
*/
|
||
|
|
function toFilled(arr, value, start = 0, end = arr.length) {
|
||
|
|
const length = arr.length;
|
||
|
|
const finalStart = Math.max(start >= 0 ? start : length + start, 0);
|
||
|
|
const finalEnd = Math.min(end >= 0 ? end : length + end, length);
|
||
|
|
const newArr = arr.slice();
|
||
|
|
for (let i = finalStart; i < finalEnd; i++) newArr[i] = value;
|
||
|
|
return newArr;
|
||
|
|
}
|
||
|
|
//#endregion
|
||
|
|
export { toFilled };
|