MLGetLinksFromEnvironment （C 関数）

MLGetLinksFromEnvironmentはWSGetLinksFromEnvironmentに置き換えられた．

int MLGetLinksFromEnvironment( MLENV env , MLINK ** links , int * l )

MathLink環境 env で現在開いているリンクのリストを得て，そのリストを links に，リストの長さを l に保存する．

詳細

  • MLGetLinksFromEnvironment()はメモリを割り当てて，MLReleaseLinksFromEnvironment()を呼び出すことによって解放しなくてはならないリンクのリストを保存する．MLGetLinksFromEnvironment()がエラーを返す場合には，links の内容に対してMLReleaseLinksFromEnvironment()を呼び出してはならない．
  • MLGetLinksFromEnvironment()は，成功した場合には1を，失敗した場合には0を返す．
  • MLGetLinksFromEnvironment()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

void examineTheLinks(MLENV env)
{
    MLINK *theLinks;
    int length;
    int apiResult;

    apiResult = MLGetLinksFromEnvironment(env, &theLinks, &length);
    if(! apiResult)
    { /* Unable to retrieve the list of open links */ }

    /* ... */

    MLReleaseLinksFromEnvironment(env, theLinks, length);
}