core.thread

this(T def = T.init);

Initializes thread local storage for the indicated value which will be initialized to def for all threads.

Params:

def	The default value to return if no value has been explicitly set.

T val();

Gets the value last set by the calling thread, or def if no such value has been set.

Returns:
The stored value or def if no value is stored.

T val(T newval);

Copies newval to a location specific to the calling thread, and returns newval.

Params:

T newval

The value to set.

Returns:
The value passed to this function.

final Thread create(void function() fn);

Creates and starts a new Thread object that executes fn and adds it to the list of tracked threads.

Params:

void function() fn

The thread function.

Returns:
A reference to the newly created thread.

final Thread create(void delegate() dg);

Creates and starts a new Thread object that executes dg and adds it to the list of tracked threads.

Params:

void delegate() dg

The thread function.

Returns:
A reference to the newly created thread.

final void add(Thread t);

Add t to the list of tracked threads if it is not already being tracked.

Params:

Thread t

The thread to add.

In:
t must not be null.

final void remove(Thread t);

Removes t from the list of tracked threads. No operation will be performed if t is not currently being tracked by this object.

Params:

Thread t

The thread to remove.

In:
t must not be null.

final int opApply(int delegate(ref Thread) dg);

Operates on all threads currently tracked by this object.

final void joinAll(bool rethrow = true);

Iteratively joins all tracked threads. This function will block add, remove, and opApply until it completes.

Params:

bool rethrow

Rethrow any unhandled exception which may have caused the current thread to terminate.

Throws:
Any exception not handled by the joined threads.

 class DerivedFiber : Fiber
 {
     this()
     {
         super( &run );
     }

 private :
     void run()
     {
         printf( "Derived fiber running.\n" );
     }
 }

 void fiberFunc()
 {
     printf( "Composed fiber running.\n" );
     Fiber.yield();
     printf( "Composed fiber running.\n" );
 }

 // create instances of each type
 Fiber derived = new DerivedFiber();
 Fiber composed = new Fiber( &fiberFunc );

 // call both fibers once
 derived.call();
 composed.call();
 printf( "Execution returned to calling context.\n" );
 composed.call();

 // since each fiber has run to completion, each should have state TERM
 assert( derived.state == Fiber.State.TERM );
 assert( composed.state == Fiber.State.TERM );

this(void function() fn, size_t sz = PAGESIZE);

Initializes a fiber object which is associated with a static D function.

Params:

void function() fn	The thread function.
size_t sz	The stack size for this fiber.

In:
fn must not be null.

this(void delegate() dg, size_t sz = PAGESIZE);

Initializes a fiber object which is associated with a dynamic D function.

Params:

void delegate() dg	The thread function.
size_t sz	The stack size for this fiber.

In:
dg must not be null.

final Object call(bool rethrow = true);

Transfers execution to this fiber object. The calling context will be suspended until the fiber calls Fiber.yield() or until it terminates via an unhandled exception.

Params:

bool rethrow

Rethrow any unhandled exception which may have caused this fiber to terminate.

In:
This fiber must be in state HOLD.

Throws:
Any exception not handled by the joined thread.

Returns:
Any exception not handled by this fiber if rethrow = false, null otherwise.

final void reset();

Resets this fiber so that it may be re-used. This routine may only be called for fibers that have terminated, as doing otherwise could result in scope-dependent functionality that is not executed. Stack-based classes, for example, may not be cleaned up properly if a fiber is reset before it has terminated.

In:
This fiber must be in state TERM.

enum State;

A fiber may occupy one of three states: HOLD, EXEC, and TERM. The HOLD state applies to any fiber that is suspended and ready to be called. The EXEC state will be set for any fiber that is currently executing. And the TERM state is set when a fiber terminates. Once a fiber terminates, it must be reset before it may be called again.

HOLD

EXEC

TERM

final State state();

Gets the current state of this fiber.

Returns:
The state of this fiber as an enumerated value.

static void yield();

Forces a context switch to occur away from the calling fiber.

static void yieldAndThrow(Object obj);

Forces a context switch to occur away from the calling fiber and then throws obj in the calling fiber.

Params:

Object obj

The object to throw.

In:
obj must not be null.

static Fiber getThis();

Provides a reference to the calling fiber or null if no fiber is currently active.

Returns:
The fiber object representing the calling fiber or null if no fiber is currently active. The result of deleting this object is undefined.