MLEnableLinkLock （C 関数）

MLEnableLinkLockはWSEnableLinkLockに置き換えられた．

void MLEnableLinkLock ( MLINK l )

l が指定するMathLink接続に対するスレッドの安全性を有効にする．

詳細

  • デフォルトでは，MathLinkのリンクオブジェクトは，複数のスレッドから同時に同じリンクに対するMathLink API関数を呼び出すことについては，スレッドセーフではない．リンクオブジェクトについてMLEnableLinkLock()を呼び出した後で，そのリンクが複数のスレッドの実行から同時に使うことができるようになる．
  • スレッドの安全性は，与えられたリンクオブジェクトに対する内部データストリームの整合性を保つために，パフォーマンス上の小さな不利な条件を導入する．共有のリソースを使うスレッドを加えられたプログラムはすべて，共有のリソースへのアクセスを守る場合にこの不利な条件を負う．
  • スレッドの安全性は，MLDisableLinkLock()を呼び出すことによって，l に対して無効にすることができる．
  • MLEnableLinkLock()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

int main(int argc, char **argv)
{
    MLENV env;
    MLINK link;
    int error;

    env = MLInitialize((MLEnvironmentParameter)0);
    if(env == (MLENV)0)
    { /* Unable to create MathLink environment object */ }

    link = MLOpenArgcArgv(env, argc, argv, &error);
    if(link == (MLINK)0 || error != MLEOK)
    { /* Unable to create link object */ }

    MLActivate(link);

    MLEnableLinkLock(link);

    /* ... */

    MLClose(link);
    MLDeinitialize(env);

    return 0;
}