NegZLong

object NegZLong

The companion object for NegZLong that offers factory methods that produce NegZLongs, implicit widening conversions from NegZLong to other numeric types, and maximum and minimum constant values for NegZLong.

Companion:
class
Source:
NegZLong.scala
class Object
trait Matchable
class Any

Value members

Concrete methods

def ensuringValid(value: Long): NegZLong

A factory/assertion method that produces an NegZLong given a valid Long value, or throws AssertionError, if given an invalid Long value.

A factory/assertion method that produces an NegZLong given a valid Long value, or throws AssertionError, if given an invalid Long 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 Long value and if it is a non-positive Long, it will return a NegZLong representing that value. Otherwise, the passed Long value is not non-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 Long literals at compile time, whereas from inspects Long 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 Long is positive.

Value parameters:
value

the Long to inspect, and if non-positive, return wrapped in a NegZLong.

Returns:

the specified Long value wrapped in a NegZLong, if it is non-positive, else throws AssertionError.

Throws:
AssertionError

if the passed value is not non-positive

Source:
NegZLong.scala
def from(value: Long): Option[NegZLong]

A factory method that produces an Option[NegZLong] given a Long value.

A factory method that produces an Option[NegZLong] given a Long value.

This method will inspect the passed Long value and if it is a non-positive Long, it will return a NegZLong representing that value, wrapped in a Some. Otherwise, the passed Long value is not non-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 Long literals at compile time, whereas from inspects Long values at run time.

Value parameters:
value

the Long to inspect, and if non-positive, return wrapped in a Some[NegZLong].

Returns:

the specified Long value wrapped in a Some[NegZLong], if it is non-positive, else None.

Source:
NegZLong.scala
def fromOrElse(value: Long, default: => NegZLong): NegZLong

A factory method that produces a NegZLong given a Long value and a default NegZLong.

A factory method that produces a NegZLong given a Long value and a default NegZLong.

This method will inspect the passed Long value and if it is a non-positive Long, it will return a NegZLong representing that value. Otherwise, the passed Long value is not non-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 Long literals at compile time, whereas from inspects Long values at run time.

Value parameters:
default

the NegZLong to return if the passed Long value is not non-positive.

value

the Long to inspect, and if non-positive, return.

Returns:

the specified Long value wrapped in a NegZLong, if it is non-positive, else the default NegZLong value.

Source:
NegZLong.scala
def goodOrElse[B](value: Long)(f: Long => B): Or[NegZLong, B]

A factory/validation method that produces a NegZLong, wrapped in a Good, given a valid Long value, or if the given Long is invalid, an error value of type B produced by passing the given invalid Long value to the given function f, wrapped in a Bad.

A factory/validation method that produces a NegZLong, wrapped in a Good, given a valid Long value, or if the given Long is invalid, an error value of type B produced by passing the given invalid Long value to the given function f, wrapped in a Bad.

This method will inspect the passed Long value and if it is a non-positive Long, it will return a NegZLong representing that value, wrapped in a Good. Otherwise, the passed Long value is not non-positive, so this method will return a result of type B obtained by passing the invalid Long 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 Long literals at compile time, whereas this method inspects Long values at run time.

Value parameters:
value

the Long to inspect, and if non-positive, return wrapped in a Good(NegZLong).

Returns:

the specified Long value wrapped in a Good(NegZLong), if it is non-positive, else a Bad(f(value)).

Source:
NegZLong.scala
def isValid(value: Long): Boolean

A predicate method that returns true if a given Long value is non-positive.

A predicate method that returns true if a given Long value is non-positive.

Value parameters:
value

the Long to inspect, and if non-positive, return true.

Returns:

true if the specified Long is non-positive, else false.

Source:
NegZLong.scala
def passOrElse[E](value: Long)(f: Long => E): Validation[E]

A validation method that produces a Pass given a valid Long 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.

A validation method that produces a Pass given a valid Long 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 Long value and if it is a non-positive Long, it will return a Pass. Otherwise, the passed Long value is non-positive, so this method will return a result of type E obtained by passing the invalid Long 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 Long literals at compile time, whereas this method inspects Long values at run time.

Value parameters:
value

the Long to validate that it is non-positive.

Returns:

a Pass if the specified Long value is non-positive, else a Fail containing an error value produced by passing the specified Long to the given function f.

Source:
NegZLong.scala
def rightOrElse[L](value: Long)(f: Long => L): Either[L, NegZLong]

