MLLinkName （C 関数）

MLLinkNameはWSLinkNameに置き換えられた．

const char * MLLinkName(MLINK link)

リンクを作成するために使った名前の文字列を返す．

詳細

  • MLLinkName()は，解放されなければならないリンク名にメモリを割り当てる．メモリを解放する場合には，関数によって返された値に対してMLReleaseLinkName()を呼び出す．MLLinkName()がNULLを返す場合には，NULLの値に対してMLReleaseLinkName()を呼び出してはならない．
  • プログラムは，MLLinkName()が返す文字列の内容を変更してはならない．
  • MathLinkのリンクは，リンクモード，リンクプロトコル，その他のオプション等を組み合わせて作成される．リンク名は，リンクモードやリンクを作成するのに使ったリンクプロトコルに必要な情報を提供する．
  • MLLinkName()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (4)

UnixあるいはMac OS X上のPipesプロトコルを使って，リンクを起動する：

リンク名には，リンクに接続するときに使うパス名とコマンドライン引数が含まれている：

TCPIPプロトコルを使ってリンクを作成する：

リンク名には，TCP接続を設立するときに使うポートとホスト名のペアが含まれている：

SharedMemoryプロトコルを使ってリンクを作成する：

リンク名には，共有メモリオブジェクトの名前が含まれている：

const char * 変数を宣言してリンク名を得る：

#include "mathlink.h"

/* A function for reading a link's name */

void f(MLINK lp)
{
    const char *name;

    name = MLLinkName(lp);
    if(name == (const char *)0)
    { /* Unable to get the link name */ }

    /* ... */

    MLReleaseLinkName(lp, name);
}