旧的 WOLFRAM 语言MATHLINK C 函数

MLGetLinkedEnvIDString()
This feature is not supported on the Wolfram Cloud.

已经被 所取代.

int MLGetLinkedEnvIDString(MLINK link,const char **e)
返回连接至 linkMathLink 环境的识别符并把它存储在 e 中.

更多信息更多信息

  • MLGetLinkedEnvIDString() 为字符串 eid 分配内存. 必须调用 MLReleaseEnvIDString() 来释放该内存. 如果 MLGetLinkedEnvIDString() 失败,函数的返回值表明一个错误,不要调用有 e 内容的 MLReleaseEnvIDString().
  • MLGetLinkedEnvIDString() 返回不可变的字符串.
  • MLGetLinkedEnvIDString() 返回的环境识别是一个零结尾的 ASCII 字符串.
  • MLGetLinkedEnvIDString() 直到连接 link 后才工作.
  • MLGetLinkedEnvIDString() 在错误事件中返回0,如果函数成功则返回非零值.
  • 如果 MLGetLinkedEnvIDString() 失败,则使用 MLError() 检索错误代码.
  • MLGetLinkedEnvIDString()MathLink 的标头文件 mathlink.h 中被声明.

范例范例打开所有单元关闭所有单元

基本范例  (1)基本范例  (1)

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

/* read the id from a link and check for "My Remote Program" */

#define ERROR -1

int f(MLINK lp)
{
    int isCorrectProg;
    const char *e;

    if(! MLGetLinkedEnvIDString(lp, &e))
        {
            /* unable to read the link id from lp */
            return ERROR;
        }

    isCorrectProg = strcmp(envid, "My Remote Program") == 0;

    MLReleaseEnvIDString(lp, e, length);

    return isCorrectProg;
}