org.scalactic.anyvals.PosFloat.scala Maven / Gradle / Ivy
/*
* Copyright 2001-2016 Artima, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.scalactic.anyvals
import scala.collection.immutable.NumericRange
import scala.language.implicitConversions
import scala.util.{Try, Success, Failure}
import org.scalactic.{Validation, Pass, Fail}
import org.scalactic.{Or, Good, Bad}
/**
* An AnyVal
for positive Float
s.
*
*
* Note: a PosFloat
may not equal 0.0. If you want positive number or 0, use [[PosZFloat]].
*
*
*
* Because PosFloat
is an AnyVal
it
* will usually be as efficient as an Float
, being
* boxed only when an Float
would have been boxed.
*
*
*
* The PosFloat.apply
factory method is implemented
* in terms of a macro that checks literals for validity at
* compile time. Calling PosFloat.apply
with a
* literal Float
value will either produce a valid
* PosFloat
instance at run time or an error at
* compile time. Here's an example:
*
*
*
* scala> import anyvals._
* import anyvals._
*
* scala> PosFloat(42.1fF)
* res0: org.scalactic.anyvals.PosFloat = PosFloat(42.1f)
*
* scala> PosFloat(0.0fF)
* <console>:14: error: PosFloat.apply can only be invoked on a positive (i > 0.0f) floating point literal, like PosFloat(42.1fF).
* PosFloat(42.1fF)
* ^
*
*
*
* PosFloat.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 PosFloat.apply
, you'll get a compiler error
* that suggests you use a different factor method,
* PosFloat.from
, instead:
*
*
*
* scala> val x = 42.1fF
* x: Float = 42.1f
*
* scala> PosFloat(x)
* <console>:15: error: PosFloat.apply can only be invoked on a floating point literal, like PosFloat(42.1fF). Please use PosFloat.from instead.
* PosFloat(x)
* ^
*
*
*
* The PosFloat.from
factory method will inspect
* the value at runtime and return an
* Option[PosFloat]
. If the value is valid,
* PosFloat.from
will return a
* Some[PosFloat]
, else it will return a
* None
. Here's an example:
*
*
*
* scala> PosFloat.from(x)
* res3: Option[org.scalactic.anyvals.PosFloat] = Some(PosFloat(42.1f))
*
* scala> val y = 0.0fF
* y: Float = 0.0f
*
* scala> PosFloat.from(y)
* res4: Option[org.scalactic.anyvals.PosFloat] = None
*
*
*
* The PosFloat.apply
factory method is marked
* implicit, so that you can pass literal Float
s
* into methods that require PosFloat
, and get the
* same compile-time checking you get when calling
* PosFloat.apply
explicitly. Here's an example:
*
*
*
* scala> def invert(pos: PosFloat): Float = Float.MaxValue - pos
* invert: (pos: org.scalactic.anyvals.PosFloat)Float
*
* scala> invert(42.1fF)
* res5: Float = 3.4028235E38
*
* scala> invert(Float.MaxValue)
* res6: Float = 0.0
*
* scala> invert(0.0fF)
* <console>:15: error: PosFloat.apply can only be invoked on a positive (i > 0.0f) floating point literal, like PosFloat(42.1fF).
* invert(0.0F)
* ^
*
* scala> invert(0.0fF)
* <console>:15: error: PosFloat.apply can only be invoked on a positive (i > 0.0f) floating point literal, like PosFloat(42.1fF).
* invert(0.0fF)
* ^
*
*
*
*
* This example also demonstrates that the PosFloat
* companion object also defines implicit widening conversions
* when no loss of precision will occur. This makes it convenient to use a
* PosFloat
where a Float
or wider
* type is needed. An example is the subtraction in the body of
* the invert
method defined above,
* Float.MaxValue - pos
. Although
* Float.MaxValue
is a Float
, which
* has no -
method that takes a
* PosFloat
(the type of pos
), you can
* still subtract pos
, because the
* PosFloat
will be implicitly widened to
* Float
.
*
*
* @param value The Float
value underlying this PosFloat
.
*/
final class PosFloat private (val value: Float) extends AnyVal {
/**
* A string representation of this PosFloat
.
*/
override def toString: String = s"PosFloat(${value.toString()}f)"
/**
* Converts this PosFloat
to a Byte
.
*/
def toByte: Byte = value.toByte
/**
* Converts this PosFloat
to a Short
.
*/
def toShort: Short = value.toShort
/**
* Converts this PosFloat
to a Char
.
*/
def toChar: Char = value.toChar
/**
* Converts this PosFloat
to an Int
.
*/
def toInt: Int = value.toInt
/**
* Converts this PosFloat
to a Long
.
*/
def toLong: Long = value.toLong
/**
* Converts this PosFloat
to a Float
.
*/
def toFloat: Float = value.toFloat
/**
* Converts this PosFloat
to a Double
.
*/
def toDouble: Double = value.toDouble
/** Returns this value, unmodified. */
def unary_+ : PosFloat = this
/** Returns the negation of this value. */
def unary_- : NegFloat = NegFloat.ensuringValid(-value)
/**
* Converts this PosFloat
's value to a string then concatenates the given string.
*/
def +(x: String): String = s"${value.toString()}${x.toString()}"
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Byte): Boolean = value < x
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Short): Boolean = value < x
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Char): Boolean = value < x
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Int): Boolean = value < x
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Long): Boolean = value < x
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Float): Boolean = value < x
/** Returns `true` if this value is less than x, `false` otherwise. */
def <(x: Double): Boolean = value < x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Byte): Boolean = value <= x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Short): Boolean = value <= x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Char): Boolean = value <= x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Int): Boolean = value <= x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Long): Boolean = value <= x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Float): Boolean = value <= x
/** Returns `true` if this value is less than or equal to x, `false` otherwise. */
def <=(x: Double): Boolean = value <= x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Byte): Boolean = value > x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Short): Boolean = value > x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Char): Boolean = value > x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Int): Boolean = value > x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Long): Boolean = value > x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Float): Boolean = value > x
/** Returns `true` if this value is greater than x, `false` otherwise. */
def >(x: Double): Boolean = value > x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Byte): Boolean = value >= x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Short): Boolean = value >= x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Char): Boolean = value >= x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Int): Boolean = value >= x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Long): Boolean = value >= x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Float): Boolean = value >= x
/** Returns `true` if this value is greater than or equal to x, `false` otherwise. */
def >=(x: Double): Boolean = value >= x
/** Returns the sum of this value and `x`. */
def +(x: Byte): Float = value + x
/** Returns the sum of this value and `x`. */
def +(x: Short): Float = value + x
/** Returns the sum of this value and `x`. */
def +(x: Char): Float = value + x
/** Returns the sum of this value and `x`. */
def +(x: Int): Float = value + x
/** Returns the sum of this value and `x`. */
def +(x: Long): Float = value + x
/** Returns the sum of this value and `x`. */
def +(x: Float): Float = value + x
/** Returns the sum of this value and `x`. */
def +(x: Double): Double = value + x
/** Returns the difference of this value and `x`. */
def -(x: Byte): Float = value - x
/** Returns the difference of this value and `x`. */
def -(x: Short): Float = value - x
/** Returns the difference of this value and `x`. */
def -(x: Char): Float = value - x
/** Returns the difference of this value and `x`. */
def -(x: Int): Float = value - x
/** Returns the difference of this value and `x`. */
def -(x: Long): Float = value - x
/** Returns the difference of this value and `x`. */
def -(x: Float): Float = value - x
/** Returns the difference of this value and `x`. */
def -(x: Double): Double = value - x
/** Returns the product of this value and `x`. */
def *(x: Byte): Float = value * x
/** Returns the product of this value and `x`. */
def *(x: Short): Float = value * x
/** Returns the product of this value and `x`. */
def *(x: Char): Float = value * x
/** Returns the product of this value and `x`. */
def *(x: Int): Float = value * x
/** Returns the product of this value and `x`. */
def *(x: Long): Float = value * x
/** Returns the product of this value and `x`. */
def *(x: Float): Float = value * x
/** Returns the product of this value and `x`. */
def *(x: Double): Double = value * x
/** Returns the quotient of this value and `x`. */
def /(x: Byte): Float = value / x
/** Returns the quotient of this value and `x`. */
def /(x: Short): Float = value / x
/** Returns the quotient of this value and `x`. */
def /(x: Char): Float = value / x
/** Returns the quotient of this value and `x`. */
def /(x: Int): Float = value / x
/** Returns the quotient of this value and `x`. */
def /(x: Long): Float = value / x
/** Returns the quotient of this value and `x`. */
def /(x: Float): Float = value / x
/** Returns the quotient of this value and `x`. */
def /(x: Double): Double = value / x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Byte): Float = value % x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Short): Float = value % x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Char): Float = value % x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Int): Float = value % x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Long): Float = value % x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Float): Float = value % x
/** Returns the remainder of the division of this value by `x`. */
def %(x: Double): Double = value % x
// Stuff from RichFloat
/**
* Returns this
if this > that
or that
otherwise.
*/
def max(that: PosFloat): PosFloat = if (math.max(value, that.value) == value) this else that
/**
* Returns this
if this < that
or that
otherwise.
*/
def min(that: PosFloat): PosFloat = if (math.min(value, that.value) == value) this else that
/**
* Indicates whether this `PosFloat` has a value that is a whole number: it is finite and it has no fraction part.
*/
def isWhole = {
val longValue = value.toLong
longValue.toFloat == value || longValue == Long.MaxValue && value < Float.PositiveInfinity || longValue == Long.MinValue && value > Float.NegativeInfinity
}
/** Converts an angle measured in degrees to an approximately equivalent
* angle measured in radians.
*
* @return the measurement of the angle x in radians.
*/
def toRadians: Float = math.toRadians(value.toDouble).toFloat
/** Converts an angle measured in radians to an approximately equivalent
* angle measured in degrees.
* @return the measurement of the angle x in degrees.
*/
def toDegrees: Float = math.toDegrees(value.toDouble).toFloat
/**
* Applies the passed Float => Float
function to the underlying Float
* value, and if the result is positive, returns the result wrapped in a PosFloat
,
* else throws AssertionError
.
*
*
* This method will inspect the result of applying the given function to this
* PosFloat
's underlying Float
value and if the result
* is positive, it will return a PosFloat
representing that value.
* Otherwise, the Float
value returned by the given function is
* not positive, 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 Float
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 PosFloat
's
* value will not produce invalid value.
* Instead of producing such invalid values, this method will throw AssertionError
.
*
*
* @param f the Float => Float
function to apply to this PosFloat
's
* underlying Float
value.
* @return the result of applying this PosFloat
's underlying Float
value to
* to the passed function, wrapped in a PosFloat
if it is positive (else throws AssertionError
).
* @throws AssertionError if the result of applying this PosFloat
's underlying Float
value to
* to the passed function is not positive.
*/
def ensuringValid(f: Float => Float): PosFloat = {
val candidateResult: Float = f(value)
if (PosFloatMacro.isValid(candidateResult)) new PosFloat(candidateResult)
else throw new AssertionError(s"${candidateResult.toString()}, the result of applying the passed function to ${value.toString()}, was not a valid PosFloat")
}
/**
* Rounds this `PosFloat` value to the nearest whole number value that can be expressed as an `PosZInt`, returning the result as a `PosZInt`.
*/
def round: PosZInt = PosZInt.ensuringValid(math.round(value))
/**
* Returns the smallest (closest to 0) `PosFloat` that is greater than or equal to this `PosFloat`
* and represents a mathematical integer.
*/
def ceil: PosFloat = PosFloat.ensuringValid(math.ceil(value).toFloat)
/**
* Returns the greatest (closest to infinity) `PosZFloat` that is less than or equal to
* this `PosZFloat` and represents a mathematical integer.
*/
def floor: PosZFloat = PosZFloat.ensuringValid(math.floor(value).toFloat)
/**
* Returns the PosFloat
sum of this PosFloat
's value and the given PosZFloat
value.
*
*
* This method will always succeed (not throw an exception) because
* adding a positive Float and non-negative Float and another
* positive Float will always result in another positive Float
* value (though the result may be infinity).
*
*/
def plus(x: PosZFloat): PosFloat = PosFloat.ensuringValid(value + x.value)
/**
* True if this PosFloat
value represents positive infinity, else false.
*/
def isPosInfinity: Boolean = Float.PositiveInfinity == value
/**
* True if this PosFloat
value is any finite value (i.e., it is neither positive nor negative infinity), else false.
*/
def isFinite: Boolean = !value.isInfinite
}
/**
* The companion object for PosFloat
that offers
* factory methods that produce PosFloat
s,
* implicit widening conversions from PosFloat
to
* other numeric types, and maximum and minimum constant values
* for PosFloat
.
*/
object PosFloat {
/**
* The largest value representable as a positive Float
,
* which is PosFloat(3.4028235E38)
.
*/
final val MaxValue: PosFloat = PosFloat.ensuringValid(Float.MaxValue)
/**
* The smallest value representable as a positive
* Float
, which is PosFloat(1.4E-45)
.
*/
final val MinValue: PosFloat = PosFloat.ensuringValid(Float.MinPositiveValue) // Can't use the macro here
/**
* A factory method that produces an Option[PosFloat]
given a
* Float
value.
*
*
* This method will inspect the passed Float
value and if
* it is a positive Float
, it will return a PosFloat
* representing that value wrapped in a Some
. Otherwise, the passed Float
* value is not positive, so this method will return None
.
*
*
*
* This factory method differs from the apply
* factory method in that apply
is implemented
* via a macro that inspects Float
literals at
* compile time, whereas from
inspects
* Float
values at run time.
*
*
* @param value the Float
to inspect, and if positive, return
* wrapped in a Some[PosFloat]
.
* @return the specified Float
value wrapped in a
* Some[PosFloat]
, if it is positive, else
* None
.
*/
def from(value: Float): Option[PosFloat] =
if (PosFloatMacro.isValid(value)) Some(new PosFloat(value)) else None
/**
* A factory/assertion method that produces a PosFloat
given a
* valid Float
value, or throws AssertionError
,
* if given an invalid Float
value.
*
* Note: you should use this method only when you are convinced that it will
* always succeed, i.e., never throw an exception. It is good practice to
* add a comment near the invocation of this method indicating ''why'' you think
* it will always succeed to document your reasoning. If you are not sure an
* `ensuringValid` call will always succeed, you should use one of the other
* factory or validation methods provided on this object instead: `isValid`,
* `tryingValid`, `passOrElse`, `goodOrElse`, or `rightOrElse`.
*
*
* This method will inspect the passed Float
value and if
* it is a positive Float
, it will return a PosFloat
representing that value.
* Otherwise, the passed Float
value is not positive, so
* this method will throw AssertionError
.
*
*
*
* This factory method differs from the apply
* factory method in that apply
is implemented
* via a macro that inspects Float
literals at
* compile time, whereas from
inspects
* Float
values at run time.
* It 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 a Float
is positive.
*
*
* @param value the Float
to inspect, and if positive, return
* wrapped in a PosFloat
.
* @return the specified Float
value wrapped in a
* PosFloat
, if it is positive, else
* throws AssertionError
.
* @throws AssertionError if the passed value is not positive
*/
def ensuringValid(value: Float): PosFloat =
if (PosFloatMacro.isValid(value)) new PosFloat(value) else {
throw new AssertionError(s"${value.toString()} was not a valid PosFloat")
}
/**
* A factory/validation method that produces a PosFloat
, wrapped
* in a Success
, given a valid Float
value, or if the
* given Float
is invalid, an AssertionError
, wrapped
* in a Failure
.
*
*
* This method will inspect the passed Float
value and if
* it is a positive Float
, it will return a PosFloat
* representing that value, wrapped in a Success
.
* Otherwise, the passed Float
value is not positive, so this
* method will return an AssertionError
, wrapped in a Failure
.
*
*
*
* This factory method differs from the apply
factory method
* in that apply
is implemented via a macro that inspects
* Float
literals at compile time, whereas this method inspects
* Float
values at run time.
*
*
* @param value the Float
to inspect, and if positive, return
* wrapped in a Success(PosFloat)
.
* @return the specified Float
value wrapped
* in a Success(PosFloat)
, if it is positive, else a Failure(AssertionError)
.
*/
def tryingValid(value: Float): Try[PosFloat] =
if (PosFloatMacro.isValid(value))
Success(new PosFloat(value))
else
Failure(new AssertionError(s"${value.toString()} was not a valid PosFloat"))
/**
* A validation method that produces a Pass
* given a valid Float
value, or
* an error value of type E
produced by passing the
* given invalid Int
value
* to the given function f
, wrapped in a Fail
.
*
*
* This method will inspect the passed Float
value and if
* it is a positive Float
, it will return a Pass
.
* Otherwise, the passed Float
value is positive, so this
* method will return a result of type E
obtained by passing
* the invalid Float
value to the given function f
,
* wrapped in a `Fail`.
*
*
*
* This factory method differs from the apply
factory method
* in that apply
is implemented via a macro that inspects
* Float
literals at compile time, whereas this method inspects
* Float
values at run time.
*
*
* @param value the `Float` to validate that it is positive.
* @return a `Pass` if the specified `Float` value is positive,
* else a `Fail` containing an error value produced by passing the
* specified `Float` to the given function `f`.
*/
def passOrElse[E](value: Float)(f: Float => E): Validation[E] =
if (PosFloatMacro.isValid(value)) Pass else Fail(f(value))
/**
* A factory/validation method that produces a PosFloat
, wrapped
* in a Good
, given a valid Float
value, or if the
* given Float
is invalid, an error value of type B
* produced by passing the given invalid Float
value
* to the given function f
, wrapped in a Bad
.
*
*
* This method will inspect the passed Float
value and if
* it is a positive Float
, it will return a PosFloat
* representing that value, wrapped in a Good
.
* Otherwise, the passed Float
value is not positive, so this
* method will return a result of type B
obtained by passing
* the invalid Float
value to the given function f
,
* wrapped in a `Bad`.
*
*
*
* This factory method differs from the apply
factory method
* in that apply
is implemented via a macro that inspects
* Float
literals at compile time, whereas this method inspects
* Float
values at run time.
*
*
* @param value the Float
to inspect, and if positive, return
* wrapped in a Good(PosFloat)
.
* @return the specified Float
value wrapped
* in a Good(PosFloat)
, if it is positive, else a Bad(f(value))
.
*/
def goodOrElse[B](value: Float)(f: Float => B): PosFloat Or B =
if (PosFloatMacro.isValid(value)) Good(PosFloat.ensuringValid(value)) else Bad(f(value))
/**
* A factory/validation method that produces a PosFloat
, wrapped
* in a Right
, given a valid Int
value, or if the
* given Int
is invalid, an error value of type L
* produced by passing the given invalid Int
value
* to the given function f
, wrapped in a Left
.
*
*
* This method will inspect the passed Int
value and if
* it is a positive Int
, it will return a PosFloat
* representing that value, wrapped in a Right
.
* Otherwise, the passed Int
value is not positive, so this
* method will return a result of type L
obtained by passing
* the invalid Int
value to the given function f
,
* wrapped in a `Left`.
*
*
*
* This factory method differs from the apply
factory method
* in that apply
is implemented via a macro that inspects
* Int
literals at compile time, whereas this method inspects
* Int
values at run time.
*
*
* @param value the Int
to inspect, and if positive, return
* wrapped in a Right(PosFloat)
.
* @return the specified Int
value wrapped
* in a Right(PosFloat)
, if it is positive, else a Left(f(value))
.
*/
def rightOrElse[L](value: Float)(f: Float => L): Either[L, PosFloat] =
if (PosFloatMacro.isValid(value)) Right(PosFloat.ensuringValid(value)) else Left(f(value))
/**
* A predicate method that returns true if a given
* Float
value is positive.
*
* @param value the Float
to inspect, and if positive, return true.
* @return true if the specified Float
is positive, else false.
*/
def isValid(value: Float): Boolean = PosFloatMacro.isValid(value)
/**
* A factory method that produces a PosFloat
given a
* Float
value and a default PosFloat
.
*
*
* This method will inspect the passed Float
value and if
* it is a positive Float
, it will return a PosFloat
representing that value.
* Otherwise, the passed Float
value is not positive, so this
* method will return the passed default
value.
*
*
*
* This factory method differs from the apply
* factory method in that apply
is implemented
* via a macro that inspects Float
literals at
* compile time, whereas from
inspects
* Float
values at run time.
*
*
* @param value the Float
to inspect, and if positive, return.
* @param default the PosFloat
to return if the passed
* Float
value is not positive.
* @return the specified Float
value wrapped in a
* PosFloat
, if it is positive, else the
* default
PosFloat
value.
*/
def fromOrElse(value: Float, default: => PosFloat): PosFloat =
if (PosFloatMacro.isValid(value)) new PosFloat(value) else default
import language.experimental.macros
import scala.language.implicitConversions
/**
* A factory method, implemented via a macro, that produces a
* PosFloat
if passed a valid Float
* literal, otherwise a compile time error.
*
*
* The macro that implements this method will inspect the
* specified Float
expression at compile time. If
* the expression is a positive Float
literal,
* it will return a PosFloat
representing that value.
* Otherwise, the passed Float
expression is either a literal
* that is not positive, or is not a literal, so this method
* will give a compiler error.
*
*
*
* This factory method differs from the from
* factory method in that this method is implemented via a
* macro that inspects Float
literals at compile
* time, whereas from
inspects Float
* values at run time.
*
*
* @param value the Float
literal expression to
* inspect at compile time, and if positive, to return
* wrapped in a PosFloat
at run time.
* @return the specified, valid Float
literal
* value wrapped in a PosFloat
. (If the
* specified expression is not a valid Float
* literal, the invocation of this method will not
* compile.)
*/
inline implicit def apply(value: => Float): PosFloat = ${ PosFloatMacro('{value}) }
/**
* Implicit widening conversion from PosFloat
to
* Float
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the
* specified PosFloat
*/
implicit def widenToFloat(pos: PosFloat): Float = pos.value
/**
* Implicit widening conversion from PosFloat
to
* Double
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the
* specified PosFloat
, widened to
* Double
.
*/
implicit def widenToDouble(pos: PosFloat): Double = pos.value
/**
* Implicit widening conversion from PosFloat
to PosDouble
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the specified PosFloat
,
* widened to Double
and wrapped in a PosDouble
.
*/
implicit def widenToPosDouble(pos: PosFloat): PosDouble = PosDouble.ensuringValid(pos.value)
/**
* Implicit widening conversion from PosFloat
to PosZFloat
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the specified PosFloat
,
* widened to Float
and wrapped in a PosZFloat
.
*/
implicit def widenToPosZFloat(pos: PosFloat): PosZFloat = PosZFloat.ensuringValid(pos.value)
/**
* Implicit widening conversion from PosFloat
to PosZDouble
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the specified PosFloat
,
* widened to Double
and wrapped in a PosZDouble
.
*/
implicit def widenToPosZDouble(pos: PosFloat): PosZDouble = PosZDouble.ensuringValid(pos.value)
/**
* Implicit widening conversion from PosFloat
to NonZeroFloat
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the specified PosFloat
,
* widened to Float
and wrapped in a NonZeroFloat
.
*/
implicit def widenToNonZeroFloat(pos: PosFloat): NonZeroFloat = NonZeroFloat.ensuringValid(pos.value)
/**
* Implicit widening conversion from PosFloat
to NonZeroDouble
.
*
* @param pos the PosFloat
to widen
* @return the Float
value underlying the specified PosFloat
,
* widened to Double
and wrapped in a NonZeroDouble
.
*/
implicit def widenToNonZeroDouble(pos: PosFloat): NonZeroDouble = NonZeroDouble.ensuringValid(pos.value)
/**
* Implicit Ordering instance.
*/
implicit val ordering: Ordering[PosFloat] =
new Ordering[PosFloat] {
def compare(x: PosFloat, y: PosFloat): Int = x.toFloat.compare(y)
}
/**
* The positive infinity value, which is PosFloat.ensuringValid(Float.PositiveInfinity)
.
*/
final val PositiveInfinity: PosFloat = PosFloat.ensuringValid(Float.PositiveInfinity) // Can't use the macro here
/**
* The smallest positive value greater than 0.0d representable as a PosFloat
, which is PosFloat(1.4E-45).
*/
final val MinPositiveValue: PosFloat = PosFloat.ensuringValid(Float.MinPositiveValue)
/**
* The formerly implicit posFloatOrd
field has been deprecated and will be removed in a future version of ScalaTest. Please use the ordering
field instead.
*/
@deprecated("The formerly implicit posFloatOrd field has been deprecated and will be removed in a future version of ScalaTest. Please use the ordering field instead.")
val posFloatOrd: Ordering[PosFloat] =
new Ordering[PosFloat] {
def compare(x: PosFloat, y: PosFloat): Int = ordering.compare(x, y)
}
}