API Number

Number

数值转换、常量与解析

Numeric conversion, constants, and parsing

脚本 API 目录

Script API Directory

概述

Overview

Number 将值转换为 AuroraScript number，并提供数值边界常量和检查函数。无法转换的输入得到 NaN；应使用 Number.isNaN 检查，而不是用 == 比较 NaN。

Number converts values to AuroraScript numbers and provides numeric-boundary constants and checks. Input that cannot be converted produces NaN; use Number.isNaN rather than == to test it.

Number([value])

Parameters:

• value
  可选待转换值。

  Optional value to convert.

Returns

数值，转换失败时为 NaN。

Number, or NaN when conversion fails.

return Number("42"); // 42

数值常量

Numeric constants

• Number.MAX_VALUE
  最大有限数。

  Largest finite value.
  return Number.MAX_VALUE > 0;

• Number.MIN_VALUE
  最小正数。

  Smallest positive value.
  return Number.MIN_VALUE > 0;

• Number.MAX_SAFE_INTEGER
  最大安全整数。

  Largest safe integer.
  return Number.MAX_SAFE_INTEGER;

• Number.MIN_SAFE_INTEGER
  最小安全整数。

  Smallest safe integer.
  return Number.MIN_SAFE_INTEGER;

• Number.NaN
  非数字常量。

  Not-a-number constant.
  return Number.isNaN(Number.NaN);

• Number.POSITIVE_INFINITY
  正无穷。

  Positive infinity.
  return Number.POSITIVE_INFINITY > 1;

• Number.NEGATIVE_INFINITY
  负无穷。

  Negative infinity.
  return Number.NEGATIVE_INFINITY < -1;

Number.isNaN(value)

Parameters:

• value
  要检查的数值。

  Number to inspect.

Returns

是否为 NaN。

Whether it is NaN.

return Number.isNaN(Number("not a number")); // true

Number.isInteger(value)

Parameters:

• value
  要检查的数值。

  Number to inspect.

Returns

是否为整数。

Whether it is an integer.

return Number.isInteger(42); // true

Number.isInfinity(value)

Parameters:

• value
  要检查的数值。

  Number to inspect.

Returns

是否为正无穷或负无穷。

Whether it is positive or negative infinity.

return Number.isInfinity(Number.POSITIVE_INFINITY); // true

Number.parseFloat(value)

Parameters:

• value
  字符串或数值。

  String or number.

Returns

解析出的浮点数；失败时为 NaN。

Parsed floating-point value, or NaN on failure.

return Number.parseFloat("3.14"); // 3.14

Number.parseInt(value)

Parameters:

• value
  字符串或数值。

  String or number.

Returns

解析出的整数；失败时为 NaN。

Parsed integer, or NaN on failure.

return Number.parseInt("42"); // 42

number.toString([radix])

Parameters:

• radix
  可选进制。

  Optional radix.

Returns

数字文本。

Text representation of the number.

return (42).toString(); // "42"