ballerina/lang.float

function abs(float x) returns float

Returns the IEEE absolute value of a float value.

function acos(float x) returns float

Returns the arccosine of a float value.

Corresponds to IEEE acos operation.

function asin(float x) returns float

Returns the arcsine of a float value.

Corresponds to IEEE asin operation.

function atan(float x) returns float

Returns the arctangent of a float value.

Corresponds to IEEE atan operation.

function atan2(float y, float x) returns float

Performs the 2-argument arctangent operation.

Corresponds IEEE atan2(y, x) operation.

function cbrt(float x) returns float

Returns the cube root of a float value.

Corresponds to IEEE rootn(x, 3) operation.

function ceiling(float x) returns float

Rounds a float up to the closest integral value.

function cos(float x) returns float

Returns the cosine of a float value.

Corresponds to IEEE cos operation.

function cosh(float x) returns float

Returns the hyperbolic cosine of a float value.

Corresponds to IEEE cosh operation.

function exp(float x) returns float

Raises Euler's number to a power.

Corresponds to IEEE exp operation.

function floor(float x) returns float

Rounds a float down to the closest integral value.

function fromBitsInt(int x) returns float

Returns the float that is represented in IEEE 64-bit floating point by an int.

All bit patterns that IEEE defines to be NaNs will all be mapped to the single float NaN value.

function fromHexString(string s) returns float|error

Return the float value represented by a string.

parameter s must follow the syntax of HexFloatingPointLiteral as defined by the Ballerina specification with the following modifications

• the HexFloatingPointLiteral may have a leading + or - sign
• NaN is allowed
• Infinity is allowed with an optional leading + or - sign

function fromString(string s) returns float|error

Returns the float value represented by a string.

parameter s must follow the syntax of DecimalFloatingPointNumber as defined by the Ballerina specification with the following modifications

• the DecimalFloatingPointNumber may have a leading + or - sign
• NaN is allowed
• Infinity is allowed with an optional leading + or - sign
• a FloatingPointTypeSuffix is not allowed This is the inverse of function value:toString applied to an float.

function isFinite(float x) returns boolean

Tests whether a float is finite.

Exactly one of isFinite, isInfinite and IsNaN will be true for any float value

function isInfinite(float x) returns boolean

Tests whether a float is infinite.

Exactly one of isFinite, isInfinite and IsNaN will be true for any float value

function isNaN(float x) returns boolean

Tests whether a float is NaN.

Exactly one of isFinite, isInfinite and IsNaN will be true for any float value.

function log(float x) returns float

Returns the natural logarithm of a float value.

Corresponds to IEEE log operation.

function log10(float x) returns float

Returns the base 10 logarithm of a float value.

Corresponds to IEEE log10 operation.

function max(float... xs) returns float

Returns the maximum of zero or more float values.

Result is -∞ if no args NaN if any arg is NaN

function min(float... xs) returns float

Returns the minimum of zero or more float values.

Result is +∞ if no args Result is NaN if any arg is NaN

function pow(float x, float y) returns float

Raises one float value to the power of another float values.

Corresponds to IEEE pow(x, y) operation.

function round(float x, int fractionDigits) returns float

Rounds a float value to a specified number of digits.

Returns the float value that is an integral multiple of 10 raised to the power of -fractionDigits and closest to x. If there are two such values, choose the one whose final digit is even (this is the round-to-nearest rounding mode, which is the default for IEEE and for Ballerina). A value of fractionDigits greater than 0 thus corresponds to the number of digits after the decimal point being fractionDigits; a value of 0 for fractionDigits rounds to an integer. If x is NaN, +0, -0, +∞ or -∞, then the result is x. When fractionDigits is 0, this is the same as Java Math.rint method, .NET Math.Round method and IEEE roundToIntegralTiesToEven operation Note that <int>x is the same as <int>x.round(0).

function sin(float x) returns float

Returns the sine of a float value.

Corresponds to IEEE sin operation.

function sinh(float x) returns float

Returns the hyperbolic sine of a float value.

Corresponds to IEEE sinh operation.

function sqrt(float x) returns float

Returns the square root of a float value.

Corresponds to IEEE squareRoot operation.

function sum(float... xs) returns float

Returns the sum of zero or more float values.

Result is NaN if any arg is NaN

function tan(float x) returns float

Returns the tangent of a float value.

Corresponds to IEEE tan operation

function tanh(float x) returns float

Returns the hyperbolic tangent of a float value.

Corresponds to IEEE tanh operation.

function toBitsInt(float x) returns int

Returns IEEE 64-bit binary floating point format representation of a float value as an int.

function toExpString(float x, int? fractionDigits) returns string

Returns a string that represents x using scientific notation. The returned string will be in the same format used by value:toString, except that it will always include an exponent and there will be exactly one digit before the decimal point. But if x is NaN or infinite, the result will be the same as value:toString. The digit before the decimal point will be zero only if all other digits are zero. This will panic if fractionDigits is less than 0. If fractionDigits is zero, there will be no decimal point. Any necessary rounding will use the roundTiesToEven rounding direction. The exponent in the result uses lower-case e, followed by a + or - sign, followed by at least two digits, and only as many more digits as are needed to represent the result. If x is zero, the exponent is zero. A zero exponent is represented with a + sign.

function toFixedString(float x, int? fractionDigits) returns string

Returns a string that represents x using fixed-point notation. The returned string will be in the same format used by value:toString, except that it will not include an exponent. If x is NaN or infinite, the result will be the same as value:toString. This will panic if fractionDigits is less than 0. If fractionDigits is zero, there will be no decimal point. Any necessary rounding will use the roundTiesToEven rounding direction.

function toHexString(float x) returns string

Returns a string that represents a float value as a hexadecimal floating point number.

The returned string will comply to the grammar of HexFloatingPointLiteral in the Ballerina spec with the following modifications:

• it will have a leading - sign if negative
• positive infinity will be represented by Infinity
• negative infinity will be represented by -Infinity
• NaN will be represented by NaN The representation includes 0x for finite numbers.