zio/zio.stm/ZSTM

ZSTM

final class ZSTM[-R, +E, +A] extends AnyVal

STM[E, A] represents an effect that can be performed transactionally, resulting in a failure E or a value A.

def transfer(receiver: TRef[Int],
             sender: TRef[Int], much: Int): UIO[Int] =
 STM.atomically {
   for {
     balance <- sender.get
     _       <- STM.check(balance >= much)
     _       <- receiver.update(_ + much)
     _       <- sender.update(_ - much)
     newAmnt <- receiver.get
   } yield newAmnt
 }

 val action: UIO[Int] =
   for {
     t <- STM.atomically(TRef.make(0).zip(TRef.make(20000)))
     (receiver, sender) = t
     balance <- transfer(receiver, sender, 1000)
   } yield balance

Software Transactional Memory is a technique which allows composition of arbitrary atomic operations. It is the software analog of transactions in database systems.

The API is lifted directly from the Haskell package Control.Concurrent.STM although the implementation does not resemble the Haskell one at all. http://hackage.haskell.org/package/stm-2.5.0.0/docs/Control-Concurrent-STM.html

STM in Haskell was introduced in: Composable memory transactions, by Tim Harris, Simon Marlow, Simon Peyton Jones, and Maurice Herlihy, in ACM Conference on Principles and Practice of Parallel Programming 2005. https://www.microsoft.com/en-us/research/publication/composable-memory-transactions/

See also: Lock Free Data Structures using STMs in Haskell, by Anthony Discolo, Tim Harris, Simon Marlow, Simon Peyton Jones, Satnam Singh) FLOPS 2006: Eighth International Symposium on Functional and Logic Programming, Fuji Susono, JAPAN, April 2006 https://www.microsoft.com/en-us/research/publication/lock-free-data-structures-using-stms-in-haskell/

Companion:
object
class AnyVal
trait Matchable
class Any
ZSTM[R, E, A]

Value members

Concrete methods

final def !(implicit ev: E <:< Throwable, ev2: CanFail[E]): ZSTM[R, Nothing, A]

A symbolic alias for orDie.

A symbolic alias for orDie.

def &&&[R1 <: R, E1 >: E, B](that: ZSTM[R1, E1, B]): ZSTM[R1, E1, (A, B)]

Alias for <*> and zip.

Alias for <*> and zip.

def ***[R1, E1 >: E, B](that: ZSTM[R1, E1, B]): ZSTM[(R, R1), E1, (A, B)]

Splits the environment, providing the first part to this effect and the second part to that effect.

Splits the environment, providing the first part to this effect and the second part to that effect.

def *>[R1 <: R, E1 >: E, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, B]

Sequentially zips this value with the specified one, discarding the first element of the tuple.

Sequentially zips this value with the specified one, discarding the first element of the tuple.

def +++[R1, B, E1 >: E](that: ZSTM[R1, E1, B]): ZSTM[Either[R, R1], E1, Either[A, B]]

Depending on provided environment, returns either this one or the other effect lifted in Left or Right, respectively.

Depending on provided environment, returns either this one or the other effect lifted in Left or Right, respectively.

def <*[R1 <: R, E1 >: E, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, A]

Sequentially zips this value with the specified one, discarding the second element of the tuple.

Sequentially zips this value with the specified one, discarding the second element of the tuple.

def <*>[R1 <: R, E1 >: E, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, (A, B)]

Sequentially zips this value with the specified one.

Sequentially zips this value with the specified one.

def <+>[R1 <: R, E1, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, Either[A, B]]

A symbolic alias for orElseEither.

A symbolic alias for orElseEither.

def <<<[R1, E1 >: E](that: ZSTM[R1, E1, R]): ZSTM[R1, E1, A]

Propagates self environment to that.

Propagates self environment to that.

def <>[R1 <: R, E1, A1 >: A](that: => ZSTM[R1, E1, A1]): ZSTM[R1, E1, A1]

Tries this effect first, and if it fails or retries, tries the other effect.

Tries this effect first, and if it fails or retries, tries the other effect.

def <|>[R1 <: R, E1 >: E, A1 >: A](that: => ZSTM[R1, E1, A1]): ZSTM[R1, E1, A1]

