random

지정된 범위 내의 난수를 생성하는 함수입니다.

Signatures

function random(max: number): number;
function random(min: number, max: number): number;

Parameters

이름	타입	설명	필수 여부
min	`number`	최소값 (두 번째 인자로 사용 시 최대값)	✓
max	`number`	최대값	-

Returns

number - min(포함)과 max(미포함) 사이의 난수

Errors

다음과 같은 경우에 에러가 발생합니다:

최소값이 최대값보다 큰 경우
최소값과 최대값이 같은 경우

사용 예시

import { random } from '@teamsparta/utils';
 
// 단일 인자 사용 (0부터 시작)
random(10); // 0 이상 10 미만의 난수
random(1); // 0 이상 1 미만의 난수
 
// 범위 지정
random(1, 5); // 1 이상 5 미만의 난수
random(0, 1); // 0 이상 1 미만의 난수
 
// 음수 범위
random(-10, -5); // -10 이상 -5 미만의 난수
 
// 음수와 양수가 혼합된 범위
random(-5, 5); // -5 이상 5 미만의 난수
 
// 소수점 범위
random(0.1, 0.9); // 0.1 이상 0.9 미만의 난수
 
// 에러 발생 케이스
random(5, 0); // Error: Invalid input: The maximum value must be greater than the minimum value.
random(5, 5); // Error: Invalid input: The maximum value must be greater than the minimum value.

clamp randomInt