WSReleaseUTF16LinkName （C 関数）

void WSReleaseUTF16LinkName(WSLINK l, const unsigned short *n, int v)

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

詳細

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

例題

例  (1)

#include "wstp.h"

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

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

    name = WSUTF16LinkName(l, &length);

    /* We test for length <= 1 because WSUTF16LinkName()
    returns a string with a byte order mark. */

    if(name == (const unsigned short *)0 || length <= 1)
    {  /* Unable to get the name of the link */ }

    /* ... */

    WSReleaseUTF16LinkName(l, name, length);
}