このページの英語版を見る

core.runtime

ランタイム・モジュールは、Dランタイム・コードに固有の情報を公開する。

License:

Boost License 1.0

Authors:

Sean Kelly

ソース runtime.d

ドキュメント https://dlang.org/phobos/core_runtime.html

void* rt_loadLibrary(const char* name);

Runtime.loadLibraryとのCインターフェイス

int rt_unloadLibrary(void* ptr);

Runtime.unloadLibraryとのインターフェイスで、boolの代わりに1/0を返す。

int rt_init();

Runtime.initializeのCインターフェイス、boolの代わりに1/0を返す

int rt_term();

Runtime.terminateとのインターフェイスで、boolの代わりに1/0を返す。

struct UnitTestResult;

この型は、モジュール単体テストハンドラがテスト結果を示すために返す。結果を返す。

size_t executed;: テストされたモジュールの数
size_t passed;: ユニットテストに合格したモジュールの数
bool runMain;: メイン関数を実行すべきかどうか?テストが失敗した場合は無視される。が失敗した場合は無視される。
bool summarize;: 結果の要約を表示すべきか?
const bool opCast(T : bool)();: ユニットテストが実行された後、実行を続けるべきかどうかの単純なチェック。が実行された後も実行を続けるべきかどうかをチェックする。bool が返されることを期待していたレガシーなコードでも動作する。
Returns:
テストが完了した後も実行を続けるべき場合はtrue、そうでない場合はfalseを返す。を返す。
enum UnitTestResult pass;: 単体テストが合格し、mainが実行されるべきであるという単純なリターン・コード。
enum UnitTestResult fail;: ユニットテストが失敗したという単純なリターン・コード。

alias ModuleUnitTester = bool function();

レガシー・モジュール単体テスト・ハンドラ

alias ExtendedModuleUnitTester = UnitTestResult function();

モジュール単体テストハンドラ

struct CArgs;

プロセス開始時に供給された未処理の引数を保存する。引数カウント。

int argc;: 引数のカウント。
char** argv;: 文字列のC配列としての引数。

struct Runtime;

この構造体は、呼び出し元コンテキストの基礎となるランタイム・モジュールに関連するすべての機能をカプセル化する。モジュールに関連するすべての機能をカプセル化する。

static bool initialize();

ランタイムを初期化する。この呼び出しは、標準のプログラム初期化処理が実行されない場合に使用される。標準のプログラム初期化プロセスが実行されない場合に使用される。これは共有ライブラリやCプログラムにリンクされたライブラリでよくあることである。ランタイムがすでに正常に初期化されている場合、これは真を返す。 initializeを呼び出すたびに、必ず対になって terminate.

Returns:

初期化に成功した場合はtrueを、初期化に失敗した場合はfalseを返す。

static bool terminate();

ランタイムを終了する。この呼び出しは、標準的なプログラム終了処理が実行されない場合に使用する。標準のプログラム終了処理が実行されない場合に使用される。これは共有ライブラリやCプログラムにリンクされたライブラリでよくあることである。ランタイムが正常に初期化されなかった場合、この関数は偽を返す。

Returns:

終了に成功した場合はtrue、失敗した場合はfalseを返す。

static @property string[] args();

プロセスの開始時に供給された引数を返す。

Returns:

このプロセスが開始されたときに提供された引数。

static @nogc @property CArgs cArgs();

プロセス開始時に供給された未処理のC引数を返す。 Cライブラリにargcとargvを供給する必要がある場合に使用する。

Returns:

A CArgsこのプロセスの開始時に供給された引数を持つ構造体。

例:

import core.runtime;

// char**引数を必要とするCライブラリ関数
extern(C) void initLibFoo(int argc, char** argv);

void main()
{
    auto args = Runtime.cArgs;
    initLibFoo(args.argc, args.argv);
}

void* loadLibrary()(scope const char[] name);

指定されたライブラリ名でダイナミック・ライブラリを検索し、呼び出し元のアドレス空間に動的にロードする。呼び出し元のアドレス空間にロードする。ライブラリにD ランタイムが含まれていれば、現在のランタイムと統合される。

Parameters:

char[] name ロードするダイナミック・ライブラリーの名前。

Returns:

エラー時にはnull。

bool unloadLibrary()(void* p);

pによって参照されているダイナミック・ライブラリをアンロードする。 Dランタイムが含まれている場合、そのランタイムの必要なファイナライズまたはクリーンアップが実行される。が実行される。

Parameters:

void* p アンロードするライブラリへの参照。

static @property void traceHandler(TraceHandler h, Throwable.TraceDeallocator d = null);

デフォルトのトレース機構を、ユーザーが提供するバージョンで上書きする。 A トレースは、例外がスローされたコンテキストを表し、例外が発生するとトレースハンドラが呼ばれる。トレースハンドラが呼ばれる。このルーチンに与えられるポインタはこのルーチンに与えられるポインタは、トレースが発生するベース・アドレスを示す。与えられたポインタがNULLの場合、トレース・ルーチンは、トレースを開始する適切な呼び出しコンテキストを決定しなければならない。トレースを開始する適切な呼び出しコンテキストを決定しなければならない。

