effects-thread-0.1: Thread effects
Safe HaskellNone
LanguageGHC2021

Effects.Concurrent.Thread

Description

Provides the MonadThread typeclass.

Since: 0.1

Synopsis

Thread Effect

class Monad m => MonadThread (m :: Type -> Type) where Source #

Represents thread effects.

Since: 0.1

Methods

threadDelay :: Int -> m () Source #

Lifted threadDelay.

Since: 0.1

throwTo :: (Exception e, HasCallStack) => ThreadId -> e -> m () Source #

Lifted throwTo.

Since: 0.1

getNumCapabilities :: m Int Source #

Lifted getNumCapabilities.

Since: 0.1

setNumCapabilities :: Int -> m () Source #

Lifted setNumCapabilities.

Since: 0.1

threadCapability :: ThreadId -> m (Int, Bool) Source #

Lifted threadCapability.

Since: 0.1

myThreadId :: m ThreadId Source #

Lifted myThreadId.

Since: 0.1

labelThread :: ThreadId -> String -> m () Source #

Lifted labelThread.

Since: 0.1

threadLabel :: ThreadId -> m (Maybe String) Source #

Lifted threadLabel.

Since: 0.1

microsleep :: (HasCallStack, MonadThread m) => Natural -> m () Source #

threadDelay in terms of unbounded Natural rather than Int i.e. runs sleep in the current thread for the specified number of microseconds.

Since: 0.1

sleep :: (HasCallStack, MonadThread m) => Natural -> m () Source #

Runs sleep in the current thread for the specified number of seconds.

Since: 0.1

Reexports

data Natural #

Natural number

Invariant: numbers <= 0xffffffffffffffff use the NS constructor

Instances

Instances details
Data Natural

Since: base-4.8.0.0

Instance details

Defined in Data.Data

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Natural -> c Natural #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Natural #

toConstr :: Natural -> Constr #

dataTypeOf :: Natural -> DataType #

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c Natural) #

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Natural) #

gmapT :: (forall b. Data b => b -> b) -> Natural -> Natural #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Natural -> r #

gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Natural -> r #

gmapQ :: (forall d. Data d => d -> u) -> Natural -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> Natural -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> Natural -> m Natural #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Natural -> m Natural #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Natural -> m Natural #

Bits Natural

Since: base-4.8.0

Instance details

Defined in GHC.Bits

Enum Natural

Since: base-4.8.0.0

Instance details

Defined in GHC.Enum

Ix Natural

Since: base-4.8.0.0

Instance details

Defined in GHC.Ix

Num Natural

Note that Natural's Num instance isn't a ring: no element but 0 has an additive inverse. It is a semiring though.

Since: base-4.8.0.0

Instance details

Defined in GHC.Num

Read Natural

Since: base-4.8.0.0

Instance details

Defined in GHC.Read

Integral Natural

Since: base-4.8.0.0

Instance details

Defined in GHC.Real

Real Natural

Since: base-4.8.0.0

Instance details

Defined in GHC.Real

Show Natural

Since: base-4.8.0.0

Instance details

Defined in GHC.Show

PrintfArg Natural

Since: base-4.8.0.0

Instance details

Defined in Text.Printf

Eq Natural 
Instance details

Defined in GHC.Num.Natural

Methods

(==) :: Natural -> Natural -> Bool #

(/=) :: Natural -> Natural -> Bool #

Ord Natural 
Instance details

Defined in GHC.Num.Natural

KnownNat n => HasResolution (n :: Nat)

For example, Fixed 1000 will give you a Fixed with a resolution of 1000.

Instance details

Defined in Data.Fixed

Methods

resolution :: p n -> Integer #

TestCoercion SNat

Since: base-4.18.0.0

Instance details

Defined in GHC.TypeNats

Methods

testCoercion :: forall (a :: Nat) (b :: Nat). SNat a -> SNat b -> Maybe (Coercion a b) #

TestEquality SNat

Since: base-4.18.0.0

Instance details

Defined in GHC.TypeNats

Methods

testEquality :: forall (a :: Nat) (b :: Nat). SNat a -> SNat b -> Maybe (a :~: b) #

type Compare (a :: Natural) (b :: Natural) 
Instance details

Defined in Data.Type.Ord

type Compare (a :: Natural) (b :: Natural) = CmpNat a b

data ThreadId #

A ThreadId is an abstract type representing a handle to a thread. ThreadId is an instance of Eq, Ord and Show, where the Ord instance implements an arbitrary total ordering over ThreadIds. The Show instance lets you convert an arbitrary-valued ThreadId to string form; showing a ThreadId value is occasionally useful when debugging or diagnosing the behaviour of a concurrent program.

Note: in GHC, if you have a ThreadId, you essentially have a pointer to the thread itself. This means the thread itself can't be garbage collected until you drop the ThreadId. This misfeature would be difficult to correct while continuing to support threadStatus.

Instances

Instances details
Show ThreadId

Since: base-4.2.0.0

Instance details

Defined in GHC.Conc.Sync

Eq ThreadId

Since: base-4.2.0.0

Instance details

Defined in GHC.Conc.Sync

Ord ThreadId

Since: base-4.2.0.0

Instance details

Defined in GHC.Conc.Sync

QSem Effect

class Monad m => MonadQSem (m :: Type -> Type) where Source #

Effect for QSem semaphore.

Since: 0.1

Methods

newQSem :: Int -> m QSem Source #

Lifted newQSem.

Since: 0.1

waitQSem :: QSem -> m () Source #

Lifted waitQSem.

Since: 0.1

signalQSem :: QSem -> m () Source #

Lifted signalQSem.

Since: 0.1

Instances

Instances details
MonadQSem IO Source #

Since: 0.1

Instance details

Defined in Effects.Concurrent.Thread

MonadQSem m => MonadQSem (ReaderT e m) Source #

Since: 0.1

Instance details

Defined in Effects.Concurrent.Thread

Methods

newQSem :: Int -> ReaderT e m QSem Source #

waitQSem :: QSem -> ReaderT e m () Source #

signalQSem :: QSem -> ReaderT e m () Source #

class Monad m => MonadQSemN (m :: Type -> Type) where Source #

Effect for QSemN semaphore.

Since: 0.1

Methods

newQSemN :: Int -> m QSemN Source #

Lifted newQSemN.

Since: 0.1

waitQSemN :: QSemN -> Int -> m () Source #

Lifted waitQSemN.

Since: 0.1

signalQSemN :: QSemN -> Int -> m () Source #

Lifted signalQSemN.

Since: 0.1

Instances

Instances details
MonadQSemN IO Source #

Since: 0.1

Instance details

Defined in Effects.Concurrent.Thread

MonadQSemN m => MonadQSemN (ReaderT e m) Source #

Since: 0.1

Instance details

Defined in Effects.Concurrent.Thread

Methods

newQSemN :: Int -> ReaderT e m QSemN Source #

waitQSemN :: QSemN -> Int -> ReaderT e m () Source #

signalQSemN :: QSemN -> Int -> ReaderT e m () Source #

Reexports

data QSem #

QSem is a quantity semaphore in which the resource is acquired and released in units of one. It provides guaranteed FIFO ordering for satisfying blocked waitQSem calls.

The pattern

  bracket_ waitQSem signalQSem (...)

is safe; it never loses a unit of the resource.

data QSemN #

QSemN is a quantity semaphore in which the resource is acquired and released in units of one. It provides guaranteed FIFO ordering for satisfying blocked waitQSemN calls.

The pattern

  bracket_ (waitQSemN n) (signalQSemN n) (...)

is safe; it never loses any of the resource.