Number

GitHub   Edit on GitHub

Utilities for working with numbers.

Added in 0.4.0 No other changes yet.
1
from "number" include Number
1
1
1
-1
1
0.5
1
1/2
1
Infinity
1
NaN

Types

Type declarations included in the Number module.

Number.ParseIntError

Added in 0.6.0 No other changes yet.
1
2
3
4
5
enum ParseIntError {
ParseIntEmptyString,
ParseIntInvalidDigit,
ParseIntInvalidRadix,
}

Represents an error that occurred trying to parse an integer.

Variants:

1
ParseIntEmptyString

Represents an error caused by trying to parse an empty string.

1
ParseIntInvalidDigit

Represents an error caused by trying to parse a string with an invalid character.

1
ParseIntInvalidRadix

Represents an error caused by trying to parse with an invalid radix.


Values

Functions and constants included in the Number module.

Number.pi

Added in 0.5.2 No other changes yet.
1
pi : Number

Pi represented as a Number value.

Number.tau

Added in 0.5.2 No other changes yet.
1
tau : Number

Tau represented as a Number value.

Number.e

Added in 0.5.2 No other changes yet.
1
e : Number

Euler’s number represented as a Number value.

Number.(+)

Added in 0.6.0
versionchanges
0.4.0Originally named `add`
1
(+) : (num1: Number, num2: Number) => Number

Computes the sum of its operands.

Parameters:

param type description
num1 Number The first operand
num2 Number The second operand

Returns:

type description
Number The sum of the two operands

Examples:

1
2
from Number use { (+) }
assert 1 + 2 == 3

Number.(-)

Added in 0.6.0
versionchanges
0.4.0Originally named `sub`
1
(-) : (num1: Number, num2: Number) => Number

Computes the difference of its operands.

Parameters:

param type description
num1 Number The first operand
num2 Number The second operand

Returns:

type description
Number The difference of the two operands

Examples:

1
2
from Number use { (-) }
assert 5 - 2 == 3

Number.(*)

Added in 0.6.0
versionchanges
0.4.0Originally named `mul`
1
(*) : (num1: Number, num2: Number) => Number

Computes the product of its operands.

Parameters:

param type description
num1 Number The first operand
num2 Number The second operand

Returns:

type description
Number The product of the two operands

Examples:

1
2
from Number use { (*) }
assert 5 * 4 == 20

Number.(/)

Added in 0.6.0
versionchanges
0.4.0Originally named `div`
1
(/) : (num1: Number, num2: Number) => Number

Computes the quotient of its operands.

Parameters:

param type description
num1 Number The dividend
num2 Number The divisor

Returns:

type description
Number The quotient of the two operands

Examples:

1
2
from Number use { (/) }
assert 10 / 2.5 == 4

Number.(**)

Added in 0.6.0
versionchanges
0.5.4Originally named `pow`
1
(**) : (base: Number, power: Number) => Number

Computes the exponentiation of the given base and power.

Parameters:

param type description
base Number The base number
power Number The exponent number

Returns:

type description
Number The base raised to the given power

Examples:

1
2
from Number use { (**) }
assert 10 ** 2 == 100

Number.exp

Added in 0.5.4 No other changes yet.
1
exp : (power: Number) => Number

Computes the exponentiation of Euler’s number to the given power.

Parameters:

param type description
power Number The exponent number

Returns:

type description
Number The Number.e value raised to the given power

Examples:

1
Number.exp(1) == Number.e
1
Number.exp(10) == 22026.465794806703

Number.sqrt

Added in 0.4.0 No other changes yet.
1
sqrt : (x: Number) => Number

Computes the square root of its operand.

Parameters:

param type description
x Number The number to square root

Returns:

type description
Number The square root of the operand

Examples:

1
Number.sqrt(25) == 5

Number.sign

Added in 0.5.0 No other changes yet.
1
sign : (x: Number) => Number

Determine the positivity or negativity of a Number.

Parameters:

param type description
x Number The number to inspect

Returns:

type description
Number -1 if the number is negative, 1 if positive, or 0 otherwise; signedness of -0.0 is preserved

Examples:

1
Number.sign(-10000) == -1
1
Number.sign(222222) == 1
1
Number.sign(0) == 0

Number.min

Added in 0.4.0
versionchanges
0.5.4Handle NaN properly
1
min : (x: Number, y: Number) => Number

Returns the smaller of its operands.

Parameters:

param type description
x Number The first operand
y Number The second operand

Returns:

type description
Number The smaller of the two operands

