Functions

abs	I Returns the IEEE absolute value of a float value.
acos	I Returns the arccosine of a float value.
asin	I Returns the arcsine of a float value.
atan	I Returns the arctangent of a float value.
atan2	I Performs the 2-argument arctangent operation.
cbrt	I Returns the cube root of a float value.
ceiling	I Rounds a float up to the closest integral value.
cos	I Returns the cosine of a float value.
cosh	I Returns the hyperbolic cosine of a float value.
exp	I Raises Euler's number to a power.
floor	I Rounds a float down to the closest integral value.
fromBitsInt	I Returns the float that is represented in IEEE 64-bit floating point by an int.
fromHexString	I Return the float value represented by a string.
fromString	I Returns the float value represented by a string.
isFinite	I Tests whether a float is finite.
isInfinite	I Tests whether a float is infinite.
isNaN	I Tests whether a float is NaN.
log	I Returns the natural logarithm of a float value.
log10	I Returns the base 10 logarithm of a float value.
max	I Returns the maximum of zero or more float values.
min	I Returns the minimum of zero or more float values.
pow	I Raises one float value to the power of another float values.
round	I Rounds a float value to the closest integral value.
sin	I Returns the sine of a float value.
sinh	I Returns the hyperbolic sine of a float value.
sqrt	I Returns the square root of a float value.
sum	I Returns the sum of zero or more float values.
tan	I Returns the tangent of a float value.
tanh	I Returns the hyperbolic tangent of a float value.
toBitsInt	I Returns IEEE 64-bit binary floating point format representation of a float value as an int.
toHexString	I Returns a string that represents a float value as a hexadecimal floating point number.

abs

function abs(float x) returns float

Isolated Function

Returns the IEEE absolute value of a float value.

Parameters

x float

float value to operate on

Return Type

(float)

absolute value of parameter x

acos

function acos(float x) returns float

Isolated Function

Returns the arccosine of a float value.

Corresponds to IEEE acos operation.

Parameters

x float

float value to operate on

Return Type

(float)

the arccosine of parameter x in radians

asin

function asin(float x) returns float

Isolated Function

Returns the arcsine of a float value.

Corresponds to IEEE asin operation.

Parameters

x float

float value to operate on

Return Type

(float)

the arcsine of parameter x in radians

atan

function atan(float x) returns float

Isolated Function

Returns the arctangent of a float value.

Corresponds to IEEE atan operation.

Parameters

x float

float value to operate on

Return Type

(float)

the arctangent of parameter x in radians

atan2

function atan2(float y, float x) returns float

Isolated Function

Performs the 2-argument arctangent operation.

Corresponds IEEE atan2(y, x) operation.

Parameters

y float

the y-coordinate

x float

the x-coordinate

Return Type

(float)

the angle in radians from the positive x-axis to the point whose Cartesian coordinates are (x, y)

cbrt

function cbrt(float x) returns float

Isolated Function

Returns the cube root of a float value.

Corresponds to IEEE rootn(x, 3) operation.

Parameters

x float

float value to operate on

Return Type

(float)

cube root of parameter x

ceiling

function ceiling(float x) returns float

Isolated Function

Rounds a float up to the closest integral value.

Parameters

x float

float value to operate on

Return Type

(float)

smallest (closest to -∞) decimal value not less than parameter x that is a mathematical integer

cos

function cos(float x) returns float

Isolated Function

Returns the cosine of a float value.

Corresponds to IEEE cos operation.

Parameters

x float

float value, specifying an angle in radians

Return Type

(float)

the cosine of parameter x

cosh

function cosh(float x) returns float

Isolated Function

Returns the hyperbolic cosine of a float value.

Corresponds to IEEE cosh operation.

Parameters

x float

float value to operate on

Return Type

(float)

hyperbolic cosine of parameter x

exp

function exp(float x) returns float

Isolated Function

Raises Euler's number to a power.

Corresponds to IEEE exp operation.

Parameters

x float

float value to operate on

Return Type

(float)

Euler's number raised to the power parameter x

floor

function floor(float x) returns float

Isolated Function

Rounds a float down to the closest integral value.

Parameters

x float

float value to operate on

Return Type

(float)

largest (closest to +∞) float value not greater than parameter x that is a mathematical integer

fromBitsInt

function fromBitsInt(int x) returns float

Isolated Function

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.

Parameters

x int

int value

Return Type

