Class/Object

zio

Fiber

Related Docs: object Fiber | package zio

Permalink

sealed abstract class Fiber[+E, +A] extends AnyRef

A fiber is a lightweight thread of execution that never consumes more than a whole thread (but may consume much less, depending on contention and asynchronicity). Fibers are spawned by forking ZIO effects, which run concurrently with the parent effect.

Fibers can be joined, yielding their result to other fibers, or interrupted, which terminates the fiber, safely releasing all resources.

def parallel[A, B](io1: Task[A], io2: Task[B]): Task[(A, B)] =
  for {
    fiber1 <- io1.fork
    fiber2 <- io2.fork
    a      <- fiber1.join
    b      <- fiber2.join
  } yield (a, b)
Self Type
Fiber[E, A]
Linear Supertypes
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Fiber
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def await(implicit trace: ZTraceElement): UIO[Exit[E, A]]

    Permalink

    Awaits the fiber, which suspends the awaiting fiber until the result of the fiber has been determined.

    Awaits the fiber, which suspends the awaiting fiber until the result of the fiber has been determined.

    returns

    UIO[Exit[E, A]]

  2. abstract def getRef[A](ref: ZFiberRef.Runtime[A])(implicit trace: ZTraceElement): UIO[A]

    Permalink

    Gets the value of the fiber ref for this fiber, or the initial value of the fiber ref, if the fiber is not storing the ref.

  3. abstract def inheritRefs(implicit trace: ZTraceElement): UIO[Unit]

    Permalink

    Inherits values from all FiberRef instances into current fiber.

    Inherits values from all FiberRef instances into current fiber. This will resume immediately.

    returns

    UIO[Unit]

  4. abstract def interruptAs(fiberId: FiberId)(implicit trace: ZTraceElement): UIO[Exit[E, A]]

    Permalink

    Interrupts the fiber as if interrupted from the specified fiber.

    Interrupts the fiber as if interrupted from the specified fiber. If the fiber has already exited, the returned effect will resume immediately. Otherwise, the effect will resume when the fiber exits.

    returns

    UIO[Exit, E, A]]

  5. abstract def poll(implicit trace: ZTraceElement): UIO[Option[Exit[E, A]]]

    Permalink

    Tentatively observes the fiber, but returns immediately if it is not already done.

    Tentatively observes the fiber, but returns immediately if it is not already done.

    returns

    UIO[Option[Exit, E, A]]]

