# bigfix/developer.bigfix.com

Fetching contributors…
Cannot retrieve contributors at this time
210 lines (117 sloc) 7.21 KB

# type: floating point

The `floating point` type holds a floating-point number, with precision dependent on the computer. It also keeps track of the IEEE floating-point exceptions raised in a calculation and an estimate of the significance with which the number should be expressed when it is converted to a string.

All arithmetic operations are carried out to the full precision of the computer; only conversions to string are affected by the estimated significance.

# divided by zero of <floating point> : boolean

Returns `True` if the calculation raised the divide-by-zero exception; that is, if some part of the calculation produced an exact infinity.

# extrema of <floating point> : ( floating point, floating point )

Returns the minimum and maximum extreme values of the list of numbers.

{% qna %} Q: extrema of floating points ("3.1415926"; "-1.06"; "2.7") A: -1.06, 3.1415926 {% endqna %}

# finite of <floating point> : boolean

Returns `True` if the floating point number is finite.

{% qna %} Q: (it, finite of it) of (floating point "1" / 2) A: 0.5, True {% endqna %}

{% qna %} Q: (it, finite of it) of (floating point "1" / 0) A: +infinity, False {% endqna %}

# floating point <floating point> : floating point

Creates a floating point type object from the specified floating point number.

{% qna %} Q: floating point "3.14159265358" A: 3.14159265358 {% endqna %}

# inexact of <floating point> : boolean

Returns `True` if the calculation raised the inexact exception; that is, if some intermediate result could not be represented exactly.

# infinite of <floating point> : boolean

Returns `True` if the floating point number is infinite.Example: infinite of (floating point "1"/ 0) - Returns `True`.

# integer ceiling of <floating point> : integer

Returns the smallest integer not less than the floating point number.

{% qna %} Q: integer ceiling of floating point "3.14159265358" A: 4 {% endqna %}

{% qna %} Q: integer ceiling of floating point "-3.14159265358" A: -3 {% endqna %}

# integer floor of <floating point> : integer

Returns the largest integer less than or equal to the floating point number.

{% qna %} Q: integer floor of floating point "3.14159265358" A: 3 {% endqna %}

{% qna %} Q: integer floor of floating point "-3.14159265358" A: -4 {% endqna %}

# invalid of <floating point> : boolean

Returns `True` if the calculation raised the invalid exception; that is, if some part of the calculation a function was applied to a value outside its domain.

# less significance <integer> of <floating point> : floating point

Removes <integer> number of digits of significance from the floating point value.

# maximum of <floating point> : floating point

Returns the maximum value from a list of <floating point> types.

# mean of <floating point> : floating point

The mean of the floating point number(s).

# minimum of <floating point> : floating point

Returns the minimum value from a list of <floating point> types.

# more significance <integer> of <floating point> : floating point

Adds <integer> number of digits of significance to the floating point value.

# nan of <floating point> : boolean

Returns `True` if the value is not a number.Example: nan of (floating point "1.e-99999" * floating point "1.e999999") - Returns `True`.

# normal of <floating point> : boolean

Returns `True` if the value is a valid floating point number.

# overflow of <floating point> : boolean

Returns `True` if the calculation raised the overflow exception; that is, if some intermediate result was too large to be represented, but not an exact infinity.Example: overflow of (floating point "1.0e50000") - Returns `True`, since the number is too big to represent in floating point.

# product of <floating point> : floating point

Multiplies a list of floating point numbers, returning a floating point product.

# relative significance place <integer> of <floating point> : floating point

The same floating point value, to be expressed to the given number of significant digits.

# relative significance place of <floating point> : floating point

The base 10 logarithm of the quotient of the value and its significance place; approximately the number of significant digits to which the number should be expressed.

# significance place <integer> of <floating point> : floating point

The same floating point value, to be expressed to the given decimal place.

# significance place of <floating point> : floating point

The base 10 logarithm of the significance threshold; approximately the number of digits to the left (positive) or right (negative) of the ones place to which the number should be expressed.

# significance threshold of <floating point> : floating point

The difference between the given value and the next number expressed to the same significance level. For example, the significance threshold of 3 is 1, the significance threshold of 3.0 is 0.1, and the significance threshold of 3000 is 1000.

# sqrt of <floating point> : floating point

No documentation exists.

# standard deviation of <floating point> : floating point

The standard deviation of the floating point number(s).

# sum of <floating point> : floating point

Returns the sum of a list of floating point numbers.

# underflow of <floating point> : boolean

Returns `True` if the calculation raised the underflow exception; that is, if some intermediate result was a nonzero value too small to be represented.

# unique value of <floating point> : floating point with multiplicity

Returns the unique values of a given list of <floating point> types, removing duplicates and sorting by value.

# <floating point> as floating point : floating point

This casting operator is added for completeness. It takes a floating point number and casts it as a floating point number. It facilitates automatic relevance generation where the software is not aware of the input types.

# <floating point> as integer : integer

Rounds off and casts a floating point number as an integer.Example: 15/2 as integer - Returns 7.

# <floating point> as scientific notation : string

Converts a floating point number into a string with scientific notation.

# <floating point> as standard notation : string

Converts a floating point number into a string with standard notation.

# <floating point> as string : string

Converts a floating point number into a string with standard notation.

# <floating point> < <floating point> : boolean

No documentation exists.

# <floating point> <= <floating point> : boolean

No documentation exists.

# <floating point> * <floating point> : floating point

No documentation exists.

# <floating point> + <floating point> : floating point

No documentation exists.

# <floating point> - <floating point> : floating point

No documentation exists.

# <floating point> / <floating point> : floating point

No documentation exists.

# <floating point> = <floating point> : boolean

No documentation exists.

# - <floating point> : floating point

Change the sign of a floating point number.

You can’t perform that action at this time.