A factory/validation method that produces a NegZLong, 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.

A factory/validation method that produces a NegZLong, 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 non-positive Int, it will return a NegZLong representing that value, wrapped in a Right. Otherwise, the passed Int value is not non-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.

Value parameters:
value

the Int to inspect, and if non-positive, return wrapped in a Right(NegZLong).

Returns:

the specified Int value wrapped in a Right(NegZLong), if it is non-positive, else a Left(f(value)).

Source:
NegZLong.scala
def tryingValid(value: Long): Try[NegZLong]

A factory/validation method that produces a NegZLong, wrapped in a Success, given a valid Long value, or if the given Long is invalid, an AssertionError, wrapped in a Failure.

A factory/validation method that produces a NegZLong, wrapped in a Success, given a valid Long value, or if the given Long is invalid, an AssertionError, wrapped in a Failure.

This method will inspect the passed Long value and if it is a non-positive Long, it will return a NegZLong representing that value, wrapped in a Success. Otherwise, the passed Long value is not non-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 Long literals at compile time, whereas this method inspects Long values at run time.

Value parameters:
value

the Long to inspect, and if non-positive, return wrapped in a Success(NegZLong).

Returns:

the specified Long value wrapped in a Success(NegZLong), if it is non-positive, else a Failure(AssertionError).

Source:
NegZLong.scala

Concrete fields

final val MaxValue: NegZLong

The largest value representable as a non-positive Long, which is NegZLong(0L).

The largest value representable as a non-positive Long, which is NegZLong(0L).

Source:
NegZLong.scala
final val MinValue: NegZLong

The smallest value representable as a positive Long, which is NegZLong(-9223372036854775808).

The smallest value representable as a positive Long, which is NegZLong(-9223372036854775808).

Source:
NegZLong.scala

Implicits

Implicits

implicit inline def apply(value: => Long): NegZLong

A factory method, implemented via a macro, that produces a NegZLong if passed a valid Long literal, otherwise a compile time error.

A factory method, implemented via a macro, that produces a NegZLong if passed a valid Long literal, otherwise a compile time error.

The macro that implements this method will inspect the specified Long expression at compile time. If the expression is a non-positive Long literal, it will return a NegZLong representing that value. Otherwise, the passed Long expression is either a literal that is not non-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 Long literals at compile time, whereas from inspects Long values at run time.

Value parameters:
value

the Long literal expression to inspect at compile time, and if non-positive, to return wrapped in a NegZLong at run time.

Returns:

the specified, valid Long literal value wrapped in a NegZLong. (If the specified expression is not a valid Long literal, the invocation of this method will not compile.)

Source:
NegZLong.scala
implicit val ordering: Ordering[NegZLong]

Implicit Ordering instance.

Implicit Ordering instance.

Source:
NegZLong.scala
implicit def widenToDouble(pos: NegZLong): Double

Implicit widening conversion from NegZLong to Double.

Implicit widening conversion from NegZLong to Double.

Value parameters:
pos

the NegZLong to widen

Returns:

the Long value underlying the specified NegZLong, widened to Double.

Source:
NegZLong.scala
implicit def widenToFloat(pos: NegZLong): Float

Implicit widening conversion from NegZLong to Float.

Implicit widening conversion from NegZLong to Float.

Value parameters:
pos

the NegZLong to widen

Returns:

the Long value underlying the specified NegZLong, widened to Float.

Source:
NegZLong.scala
implicit def widenToLong(pos: NegZLong): Long

Implicit widening conversion from NegZLong to Long.

Implicit widening conversion from NegZLong to Long.

Value parameters:
pos

the NegZLong to widen

Returns:

the Long value underlying the specified NegZLong.

Source:
NegZLong.scala

Implicit widening conversion from NegZLong to NegZDouble.

Implicit widening conversion from NegZLong to NegZDouble.

Value parameters:
pos

the NegZLong to widen

Returns:

the Long value underlying the specified NegZLong, widened to Double and wrapped in a NegZDouble.

Source:
NegZLong.scala
implicit def widenToNegZFloat(pos: NegZLong): NegZFloat

Implicit widening conversion from NegZLong to NegZFloat.

Implicit widening conversion from NegZLong to NegZFloat.

Value parameters:
pos

the NegZLong to widen

Returns:

the Long value underlying the specified NegZLong, widened to Float and wrapped in a NegZFloat.

Source:
NegZLong.scala