Examples:

1
Number.min(5, 2) == 2

Number.max

Added in 0.4.0
versionchanges
0.5.4Handle NaN properly
1
max : (x: Number, y: Number) => Number

Returns the larger of its operands.

Parameters:

param type description
x Number The first operand
y Number The second operand

Returns:

type description
Number The larger of the two operands

Examples:

1
Number.max(5, 2) == 5

Number.ceil

Added in 0.4.0
versionchanges
0.5.4Handle NaN and Infinity properly
1
ceil : (x: Number) => Number

Rounds its operand up to the next largest integer.

Parameters:

param type description
x Number The number to round

Returns:

type description
Number The next largest integer of the operand

Examples:

1
Number.ceil(5.5) == 6
1
Number.ceil(-5.5) == -5

Number.floor

Added in 0.4.0
versionchanges
0.5.4Handle NaN and Infinity properly
1
floor : (x: Number) => Number

Rounds its operand down to the largest integer less than the operand.

Parameters:

param type description
x Number The number to round

Returns:

type description
Number The previous integer of the operand

Examples:

1
Number.floor(5.5) == 5
1
Number.floor(-5.5) == -6

Number.trunc

Added in 0.4.0
versionchanges
0.5.4Handle NaN and Infinity properly
1
trunc : (x: Number) => Number

Returns the integer part of its operand, removing any fractional value.

Parameters:

param type description
x Number The number to truncate

Returns:

type description
Number The integer part of the operand

Examples:

1
Number.trunc(5.5) == 5

Number.round

Added in 0.4.0
versionchanges
0.5.4Handle NaN and Infinity properly
1
round : (x: Number) => Number

Returns its operand rounded to its nearest integer.

Parameters:

param type description
x Number The number to round

Returns:

type description
Number The nearest integer to the operand

Examples:

1
Number.round(5.5) == 6
1
Number.round(5.4) == 5
1
Number.round(-5.5) == -6
1
Number.round(-5.4) == -5

Number.abs

Added in 0.4.0 No other changes yet.
1
abs : (x: Number) => Number

Returns the absolute value of a number. That is, it returns x if x is positive or zero and the negation of x if x is negative.

Parameters:

param type description
x Number The operand

Returns:

type description
Number The absolute value of the operand

Examples:

1
Number.abs(-1) == 1
1
Number.abs(5) == 5

Number.neg

Added in 0.4.0 No other changes yet.
1
neg : (x: Number) => Number

Returns the negation of its operand.

Parameters:

param type description
x Number The number to negate

Returns:

type description
Number The negated operand

Examples:

1
Number.neg(-1) == 1
1
Number.neg(1) == -1

Number.isFloat

Added in 0.5.3 No other changes yet.
1
isFloat : (x: Number) => Bool

Checks if a number is a floating point value.

Parameters:

param type description
x Number The number to check

Returns:

type description
Bool true if the value is a floating point number or false otherwise

Examples:

1
Number.isFloat(0.5)
1
Number.isFloat(1.0)
1
Number.isFloat(Infinity)
1
Number.isFloat(NaN)
1
Number.isFloat(1/2) == false
1
Number.isFloat(1) == false

Number.isInteger

Added in 0.5.3 No other changes yet.
1
isInteger : (x: Number) => Bool

Checks if a number is an integer.

Parameters:

param type description
x Number The number to check

Returns:

type description
Bool true if the value is an integer or false otherwise

Examples:

1
Number.isInteger(1)
1
Number.isInteger(0.5) == false
1
Number.isInteger(1.0) == false
1
Number.isInteger(1/2) == false
1
Number.isInteger(Infinity) == false
1
Number.isInteger(NaN) == false

Number.isRational

Added in 0.5.3 No other changes yet.
1
isRational : (x: Number) => Bool

Checks if a number is a non-integer rational value.

Parameters:

param type description
x Number The number to check

Returns:

type description
Bool true if the value is a non-integer rational number or false otherwise

Examples:

1
Number.isRational(1/2)
1
Number.isRational(0.5) == false
1
Number.isRational(1.0) == false
1
Number.isRational(1) == false
1
Number.isRational(Infinity) == false
1
Number.isRational(NaN) == false

Number.isFinite

Added in 0.4.0 No other changes yet.
1
isFinite : (x: Number) => Bool

Checks if a number is finite. All values are finite exept for floating point NaN, infinity or negative infinity.

Parameters:

param type description
x Number The number to check

Returns:

type description
Bool true if the value is finite or false otherwise