deallocatorが設定されている場合は、例外が確定したときにtraceinfoとともに呼び出される。と共に呼び出される。deallocatorが例外に設定されるのは、以下の場合だけである。デフォルトのハンドラがトレース情報を生成するために使われた場合のみ、例外にデアロケータがセットされる。

Parameters:

TraceHandler `h`	新しいトレースハンドラ。例外バックトレースを無効にするにはnullに設定する。
Throwable.TraceDeallocator `d`	新しいトレース・デアロケータ。nullでない場合、これは例外の破棄時にトレース情報と一緒に呼び出される。ハンドラが TraceInfo を生成するために使用される場合のみ。

static @property TraceHandler traceHandler();

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

Returns:

現在のトレースハンドラ、または何も設定されていない場合は null。

static @property Throwable.TraceDeallocator traceDeallocator();

現在のトレースデアロケータを取得する。

Returns:

現在のトレースデアロケータ、または何も設定されていない場合は null。

static @property void collectHandler(CollectHandler h);

デフォルトの collect ハンドラを、ユーザーが提供するバージョンで上書きする。このこのルーチンは、非決定的な方法--通常はガベージコレクションサイクルの間--で最終化された各リソースオブジェクトに対して呼ばれる。このルーチンは、非決定的な方法--通常はガベージコレクションサイクル中--で最終化される各リソースオブジェクトに対して呼び出される。提供されたルーチンがtrueを返した場合、オブジェクトのdtorは通常通り呼び出される。が呼び出されるが、もしこのルーチンが偽を返せば、ctorは呼び出されない。は呼び出されない。デフォルトの動作は、すべてのオブジェクトのdtorが呼び出されることである。

Parameters:

CollectHandler h 新しいコレクト・ハンドラ。デフォルトのハンドラを使用するには null を設定する。

static @property CollectHandler collectHandler();

現在のコレクト・ハンドラを取得する。

Returns:

現在の collect ハンドラ、または何も設定されていない場合は null。

static @property void extendedModuleUnitTester(ExtendedModuleUnitTester h); static @property void moduleUnitTester(ModuleUnitTester h);

デフォルトのモジュール・ユニット・テスターをユーザーが指定したバージョンでオーバーライドする。このルーチンは、プログラムの初期化時に 1 回呼び出される。このルーチンの戻り値このルーチンの戻り値は、テストがエラーなしで実行されたかどうかをランタイムに示す。を示す。

ハンドラには2つのオプションがある。bool 。はレガシー・サポートのために残しておく。ハンドラーからtrue を返すことは、拡張バージョンからを返すことと同じである。拡張バージョンからUnitTestResult.pass を返すのと同じである。ハンドラからfalse を返すことは、拡張バージョンからを返すことと同じである。 UnitTestResult.fail を返すのと同じである。

どのようにセットアップすべきかについては、UnitTestResult のドキュメントを参照のこと。のドキュメントを参照のこと。

runModuleUnitTests デフォルトののドキュメントを参照するか、以下の例を読んでほしい。

Parameters:

ExtendedModuleUnitTester h 新しいユニットテスター。デフォルトのテスターを使う。

例:

shared static this()
{
    import core.runtime;

    Runtime.extendedModuleUnitTester = &customModuleUnitTester;
}

UnitTestResult customModuleUnitTester()
{
    import std.stdio;

    writeln("Using customModuleUnitTester");

    // デフォルトのmoduleUnitTesterと同じことを行う:
    UnitTestResult result;
    foreach (m; ModuleInfo)
    {
        if (m)
        {
            auto fp = m.unitTest;

            if (fp)
            {
                ++result.executed;
                try
                {
                    fp();
                    ++result.passed;
                }
                catch (Throwable e)
                {
                    writeln(e);
                }
            }
        }
    }
    if (result.executed != result.passed)
    {
        result.runMain = false;  // mainを実行しない
        result.summarize = true; // 表示失敗
    }
    else
    {
        result.runMain = true;    // すべてのUTに合格した
        result.summarize = false; // ひた隠しにする。
    }
    return result;
}

static @property ModuleUnitTester moduleUnitTester();

現在のレガシー・モジュールのユニット・テスターを取得する。

このプロパティは使用されるべきではないが、レガシーな目的のためにサポートされている。

拡張ユニットテストハンドラが設定されている場合、このハンドラは無視される。は無視される。

Returns:

現在のレガシー・モジュールのユニット・テスタ・ハンドラ、または何も設定されていない場合はNULL を設定する。

static @property ExtendedModuleUnitTester extendedModuleUnitTester();

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

このハンドラは moduleUnitTester" プロパティによって設定されたレガシーモジュールユニットテスターを上書きする。

Returns:

現在のモジュール・ユニット・テスター・ハンドラ、または何も設定されていない場合は null を設定する。

void dmd_coverSourcePath(string path);

カバレッジ・レポートのソース・ファイル・パスを設定する。

Parameters:

string path 新しいパス名。