Tries this effect first, and if it enters retry, then it tries the other effect. This is an equivalent of haskell's orElse.

Tries this effect first, and if it enters retry, then it tries the other effect. This is an equivalent of haskell's orElse.

def >>=[R1 <: R, E1 >: E, B](f: A => ZSTM[R1, E1, B]): ZSTM[R1, E1, B]

Feeds the value produced by this effect to the specified function, and then runs the returned effect as well to produce its results.

Feeds the value produced by this effect to the specified function, and then runs the returned effect as well to produce its results.

def >>>[E1 >: E, B](that: ZSTM[A, E1, B]): ZSTM[R, E1, B]

Propagates the given environment to self.

Propagates the given environment to self.

def absolve[E1 >: E, B](implicit ev: A <:< Either[E1, B]): ZSTM[R, E1, B]

Returns an effect that submerges the error case of an Either into the STM. The inverse operation of STM.either.

Returns an effect that submerges the error case of an Either into the STM. The inverse operation of STM.either.

def andThen[E1 >: E, B](that: ZSTM[A, E1, B]): ZSTM[R, E1, B]

Named alias for >>>.

Named alias for >>>.

def as[B](b: => B): ZSTM[R, E, B]

Maps the success value of this effect to the specified constant value.

Maps the success value of this effect to the specified constant value.

def asSome: ZSTM[R, E, Option[A]]

Maps the success value of this effect to an optional value.

Maps the success value of this effect to an optional value.

def asSomeError: ZSTM[R, Option[E], A]

Maps the error value of this effect to an optional value.

Maps the error value of this effect to an optional value.

def catchAll[R1 <: R, E2, A1 >: A](h: E => ZSTM[R1, E2, A1])(implicit ev: CanFail[E]): ZSTM[R1, E2, A1]

Recovers from all errors.

Recovers from all errors.

def catchSome[R1 <: R, E1 >: E, A1 >: A](pf: PartialFunction[E, ZSTM[R1, E1, A1]])(implicit ev: CanFail[E]): ZSTM[R1, E1, A1]

Recovers from some or all of the error cases.

Recovers from some or all of the error cases.

def collect[B](pf: PartialFunction[A, B]): ZSTM[R, E, B]

Simultaneously filters and maps the value produced by this effect.

Simultaneously filters and maps the value produced by this effect.

def collectM[R1 <: R, E1 >: E, B](pf: PartialFunction[A, ZSTM[R1, E1, B]]): ZSTM[R1, E1, B]

Simultaneously filters and flatMaps the value produced by this effect. Continues on the effect returned from pf.

Simultaneously filters and flatMaps the value produced by this effect. Continues on the effect returned from pf.

def commit: ZIO[R, E, A]

Commits this transaction atomically.

Commits this transaction atomically.

def commitEither: ZIO[R, E, A]

Commits this transaction atomically, regardless of whether the transaction is a success or a failure.

Commits this transaction atomically, regardless of whether the transaction is a success or a failure.

def compose[R1, E1 >: E](that: ZSTM[R1, E1, R]): ZSTM[R1, E1, A]

Named alias for <<<.

Named alias for <<<.

def either(implicit ev: CanFail[E]): URSTM[R, Either[E, A]]

Converts the failure channel into an Either.

Converts the failure channel into an Either.

def ensuring[R1 <: R](finalizer: ZSTM[R1, Nothing, Any]): ZSTM[R1, E, A]

Executes the specified finalization transaction whether or not this effect succeeds. Note that as with all STM transactions, if the full transaction fails, everything will be rolled back.

Executes the specified finalization transaction whether or not this effect succeeds. Note that as with all STM transactions, if the full transaction fails, everything will be rolled back.

def eventually(implicit ev: CanFail[E]): URSTM[R, A]

Returns an effect that ignores errors and runs repeatedly until it eventually succeeds.

Returns an effect that ignores errors and runs repeatedly until it eventually succeeds.

def filterOrDie(p: A => Boolean)(t: => Throwable): ZSTM[R, E, A]

Dies with specified Throwable if the predicate fails.

Dies with specified Throwable if the predicate fails.

