MLUCS2LinkName （C 関数）

MLUCS2LinkNameはWSUCS2LinkNameに置き換えられた．

const unsigned short * MLUCS2LinkName(MLINK l, int *n)

l で指定されたMathLink接続から，長さ n のUCS2でコード化された文字列としてコード化されたリンクの名前を返す．

詳細

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

例題

例  (1)

#include "mathlink.h"

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

void f(MLINK l)
{
    const unsigned short *name;
    int length;

    name = MLUCS2LinkName(l, &length);
    if(name == NULL || length == 0)
    { /* Unable to read link name */ }

    /* ... */

    MLReleaseUCS2LinkName(l, name, length);
}