This class defines mathematical functions and constants.
See also:
Static variables
staticread onlyNEGATIVE_INFINITY:Float = cs.system.Double.NegativeInfinity
Available on cs, cpp, flash, php, macro, hl, neko, java, python
A special Float
constant which denotes negative infinity.
For example, this is the result of -1.0 / 0.0.
Operations with NEGATIVE_INFINITY
as an operand may result in
NEGATIVE_INFINITY
, POSITIVE_INFINITY
or NaN
.
If this constant is converted to an Int
, e.g. through Std.int()
, the
result is unspecified.
staticread onlyNaN:Float = cs.system.Double.NaN
Available on cs, cpp, flash, php, macro, hl, neko, java, python
A special Float
constant which denotes an invalid number.
NaN stands for "Not a Number". It occurs when a mathematically incorrect operation is executed, such as taking the square root of a negative number: Math.sqrt(-1).
All further operations with NaN
as an operand will result in NaN
.
If this constant is converted to an Int
, e.g. through Std.int()
, the
result is unspecified.
In order to test if a value is NaN
, you should use Math.isNaN()
function.
staticread onlyPI:Float = cs.system.Math.PI
Available on cs, cpp, flash, php, js, macro, hl, neko, java, python
Represents the ratio of the circumference of a circle to its diameter,
specified by the constant, π. PI
is approximately 3.141592653589793.
staticread onlyPOSITIVE_INFINITY:Float = cs.system.Double.PositiveInfinity
Available on cs, cpp, flash, php, macro, hl, neko, java, python
A special Float
constant which denotes positive infinity.
For example, this is the result of 1.0 / 0.0.
Operations with POSITIVE_INFINITY
as an operand may result in
NEGATIVE_INFINITY
, POSITIVE_INFINITY
or NaN
.
If this constant is converted to an Int
, e.g. through Std.int()
, the
result is unspecified.
Static methods
staticabs(v:Float):Float
Returns the absolute value of v
.
If v
is positive or 0, the result is unchanged. Otherwise the result
is -v
.
If v
is NEGATIVE_INFINITY
or POSITIVE_INFINITY
, the result is
POSITIVE_INFINITY
.
If v
is NaN
, the result is NaN
.
staticacos(v:Float):Float
Returns the trigonometric arc cosine of the specified angle v
,
in radians.
If v
is NaN
or infinite, the result is NaN
.
staticasin(v:Float):Float
Returns the trigonometric arc of the specified angle v
, in radians.
If v
is NaN
or infinite, the result is NaN
.
staticatan(v:Float):Float
Returns the trigonometric arc tangent of the specified angle v
,
in radians.
If v
is NaN
or infinite, the result is NaN
.
staticatan2(y:Float, x:Float):Float
Returns the trigonometric arc tangent whose tangent is the quotient of two specified numbers, in radians.
If parameter x
or y
is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
,
the result is NaN
.
staticceil(v:Float):Int
Returns the smallest integer value that is not less than v
.
If v
is outside of the signed Int32
range, or is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
, the result is unspecified.
staticcos(v:Float):Float
Returns the trigonometric cosine of the specified angle v
, in radians.
If v
is NaN
or infinite, the result is NaN
.
staticexp(v:Float):Float
Returns Euler's number, raised to the power of v
.
exp(1.0) is approximately 2.718281828459.
If v
is POSITIVE_INFINITY
, the result is POSITIVE_INFINITY
.
If v
is NEGATIVE_INFINITY
, the result is 0.0
.
If v
is NaN
, the result is NaN
.
staticfceil(v:Float):Float
Returns the smallest integer value that is not less than v
, as a Float
.
If v
is is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
,
the result is unspecified.
staticffloor(v:Float):Float
Returns the largest integer value that is not greater than v
, as a Float
.
If v
is is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
,
the result is unspecified.
staticfloor(v:Float):Int
Returns the largest integer value that is not greater than v
.
If v
is outside of the signed Int32
range, or is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
, the result is unspecified.
staticfround(v:Float):Float
Rounds v
to the nearest integer value, as a Float.
Ties are rounded up, so that 0.5
becomes 1
and -0.5
becomes 0
.
If v
is is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
,
the result is unspecified.
staticlog(v:Float):Float
Returns the natural logarithm of v
.
This is the mathematical inverse operation of exp,
i.e. log(exp(v)) == v
always holds.
If v
is negative (including NEGATIVE_INFINITY
) or NaN
, the result
is NaN
.
If v
is POSITIVE_INFINITY
, the result is POSITIVE_INFINITY
.
If v
is 0.0
, the result is NEGATIVE_INFINITY
.
staticmax(a:Float, b:Float):Float
Returns the greater of values a
and b
.
If a
or b
are NaN
, the result is NaN
.
If a
or b
are POSITIVE_INFINITY
, the result is POSITIVE_INFINITY
.
If a
and b
are NEGATIVE_INFINITY
, the result is NEGATIVE_INFINITY
.
staticmin(a:Float, b:Float):Float
Returns the smaller of values a
and b
.
If a
or b
are NaN
, the result is NaN
.
If a
or b
are NEGATIVE_INFINITY
, the result is NEGATIVE_INFINITY
.
If a
and b
are POSITIVE_INFINITY
, the result is POSITIVE_INFINITY
.
staticrandom():Float
Returns a pseudo-random number which is greater than or equal to 0.0, and less than 1.0.
staticround(v:Float):Int
Rounds v
to the nearest integer value.
Ties are rounded up, so that 0.5
becomes 1
and -0.5
becomes 0
.
If v
is outside of the signed Int32
range, or is NaN
, NEGATIVE_INFINITY
or POSITIVE_INFINITY
, the result is unspecified.
staticsin(v:Float):Float
Returns the trigonometric sine of the specified angle v
, in radians.
If v
is NaN
or infinite, the result is NaN
.