Scala 3/API/scala.math/Ordering/Double/IeeeOrdering

IeeeOrdering

trait IeeeOrdering extends Ordering[Double]

An ordering for Doubles which is consistent with IEEE specifications whenever possible.

An ordering for Doubles which is consistent with IEEE specifications whenever possible.

  • lt, lteq, equiv, gteq and gt are consistent with primitive comparison operations for Doubles, and return false when called with NaN.

  • min and max are consistent with math.min and math.max, and return NaN when called with NaN as either argument.

  • compare behaves the same as java.lang.Double.compare.

Because the behavior of Doubles specified by IEEE is not consistent with a total ordering when dealing with NaN, there are two orderings defined for Double: TotalOrdering, which is consistent with a total ordering, and IeeeOrdering, which is consistent as much as possible with IEEE spec and floating point operations defined in scala.math.

This ordering may be preferable for numeric contexts.

See also
Companion
object
trait Equiv[Double]
class Object
trait Matchable
class Any

Type members

Inherited classlikes

class OrderingOps(lhs: T)

This inner class defines comparison operators available for T.

This inner class defines comparison operators available for T.

It can't extend AnyVal because it is not a top-level class or a member of a statically accessible object.

Inherited from
Ordering

Value members

Concrete methods

def compare(x: Double, y: Double): Int
override def equiv(x: Double, y: Double): Boolean
Definition Classes
override def gt(x: Double, y: Double): Boolean
Definition Classes
override def gteq(x: Double, y: Double): Boolean
Definition Classes
override def lt(x: Double, y: Double): Boolean
Definition Classes
override def lteq(x: Double, y: Double): Boolean
Definition Classes
override def max[U <: Double](x: U, y: U): U
Definition Classes
override def min[U <: Double](x: U, y: U): U
Definition Classes

Inherited methods

def isReverseOf(other: Ordering[_]): Boolean

Returns whether or not the other ordering is the opposite ordering of this one.

Returns whether or not the other ordering is the opposite ordering of this one.

Equivalent to other == this.reverse.

Implementations should only override this method if they are overriding reverse as well.

Inherited from
Ordering
def on[U](f: U => Double): Ordering[U]

Given f, a function from U into T, creates an Ordering[U] whose compare function is equivalent to:

Given f, a function from U into T, creates an Ordering[U] whose compare function is equivalent to:

def compare(x:U, y:U) = Ordering[T].compare(f(x), f(y))
Inherited from
Ordering
def orElse(other: Ordering[Double]): Ordering[Double]

Creates an Ordering[T] whose compare function returns the result of this Ordering's compare function, if it is non-zero, or else the result of others compare function.

Creates an Ordering[T] whose compare function returns the result of this Ordering's compare function, if it is non-zero, or else the result of others compare function.

Value Params
other

an Ordering to use if this Ordering returns zero

Example

case class Pair(a: Int, b: Int)
val pairOrdering = Ordering.by[Pair, Int](_.a)
                          .orElse(Ordering.by[Pair, Int](_.b))
Inherited from
Ordering
def orElseBy[S](f: Double => S)(ord: Ordering[S]): Ordering[Double]

Given f, a function from T into S, creates an Ordering[T] whose compare function returns the result of this Ordering's compare function, if it is non-zero, or else a result equivalent to:

Given f, a function from T into S, creates an Ordering[T] whose compare function returns the result of this Ordering's compare function, if it is non-zero, or else a result equivalent to:

Ordering[S].compare(f(x), f(y))

This function is equivalent to passing the result of Ordering.by(f) to orElse.

Example

case class Pair(a: Int, b: Int)
val pairOrdering = Ordering.by[Pair, Int](_.a)
                          .orElseBy[Int](_.b)
Inherited from
Ordering
override def reverse: Ordering[Double]

Return the opposite ordering of this one.

Return the opposite ordering of this one.

Implementations overriding this method MUST override isReverseOf as well if they change the behavior at all (for example, caching does not require overriding it).

Definition Classes
Inherited from
Ordering
def reversed(): Comparator[Double]
Inherited from
Comparator
def thenComparing[U <: Comparable[_ >: U <: `<FromJavaObject>`]](`x$0`: Function[_ >: T <: `<FromJavaObject>`, _ <: U]): Comparator[Double]
Inherited from
Comparator
def thenComparing[U <: `<FromJavaObject>`](`x$0`: Function[_ >: T <: `<FromJavaObject>`, _ <: U], `x$1`: Comparator[_ >: U <: `<FromJavaObject>`]): Comparator[Double]
Inherited from
Comparator
def thenComparing(`x$0`: Comparator[_ >: T <: `<FromJavaObject>`]): Comparator[Double]
Inherited from
Comparator
def thenComparingDouble(`x$0`: ToDoubleFunction[_ >: T <: `<FromJavaObject>`]): Comparator[Double]
Inherited from
Comparator
def thenComparingInt(`x$0`: ToIntFunction[_ >: T <: `<FromJavaObject>`]): Comparator[Double]
Inherited from
Comparator
def thenComparingLong(`x$0`: ToLongFunction[_ >: T <: `<FromJavaObject>`]): Comparator[Double]
Inherited from
Comparator
def tryCompare(x: Double, y: Double): Option[Int]

Returns whether a comparison between x and y is defined, and if so the result of compare(x, y).

Returns whether a comparison between x and y is defined, and if so the result of compare(x, y).

Inherited from
Ordering

Implicits

Inherited implicits

implicit def mkOrderingOps(lhs: Double): OrderingOps

This implicit method augments T with the comparison operators defined in scala.math.Ordering.Ops.

This implicit method augments T with the comparison operators defined in scala.math.Ordering.Ops.

Inherited from
Ordering