Documentation
    Preparing search index...

    Function repeat

    • Executes a function a specified number of times and collects the results into an array.

      A synchronous repetition function that executes the given function for each index (from 0 to count-1) and collects the results into an array.

      Processing cost: The callback runs once for each of N indices, with O(N) output storage.

      Type Parameters

      • T

        The type of the result from each execution

      Parameters

      • count: number

        The number of times to repeat (integer from 0 to 2^32 - 1)

      • closure: (index: number) => T

        The function to execute repeatedly

      Returns T[]

      An array of results

      // Generate an array of squares from 1 to 5
      const squares = ArrayUtil.repeat(5, (index) => (index + 1) ** 2);
      console.log(squares); // [1, 4, 9, 16, 25]

      // Generate an array of default user objects
      const users = ArrayUtil.repeat(3, (index) => ({
      id: index + 1,
      name: `User${index + 1}`,
      email: `user${index + 1}@example.com`,
      }));
      console.log(users);
      // [
      // { id: 1, name: 'User1', email: 'user1@example.com' },
      // { id: 2, name: 'User2', email: 'user2@example.com' },
      // { id: 3, name: 'User3', email: 'user3@example.com' }
      // ]

      contracts/common.md#principled-implementation An invalid count is refused with a RangeError, and otherwise the closure is called for each index from 0 to count minus one and the results are collected in order, with cost linear in the count.

      contracts/common.md#clear-and-simple-design The synchronous counterpart of asyncRepeat, sharing its validator.

      contracts/common.md#prohibited-implementation-shortcuts The loop implements the documented behavior directly.

      contracts/common.md#meaningful-documentation The comment states the index range and the result, with examples.