| Safe Haskell | None |
|---|
Data.Conduit.TQueue
Contents
Description
Contains a simple source and sink linking together conduits in
different threads. For extended examples of usage and bottlenecks
see TMChan.
TQueue is an amoritized FIFO queue behaves like TChan, with two important differences:
- it's faster (but amortized thus the cost of individual operations may vary a lot)
- it doesn't provide equivalent of the dupTChan and cloneTChan operations
Here is short description of data structures:
- TQueue - unbounded infinite queue
- TBQueue - bounded infinite queue
- TMQueue - unbounded finite (closable) queue
- TBMQueue - bounded finite (closable) queue
Caveats
Infinite operations means that source doesn't know when stream is ended so one need to use other methods of finishing stream like sending an exception or finish conduit in downstream.
- sourceTQueue :: MonadIO m => TQueue a -> Source m a
- sinkTQueue :: MonadIO m => TQueue a -> Sink a m ()
- sourceTBQueue :: MonadIO m => TBQueue a -> Source m a
- sinkTBQueue :: MonadIO m => TBQueue a -> Sink a m ()
- sourceTMQueue :: MonadIO m => TMQueue a -> Source m a
- sinkTMQueue :: MonadIO m => TMQueue a -> Bool -> Sink a m ()
- sourceTBMQueue :: MonadIO m => TBMQueue a -> Source m a
- sinkTBMQueue :: MonadIO m => TBMQueue a -> Bool -> Sink a m ()
- module Control.Concurrent.STM.TQueue
Connectors
Infinite queues
sourceTQueue :: MonadIO m => TQueue a -> Source m aSource
A simple wrapper around a TQueue. As data is pushed into the queue, the source will read it and pass it down the conduit pipeline.
sinkTQueue :: MonadIO m => TQueue a -> Sink a m ()Source
A simple wrapper around a TQueue. As data is pushed into this sink, it will magically begin to appear in the queue.
TBQueue connectors
sourceTBQueue :: MonadIO m => TBQueue a -> Source m aSource
A simple wrapper around a TBQueue. As data is pushed into the queue, the source will read it and pass it down the conduit pipeline.
sinkTBQueue :: MonadIO m => TBQueue a -> Sink a m ()Source
A simple wrapper around a TBQueue. As data is pushed into this sink, it will magically begin to appear in the queue. Boolean argument is used to specify if queue should be closed when the sink is closed.
Closable queues
TMQueue connectors
sourceTMQueue :: MonadIO m => TMQueue a -> Source m aSource
A simple wrapper around a TMQueue. As data is pushed into the queue, the source will read it and pass it down the conduit pipeline. When the queue is closed, the source will close also.
Arguments
| :: MonadIO m | |
| => TMQueue a | |
| -> Bool | Should the queue be closed when the sink is closed? |
| -> Sink a m () |
A simple wrapper around a TMQueue. As data is pushed into this sink, it will magically begin to appear in the queue.
TBMQueue connectors
sourceTBMQueue :: MonadIO m => TBMQueue a -> Source m aSource
A simple wrapper around a TBMQueue. As data is pushed into the queue, the source will read it and pass it down the conduit pipeline. When the queue is closed, the source will close also.