MLNewParameters （C 関数）

MLNewParametersはWSNewParametersに置き換えられた．

MLEnvironmentParameter MLNewParameters(unsigned long rev,unsigned long apirev)

MLEnvironmentParameterオブジェクトを割り当てて初期化して，MathLink改訂番号をrev で指定された値に，そして MathLink API 改訂番号をapirev で指定された値に設定する．

詳細

  • MathLink改訂番号と MathLink API改訂番号は，mathlink.hからの定数MLREVISIONとMLAPIREVISIONに設定されるべきである．
  • MLNewParameters()は，解放しなければならないMLEnvironmentParameterオブジェクトにメモリを割り当てる．MLNewParameters()で割り当てられたメモリを解放するには，MLReleaseParameters()を呼び出すとよい．
  • MLNewParameters()は，エラーがあった場合にはNULLを返す．
  • MLNewParameters()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (1)

#include <stdlib.h>
#include "mathlink.h"

/* initialize the MathLink environment */

MLENV f(void)
{
    MLENV env;
    MLEnvironmentParameter p;
    unsigned long res;

    p = MLNewParameters(MLREVISION, MLAPIREVISION);
    if(p == (MLEnvironmentParameter)0)
    { /* Unable to initialize parameter object */ }

    MLSetAllocParameter(p, malloc, free);

    env = MLInitialize(p);
    if(env == (MLENV)0)
    { /* Unable to initialize the MathLink environment */ }

    MLReleaseParameters(p);

    return env;
}