MLUTF32ErrorMessage （C 関数）

MLUTF32ErrorMessageはWSUTF32ErrorMessageに置き換えられた．

const unsigned int * MLUTF32ErrorMessage(MLINK l, int *n)

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

詳細

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

例題

例  (1)

#include "mathlink.h"

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

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

    message = MLUTF32ErrorMessage(l, &length);

    /* We check for length <= 1 because MLUTF32ErrorMessage() returns
    a byte order mark. */

    if(message == (const unsigned int *)0 || length <= 1)
    { /* Unable to read the error message from the link */ }

    /* ... */

    MLReleaseUTF32ErrorMessage(l, message, length);
}