Failure

scala.util.Failure
final case class Failure[+T](exception: Throwable) extends Try[T]

Attributes

Source
Try.scala
Graph
Supertypes
class Try[T]
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all

Members list

Keywords
  • no keywords
  • final
  • override
Inherited
  • Not inherited
  • Product
  • Try

Type members

Inherited classlikes

final class WithFilter(p: T => Boolean)

We need a whole WithFilter class to honor the "doesn't create a new collection" contract even though it seems unlikely to matter much in a collection with max size 1.

We need a whole WithFilter class to honor the "doesn't create a new collection" contract even though it seems unlikely to matter much in a collection with max size 1.

Attributes

Inherited from:
Try
Source
Try.scala
Supertypes
class Object
trait Matchable
class Any

Value members

Concrete methods

override def collect[U](pf: PartialFunction[T, U]): Try[U]

Applies the given partial function to the value from this Success or returns this if this is a Failure.

Applies the given partial function to the value from this Success or returns this if this is a Failure.

Attributes

Definition Classes
Try
Source
Try.scala
override def failed: Try[Throwable]

Inverts this Try.

Inverts this Try. If this is a Failure, returns its exception wrapped in a Success. If this is a Success, returns a Failure containing an UnsupportedOperationException.

Attributes

Definition Classes
Try
Source
Try.scala
override def filter(p: T => Boolean): Try[T]

Converts this to a Failure if the predicate is not satisfied.

Converts this to a Failure if the predicate is not satisfied.

Attributes

Definition Classes
Try
Source
Try.scala
override def flatMap[U](f: T => Try[U]): Try[U]

Returns the given function applied to the value from this Success or returns this if this is a Failure.

Returns the given function applied to the value from this Success or returns this if this is a Failure.

Attributes

Definition Classes
Try
Source
Try.scala
override def flatten[U](implicit ev: T <:< Try[U]): Try[U]

Transforms a nested Try, ie, a Try of type Try[Try[T]], into an un-nested Try, ie, a Try of type Try[T].

Transforms a nested Try, ie, a Try of type Try[Try[T]], into an un-nested Try, ie, a Try of type Try[T].

Attributes

Definition Classes
Try
Source
Try.scala
override def fold[U](fa: Throwable => U, fb: T => U): U

Applies fa if this is a Failure or fb if this is a Success.

Applies fa if this is a Failure or fb if this is a Success. If fb is initially applied and throws an exception, then fa is applied with this exception.

Value parameters

fa

the function to apply if this is a Failure

fb

the function to apply if this is a Success

Attributes

Returns

the results of applying the function

Example

val result: Try[Int] = Try { string.toInt }
log(result.fold(
 ex => "Operation failed with " + ex,
 v => "Operation produced value: " + v
))
Definition Classes
Try
Source
Try.scala
override def foreach[U](f: T => U): Unit

Applies the given function f if this is a Success, otherwise returns Unit if this is a Failure.

Applies the given function f if this is a Success, otherwise returns Unit if this is a Failure.

Note: If f throws, then this method may throw an exception.

Attributes

Definition Classes
Try
Source
Try.scala
override def get: T

Returns the value from this Success or throws the exception if this is a Failure.

Returns the value from this Success or throws the exception if this is a Failure.

Attributes

Definition Classes
Try
Source
Try.scala
override def getOrElse[U >: T](default: => U): U

Returns the value from this Success or the given default argument if this is a Failure.

Returns the value from this Success or the given default argument if this is a Failure.

Note:: This will throw an exception if it is not a success and default throws an exception.

Attributes

Definition Classes
Try
Source
Try.scala
override def isFailure: Boolean

Returns true if the Try is a Failure, false otherwise.

Returns true if the Try is a Failure, false otherwise.

Attributes

Definition Classes
Try
Source
Try.scala
override def isSuccess: Boolean

Returns true if the Try is a Success, false otherwise.

Returns true if the Try is a Success, false otherwise.

Attributes

Definition Classes
Try
Source
Try.scala
override def map[U](f: T => U): Try[U]

Maps the given function to the value from this Success or returns this if this is a Failure.

Maps the given function to the value from this Success or returns this if this is a Failure.

Attributes

Definition Classes
Try
Source
Try.scala
override def orElse[U >: T](default: => Try[U]): Try[U]

Returns this Try if it's a Success or the given default argument if this is a Failure.

Returns this Try if it's a Success or the given default argument if this is a Failure.

Attributes

Definition Classes
Try
Source
Try.scala
override def recover[U >: T](pf: PartialFunction[Throwable, U]): Try[U]

Applies the given function f if this is a Failure, otherwise returns this if this is a Success.

Applies the given function f if this is a Failure, otherwise returns this if this is a Success. This is like map for the exception.

Attributes

Definition Classes
Try
Source
Try.scala
override def recoverWith[U >: T](pf: PartialFunction[Throwable, Try[U]]): Try[U]

Applies the given function f if this is a Failure, otherwise returns this if this is a Success.

Applies the given function f if this is a Failure, otherwise returns this if this is a Success. This is like flatMap for the exception.

Attributes

Definition Classes
Try
Source
Try.scala
override def toEither: Either[Throwable, T]

Returns Left with Throwable if this is a Failure, otherwise returns Right with Success value.

Returns Left with Throwable if this is a Failure, otherwise returns Right with Success value.

Attributes

Definition Classes
Try
Source
Try.scala
override def toOption: Option[T]

Returns None if this is a Failure or a Some containing the value if this is a Success.

Returns None if this is a Failure or a Some containing the value if this is a Success.

Attributes

Definition Classes
Try
Source
Try.scala
override def transform[U](s: T => Try[U], f: Throwable => Try[U]): Try[U]

Completes this Try by applying the function f to this if this is of type Failure, or conversely, by applying s if this is a Success.

Completes this Try by applying the function f to this if this is of type Failure, or conversely, by applying s if this is a Success.

Attributes

Definition Classes
Try
Source
Try.scala

Inherited methods

An iterator over the names of all the elements of this product.

An iterator over the names of all the elements of this product.

Attributes

Inherited from:
Product
Source
Product.scala

An iterator over all the elements of this product.

An iterator over all the elements of this product.

Attributes

Returns

in the default implementation, an Iterator[Any]

Inherited from:
Product
Source
Product.scala
final def withFilter(p: T => Boolean): WithFilter

Creates a non-strict filter, which eventually converts this to a Failure if the predicate is not satisfied.

Creates a non-strict filter, which eventually converts this to a Failure if the predicate is not satisfied.

Note: unlike filter, withFilter does not create a new Try. Instead, it restricts the domain of subsequent map, flatMap, foreach, and withFilter operations.

As Try is a one-element collection, this may be a bit overkill, but it's consistent with withFilter on Option and the other collections.

Value parameters

p

the predicate used to test elements.

Attributes

Returns

an object of class WithFilter, which supports map, flatMap, foreach, and withFilter operations. All these operations apply to those elements of this Try which satisfy the predicate p.

Inherited from:
Try
Source
Try.scala