MLLowLevelDeviceName （C 函数）

MLLowLevelDeviceName 已被 WSLowLevelDeviceName 替代.

int MLLowLevelDeviceName( MLINK l , const char ** name )

获取由 l 指定的 MathLink 连接的链接名称的底层协议形式，并将结果存储在 name 中.

更多信息

  • MLLowLevelDeviceName() 为必须通过调用 MLReleaseLowLevelDeviceName() 来释放的名称分配内存. 如果 MLLowLevelDeviceName() 返回错误，请勿对 name 的内容调用 MLReleaseLowLevelDeviceName().
  • 如果 MLLowLevelDeviceName() 成功，则返回 1；若失败，则返回 0.
  • MLLowLevelDeviceName() 在 MathLink 标头文件 mathlink.h 中被声明.

范例

基本范例  (1)

#include "mathlink.h"

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

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

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

    MLActivate(link);

    apiResult = MLLowLevelDeviceName(link, &name);
    if(apiResult == 0)
    { /* Failed to retrieve low level name */ }

    /* ... */

    MLReleaseLowLevelDeviceName(link, name);        

    /* .... */

    MLClose(link);
    MLDeinitialize(env);
    return 0;
}