Function toFilled

Alias

  • toFilled<T, U>(arr, value): (T | U)[]

  • 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.

    Type Parameters

    • T

      The type of elements in the original array.

    • U

      The type of the value to fill the new array with.

    Parameters

    • arr: readonly T[]

      The array to base the new array on.

    • value: U

      The value to fill the new array with.

    Returns (T | U)[]

    The new array with the filled values.

    Example

    const array = [1, 2, 3, 4, 5];
    let result = toFilled(array, '*', 2);
    console.log(result); // [1, 2, '*', '*', '*']
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*', 1, 4);
    console.log(result); // [1, '*', '*', '*', 5]
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*');
    console.log(result); // ['*', '*', '*', '*', '*']
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*', -4, -1);
    console.log(result); // [1, '*', '*', '*', 5]
    console.log(array); // [1, 2, 3, 4, 5]
  • toFilled<T, U>(arr, value, start?): (T | U)[]

  • 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.

    Type Parameters

    • T

      The type of elements in the original array.

    • U

      The type of the value to fill the new array with.

    Parameters

    • arr: readonly T[]

      The array to base the new array on.

    • value: U

      The value to fill the new array with.

    • Optionalstart: number

      The start position. Defaults to 0.

    Returns (T | U)[]

    The new array with the filled values.

    Example

    const array = [1, 2, 3, 4, 5];
    let result = toFilled(array, '*', 2);
    console.log(result); // [1, 2, '*', '*', '*']
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*', 1, 4);
    console.log(result); // [1, '*', '*', '*', 5]
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*');
    console.log(result); // ['*', '*', '*', '*', '*']
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*', -4, -1);
    console.log(result); // [1, '*', '*', '*', 5]
    console.log(array); // [1, 2, 3, 4, 5]
  • toFilled<T, U>(arr, value, start?, end?): (T | U)[]

  • 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.

    Type Parameters

    • T

      The type of elements in the original array.

    • U

      The type of the value to fill the new array with.

    Parameters

    • arr: readonly T[]

      The array to base the new array on.

    • value: U

      The value to fill the new array with.

    • Optionalstart: number

      The start position. Defaults to 0.

    • Optionalend: number

      The end position. Defaults to the array's length.

    Returns (T | U)[]

    The new array with the filled values.

    Example

    const array = [1, 2, 3, 4, 5];
    let result = toFilled(array, '*', 2);
    console.log(result); // [1, 2, '*', '*', '*']
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*', 1, 4);
    console.log(result); // [1, '*', '*', '*', 5]
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*');
    console.log(result); // ['*', '*', '*', '*', '*']
    console.log(array); // [1, 2, 3, 4, 5]

    result = toFilled(array, '*', -4, -1);
    console.log(result); // [1, '*', '*', '*', 5]
    console.log(array); // [1, 2, 3, 4, 5]

Settings

Member Visibility