MLReleaseUTF8ErrorMessage （C 関数）

MLReleaseUTF8ErrorMessageはWSReleaseUTF8ErrorMessageに置き換えられた．

void MLReleaseUTF8ErrorMessage(MLINK l, const unsigned char *m, int n)

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

詳細

  • メッセージ m を保持するために使われたメモリは，MLUTF8ErrorMessage()への呼出しによって割り当てられたものでなければならない．
  • MLReleaseUTF8ErrorMessage()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

/* A function for reading the error message from a link */

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

    message = MLUTF8ErrorMessage(l, &length);
    if(message == (const unsigned char *)0 || length == 0)
    { /* Unable to read the error message from the link */ }

    /* ... */

    MLReleaseUTF8ErrorMessage(l, message, length);
}