D 1.0   D 2.0
About Japanese Translation

D Programming Language 2.0

• English
• Download D!

• D
• 言語仕様
• Phobos
• 比較

• object
• std
• std.algorithm
• std.array
• std.base64
• std.bigint
• std.bind
• std.bitmanip
• std.boxer
• std.compiler
• std.complex
• std.concurrency
• std.container
• std.contracts
• std.conv
• std.cover
• std.cpuid
• std.ctype
• std.date
• std.datetime
• std.demangle
• std.encoding
• std.exception
• std.file
• std.format
• std.functional
• core.memory
• std.getopt
• std.gregorian
• std.intrinsic
• std.json
• std.math
• std.mathspecial
• std.md5
• std.metastrings
• std.mmfile
• std.numeric
• std.outbuffer
• std.path
• std.perf
• std.process
• std.random
• std.range
• std.regex
• std.regexp
• std.signals
• std.socket
• std.socketstream
• std.stdint
• std.stdio
• std.cstream
• std.stream
• std.string
• std.system
• std.thread
• std.traits
• std.typecons
• std.typetuple
• std.uni
• std.uri
• std.utf
• std.variant
• std.xml
• std.zip
• std.zlib
• std.c.fenv
• std.c.locale
• std.c.math
• std.c.process
• std.c.stdarg
• std.c.stddef
• std.c.stdio
• std.c.stdlib
• std.c.string
• std.c.time
• std.c.wcharh
• std.windows.charset
• std.windows
• std.linux
• std.c.windows
• std.c.linux

• core
• core.atomic
• core.bitop
• core.cpuid
• core.exception
• core.memory
• core.runtime
• core.thread
• core.vararg
• core.sync.barrier
• core.sync.condition
• core.sync.config
• core.sync.exception
• core.sync.mutex
• core.sync.rwmutex
• core.sync.semaphore

core.thread

class ThreadException: object.Exception;

threadモジュールの投げる例外の基底クラスです。

class FiberException: object.Exception;

Fiber例外の基底クラスです。

alias btex_fptr;

class Thread;

このクラスはD言語のスレッド関連の全ての機能をカプセル化しています。 スレッドの管理はガベージコレクションの際に必要となるため。 ユーザースレッドは全て必ずこのクラスから派生します。 また、このクラスのインスタンスを明示的にdeleteしないようにしてください。 新しいスレッドは、派生もしくは委譲のどちらの方法でも作成できます。 例を以下に示します。

Example:

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

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

 void threadFunc()
 {
     printf( "Composed thread running.\n" );
 }

 // それぞれの型のインスタンスを作成
 Thread derived = new DerivedThread();
 Thread composed = new Thread( &threadFunc );

 // 両方を実行開始
 derived.start();
 composed.start();

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

静的なDの関数に関連づけて スレッドオブジェクトを初期化します。

Params:

void function() fn	スレッドのメイン関数
size_t sz	スレッドのスタックサイズ

In:
fn に null を指定することはできません。

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

動的なDの関数に関連づけて スレッドオブジェクトを初期化します。

Params:

void delegate() dg	スレッドのメイン関数
size_t sz	スレッドのスタックサイズ

In:
dg に null を指定することはできません。

final void start();

スレッドを開始し、コンストラクタに渡された関数あるいはdelegateを実行します。

In:
この関数はひとつのスレッドインスタンスにつき一度だけ実行できます。

Throws:
スレッドを開始できなかった場合 ThreadException

final Throwable join(bool rethrow = true);

スレッドが実行完了するのを待機します。 スレッドが未処理の例外で終了した場合、その例外が再throwされます。

Params:

bool rethrow

このスレッドが例外で終了した場合、 例外を再throwします

Throws:
この操作に失敗した場合 ThreadException。 join対象のスレッドで処理されなかった全ての例外。

Returns:
rethrow = false で、処理されなかった例外があった場合その例外オブジェクト。 それ以外の場合は null。

final string name();

このスレッドの可読性のあるラベルを取得

Returns:
このスレッドの名前

