CyrefJS
CCyrefJS
EN
بازگشت به مستندات
عدد/از نسخه 1.38.0

randomInt

یک عدد صحیح تصادفی بین حداقل و حداکثر مشخص‌شده، به‌صورت شامل هر دو انتها، برمی‌گرداند.

randomInt(min, max):number

پارامترها

minnumberالزامی

حداقل عدد صحیحی که می‌تواند برگردانده شود.

maxnumberالزامی

حداکثر عدد صحیحی که می‌تواند برگردانده شود.

مقدار بازگشتی

number

یک عدد صحیح تصادفی در بازه شامل min تا max را برمی‌گرداند.

خطاها

اگر min یا max عدد صحیح نباشد، یک RangeError ایجاد می‌کند.

اگر min بزرگ‌تر از max باشد، یک RangeError ایجاد می‌کند.

مثال‌ها

01

استفاده پایه

یک عدد صحیح تصادفی بین 1 و 10 تولید می‌کند و هر دو مقدار ابتدا و انتها را شامل می‌شود.

TypeScript
const result = randomInt(1, 10);

console.log(result);
// Random integer from 1 to 10
02

یک مقدار

وقتی min و max برابر باشند، تنها نتیجه ممکن همان مقدار است.

TypeScript
console.log(randomInt(5, 5));
// 5
03

بازه منفی

اعداد صحیح منفی نیز می‌توانند به‌عنوان محدوده استفاده شوند.

TypeScript
const result = randomInt(-10, -1);

console.log(result);
// Random integer from -10 to -1
04

بازه شامل صفر

بازه می‌تواند شامل اعداد صحیح منفی و مثبت باشد.

TypeScript
const result = randomInt(-5, 5);

console.log(result);
// Random integer from -5 to 5
05

بازه بزرگ

تابع می‌تواند از یک بازه بزرگ‌تر و شامل هر دو انتها عدد صحیح تولید کند.

TypeScript
const result = randomInt(100, 1000);

console.log(result);
// Random integer from 100 to 1000
06

محدوده غیرصحیح

هر دو مقدار min و max باید عدد صحیح باشند.

TypeScript
randomInt(1.5, 10);
// RangeError: randomInt: min and max must be integers
07

بازه نامعتبر

مقدار حداقل نمی‌تواند بزرگ‌تر از مقدار حداکثر باشد.

TypeScript
randomInt(10, 1);
// RangeError: randomInt: min must be less than or equal to max
08

شامل ابتدا و انتها

هر دو مقدار min و max می‌توانند نتیجه تابع باشند.

TypeScript
const result = randomInt(1, 3);

// Possible results:
// 1
// 2
// 3
ساخته شده با@cyref/js·مستندات رسمی