(float)

parameter x bit pattern as a float

fromHexString

function fromHexString(string s) returns float | error

Isolated Function

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

Parameters

s string

hexadecimal floating point hex string representation

Return Type

(float | error)

float value or error

fromString

function fromString(string s) returns float | error

Isolated Function

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.

Parameters

s string

string representation of a float

Return Type

(float | error)

float value or error

isFinite

function isFinite(float x) returns boolean

Isolated Function

Tests whether a float is finite.

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

Parameters

x float

the float to be tested

Return Type

(boolean)

true if parameter x is finite, i.e., neither NaN nor +∞ nor -∞

isInfinite

function isInfinite(float x) returns boolean

Isolated Function

Tests whether a float is infinite.

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

Parameters

x float

the float to be tested

Return Type

(boolean)

true if parameter x is either +∞ or -∞

isNaN

function isNaN(float x) returns boolean

Isolated Function

Tests whether a float is NaN.

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

Parameters

x float

the float to be tested

Return Type

(boolean)

true if parameter x is NaN

log

function log(float x) returns float

Isolated Function

Returns the natural logarithm of a float value.

Corresponds to IEEE log operation.

Parameters

x float

float value to operate on

Return Type

(float)

natural logarithm of parameter x

log10

function log10(float x) returns float

Isolated Function

Returns the base 10 logarithm of a float value.

Corresponds to IEEE log10 operation.

Parameters

x float

float value to operate on

Return Type

(float)

base 10 logarithm of parameter x

max

function max(float... xs) returns float

Isolated Function

Returns the maximum of zero or more float values.

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

Parameters

xs float...

float values to operate on

Return Type

(float)

maximum value of all of parameter xs

min

function min(float... xs) returns float

Isolated Function

Returns the minimum of zero or more float values.

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

Parameters

xs float...

float values to operate on

Return Type

(float)

minimum value of all of parameter xs

pow

function pow(float x, float y) returns float

Isolated Function

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

Corresponds to IEEE pow(x, y) operation.

Parameters

x float

base value

y float

the exponent

Return Type

(float)

x raised to the power of parameter y

round

function round(float x) returns float

Isolated Function

Rounds a float value to the closest integral value.

Returns the float value that is a mathematical integer and closest to parameter x. If there are two such values, choose the one that is even (this is the round-to-nearest rounding mode, which is the default for IEEE and for Ballerina). Same as Java Math.rint method Same as .NET Math.Round method IEEE roundToIntegralTiesToEven operation Note that <int>x is the same as <int>x.round()

Parameters

x float

float value to operate on

Return Type

(float)

closest float value to parameter x that is a mathematical integer

sin

function sin(float x) returns float

Isolated Function

Returns the sine of a float value.

Corresponds to IEEE sin operation.

Parameters

x float

float value, specifying an angle in radians

Return Type

(float)

the sine of parameter x

sinh

function sinh(float x) returns float

Isolated Function

Returns the hyperbolic sine of a float value.

Corresponds to IEEE sinh operation.

Parameters

x float

float value to operate on

Return Type

(float)

hyperbolic sine of parameter x

sqrt

function sqrt(float x) returns float

Isolated Function

Returns the square root of a float value.

Corresponds to IEEE squareRoot operation.

Parameters

x float

float value to operate on

Return Type

(float)

square root of parameter x

sum

function sum(float... xs) returns float

Isolated Function

Returns the sum of zero or more float values.

Result is NaN if any arg is NaN

Parameters

xs float...

float values to sum

Return Type

(float)

sum of all of parameter xs, +0.0 if parameter xs is empty

tan

function tan(float x) returns float

Isolated Function

Returns the tangent of a float value.

Corresponds to IEEE tan operation

Parameters

x float

float value, specifying an angle in radians

Return Type

(float)

the tangent of parameter x

tanh

function tanh(float x) returns float

Isolated Function

Returns the hyperbolic tangent of a float value.

Corresponds to IEEE tanh operation.

Parameters

x float

float value to operate on

Return Type

(float)

hyperbolic tangent of parameter x

toBitsInt

function toBitsInt(float x) returns int

Isolated Function

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

Parameters

x float

float value

Return Type

(int)

parameter x bit pattern as an int

toHexString

function toHexString(float x) returns string

Isolated Function

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.

Parameters

x float

float value

Return Type

(string)

hexadecimal floating point hex string representation