MLUTF8ErrorMessage （C 関数）

MLUTF8ErrorMessageはWSUTF8ErrorMessageに置き換えられた．

const unsigned char * MLUTF8ErrorMessage(MLINK l, int *n)

l で指定されたMathLink接続上で最後に起ったエラーを説明する，長さ n のUTF-8のコード形式でコード化された文字列を返す．

詳細

  • MLUTF8ErrorMessage()は，解放しなければならないメッセージについてメモリを割り当てる．MLReleaseUTF8ErrorMessage()を使って，MLUTF8ErrorMessage()によって割り当てられたメモリを解放する．MLUTF8ErrorMessage()がNULLを返す場合には，NULLの値についてMLReleaseUTF8ErrorMessage()を呼び出してはならない．
  • プログラムは，文字列の内容を変更してはならない．
  • MLUTF8ErrorMessage()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

/* A function for reading the error message of 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);
}