def filterOrDieMessage(p: A => Boolean)(msg: => String): ZSTM[R, E, A]

Dies with a java.lang.RuntimeException having the specified text message if the predicate fails.

Dies with a java.lang.RuntimeException having the specified text message if the predicate fails.

def filterOrElse[R1 <: R, E1 >: E, A1 >: A](p: A => Boolean)(f: A => ZSTM[R1, E1, A1]): ZSTM[R1, E1, A1]

Applies f if the predicate fails.

Applies f if the predicate fails.

def filterOrElse_[R1 <: R, E1 >: E, A1 >: A](p: A => Boolean)(zstm: => ZSTM[R1, E1, A1]): ZSTM[R1, E1, A1]

Supplies zstm if the predicate fails.

Supplies zstm if the predicate fails.

def filterOrFail[E1 >: E](p: A => Boolean)(e: => E1): ZSTM[R, E1, A]

Fails with e if the predicate fails.

Fails with e if the predicate fails.

def flatMap[R1 <: R, E1 >: E, B](f: A => ZSTM[R1, E1, B]): ZSTM[R1, E1, B]

Feeds the value produced by this effect to the specified function, and then runs the returned effect as well to produce its results.

Feeds the value produced by this effect to the specified function, and then runs the returned effect as well to produce its results.

def flatMapError[R1 <: R, E2](f: E => ZSTM[R1, Nothing, E2])(implicit ev: CanFail[E]): ZSTM[R1, E2, A]

Creates a composite effect that represents this effect followed by another one that may depend on the error produced by this one.

Creates a composite effect that represents this effect followed by another one that may depend on the error produced by this one.

def flatten[R1 <: R, E1 >: E, B](implicit ev: A <:< ZSTM[R1, E1, B]): ZSTM[R1, E1, B]

Flattens out a nested STM effect.

Flattens out a nested STM effect.

def flattenErrorOption[E1, E2 <: E1](default: => E2)(implicit ev: E <:< Option[E1]): ZSTM[R, E1, A]

Unwraps the optional error, defaulting to the provided value.

Unwraps the optional error, defaulting to the provided value.

def flip(implicit ev: CanFail[E]): ZSTM[R, A, E]

Flips the success and failure channels of this transactional effect. This allows you to use all methods on the error channel, possibly before flipping back.

Flips the success and failure channels of this transactional effect. This allows you to use all methods on the error channel, possibly before flipping back.

def flipWith[R1, A1, E1](f: ZSTM[R, A, E] => ZSTM[R1, A1, E1]): ZSTM[R1, E1, A1]

Swaps the error/value parameters, applies the function f and flips the parameters back

Swaps the error/value parameters, applies the function f and flips the parameters back

def fold[B](f: E => B, g: A => B)(implicit ev: CanFail[E]): URSTM[R, B]

Folds over the STM effect, handling both failure and success, but not retry.

Folds over the STM effect, handling both failure and success, but not retry.

def foldM[R1 <: R, E1, B](f: E => ZSTM[R1, E1, B], g: A => ZSTM[R1, E1, B])(implicit ev: CanFail[E]): ZSTM[R1, E1, B]

Effectfully folds over the STM effect, handling both failure and success.

Effectfully folds over the STM effect, handling both failure and success.

def get[B](implicit ev1: E <:< Nothing, ev2: A <:< Option[B]): ZSTM[R, Option[Nothing], B]

Unwraps the optional success of this effect, but can fail with None value.

Unwraps the optional success of this effect, but can fail with None value.

def head[B](implicit ev: A <:< List[B]): ZSTM[R, Option[E], B]

Returns a successful effect with the head of the list if the list is non-empty or fails with the error None if the list is empty.

Returns a successful effect with the head of the list if the list is non-empty or fails with the error None if the list is empty.

def ignore: URSTM[R, Unit]

Returns a new effect that ignores the success or failure of this effect.

Returns a new effect that ignores the success or failure of this effect.

def isFailure: ZSTM[R, Nothing, Boolean]

Returns whether this transactional effect is a failure.

Returns whether this transactional effect is a failure.

def isSuccess: ZSTM[R, Nothing, Boolean]

