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);
}