Examples:

1
Number.isFinite(1/2)
1
Number.isFinite(0.5)
1
Number.isFinite(1.0)
1
Number.isFinite(1)
1
Number.isFinite(Infinity) == false
1
Number.isFinite(-Infinity) == false
1
Number.isFinite(NaN) == false

Number.isNaN

Added in 0.4.0 No other changes yet.
1
isNaN : (x: Number) => Bool

Checks if a number is the float NaN value (Not A Number).

Parameters:

param type description
x Number The number to check

Returns:

type description
Bool true if the value is NaN, otherwise false

Examples:

1
Number.isNaN(NaN)
1
Number.isNaN(Infinity) == false
1
Number.isNaN(-Infinity) == false
1
Number.isNaN(1/2) == false
1
Number.isNaN(0.5) == false
1
Number.isNaN(1.0) == false
1
Number.isNaN(1) == false

Number.isInfinite

Added in 0.4.0 No other changes yet.
1
isInfinite : (x: Number) => Bool

Checks if a number is infinite, that is either of floating point positive or negative infinity. Note that this function is not the exact opposite of isFinite(Number) in that it doesn’t return true for NaN.

Parameters:

param type description
x Number The number to check

Returns:

type description
Bool true if the value is infinite or false otherwise

Examples:

1
Number.isInfinite(Infinity)
1
Number.isInfinite(-Infinity)
1
Number.isInfinite(NaN) == false
1
Number.isInfinite(1/2) == false
1
Number.isInfinite(0.5) == false
1
Number.isInfinite(1.0) == false
1
Number.isInfinite(1) == false

Number.isClose

Added in 0.6.0 No other changes yet.
1
2
3
isClose :
(a: Number, b: Number, ?relativeTolerance: Number,
?absoluteTolerance: Number) => Bool

Determines whether two values are considered close to each other using a relative and absolute tolerance.

Parameters:

param type description
a Number The first value
b Number The second value
?relativeTolerance Number The maximum tolerance to use relative to the larger absolute value a or b
?absoluteTolerance Number The absolute tolerance to use, regardless of the values of a or b

Returns:

type description
Bool true if the values are considered close to each other or false otherwise

Examples:

1
Number.isClose(1.233, 1.233)
1
Number.isClose(1.233, 1.233000001)
1
Number.isClose(8.005, 8.450, absoluteTolerance=0.5)
1
Number.isClose(4, 4.1, relativeTolerance=0.025)
1
Number.isClose(1.233, 1.24) == false
1
Number.isClose(1.233, 1.4566) == false
1
Number.isClose(8.005, 8.450, absoluteTolerance=0.4) == false
1
Number.isClose(4, 4.1, relativeTolerance=0.024) == false

Number.parseInt

Added in 0.4.5
versionchanges
0.6.0Switched from a string-based error message to a structured error enum
1
2
parseInt :
(string: String, radix: Number) => Result<Number, Atoi.ParseIntError>

Parses a string representation of an integer into a Number using the specified radix (also known as a number system “base”).

If the string has a radix prefix (i.e. “0x”/“0X”, “0o”/“0O”, or “0b”/“0B” for radixes 16, 8, or 2 respectively), the supplied radix is ignored in favor of the prefix. Underscores that appear in the numeric portion of the input are ignored.

Parameters:

param type description
string String The string to parse
radix Number The number system base to use when parsing the input string

Returns:

type description
Result<Number, Atoi.ParseIntError> Ok(value) containing the parsed number on a successful parse or Err(err) containing a variant of ParseIntError

Examples:

1
Number.parseInt("1", radix=10) == Ok(1)
1
Number.parseInt("-1", radix=10) == Ok(-1)
1
Number.parseInt("0xf0", radix=16) == Ok(0x0f0)

Number.parseFloat

Added in 0.5.5 No other changes yet.
1
parseFloat : (string: String) => Result<Number, String>

Parses a string representation of a float into a Number. Underscores that appear in numeric portions of the input are ignored.

Parameters:

param type description
string String The string to parse

Returns:

type description
Result<Number, String> Ok(value) containing the parsed number on a successful parse or Err(msg) containing an error message string otherwise

Examples:

1
Number.parseFloat("1") == Ok(1.0)
1
Number.parseFloat("-1") == Ok(-1.0)
1
Number.parseFloat("-1.5") == Ok(-1.5)

Number.parse

Added in 0.5.5 No other changes yet.
1
parse : (input: String) => Result<Number, Atoi.ParseIntError>