Returns whether this transactional effect is a success.

Returns whether this transactional effect is a success.

def left[B, C](implicit ev: A <:< Either[B, C]): ZSTM[R, Option[E], B]

Returns a successful effect if the value is Left, or fails with the error None.

Returns a successful effect if the value is Left, or fails with the error None.

def leftOrFail[B, C, E1 >: E](e: => E1)(implicit ev: A <:< Either[B, C]): ZSTM[R, E1, B]

Returns a successful effect if the value is Left, or fails with the error e.

Returns a successful effect if the value is Left, or fails with the error e.

def leftOrFailException[B, C, E1 >: NoSuchElementException](implicit ev: A <:< Either[B, C], ev2: E <:< E1): ZSTM[R, E1, B]

Returns a successful effect if the value is Left, or fails with a java.util.NoSuchElementException.

Returns a successful effect if the value is Left, or fails with a java.util.NoSuchElementException.

def map[B](f: A => B): ZSTM[R, E, B]

Maps the value produced by the effect.

Maps the value produced by the effect.

def mapBoth[E2, B](f: E => E2, g: A => B)(implicit ev: CanFail[E]): ZSTM[R, E2, B]

Returns an STM effect whose failure and success channels have been mapped by the specified pair of functions, f and g.

Returns an STM effect whose failure and success channels have been mapped by the specified pair of functions, f and g.

def mapError[E1](f: E => E1)(implicit ev: CanFail[E]): ZSTM[R, E1, A]

Maps from one error type to another.

Maps from one error type to another.

def mapPartial[B](f: A => B)(implicit ev: E <:< Throwable): ZSTM[R, Throwable, B]

Maps the value produced by the effect with the specified function that may throw exceptions but is otherwise pure, translating any thrown exceptions into typed failed effects.

Maps the value produced by the effect with the specified function that may throw exceptions but is otherwise pure, translating any thrown exceptions into typed failed effects.

def merge[A1 >: A](implicit ev1: E <:< A1, ev2: CanFail[E]): URSTM[R, A1]

Returns a new effect where the error channel has been merged into the success channel to their common combined type.

Returns a new effect where the error channel has been merged into the success channel to their common combined type.

def none[B](implicit ev: A <:< Option[B]): ZSTM[R, Option[E], Unit]

Requires the option produced by this value to be None.

Requires the option produced by this value to be None.

def onFirst[R1 <: R]: ZSTM[R1, E, (A, R1)]

Propagates the success value to the first element of a tuple, but passes the effect input R along unmodified as the second element of the tuple.

Propagates the success value to the first element of a tuple, but passes the effect input R along unmodified as the second element of the tuple.

def onLeft[C]: ZSTM[Either[R, C], E, Either[A, C]]

Returns this effect if environment is on the left, otherwise returns whatever is on the right unmodified. Note that the result is lifted in either.

Returns this effect if environment is on the left, otherwise returns whatever is on the right unmodified. Note that the result is lifted in either.

def onRight[C]: ZSTM[Either[C, R], E, Either[C, A]]

Returns this effect if environment is on the right, otherwise returns whatever is on the left unmodified. Note that the result is lifted in either.

Returns this effect if environment is on the right, otherwise returns whatever is on the left unmodified. Note that the result is lifted in either.

def onSecond[R1 <: R]: ZSTM[R1, E, (R1, A)]

Propagates the success value to the second element of a tuple, but passes the effect input R along unmodified as the first element of the tuple.

Propagates the success value to the second element of a tuple, but passes the effect input R along unmodified as the first element of the tuple.

def option(implicit ev: CanFail[E]): URSTM[R, Option[A]]

Converts the failure channel into an Option.

Converts the failure channel into an Option.

def optional[E1](implicit ev: E <:< Option[E1]): ZSTM[R, E1, Option[A]]

Converts an option on errors into an option on values.

Converts an option on errors into an option on values.

def orDie(implicit ev1: E <:< Throwable, ev2: CanFail[E]): URSTM[R, A]

Translates STM effect failure into death of the fiber, making all failures unchecked and not a part of the type of the effect.

Translates STM effect failure into death of the fiber, making all failures unchecked and not a part of the type of the effect.

