scodec

Attempt

sealed abstract class Attempt[+A] extends Product with Serializable

Right biased Either[Err, A].

An Attempt is either an Attempt.Successful or an Attempt.Failure. Attempts can be created by calling Attempt.successful or Attempt.failure, as well as converting from an Option via fromOption.

Source
Attempt.scala
Linear Supertypes
Known Subclasses
Ordering
  1. Grouped
  2. Alphabetic
  3. By inheritance
Inherited
  1. Attempt
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. AnyRef
  7. Any
Implicitly
  1. by TransformSyntax
  2. by any2stringadd
  3. by any2stringfmt
  4. by any2ArrowAssoc
  5. by any2Ensuring
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new Attempt()

Abstract Value Members

  1. abstract def canEqual(that: Any): Boolean

    Definition Classes
    Equals
  2. abstract def flatMap[B](f: (A) ⇒ Attempt[B]): Attempt[B]

    Maps the supplied function over the successful value, if present.

  3. abstract def flatten[B](implicit ev: <:<[A, Attempt[B]]): Attempt[B]

    Converts an Attempt[Attempt[X]] in to an Attempt[X].

  4. abstract def fold[B](ifFailure: (Err) ⇒ B, ifSuccessful: (A) ⇒ B): B

    Transforms this attempt to a value of type B using the supplied functions.

  5. abstract def getOrElse[B >: A](default: ⇒ B): B

    Returns the sucessful value if successful, otherwise the supplied default.

  6. abstract def isSuccessful: Boolean

    True if attempt was successful.

  7. abstract def map[B](f: (A) ⇒ B): Attempt[B]

    Maps the supplied function over the successful value, if present.

  8. abstract def mapErr(f: (Err) ⇒ Err): Attempt[A]

    Maps the supplied function over the failure error, if present.

  9. abstract def orElse[B >: A](fallback: ⇒ Attempt[B]): Attempt[B]

    Returns this attempt if successful, otherwise the fallback attempt.

  10. abstract def productArity: Int

    Definition Classes
    Product
  11. abstract def productElement(n: Int): Any

    Definition Classes
    Product
  12. abstract def recover[B >: A](f: PartialFunction[Err, B]): Attempt[B]

    If this attempt is a failure, and the supplied partial function is defined for the cause of the failure, a successful attempt is returned.

    If this attempt is a failure, and the supplied partial function is defined for the cause of the failure, a successful attempt is returned. If this attempt is successful or the supplied function is not defined for the cause of the failure, this attempt is returned unmodified.

  13. abstract def recoverWith[B >: A](f: PartialFunction[Err, Attempt[B]]): Attempt[B]

    If this attempt is a failure, and the supplied partial function is defined for the cause of the failure, the result of applying that function is returned.

    If this attempt is a failure, and the supplied partial function is defined for the cause of the failure, the result of applying that function is returned. If this attempt is successful or the supplied function is not defined for the cause of the failure, this attempt is returned unmodified.

  14. abstract def require: A

    Returns the successful value if present; otherwise throws an IllegalArgumentException.

  15. abstract def toEither: Either[Err, A]

    Converts to an either.

  16. abstract def toOption: Option[A]

    Converts to an option, discarding the error value.

