MLInitialize （C 関数）

MLInitializeはWSInitializeに置き換えられた．

MLENV MLInitialize(MLEnvironmentParameter p)

MathLink環境オブジェクトを初期化して，p のパラメータに渡す．

詳細

  • MathLink環境オブジェクトはプログラムの実行中にMathLinkの大域状況を保持する．
  • プログラムは環境パラメータオブジェクトp を使って，ユーザ定義のメモリアロケータをインストールすることができる．
  • 外部プログラムがMathLinkテンプレートから作成されると，MLInitialize()への適切な呼出しが自動的に行われる．
  • MathLinkライブラリを使う任意の外部プログラムは，MathLinkライブラリのリンク関連の他の関数を呼び出す前にMLInitialize()を呼び出さなくてはならない．
  • MathLink環境はリンクオブジェクトを作成する工場の働きをしている．
  • MLInitialize()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (1)

#include "mathlink.h"

int main(int argc, char **argv)
{
    MLENV ep;
    MLINK lp;
    int error;

    ep = MLInitialize((MLEnvironmentParameter)0);
    if(ep == (MLENV)0)
        { /* unable to initialize environment */ }

    lp = MLOpenArgcArgv(ep, argc, argv, &error);
    if(lp == (MLINK)0 || error != MLEOK)
        { /* unable to create link */ }

    /* ... */

    MLClose(lp);
    MLDeinitialize(ep);
    return 0;
}