def orDieWith(f: E => Throwable)(implicit ev: CanFail[E]): URSTM[R, A]

Keeps none of the errors, and terminates the fiber running the STM effect with them, using the specified function to convert the E into a Throwable.

Keeps none of the errors, and terminates the fiber running the STM effect with them, using the specified function to convert the E into a Throwable.

def orElse[R1 <: R, E1, A1 >: A](that: => ZSTM[R1, E1, A1]): ZSTM[R1, E1, A1]

Named alias for <>.

Named alias for <>.

def orElseEither[R1 <: R, E1, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, Either[A, B]]

Returns a transactional effect that will produce the value of this effect in left side, unless it fails or retries, in which case, it will produce the value of the specified effect in right side.

Returns a transactional effect that will produce the value of this effect in left side, unless it fails or retries, in which case, it will produce the value of the specified effect in right side.

def orElseFail[E1](e1: => E1): ZSTM[R, E1, A]

Tries this effect first, and if it fails or retries, fails with the specified error.

Tries this effect first, and if it fails or retries, fails with the specified error.

def orElseOptional[R1 <: R, E1, A1 >: A](that: => ZSTM[R1, Option[E1], A1])(implicit ev: E <:< Option[E1]): ZSTM[R1, Option[E1], A1]

Returns an effect that will produce the value of this effect, unless it fails with the None value, in which case it will produce the value of the specified effect.

Returns an effect that will produce the value of this effect, unless it fails with the None value, in which case it will produce the value of the specified effect.

def orElseSucceed[A1 >: A](a1: => A1): URSTM[R, A1]

Tries this effect first, and if it fails or retries, succeeds with the specified value.

Tries this effect first, and if it fails or retries, succeeds with the specified value.

def orTry[R1 <: R, E1 >: E, A1 >: A](that: => ZSTM[R1, E1, A1]): ZSTM[R1, E1, A1]

Named alias for <|>.

Named alias for <|>.

def provide(r: R): STM[E, A]

Provides the transaction its required environment, which eliminates its dependency on R.

Provides the transaction its required environment, which eliminates its dependency on R.

def provideSome[R0](f: R0 => R): ZSTM[R0, E, A]

Provides some of the environment required to run this effect, leaving the remainder R0.

Provides some of the environment required to run this effect, leaving the remainder R0.

def refineOrDie[E1](pf: PartialFunction[E, E1])(implicit ev1: E <:< Throwable, ev2: CanFail[E]): ZSTM[R, E1, A]

Keeps some of the errors, and terminates the fiber with the rest.

Keeps some of the errors, and terminates the fiber with the rest.

def refineOrDieWith[E1](pf: PartialFunction[E, E1])(f: E => Throwable)(implicit ev: CanFail[E]): ZSTM[R, E1, A]

Keeps some of the errors, and terminates the fiber with the rest, using the specified function to convert the E into a Throwable.

Keeps some of the errors, and terminates the fiber with the rest, using the specified function to convert the E into a Throwable.

def reject[E1 >: E](pf: PartialFunction[A, E1]): ZSTM[R, E1, A]

Fail with the returned value if the PartialFunction matches, otherwise continue with our held value.

Fail with the returned value if the PartialFunction matches, otherwise continue with our held value.

def rejectM[R1 <: R, E1 >: E](pf: PartialFunction[A, ZSTM[R1, E1, E1]]): ZSTM[R1, E1, A]

Continue with the returned computation if the PartialFunction matches, translating the successful match into a failure, otherwise continue with our held value.

Continue with the returned computation if the PartialFunction matches, translating the successful match into a failure, otherwise continue with our held value.

def repeatUntil(f: A => Boolean): ZSTM[R, E, A]

Repeats this STM effect until its result satisfies the specified predicate. '''WARNING''': repeatUntil uses a busy loop to repeat the effect and will consume a thread until it completes (it cannot yield). This is because STM describes a single atomic transaction which must either complete, retry or fail a transaction before yielding back to the ZIO Runtime.

