MLReleaseUTF16LinkName (C Function)

MLReleaseUTF16LinkName has been replaced by WSReleaseUTF16LinkName.

void MLReleaseUTF16LinkName(MLINK l, const unsigned short *n, int v)

releases memory allocated by MLUTF16LinkName() to store the UTF-16 encoded link name n, an array of length v.

Details

  • The memory allocated to hold the link name n must have been allocated by a call to MLUTF16LinkName().
  • MLReleaseUTF16LinkName() is declared in the MathLink header file mathlink.h.

Examples

Basic Examples  (1)

#include "mathlink.h"

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

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

    name = MLUTF16LinkName(l, &length);

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

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

    /* ... */

    MLReleaseUTF16LinkName(l, name, length);
}