Control.Concurrent.PostMessAge

Mechanism to get messages sent to a Handle concurrently without getting them mixed. They are sent to the handle in the same order they are received by a passer object (see Passer), not sending a message before the previous message is sent completely.

Passer type

data Passer a

The Passer is the object that you send the messages to. It will redirect this message to its attached Handle, making sure the messages are not intercalated. Use postMessage to send message to a passer object.

Open/Close a passer

createPasser

Arguments

:: Handle

Handle to use

-> (Handle -> a -> IO ())

-> IO (Passer a)

Create a passer object from a Handle and a function to send values to that handle.

closePasser :: Passer a -> IO ()

Close a passer object, so it won't receive any more messages in the future. Once a passer object is closed, it can't be opened again. If you want to reuse a handle, create another passer object with createPasser.

Send messages to the passer

postMessage :: Passer a -> a -> IO Bool

Send a message to a passer object. It returns a value indicating if the message reached the passer object.

Check passer status

isPasserClosed :: Passer a -> IO Bool

Check if a passer object is closed. When a passer object is closed, it won't send any more messages to its attached handle. This does not mean the handle itself is closed.

isPasserOpen :: Passer a -> IO Bool

Check if a passer object is open. While a passer object is open, all the messages received by the passer are sent to its attached handle.