MLEnvironmentParameter （C 関数）

MLEnvironmentParameterはWSEnvironmentParameterに置き換えられた．

MathLink ライブラリの環境パラメータ集合を表すMathLinkタイプである．

詳細

  • MathLink の環境パラメータオブジェクトは，MathLink環境オブジェクトを設定するのに使われた設定を保存する．
  • MLEnvironmentParameterは，MathLinkヘッダファイルmathlink.hで定義される．これは任意のMathLink互換プログラムについてのソースコードに含まれるべきものである．
  • MLEnvironmentParameterオブジェクトは，MLNewParameters()関数によって作成され，MLReleaseParameters()関数によって割当てを解除される．
  • MLEnvironmentParametersは，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"


void * Custom_Allocator(size_t size)
{
    /* ... */
}

void Custom_Deallocator(void *ptr)
{
    /* ... */
}


int main()
{
    MLEnvironmentParameter ep;
    MLENV env;
    
    ep = MLNewParameters(MLREVISION, MLAPIREVISION);
    if(ep == (MLEnvironmentParameter)0)
    { /* Unable to initialize MLEnvironmentParameter object */ }

    MLSetAllocParameter(ep, Custom_Allocator, Custom_Deallocator);

    /* Give the MathLink library the custom memory allocator */
    env = MLInitialize(ep);
    if(env == (MLENV)0)
    { /* Unable to initialize the MathLink environment */ }

    MLReleaseParameters(ep);

    /* ... */

    MLDeinitialize(env);

    return 0;
}