MLReleaseUTF8LinkName （C 関数）

MLReleaseUTF8LinkNameはWSReleaseUTF8LinkNameに置き換えられた．

void MLReleaseUTF8LinkName(MLINK l, const unsigned char *n, int v)

MLUTF8LinkName()によって割り当てられたメモリを解放して，長さ v の配列である，UTF-8でコード化されたリンク名 n を保存する．

詳細

  • リンク名 n を保存するために使われたメモリは，MLUTF8LinkName()への呼出しによって割り当てられたものでなければならない．
  • MLReleaseUTF8LinkName()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

/* A function for reading the name of a link */

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

    name = MLUTF8LinkName(l, &length);
    if(name == (const unsigned char *)0 || length == 0)
    { /* Unable to get the name of the link */ }

    /* ... */

    MLReleaseUTF8LinkName(l, name, length);
}