Concrete Value Members

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

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def *>[E1 >: E, B](that: Fiber[E1, B]): Synthetic[E1, B]

    Permalink

    Same as zip but discards the output of the left hand side.

    Same as zip but discards the output of the left hand side.

    E1

    error type

    B

    type of the fiber

    that

    fiber to be zipped

    returns

    Fiber[E1, B] combined fiber

  4. final def <*[E1 >: E, B](that: Fiber[E1, B]): Synthetic[E1, A]

    Permalink

    Same as zip but discards the output of the right hand side.

    Same as zip but discards the output of the right hand side.

    E1

    error type

    B

    type of the fiber

    that

    fiber to be zipped

    returns

    Fiber[E1, A] combined fiber

  5. final def <*>[E1 >: E, B](that: ⇒ Fiber[E1, B])(implicit zippable: Zippable[A, B]): Synthetic[E1, Out]

    Permalink

    Zips this fiber and the specified fiber together, producing a tuple of their output.

    Zips this fiber and the specified fiber together, producing a tuple of their output.

    E1

    error type

    B

    type of that fiber

    that

    fiber to be zipped

    returns

    Fiber[E1, (A, B)] combined fiber

  6. final def <+>[E1 >: E, B](that: ⇒ Fiber[E1, B])(implicit ev: CanFail[E]): Synthetic[E1, Either[A, B]]

    Permalink

    A symbolic alias for orElseEither.

  7. def <>[E1, A1 >: A](that: ⇒ Fiber[E1, A1])(implicit ev: CanFail[E]): Synthetic[E1, A1]

    Permalink

    A symbolic alias for orElse.

  8. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  9. final def as[B](b: ⇒ B): Synthetic[E, B]

    Permalink

    Maps the output of this fiber to the specified constant.

    Maps the output of this fiber to the specified constant.

    B

    type of the fiber

    b

    constant

    returns

    Fiber[E, B] fiber mapped to constant

  10. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  11. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  12. final def eq(arg0: AnyRef): Boolean

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

    Permalink
    Definition Classes
    AnyRef → Any
  14. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  15. final def fold[Z](runtime: (Fiber.Runtime[E, A]) ⇒ Z, synthetic: (Synthetic[E, A]) ⇒ Z): Z

    Permalink

    Folds over the runtime or synthetic fiber.

  16. final def getClass(): Class[_]

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

    Permalink
    Definition Classes
    AnyRef → Any
  18. final def interrupt(implicit trace: ZTraceElement): UIO[Exit[E, A]]

    Permalink

    Interrupts the fiber from whichever fiber is calling this method.

    Interrupts the fiber from whichever fiber is calling this method. If the fiber has already exited, the returned effect will resume immediately. Otherwise, the effect will resume when the fiber exits.

    returns

    UIO[Exit, E, A]]

  19. final def interruptFork(implicit trace: ZTraceElement): UIO[Unit]

    Permalink

    Interrupts the fiber from whichever fiber is calling this method.

    Interrupts the fiber from whichever fiber is calling this method. The interruption will happen in a separate daemon fiber, and the returned effect will always resume immediately without waiting.

    returns

    UIO[Unit]

  20. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  21. final def join(implicit trace: ZTraceElement): IO[E, A]

    Permalink

    Joins the fiber, which suspends the joining fiber until the result of the fiber has been determined.

    Joins the fiber, which suspends the joining fiber until the result of the fiber has been determined. Attempting to join a fiber that has erred will result in a catchable error. Joining an interrupted fiber will result in an "inner interruption" of this fiber, unlike interruption triggered by another fiber, "inner interruption" can be caught and recovered.

    returns

    IO[E, A]

  22. final def map[B](f: (A) ⇒ B): Synthetic[E, B]

    Permalink

    Maps over the value the Fiber computes.

    Maps over the value the Fiber computes.

    B

    result type of f

    f

    mapping function

    returns

    Fiber[E, B] mapped fiber

  23. final def mapFiber[E1 >: E, B](f: (A) ⇒ Fiber[E1, B])(implicit trace: ZTraceElement): UIO[Fiber[E1, B]]

    Permalink

    Passes the success of this fiber to the specified callback, and continues with the fiber that it returns.

    Passes the success of this fiber to the specified callback, and continues with the fiber that it returns.

    B

    The success value.

    f

    The callback.

    returns

    Fiber[E, B] The continued fiber.

  24. final def mapZIO[E1 >: E, B](f: (A) ⇒ IO[E1, B]): Synthetic[E1, B]

    Permalink

    Effectually maps over the value the fiber computes.

  25. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  26. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  27. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  28. def orElse[E1, A1 >: A](that: ⇒ Fiber[E1, A1])(implicit ev: CanFail[E]): Synthetic[E1, A1]

    Permalink

    Returns a fiber that prefers this fiber, but falls back to the that one when this one fails.

    Returns a fiber that prefers this fiber, but falls back to the that one when this one fails. Interrupting the returned fiber will interrupt both fibers, sequentially, from left to right.

    E1

    error type

    A1

    type of the other fiber

    that

    fiber to fall back to

    returns

    Fiber[E1, A1]

  29. final def orElseEither[E1, B](that: ⇒ Fiber[E1, B]): Synthetic[E1, Either[A, B]]

    Permalink

    Returns a fiber that prefers this fiber, but falls back to the that one when this one fails.

    Returns a fiber that prefers this fiber, but falls back to the that one when this one fails. Interrupting the returned fiber will interrupt both fibers, sequentially, from left to right.

    E1

    error type

    B

    type of the other fiber

    that

    fiber to fall back to

    returns

    Fiber[E1, B]

  30. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  31. final def toFuture(implicit ev: IsSubtypeOfError[E, Throwable], trace: ZTraceElement): UIO[CancelableFuture[A]]

    Permalink

    Converts this fiber into a scala.concurrent.Future.

    Converts this fiber into a scala.concurrent.Future.

    ev

    implicit witness that E is a subtype of Throwable

    returns

    UIO[Future[A]]

  32. final def toFutureWith(f: (E) ⇒ Throwable)(implicit trace: ZTraceElement): UIO[CancelableFuture[A]]

    Permalink

    Converts this fiber into a scala.concurrent.Future, translating any errors to java.lang.Throwable with the specified conversion function, using Cause.squashTraceWith

    Converts this fiber into a scala.concurrent.Future, translating any errors to java.lang.Throwable with the specified conversion function, using Cause.squashTraceWith

    f

    function to the error into a Throwable

    returns

    UIO[Future[A]]

  33. final def toManaged(implicit trace: ZTraceElement): ZManaged[Any, Nothing, Fiber[E, A]]

    Permalink

    Converts this fiber into a zio.ZManaged.

    Converts this fiber into a zio.ZManaged. Fiber is interrupted on release.

    returns

    ZManaged[Any, Nothing, Fiber[E, A]]

  34. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  35. final def unit: Synthetic[E, Unit]

    Permalink

    Maps the output of this fiber to ().

    Maps the output of this fiber to ().

    returns

    Fiber[E, Unit] fiber mapped to ()

  36. final def wait(): Unit

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

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  39. final def zip[E1 >: E, B](that: ⇒ Fiber[E1, B])(implicit zippable: Zippable[A, B]): Synthetic[E1, Out]

    Permalink

    Named alias for <*>.

    Named alias for <*>.

    E1

    error type

    B

    type of that fiber

    that

    fiber to be zipped

    returns

    Fiber[E1, (A, B)] combined fiber

  40. final def zipLeft[E1 >: E, B](that: Fiber[E1, B]): Synthetic[E1, A]

    Permalink

    Named alias for <*.

    Named alias for <*.

    E1

    error type

    B

    type of the fiber

    that

    fiber to be zipped

    returns

    Fiber[E1, A] combined fiber

  41. final def zipRight[E1 >: E, B](that: Fiber[E1, B]): Synthetic[E1, B]

    Permalink

    Named alias for *>.

    Named alias for *>.

    E1

    error type

    B

    type of the fiber

    that

    fiber to be zipped

    returns

    Fiber[E1, B] combined fiber

  42. final def zipWith[E1 >: E, B, C](that: ⇒ Fiber[E1, B])(f: (A, B) ⇒ C): Synthetic[E1, C]

    Permalink

    Zips this fiber with the specified fiber, combining their results using the specified combiner function.

    Zips this fiber with the specified fiber, combining their results using the specified combiner function. Both joins and interruptions are performed in sequential order from left to right.

    E1

    error type

    B

    type of that fiber

    C

    type of the resulting fiber

    that

    fiber to be zipped

    f

    function to combine the results of both fibers

    returns

    Fiber[E1, C] combined fiber

Deprecated Value Members

  1. final def mapM[E1 >: E, B](f: (A) ⇒ IO[E1, B]): Synthetic[E1, B]

    Permalink

    Effectually maps over the value the fiber computes.

    Effectually maps over the value the fiber computes.

    Annotations
    @deprecated
    Deprecated

    (Since version 2.0.0) use mapZIO

Inherited from AnyRef

Inherited from Any

Ungrouped