final void name(string val);

このスレッドの可読性のあるラベルを設定

Params:

string val

このスレッドの新しい名前

final bool isDaemon();

このスレッドのデーモン状態フラグを取得します。 ランタイムは、プロセスを落とす前に全ての通常スレッドの実行完了を待ちますが、 デーモンスレッドは無視するため終了タイミングに影響しません。 最終的には、デーモンスレッドはプロセス終了時に OS によって自動的に終了されます。

Returns:
デーモンスレッドならば true

final void isDaemon(bool val);

このスレッドのデーモン状態フラグを設定します。 ランタイムは、プロセスを落とす前に全ての通常スレッドの実行完了を待ちますが、 デーモンスレッドは無視するため終了タイミングに影響しません。 最終的には、デーモンスレッドはプロセス終了時に OS によって自動的に終了されます。

Throws:
Params:

bool val

スレッドの新しいデーモン状態フラグ

final bool isRunning();

スレッドが実行中かどうかを調べます。

Returns:
スレッドが実行中ならば true、そうでなければ false

const int PRIORITY_MIN;

スレッドに設定できる最低の優先度です。 複数のスケジューリングポリシーが設定できるシステムでは、 この値はプロセスのスケジューリングポリシーの下で 有効な最低の優先度になります。

const int PRIORITY_MAX;

スレッドに設定できる最高の優先度です。 複数のスケジューリングポリシーが設定できるシステムでは、 この値はプロセスのスケジューリングポリシーの下で 有効な最高の優先度になります。

final int priority();

スレッドのスケジューリング優先度を取得します。

Returns:
このスレッドの優先度

final void priority(int val);

スレッドのスケジューリング優先度を設定します。

Params:

int val

このスレッドの新しい優先度

static void sleep(Duration val);

呼び出したスレッドを、指定された時間の間停止します。 OSのサポートする最大の sleep 時間より長い値を指定した場合、複数回のシステムコール呼び出しとなります。

Parameters:

Duration val

スレッドを停止したい時間の下限

In:
非負の値を指定すること。

Example:

 Thread.sleep( milliseconds( 50 ) );  // 50ミリ秒sleep
 Thread.sleep( seconds( 5 ) );        // 5秒sleep

static void sleep(long period);

呼び出したスレッドを、指定された時間 period の間停止します。 OSのサポートする最大の sleep 時間より長い値を指定した場合、複数回のシステムコール呼び出しとなります。

Params:

long period

スレッドを停止したい時間の下限を、 100ナノ秒単位で指定

In:
period は非負の値を指定すること。

Example:

 Thread.sleep( 500_000 );        // 50ミリ秒sleep
 Thread.sleep( 50_000_000 ); // 5秒sleep

static void yield();

呼び出したスレッドから強制的にコンテキストスイッチします。

static Thread getThis();

呼び出したスレッドへの参照を取得します。

Returns:
呼び出しスレッドを表すスレッドオブジェクト。 この返値をdeleteした場合の挙動は未定義です。

static Thread[] getAll();

現在システムの把握している全スレッドのリストを返します。

Returns:
現在システムの把握している全スレッドへの参照を持った配列を返します。 この配列の要素を delete した場合の挙動は未定義です。

static int opApply(scope int delegate(ref Thread) dg);

現在システムの把握している全スレッドのリストを返します。 Thread オブジェクトを した場合の挙動は未定義です。

Params:

int delegate(ref Thread) dg

delegateとして渡されるコード

Returns:
全ての要素をvisitした場合0、それ以外の場合非0。

deprecated alias findThread;

 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" );
 }

 // それぞれの型のインスタンスを作成
 Fiber derived = new DerivedFiber();
 Fiber composed = new Fiber( &fiberFunc );

 // 両方を一度ずつ呼び出す
 derived.call();
 composed.call();
 printf( "Execution returned to calling context.\n" );
 composed.call();

 // どちらも実行完了まで動いているので、TERM 状態になる
 assert( derived.state == Fiber.State.TERM );
 assert( composed.state == Fiber.State.TERM );