Number

Methods

(static) clamp(number, loweropt, upper) → {number}

Description:

• 数字限制在 lower 和 upper 之间的值。

  特殊说明：

  • 如果只传入 1 个参数，直接返回该参数；
  • 如果只传入 2 个参数，lower 透传给 upper。

Source:

• clamp.js, line 32

Since:

• 1.0.0

Example

clamp(-10, -5, 5); // -5

clamp(-10, 0, 5); // 0

clamp(10, -5, 5); // 5

// 仅限制上限
clamp(10, 5); // 5

clamp(-10, 5); // -10

Parameters:

Returns:

Type

number

(static) inRange(number, start, endopt) → {number}

Description:

• 检查数字是否在 start 与 end 之间，但不包括 end。

  如果 start 大于 end 会自动交换范围参数。

Source:

• inRange.js, line 34

Since:

• 1.0.0

Example

inRange(3, 2, 4); // true

inRange(1, 0, 2); // true

inRange(1.2, 0.5, 1.5); // true

inRange(2.2, 0.5, 1.5); // false

inRange(-2, -2, 4); // true

inRange(4, -2, 4); // false

// 某个范围为 0 可省略最后一个参数
inRange(1， 2); // true

inRange(1， -2); // false

Parameters:

Returns:

Type

number

(static) random(loweropt, upperopt) → {number}

Description:

• 产生一个包含 lower 与 upper 之间的随机浮点数。

  如果 lower 大于 upper 会自动交换参数。

Source:

• random.js, line 28

Since:

• 1.0.0

Example

// 0 到 1 之间的浮点数
random(); // 0.40340470210512236

// 2 到 4 之间的浮点数
random(2, 4); // 3.0039717466399787

// 2 到 4 之间的浮点数
random(4, 2); // 2.388398370184757

// 1.2 到 2.4 之间的浮点数
random(1.2, 2.4); // 1.6319041677720918

Parameters:

Returns:

Type

number

(static) randomInt(loweropt, upperopt) → {number}

Description:

• 产生一个包含 lower 与 upper 之间的随机整数。

  如果参数非整数 lower=Math.ceil(lower) upper=Math.floor(upper)。如果 lower 大于 upper 会自动交换参数。

Source:

• randomInt.js, line 28

Since:

• 1.0.0

Example

// 0 到 1 之间的整数
randomInt(); // 1

// 2 到 4 之间的整数
randomInt(2, 4); // 4

// 2 到 4 之间的整数
randomInt(4, 2); // 3

// 区间只有一个整数
randomInt(1.2, 2.4); // 2

Parameters:

Returns:

Type

number