$end`, it returns a descending range instead of * an empty one. * * If you don't need the items to be enumerated, consider Vec\fill. * * Examples: * * Vec\range(0, 5) * => Vec(0, 1, 2, 3, 4, 5) * * Vec\range(5, 0) * => Vec(5, 4, 3, 2, 1, 0) * * Vec\range(0.0, 3.0, 0.5) * => Vec(0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0) * * Vec\range(3.0, 0.0, -0.5) * => Vec(3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.0) * * @template T of int|float * * @param T $start * @param T $end * @param T|null $step * * @throws Exception\LogicException If $start < $end, and $step is negative. * * @return non-empty-list * * @psalm-suppress InvalidReturnType * @psalm-suppress InvalidReturnStatement * @psalm-suppress InvalidOperand * @psalm-suppress MixedOperand * * @see https://github.com/vimeo/psalm/issues/2152#issuecomment-533363310 */ function range(int|float $start, int|float $end, int|float|null $step = null): array { if (((float) $start) === ((float) $end)) { return [$start]; } if ($start < $end) { if (null === $step) { /** @var T $step */ $step = 1; } if ($step < 0) { throw new Exception\LogicException('If $end is greater than $start, then $step must be positive or null.'); } $result = []; for ($i = $start; $i <= $end; $i += $step) { $result[] = $i; } return $result; } if (null === $step) { /** @var T $step */ $step = -1; } if ($step > 0) { throw new Exception\LogicException('If $start is greater than $end, then $step must be negative or null.'); } $result = []; for ($i = $start; $i >= $end; $i += $step) { $result[] = $i; } return $result; }