An AnyVal for finite Doubles.
Because FiniteDouble is an AnyVal it
will usually be as efficient as an Double, being
boxed only when a Double would have been boxed.
The FiniteDouble.apply factory method is
implemented in terms of a macro that checks literals for
validity at compile time. Calling
FiniteDouble.apply with a literal
Double value will either produce a valid
FiniteDouble instance at run time or an error at
compile time. Here's an example:
scala> import anyvals._
import anyvals._
scala> FiniteDouble(1.1)
res1: org.scalactic.anyvals.FiniteDouble = FiniteDouble(1.1)
scala> FiniteDouble(Finite.PositiveInfinity)
<console>:14: error: FiniteDouble.apply can only be invoked on a finite (i != Double.NegativeInfinity && i != Double.PositiveInfinity && !i.isNaN) floating point literal, like FiniteDouble(1.1).
FiniteDouble(Finite.PositiveInfinity)
^
FiniteDouble.apply cannot be used if the value
being passed is a variable (i.e., not a literal),
because the macro cannot determine the validity of variables
at compile time (just literals). If you try to pass a
variable to FiniteDouble.apply, you'll get a
compiler error that suggests you use a different factor
method, FiniteDouble.from, instead:
scala> val x = 1.1
x: Double = 1.1
scala> FiniteDouble(x)
<console>:15: error: FiniteDouble.apply can only be invoked on a floating point literal, like FiniteDouble(1.1). Please use FiniteDouble.from instead.
FiniteDouble(x)
^
The FiniteDouble.from factory method will inspect
the value at runtime and return an
Option[FiniteDouble]. If the value is valid,
FiniteDouble.from will return a
Some[FiniteDouble], else it will return a
None. Here's an example:
scala> FiniteDouble.from(x) res4: Option[org.scalactic.anyvals.FiniteDouble] = Some(FiniteDouble(1.1)) scala> val y = Finite.PositiveInfinity y: Double = Finite.PositiveInfinity scala> FiniteDouble.from(y) res5: Option[org.scalactic.anyvals.FiniteDouble] = None
The FiniteDouble.apply factory method is marked
implicit, so that you can pass literal Doubles
into methods that require FiniteDouble, and get the
same compile-time checking you get when calling
FiniteDouble.apply explicitly. Here's an example:
scala> def invert(pos: FiniteDouble): Double = Double.MaxValue - pos
invert: (pos: org.scalactic.anyvals.FiniteDouble)Double
scala> invert(1.1)
res6: Double = 1.7976931348623157E308
scala> invert(Double.MaxValue)
res8: Double = 0.0
scala> invert(Finite.PositiveInfinity)
<console>:15: error: FiniteDouble.apply can only be invoked on a finite (i != Double.NegativeInfinity && i != Double.PositiveInfinity && !i.isNaN) floating point literal, like FiniteDouble(1.1).
invert(Finite.PositiveInfinity)
^
This example also demonstrates that the
FiniteDouble companion object also defines implicit
widening conversions when a similar conversion is provided in
Scala. This makes it convenient to use a
FiniteDouble where a Double is
needed. An example is the subtraction in the body of the
invert method defined above,
Double.MaxValue - pos. Although
Double.MaxValue is a Double, which
has no - method that takes a
FiniteDouble (the type of pos), you
can still subtract pos, because the
FiniteDouble will be implicitly widened to
Double.
- Value parameters:
- value
The
Doublevalue underlying thisFiniteDouble.
- Companion:
- object
- Source:
- FiniteDouble.scala
Value members
Concrete methods
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the remainder of the division of this value by x.
Returns the remainder of the division of this value by x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Returns the product of this value and x.
Returns the product of this value and x.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble's value to a string then concatenates the given string.
Converts this FiniteDouble's value to a string then concatenates the given string.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the difference of this value and x.
Returns the difference of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns the quotient of this value and x.
Returns the quotient of this value and x.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than x, false otherwise.
Returns true if this value is less than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is less than or equal to x, false otherwise.
Returns true if this value is less than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than x, false otherwise.
Returns true if this value is greater than x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns true if this value is greater than or equal to x, false otherwise.
Returns true if this value is greater than or equal to x, false otherwise.
- Source:
- FiniteDouble.scala
Returns the smallest (closest to 0) FiniteDouble that is greater than or equal to this FiniteDouble
and represents a mathematical integer.
Returns the smallest (closest to 0) FiniteDouble that is greater than or equal to this FiniteDouble
and represents a mathematical integer.
- Source:
- FiniteDouble.scala
Applies the passed Double => Double function to the underlying Double
value, and if the result is positive, returns the result wrapped in a FiniteDouble,
else throws AssertionError.
Applies the passed Double => Double function to the underlying Double
value, and if the result is positive, returns the result wrapped in a FiniteDouble,
else throws AssertionError.
This method will inspect the result of applying the given function to this
FiniteDouble's underlying Double value and if the result
is greater than 0.0, it will return a FiniteDouble representing that value.
Otherwise, the Double value returned by the given function is
0.0 or negative, so this method will throw AssertionError.
This method differs from a vanilla assert or ensuring
call in that you get something you didn't already have if the assertion
succeeds: a type that promises an Double is positive.
With this method, you are asserting that you are convinced the result of
the computation represented by applying the given function to this FiniteDouble's
value will not produce zero, a negative number, including Double.NegativeInfinity, or Double.NaN.
Instead of producing such invalid values, this method will throw AssertionError.
- Value parameters:
- f
the
Double => Doublefunction to apply to thisFiniteDouble's underlyingDoublevalue.
- Returns:
the result of applying this
FiniteDouble's underlyingDoublevalue to to the passed function, wrapped in aFiniteDoubleif it is positive (else throwsAssertionError).- Throws:
- AssertionError
if the result of applying this
FiniteDouble's underlyingDoublevalue to to the passed function is not positive.
- Source:
- FiniteDouble.scala
Returns the greatest (closest to infinity) FiniteDouble that is less than or equal to
this FiniteDouble and represents a mathematical integer.
Returns the greatest (closest to infinity) FiniteDouble that is less than or equal to
this FiniteDouble and represents a mathematical integer.
- Source:
- FiniteDouble.scala
Indicates whether this FiniteDouble has a value that is a whole number: it is finite and it has no fraction part.
Indicates whether this FiniteDouble has a value that is a whole number: it is finite and it has no fraction part.
- Source:
- FiniteDouble.scala
Returns this if this > that or that otherwise.
Returns this if this > that or that otherwise.
- Source:
- FiniteDouble.scala
Returns this if this < that or that otherwise.
Returns this if this < that or that otherwise.
- Source:
- FiniteDouble.scala
Rounds this FiniteDouble value to the nearest whole number value that can be expressed as an Long, returning the result as a Long.
Rounds this FiniteDouble value to the nearest whole number value that can be expressed as an Long, returning the result as a Long.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to a Byte.
Converts this FiniteDouble to a Byte.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to a Char.
Converts this FiniteDouble to a Char.
- Source:
- FiniteDouble.scala
Converts an angle measured in radians to an approximately equivalent angle measured in degrees.
Converts an angle measured in radians to an approximately equivalent angle measured in degrees.
- Returns:
the measurement of the angle x in degrees.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to a Double.
Converts this FiniteDouble to a Double.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to a Float.
Converts this FiniteDouble to a Float.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to an Int.
Converts this FiniteDouble to an Int.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to a Long.
Converts this FiniteDouble to a Long.
- Source:
- FiniteDouble.scala
Converts an angle measured in degrees to an approximately equivalent angle measured in radians.
Converts an angle measured in degrees to an approximately equivalent angle measured in radians.
- Returns:
the measurement of the angle x in radians.
- Source:
- FiniteDouble.scala
Converts this FiniteDouble to a Short.
Converts this FiniteDouble to a Short.
- Source:
- FiniteDouble.scala
A string representation of this FiniteDouble.
A string representation of this FiniteDouble.
- Definition Classes
- Any
- Source:
- FiniteDouble.scala