|Maintainer||Bas van Dijk <email@example.com> , Roel van Dijk <firstname.lastname@example.org>|
Standard threads extended with the ability to wait for their termination.
This module exports equivalently named functions from
GHC.Conc). Avoid ambiguities by importing this module qualified. May
import qualified Control.Concurrent.Thread as Thread ( ... )
The following is an example how to use this module:
The new thread will be a lightweight thread; if you want to use a foreign
library that uses thread-local storage, use
GHC note: the new thread inherits the blocked state of the parent (see
forkOS instead of
forkIO makes no difference at all to the scheduling
behaviour of the Haskell runtime system. It is a common misconception that you
need to use
forkOS instead of
forkIO to avoid blocking all the Haskell
threads when making a foreign call; this isn't the case. To allow foreign calls
to be made without blocking all the Haskell threads (with GHC), it is only
necessary to use the
-threaded option when linking your program, and to make
sure the foreign import is not marked
forkIO, but lets you specify on which CPU the thread is
created. Unlike a
forkIO thread, a thread created by
will stay on the same CPU for its entire lifetime (
can migrate between CPUs according to the scheduling policy).
forkOnIO is useful for overriding the scheduling policy when you
know in advance how best to distribute the threads.
Int argument specifies the CPU number; it is interpreted modulo
numCapabilities (note that it actually specifies a capability number
rather than a CPU number, but to a first approximation the two are
A result of a thread is either some exception that was thrown in the thread and wasn't catched or the actual value that was returned by the thread.