# Float32

## Definitions

`def abs(x: Float32): Float32`

SourceReturns the absolute value of `x`

.

`def ceil(x: Float32): Float32`

SourceReturns `x`

rounded up to a Float32 representing the nearest larger integer value.

`def clampToInt16(x: Float32, minimum: Int16, maximum: Int16, nanValue: Int16): Int16`

SourceConvert `x`

to an `Int16`

.

Returns `x`

clamped within the Int16 range `minimum`

to `maximum`

.

Warning: it is recommended to test `x`

for NaN (not-a-number) before calling this
function. Relying on `nanValue`

to convert NaN to a permissable Int16 risks masking it.

`def clampToInt32(x: Float32, minimum: Int32, maximum: Int32, nanValue: Int32): Int32`

SourceConvert `x`

to an `Int32`

.

Returns `x`

clamped within the Int32 range `minimum`

to `maximum`

.

Warning: it is recommended to test `x`

for NaN (not-a-number) before calling this
function. Relying on `nanValue`

to convert NaN to a permissable Int32 risks masking it.

`def clampToInt64(x: Float32, minimum: Int64, maximum: Int64, nanValue: Int64): Int64`

SourceConvert `x`

to an `Int64`

.

Returns `x`

clamped within the Int64 range `minimum`

to `maximum`

.

Warning: it is recommended to test `x`

for NaN (not-a-number) before calling this
function. Relying on `nanValue`

to convert NaN to a permissable Int64 risks masking it.

`def clampToInt8(x: Float32, minimum: Int8, maximum: Int8, nanValue: Int8): Int8`

SourceConvert `x`

to an `Int8`

.

Returns `x`

clamped within the Int8 range `minimum`

to `maximum`

.

Warning: it is recommended to test `x`

for NaN (not-a-number) before calling this
function. Relying on `nanValue`

to convert NaN to a permissable Int8 risks masking it.

`def floatValue(d: java.lang.Float): Float32`

SourceGet the primitive Float32 value from its object representation (i.e. ##java.lang.Float).

This function is expected to be used when marshaling Float32s from Java. Generally in Flix
code you should not need to use `##java.lang.Float`

.

`def floor(x: Float32): Float32`

SourceReturns `x`

rounded down to a Float32 representing the nearest smaller integer value.

`def fromString(s: String): Option[Float32]`

SourceParse the string `s`

as a Float32, leading or trailing whitespace is trimmed.
A successful parse is wrapped with `Some(x)`

, a parse failure is indicated by `None`

.

`def isFinite(x: Float32): Bool`

SourceReturns true if and only if `x`

is a non-infinite and non-Nan `Float32`

value.

`def isInfinite(x: Float32): Bool`

SourceReturns true if and only if `x`

is an infinite and non-Nan `Float32`

value.

`def isNan(x: Float32): Bool`

SourceReturns true if and only if `x`

is the NaN value of type `Float32`

.

`def max(x: Float32, y: Float32): Float32`

SourceReturns the larger of `x`

and `y`

.

`def maxExponent(_unit: Unit): Int32`

SourceReturns the maximum exponent that a `Float32`

may have.

`def maxValue(_unit: Unit): Float32`

SourceReturns the maximum number representable by a `Float32`

.

`def min(x: Float32, y: Float32): Float32`

SourceReturns the smaller of `x`

and `y`

.

`def minExponent(_unit: Unit): Int32`

SourceReturns the minimum exponent that a `Float32`

may have.

`def minPositiveValue(_unit: Unit): Float32`

SourceReturns the minimum positive number representable by a `Float32`

.

`def minValue(_unit: Unit): Float32`

SourceReturns the minimum number representable by a `Float32`

.

`def nan(_unit: Unit): Float32`

SourceReturns the NaN (not a number) value of type `Float32`

.

`def negativeInfinity(_unit: Unit): Float32`

SourceReturns the negative infinity value of type `Float32`

.

`def positiveInfinity(_unit: Unit): Float32`

SourceReturns the positive infinity value of type `Float32`

.

`def pow(b: Float32, n: Float32): Float32`

SourceReturns `b`

raised to the power of `n`

.

`def round(x: Float32): Float32`

SourceReturns `x`

rounded to a Float32 representing the nearest integer value.

The rounding may be upwards or downwards. If the rounding up and rounding down are equally
close, `x`

will be rounded to an even value (i.e. `round(0.5f32) == 0.0f32`

).

`def size(_unit: Unit): Int32`

SourceReturns the number of bits used to represent a `Float32`

.

`def toFloat64(x: Float32): Float64`

SourceConvert `x`

to an Float64.

`def toString(x: Float32): String`

SourceReturn a string representation of `x`

.

`def tryToBigDecimal(x: Float32): Option[BigDecimal]`

SourceConvert `x`

to an `Option[BigDecimal]`

.

Returns `Some(x as BigDecimal)`

if the numeric value of `x`

is representable
as a BigDecimal value.

If `x`

is NaN or infinity return `None`

.

`def tryToBigInt(x: Float32): Option[BigInt]`

SourceConvert `x`

to an `Option[BigInt]`

.

Returns `Some(x as BigInt)`

if the numeric value of `x`

is representable as a BigInt.

Returns `None`

if the value of `x`

is NaN or infinity.

`def tryToInt16(x: Float32): Option[Int16]`

SourceConvert `x`

to an `Option[Int16]`

.

Returns `Some(x as Int16)`

if the numeric value of `x`

is within the range of Int16,
rounding `x`

towards 0`.

Returns `None`

if the numeric value of `x`

is outside the range of Int16
(i.e. -32768 to 32767), or it is NaN or infinity.

`def tryToInt32(x: Float32): Option[Int32]`

SourceConvert `x`

to an `Option[Int32]`

.

Returns `Some(x as Int32)`

if the numeric value of `x`

is within the range of Int32,
rounding `x`

towards 0`.

Returns `None`

if the numeric value of `x`

is outside the range of Int32
(i.e. -2147483648 to 2147483647), or it is NaN or infinity.

Note: while the range of an Int32 is precisely defined using Int32 values, converting this range to Float32 values is imprecise.

`def tryToInt64(x: Float32): Option[Int64]`

SourceConvert `x`

to an `Option[Int64]`

.

Returns `Some(x as Int64)`

if the numeric value of `x`

is within the range of Int64,
rounding `x`

towards 0`.

Returns `None`

if the numeric value of `x`

is outside the range of Int64
(i.e. -9223372036854775808 to 9223372036854775807), or it is NaN or infinity.

Note: while the range of an Int64 is precisely defined using Int64 values, converting this range to Float32 values is imprecise.

`def tryToInt8(x: Float32): Option[Int8]`

SourceConvert `x`

to an `Option[Int8]`

.

Returns `Some(x as Int8)`

if the numeric value of `x`

is within the range of Int8,
rounding `x`

towards 0`.

Returns `None`

if the numeric value of `x`

is outside the range of Int8
(i.e. -128 to 127), or it is NaN or infinity.

`def valueOf(d: Float32): java.lang.Float`

SourceConvert an Float32 value to its object representation (i.e. ##java.lang.Float).

This function is expected to be used when marshaling Float32s to Java. Generally in Flix
code you should not need to use `##java.lang.Float`

.