core.runtime

D言語のランタイムに特有の情報を提供するためのモジュールです。

License:
Boost License 1.0.

Authors:
Sean Kelly

Source:
core/runtime.d

struct Runtime;

この構造体には、呼び出しコンテキストのランタイムに関する情報が全てカプセル化されて含まれています。

static bool initialize(ExceptionHandler dg = null);

ランタイムを初期化します。この関数は、通常のプログラム初期化処理を経ずに起動されたコードでのみ呼び出す必要があります。これは、共有ライブラリやCのプログラムへとリンクされたライブラリなどで起こり得ます。

Parameters:

ExceptionHandler dg

初期化中に発生した例外をハンドルするためのdelegate。 null を指定するとそれらの例外を破棄するようになります。

Returns:
初期化に成功すれば true、失敗すると false

static bool terminate(ExceptionHandler dg = null);

ランタイムを終了します。この関数は、通常のプログラム終了処理を経ずに閉じられるコードでのみ呼び出す必要があります。これは、共有ライブラリやCのプログラムへとリンクされたライブラリなどで起こり得ます。

Parameters:

ExceptionHandler dg

終了中に発生した例外をハンドルするためのdelegate。 null を指定するとそれらの例外を破棄するようになります。

Returns:
終了に成功すれば true、失敗すると false

deprecated static bool isHalting();

ランタイムが終了処理中であれば true を返します。通常の状況では、これは普通のアプリケーションコードの終了後、モジュールデストラクタが呼ばれる前にこのフラグが立ちます。

Returns:
終了処理中ならば true

static string[] args();

プロセス起動時に指定された引数

Returns:
プロセス起動時に指定された引数

static void* loadLibrary(in char[] name);

指定の名前のダイナミックライブラリを現在のアドレス空間にロードします。ライブラリにDのランタイムが含まれていれば、現在のランタイムへと統合されます。

Parameters:

char[] name

ロードしたいライブラリの名前

Returns:
ライブラリへの参照か、またはエラー時には null

static bool unloadLibrary(void* p);

p の指す動的リンクライブラリをアンロードします。このライブラリに D のランタイムが含まれていれば、必要な終了処理とクリーンアップが実行されます。

Parameters:

void* p

アンロードしたいライブラリへの参照

static void traceHandler(TraceHandler h);

デフォルトのトレースハンドラをユーザー定義の物に置き換えます、トーレスは、例外が呼び出されたときのコンテキスト情報を表し、そのハンドラは例外throw時に呼び出されます。ハンドラ関数に渡されるポインタはトレース情報の起点となるべき基底アドレスです。 null が渡された場合はハンドラ自身が、適切な起点となるコンテキストを判定する必要があります。

Parameters:

TraceHandler h

新しいトレースハンドラ。 null とするとデフォルトの処理に戻します。

static TraceHandler traceHandler();

現在のトレースハンドラを取得

Returns:
現在のトレースハンドラ、または設定されていなければ null

static void collectHandler(CollectHandler h);

デフォルトのコレクトハンドラをユーザ定義の物に置き換えます。このハンドラは、（典型的にはガベージコレクション中に）資源オブジェクトが非決定的にfinalize処理される時に呼び出されます。ハンドラが true を返すと通常通りそのオブジェクトのデストラクタが呼ばれ、 false を返すとデストラクタは呼ばれません。デフォルトは全てのデストラクタを呼び出すようになっています。

Parameters:

CollectHandler h

新しいコレクトハンドラ。 null とするとデフォルトの処理に戻します。

static CollectHandler collectHandler();

現在のコレクトハンドラを取得

Returns:
現在のコレクトハンドラ、または設定されていなければ null

static void moduleUnitTester(ModuleUnitTester h);

デフォルトのユニットテスタをユーザー定義の物に置き換えます、このルーチンはプログラム初期化時に一度だけ呼び出されます。このルーチンの返値は、ランタイムにテストがエラー無しで完了したかどうかを返します。

Parameters:

ModuleUnitTester h

新しいユニットテスタ。 null とするとデフォルトの処理に戻します。

static ModuleUnitTester moduleUnitTester();

現在のモジュールのユニットテスタを取得します。

Returns:
現在のモジュールのユニットテストハンドラ、または設定されていなければ null。

bool runModuleUnitTests();

このルーチンは起動時に各モジュールのユニットテストを行うために呼び出されます。ユーザ定義のユニットテスタが提供されていればそれを呼び出し、そうでなければ順番にユニットテストを走らせます。

Returns:
テスト完了後も実行を続けるならば true、そうでなければ false。デフォルトでは true を返します。

Throwable.TraceInfo defaultTraceHandler(void* ptr = null);