Parses a string representation of an integer, float, or rational into a Number. Underscores that appear in the numeric portion of the input are ignored.

Parameters:

param type description
input String The string to parse

Returns:

type description
Result<Number, Atoi.ParseIntError> Ok(value) containing the parsed number on a successful parse or Err(msg) containing an error message string otherwise

Examples:

1
Number.parse("1") == Ok(1)
1
Number.parse("-1") == Ok(-1)
1
Number.parse("0xf0") == Ok(0x0f0)
1
Number.parse("-1.5") == Ok(-1.5)

Number.asin

Added in 0.6.0 No other changes yet.
1
asin : (angle: Number) => Number

Computes the inverse sine of the given angle.

Parameters:

param type description
angle Number A number between -1 and 1, representing the angle’s sine value

Returns:

type description
Number The inverse sine (angle in radians between -pi/2 and pi/2) of the given angle or NaN if the given angle is not between-1 and 1

Examples:

1
Number.asin(0) == 0
1
Number.asin(1) == 1.5707963267948966

Number.acos

Added in 0.6.0 No other changes yet.
1
acos : (angle: Number) => Number

Computes the inverse cosine of the given angle.

Parameters:

param type description
angle Number A number between -1 and 1, representing the angle’s cosine value

Returns:

type description
Number The inverse cosine (angle in radians between -pi/2 and pi/2) of the given angle or NaN if the given angle is not between-1 and 1

Examples:

1
Number.acos(1) == 0
1
Number.acos(0) == 1.5707963267948966

Number.atan

Added in 0.6.0 No other changes yet.
1
atan : (angle: Number) => Number

Computes the inverse tangent of the given angle.

Parameters:

param type description
angle Number A number between -1 and 1, representing the angle’s tangent value

Returns:

type description
Number The inverse tangent (angle in radians between -pi/2 and pi/2) of the given angle or NaN if the given angle is not between-1 and 1

Examples:

1
Number.atan(0) == 0
1
Number.atan(1) == 0.7853981633974483

Number.atan2

Added in 0.6.0 No other changes yet.
1
atan2 : (y: Number, x: Number) => Number

Computes the angle between the positive x-axis and the ray from the origin to the point (x, y).

Parameters:

param type description
y Number The given y coordinate
x Number The given x coordinate

Returns:

type description
Number The angle in radians between the positive x-axis and the point (x, y)

Examples:

1
Number.atan2(0, 1) == Number.pi

Number.toRadians

Added in 0.5.4 No other changes yet.
1
toRadians : (degrees: Number) => Number

Converts degrees to radians.

Parameters:

param type description
degrees Number The value to convert

Returns:

type description
Number The value in radians

Examples:

1
Number.toRadians(180) == Number.pi

Number.toDegrees

Added in 0.5.4 No other changes yet.
1
toDegrees : (radians: Number) => Number

Converts radians to degrees.

Parameters:

param type description
radians Number The value to convert

Returns:

type description
Number The value in degrees

Examples:

1
Number.toRadians(Number.pi) == 180

Number.clamp

Added in 0.6.0 No other changes yet.
1
clamp : (range: Range<Number>, input: Number) => Number

Constrains a number within the given inclusive range.

Parameters:

param type description
range Range<Number> The inclusive range to clamp within
input Number The number to clamp

Returns:

type description
Number The constrained number

Number.linearInterpolate

Added in 0.6.0 No other changes yet.
1
linearInterpolate : (range: Range<Number>, weight: Number) => Number

Maps a weight between 0 and 1 within the given inclusive range.

Parameters:

param type description
range Range<Number> The inclusive range to interpolate within
weight Number The weight to interpolate

Returns:

type description
Number The blended value

Throws:

InvalidArgument(String)

  • When weight is not between 0 and 1
  • When range is not finite
  • When range includes NaN

Number.linearMap

Added in 0.6.0 No other changes yet.
1
2
3
linearMap :
(inputRange: Range<Number>, outputRange: Range<Number>, current: Number) =>
Number

Scales a number from one inclusive range to another inclusive range. If the number is outside the input range, it will be clamped.

Parameters:

param type description
inputRange Range<Number> The inclusive range you are mapping from
outputRange Range<Number> The inclusive range you are mapping to
current Number The number to map

Returns:

type description
Number The mapped number

Throws:

InvalidArgument(String)

  • When inputRange is not finite
  • When inputRange includes NaN
  • When outputRange is not finite
  • When outputRange includes NaN
This is a notification!