View source code
Display the source code in core/thread/osthread.d from which this page was generated on github.
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Class core.thread.osthread.Thread

This class encapsulates all threading functionality for the D programming language. As thread manipulation is a required facility for garbage collection, all user threads should derive from this class, and instances of this class should never be explicitly deleted. A new thread may be created using either derivation or composition, as in the following example.

class Thread
  : ThreadBase ;

Constructors

NameDescription
this (fn, sz) Initializes a thread object which is associated with a static D function.
this (dg, sz) Initializes a thread object which is associated with a dynamic D function.

Properties

NameTypeDescription
isRunning[get] boolTests whether this thread is running.
priority[get] intGets the scheduling priority for the associated thread.
priority[set] intSets the scheduling priority for the associated thread.
PRIORITY_DEFAULT[get] intThe default scheduling priority that is set for a thread. On systems where multiple scheduling policies are defined, this value represents the default priority for the scheduling policy of the process.
PRIORITY_MAX[get] const(int)The maximum scheduling priority that may be set for a thread. On systems where multiple scheduling policies are defined, this value represents the maximum valid priority for the scheduling policy of the process.
PRIORITY_MIN[get] intThe minimum scheduling priority that may be set for a thread. On systems where multiple scheduling policies are defined, this value represents the minimum valid priority for the scheduling policy of the process.
id[get] ulongGets the OS identifier for this thread.
isDaemon[get] boolGets the daemon status for this thread. While the runtime will wait for all normal threads to complete before tearing down the process, daemon threads are effectively ignored and thus will not prevent the process from terminating. In effect, daemon threads will be terminated automatically by the OS when the process exits.
isDaemon[set] boolSets the daemon status for this thread. While the runtime will wait for all normal threads to complete before tearing down the process, daemon threads are effectively ignored and thus will not prevent the process from terminating. In effect, daemon threads will be terminated automatically by the OS when the process exits.
isMainThread[get] boolTests whether this thread is the main thread, i.e. the thread that initialized the runtime
name[get] stringGets the user-readable label for this thread.
name[set] stringSets the user-readable label for this thread.

Methods

NameDescription
getThis () Provides a reference to the calling thread.
join (rethrow) Waits for this thread to complete. If the thread terminated as the result of an unhandled exception, this exception will be rethrown.
sleep (val) Suspends the calling thread for at least the supplied period. This may result in multiple OS calls if period is greater than the maximum sleep duration supported by the operating system.
start () Starts the thread and invokes the function or delegate passed upon construction.
yield () Forces a context switch to occur away from the calling thread.
factory (classname) Create instance of class specified by the fully qualified name classname. The class must either have no constructors or have a default constructor.
getAll () Provides a list of all threads currently being tracked by the system. Note that threads in the returned array might no longer run (see ThreadBase.isRunning).
getThis () Provides a reference to the calling thread.
opApply (dg) Operates on all threads currently being tracked by the system. The result of deleting any Thread object is undefined. Note that threads passed to the callback might no longer run (see ThreadBase.isRunning).
opCmp (o) Compare with another Object obj.
opEquals (o) Test whether this is equal to o. The default implementation only compares by identity (using the is operator). Generally, overrides for opEquals should attempt to compare objects by their contents.
toHash () Compute hash function for Object.
toString () Convert Object to a human readable string.

Example

class DerivedThread : Thread
{
    this()
    {
        super(&run);
    }

private:
    void run()
    {
        // Derived thread running.
    }
}

void threadFunc()
{
    // Composed thread running.
}

// create and start instances of each type
auto derived = new DerivedThread().start();
auto composed = new Thread(&threadFunc).start();
new Thread({
    // Codes to run in the newly created thread.
}).start();

Authors

Sean Kelly, Walter Bright, Alex Rønne Petersen, Martin Nowak

License

Distributed under the Boost Software License 1.0. (See accompanying file LICENSE)