Struct artichoke_backend::extn::core::float::Float

#[repr(transparent)]
pub struct Float(_);

Implementations

impl Float

pub const DIG: i64

The minimum number of significant decimal digits in a double-precision floating point.

Usually defaults to 15.

pub const EPSILON: f64

The difference between 1 and the smallest double-precision floating point number greater than 1.

Usually defaults to 2.2204460492503131e-16.

pub const INFINITY: f64

An expression representing positive infinity.

pub const MANT_DIG: i64

The minimum number of significant decimal digits in a double-precision floating point.

Usually defaults to 15.

pub const MAX: f64

The largest possible integer in a double-precision floating point number.

Usually defaults to 1.7976931348623157e+308.

pub const MAX_10_EXP: i64

The largest positive exponent in a double-precision floating point where 10 raised to this power minus 1.

Usually defaults to 308.

pub const MAX_EXP: i64

The largest possible exponent value in a double-precision floating point.

Usually defaults to 1024.

pub const MIN: f64

The smallest positive normalized number in a double-precision floating point.

Usually defaults to 2.2250738585072014e-308.

If the platform supports denormalized numbers, there are numbers between zero and Float::MIN. 0.0.next_float returns the smallest positive floating point number including denormalized numbers.

pub const MIN_10_EXP: i64

The smallest negative exponent in a double-precision floating point where 10 raised to this power minus 1.

Usually defaults to -307.

pub const MIN_EXP: i64

The smallest possible exponent value in a double-precision floating point.

Usually defaults to -1021.

pub const NAN: f64

An expression representing a value which is “not a number”.

pub const NEG_INFINITY: f64

pub const RADIX: i64

The base of the floating point, or number of unique digits used to represent the number.

Usually defaults to 2 on most systems, which would represent a base-10 decimal.

pub const ROUNDS: i64

Represents the rounding mode for floating point addition.

Usually defaults to 1, rounding to the nearest number.

Other modes include:

mode	value
Indeterminable	-1
Rounding towards zero	0
Rounding to the nearest number	1
Rounding towards positive infinity	2
Rounding towards negative infinity	3

Rust Caveats

Rust does not support setting the rounding mode and the behavior from LLVM is not documented. Because of this uncertainty, Artichoke sets its rounding mode to -1, Indeterminable.

The Rust docs say f64::round rounds “half-way cases away from 0.0.” Stack Overflow has a discussion around float rounding semantics in Rust and LLVM.

#[must_use]

pub const fn new() -> Self

Construct a new, zero, float.

#[must_use]

pub const fn with_f64(f: f64) -> Self

Construct a new Float with a given f64.

#[must_use]

pub const fn as_i64(self) -> i64

Convert self to an i64 with a saturating cast.

#[must_use]

pub const fn as_f64(self) -> f64

Return the inner f64.

#[must_use]

pub fn try_into_fixnum(self) -> Option<i64>

#[must_use]

pub fn modulo(self, other: Self) -> Self

Compute the remainder of self and other.

Equivalent to self.as_f64() % other.as_f64().

pub fn coerced_modulo(
    self,
    interp: &mut Artichoke,
    other: Value
) -> Result<Outcome, Error>

Trait Implementations

impl Clone for Float

fn clone(&self) -> Float

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConvertMut<Float, Value> for Artichoke

fn convert_mut(&mut self, from: Float) -> Value

Performs the infallible conversion.

impl Debug for Float

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Float

fn default() -> Float

Returns the “default value” for a type.

impl Display for Float

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Float> for Outcome

fn from(flt: Float) -> Self

Performs the conversion.

impl From<f64> for Float

fn from(flt: f64) -> Self

Performs the conversion.

impl PartialEq<Float> for Float

fn eq(&self, other: &Float) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Float) -> bool

This method tests for !=.

impl PartialOrd<Float> for Float

fn partial_cmp(&self, other: &Float) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl TryConvert<Value, Float> for Artichoke

type Error = Error

Error type for failed conversions.

fn try_convert(&self, value: Value) -> Result<Float, Self::Error>

Performs the fallible conversion.

impl Copy for Float

impl StructuralPartialEq for Float