Concrete Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. def +(other: String): String

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to StringAdd performed by method any2stringadd in scala.Predef.
    Definition Classes
    StringAdd
  5. def ->[B](y: B): (Attempt[A], B)

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to ArrowAssoc[Attempt[A]] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  6. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  7. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  8. def as[B](implicit as: Transformer[A, B]): Attempt[B]

    Transforms using implicitly available evidence that such a transformation is possible.

    Transforms using implicitly available evidence that such a transformation is possible.

    Typical transformations include converting:

    • an F[L] for some L <: HList to/from an F[CC] for some case class CC, where the types in the case class are aligned with the types in L
    • an F[C] for some C <: Coproduct to/from an F[SC] for some sealed class SC, where the component types in the coproduct are the leaf subtypes of the sealed class.
    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  9. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  10. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  11. def ensuring(cond: (Attempt[A]) ⇒ Boolean, msg: ⇒ Any): Attempt[A]

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to Ensuring[Attempt[A]] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: (Attempt[A]) ⇒ Boolean): Attempt[A]

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to Ensuring[Attempt[A]] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. def ensuring(cond: Boolean, msg: ⇒ Any): Attempt[A]

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to Ensuring[Attempt[A]] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  14. def ensuring(cond: Boolean): Attempt[A]

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to Ensuring[Attempt[A]] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  16. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  17. def exmap[B](f: (A) ⇒ Attempt[B], g: (B) ⇒ Attempt[A]): Attempt[B]

    Transforms using two functions, A => Attempt[B] and B => Attempt[A].

    Transforms using two functions, A => Attempt[B] and B => Attempt[A].

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  18. def exmapc[B](f: (A) ⇒ Attempt[B])(g: (B) ⇒ Attempt[A]): Attempt[B]

    Curried version of exmap.

    Curried version of exmap.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  19. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  20. def formatted(fmtstr: String): String

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to StringFormat performed by method any2stringfmt in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  21. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  22. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  23. def isFailure: Boolean

    True if attempt was not successful.

  24. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  25. def narrow[B](f: (A) ⇒ Attempt[B], g: (B) ⇒ A): Attempt[B]

    Transforms using two functions, A => Attempt[B] and B => A.

    Transforms using two functions, A => Attempt[B] and B => A.

    The supplied functions form an injection from B to A. Hence, this method converts from a larger to a smaller type. Hence, the name narrow.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  26. def narrowc[B](f: (A) ⇒ Attempt[B])(g: (B) ⇒ A): Attempt[B]

    Curried version of narrow.

    Curried version of narrow.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  27. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  28. final def notify(): Unit

    Definition Classes
    AnyRef
  29. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  30. def productIterator: Iterator[Any]

    Definition Classes
    Product
  31. def productPrefix: String

    Definition Classes
    Product
  32. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  33. def toString(): String

    Definition Classes
    AnyRef → Any
  34. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  35. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  36. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  37. def widen[B](f: (A) ⇒ B, g: (B) ⇒ Attempt[A]): Attempt[B]

    Transforms using two functions, A => B and B => Attempt[A].

    Transforms using two functions, A => B and B => Attempt[A].

    The supplied functions form an injection from A to B. Hence, this method converts from a smaller to a larger type. Hence, the name widen.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  38. def widenOpt[B](f: (A) ⇒ B, g: (B) ⇒ Option[A]): Attempt[B]

    Transforms using two functions, A => B and B => Option[A].

    Transforms using two functions, A => B and B => Option[A].

    Particularly useful when combined with case class apply/unapply. E.g., widenOpt(fa, Foo.apply, Foo.unapply).

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  39. def widenOptc[B](f: (A) ⇒ B)(g: (B) ⇒ Option[A]): Attempt[B]

    Curried version of widenOpt.

    Curried version of widenOpt.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  40. def widenc[B](f: (A) ⇒ B)(g: (B) ⇒ Attempt[A]): Attempt[B]

    Curried version of widen.

    Curried version of widen.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  41. def xmap[B](f: (A) ⇒ B, g: (B) ⇒ A): Attempt[B]

    Transforms using the isomorphism described by two functions, A => B and B => A.

    Transforms using the isomorphism described by two functions, A => B and B => A.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  42. def xmapc[B](f: (A) ⇒ B)(g: (B) ⇒ A): Attempt[B]

    Curried version of xmap.

    Curried version of xmap.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
  43. def [B](y: B): (Attempt[A], B)

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to ArrowAssoc[Attempt[A]] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Shadowed Implicit Value Members

  1. val self: Attempt[A]

    Supports TransformSyntax.

    Supports TransformSyntax.

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (attempt: TransformSyntax[Attempt, A]).self
    Definition Classes
    TransformSyntax
  2. val self: Any

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to StringAdd performed by method any2stringadd in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (attempt: StringAdd).self
    Definition Classes
    StringAdd
  3. val self: Any

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to StringFormat performed by method any2stringfmt in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (attempt: StringFormat).self
    Definition Classes
    StringFormat

Deprecated Value Members

  1. def pxmap[B](f: (A) ⇒ B, g: (B) ⇒ Option[A]): Attempt[B]

    Transforms using two functions, A => B and B => Option[A].

    Transforms using two functions, A => B and B => Option[A].

    Particularly useful when combined with case class apply/unapply. E.g., pxmap(fa, Foo.apply, Foo.unapply).

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to TransformSyntax[Attempt, A] performed by method TransformSyntax in scodec. This conversion will take place only if an implicit value of type Transform[Attempt] is in scope.
    Definition Classes
    TransformSyntax
    Annotations
    @deprecated
    Deprecated

    (Since version 1.7.0) Use widenOpt instead

  2. def x: Attempt[A]

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to ArrowAssoc[Attempt[A]] performed by method any2ArrowAssoc in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (attempt: ArrowAssoc[Attempt[A]]).x
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use leftOfArrow instead

  3. def x: Attempt[A]

    Implicit information
    This member is added by an implicit conversion from Attempt[A] to Ensuring[Attempt[A]] performed by method any2Ensuring in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (attempt: Ensuring[Attempt[A]]).x
    Definition Classes
    Ensuring
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use resultOfEnsuring instead

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion TransformSyntax from Attempt[A] to TransformSyntax[Attempt, A]

Inherited by implicit conversion any2stringadd from Attempt[A] to StringAdd

Inherited by implicit conversion any2stringfmt from Attempt[A] to StringFormat

Inherited by implicit conversion any2ArrowAssoc from Attempt[A] to ArrowAssoc[Attempt[A]]

Inherited by implicit conversion any2Ensuring from Attempt[A] to Ensuring[Attempt[A]]

Basic Combinators

Members