Repeats this STM effect until its result satisfies the specified predicate. '''WARNING''': repeatUntil uses a busy loop to repeat the effect and will consume a thread until it completes (it cannot yield). This is because STM describes a single atomic transaction which must either complete, retry or fail a transaction before yielding back to the ZIO Runtime.

  • Use retryUntil instead if you don't need to maintain transaction state for repeats.
  • Ensure repeating the STM effect will eventually satisfy the predicate.
  • Consider using the Blocking thread pool for execution of the transaction.
def repeatWhile(f: A => Boolean): ZSTM[R, E, A]

Repeats this STM effect while its result satisfies the specified predicate. '''WARNING''': repeatWhile uses a busy loop to repeat the effect and will consume a thread until it completes (it cannot yield). This is because STM describes a single atomic transaction which must either complete, retry or fail a transaction before yielding back to the ZIO Runtime.

Repeats this STM effect while its result satisfies the specified predicate. '''WARNING''': repeatWhile uses a busy loop to repeat the effect and will consume a thread until it completes (it cannot yield). This is because STM describes a single atomic transaction which must either complete, retry or fail a transaction before yielding back to the ZIO Runtime.

  • Use retryWhile instead if you don't need to maintain transaction state for repeats.
  • Ensure repeating the STM effect will eventually not satisfy the predicate.
  • Consider using the Blocking thread pool for execution of the transaction.
def retryUntil(f: A => Boolean): ZSTM[R, E, A]

Filters the value produced by this effect, retrying the transaction until the predicate returns true for the value.

Filters the value produced by this effect, retrying the transaction until the predicate returns true for the value.

def retryWhile(f: A => Boolean): ZSTM[R, E, A]

Filters the value produced by this effect, retrying the transaction while the predicate returns true for the value.

Filters the value produced by this effect, retrying the transaction while the predicate returns true for the value.

def right[B, C](implicit ev: A <:< Either[B, C]): ZSTM[R, Option[E], C]

Returns a successful effect if the value is Right, or fails with the error None.

Returns a successful effect if the value is Right, or fails with the error None.

def rightOrFail[B, C, E1 >: E](e: => E1)(implicit ev: A <:< Either[B, C]): ZSTM[R, E1, C]

Returns a successful effect if the value is Right, or fails with the given error 'e'.

Returns a successful effect if the value is Right, or fails with the given error 'e'.

def rightOrFailException[B, C, E1 >: NoSuchElementException](implicit ev: A <:< Either[B, C], ev2: E <:< E1): ZSTM[R, E1, C]

Returns a successful effect if the value is Right, or fails with a java.util.NoSuchElementException.

Returns a successful effect if the value is Right, or fails with a java.util.NoSuchElementException.

def some[B](implicit ev: A <:< Option[B]): ZSTM[R, Option[E], B]

Converts an option on values into an option on errors.

Converts an option on values into an option on errors.

def someOrElse[B](default: => B)(implicit ev: A <:< Option[B]): ZSTM[R, E, B]

Extracts the optional value, or returns the given 'default'.

Extracts the optional value, or returns the given 'default'.

def someOrElseM[B, R1 <: R, E1 >: E](default: ZSTM[R1, E1, B])(implicit ev: A <:< Option[B]): ZSTM[R1, E1, B]

Extracts the optional value, or executes the effect 'default'.

Extracts the optional value, or executes the effect 'default'.

def someOrFail[B, E1 >: E](e: => E1)(implicit ev: A <:< Option[B]): ZSTM[R, E1, B]

Extracts the optional value, or fails with the given error 'e'.

Extracts the optional value, or fails with the given error 'e'.

def someOrFailException[B, E1 >: E](implicit ev: A <:< Option[B], ev2: NoSuchElementException <:< E1): ZSTM[R, E1, B]

Extracts the optional value, or fails with a java.util.NoSuchElementException

Extracts the optional value, or fails with a java.util.NoSuchElementException

def summarized[R1 <: R, E1 >: E, B, C](summary: ZSTM[R1, E1, B])(f: (B, B) => C): ZSTM[R1, E1, (C, A)]

Summarizes a STM effect by computing a provided value before and after execution, and then combining the values to produce a summary, together with the result of execution.

Summarizes a STM effect by computing a provided value before and after execution, and then combining the values to produce a summary, together with the result of execution.

