Control.Monad.ST.Safe (original) (raw)

Contents

• The ST Monad
• Converting ST to IO

Description

Deprecated: Safe is now the default, please use Control.Monad.ST instead

This library provides support for strict state threads, as described in the PLDI '94 paper by John Launchbury and Simon Peyton Jones Lazy Functional State Threads.

Safe API Only.

Synopsis

• data ST s a
• runST :: (forall s. ST s a) -> a
• fixST :: (a -> ST s a) -> ST s a
• data RealWorld
• stToIO :: ST RealWorld a -> IO a

The ST Monad

data ST s a Source #

The strict [ST](Control-Monad-ST-Safe.html#t:ST "Control.Monad.ST.Safe") monad. The [ST](Control-Monad-ST-Safe.html#t:ST "Control.Monad.ST.Safe") monad allows for destructive updates, but is escapable (unlike IO). A computation of type `[ST](Control-Monad-ST-Safe.html#t:ST "Control.Monad.ST.Safe")` s a returns a value of type a, and execute in "thread" s. The s parameter is either

• an uninstantiated type variable (inside invocations of [runST](Control-Monad-ST-Safe.html#v:runST "Control.Monad.ST.Safe")), or
• [RealWorld](Control-Monad-ST-Safe.html#t:RealWorld "Control.Monad.ST.Safe") (inside invocations of [stToIO](Control-Monad-ST.html#v:stToIO "Control.Monad.ST")).

It serves to keep the internal states of different invocations of [runST](Control-Monad-ST-Safe.html#v:runST "Control.Monad.ST.Safe") separate from each other and from invocations of[stToIO](Control-Monad-ST.html#v:stToIO "Control.Monad.ST").

The [>>=](Control-Monad.html#v:-62--62--61- "Control.Monad") and [>>](Control-Monad.html#v:-62--62- "Control.Monad") operations are strict in the state (though not in values stored in the state). For example,

[runST](Control-Monad-ST-Safe.html#v:runST "Control.Monad.ST.Safe") (writeSTRef | v >>= f) = |

runST :: (forall s. ST s a) -> a Source #

Return the value computed by a state thread. The forall ensures that the internal state used by the [ST](Control-Monad-ST-Safe.html#t:ST "Control.Monad.ST.Safe") computation is inaccessible to the rest of the program.

fixST :: (a -> ST s a) -> ST s a Source #

Allow the result of an [ST](Control-Monad-ST-Safe.html#t:ST "Control.Monad.ST.Safe") computation to be used (lazily) inside the computation.

Note that if f is strict, `[fixST](Control-Monad-ST-Safe.html#v:fixST "Control.Monad.ST.Safe")` f = _|_.

Converting ST to IO

data RealWorld Source #

RealWorld is deeply magical. It is primitive, but it is not_unlifted_ (hence ptrArg). We never manipulate values of typeRealWorld; it's only used in the type system, to parameterise State#.

stToIO :: ST RealWorld a -> IO a Source #

Embed a strict state thread in an [IO](System-IO.html#t:IO "System.IO") action. The [RealWorld](Control-Monad-ST-Safe.html#t:RealWorld "Control.Monad.ST.Safe") parameter indicates that the internal state used by the [ST](Control-Monad-ST-Safe.html#t:ST "Control.Monad.ST.Safe") computation is a special one supplied by the [IO](System-IO.html#t:IO "System.IO") monad, and thus distinct from those used by invocations of [runST](Control-Monad-ST-Safe.html#v:runST "Control.Monad.ST.Safe").