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