def tap[R1 <: R, E1 >: E](f: A => ZSTM[R1, E1, Any]): ZSTM[R1, E1, A]

"Peeks" at the success of transactional effect.

"Peeks" at the success of transactional effect.

def tapBoth[R1 <: R, E1 >: E](f: E => ZSTM[R1, E1, Any], g: A => ZSTM[R1, E1, Any])(implicit ev: CanFail[E]): ZSTM[R1, E1, A]

"Peeks" at both sides of an transactional effect.

"Peeks" at both sides of an transactional effect.

def tapError[R1 <: R, E1 >: E](f: E => ZSTM[R1, E1, Any])(implicit ev: CanFail[E]): ZSTM[R1, E1, A]

"Peeks" at the error of the transactional effect.

"Peeks" at the error of the transactional effect.

def unit: ZSTM[R, E, Unit]

Maps the success value of this effect to unit.

Maps the success value of this effect to unit.

def unless(b: => Boolean): ZSTM[R, E, Unit]

The moral equivalent of if (!p) exp

The moral equivalent of if (!p) exp

def unlessM[R1 <: R, E1 >: E](b: ZSTM[R1, E1, Boolean]): ZSTM[R1, E1, Unit]

The moral equivalent of if (!p) exp when p has side-effects

The moral equivalent of if (!p) exp when p has side-effects

final def updateService[M]: UpdateService[R, E, A, M]

Updates a service in the environment of this effect.

Updates a service in the environment of this effect.

def when(b: => Boolean): ZSTM[R, E, Unit]

The moral equivalent of if (p) exp

The moral equivalent of if (p) exp

def whenM[R1 <: R, E1 >: E](b: ZSTM[R1, E1, Boolean]): ZSTM[R1, E1, Unit]

The moral equivalent of if (p) exp when p has side-effects

The moral equivalent of if (p) exp when p has side-effects

def withFilter(f: A => Boolean): ZSTM[R, E, A]

Same as retryUntil.

Same as retryUntil.

def zip[R1 <: R, E1 >: E, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, (A, B)]

Named alias for <*>.

Named alias for <*>.

def zipLeft[R1 <: R, E1 >: E, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, A]

Named alias for <*.

Named alias for <*.

def zipRight[R1 <: R, E1 >: E, B](that: => ZSTM[R1, E1, B]): ZSTM[R1, E1, B]

Named alias for *>.

Named alias for *>.

def zipWith[R1 <: R, E1 >: E, B, C](that: => ZSTM[R1, E1, B])(f: (A, B) => C): ZSTM[R1, E1, C]

Sequentially zips this value with the specified one, combining the values using the specified combiner function.

Sequentially zips this value with the specified one, combining the values using the specified combiner function.

def |||[R1, E1 >: E, A1 >: A](that: ZSTM[R1, E1, A1]): ZSTM[Either[R, R1], E1, A1]

Depending on provided environment returns either this one or the other effect.

Depending on provided environment returns either this one or the other effect.

Deprecated methods

@deprecated("use mapBoth", "2.0.0")
def bimap[E2, B](f: E => E2, g: A => B)(implicit ev: CanFail[E]): ZSTM[R, E2, B]

Returns an STM effect whose failure and success channels have been mapped by the specified pair of functions, f and g.

Returns an STM effect whose failure and success channels have been mapped by the specified pair of functions, f and g.

Deprecated
@deprecated("Repeating until failure doesn\'t make sense in the context of STM because it will always roll back the transaction", "1.0.2")
def forever: ZSTM[R, E, Nothing]

Repeats this effect forever (until the first error). '''WARNING''': forever uses a busy loop to repeat the effect and will consume a thread until it fails. This is because STM describes a single atomic transaction, and so must either complete, retry or fail a transaction before yielding back to the ZIO Runtime.

Repeats this effect forever (until the first error). '''WARNING''': forever uses a busy loop to repeat the effect and will consume a thread until it fails. This is because STM describes a single atomic transaction, and so must either complete, retry or fail a transaction before yielding back to the ZIO Runtime.

  • Ensure repeating the STM effect will eventually fail.
  • Consider using the Blocking thread pool for execution of the transaction.
Deprecated