MLUTF16ErrorMessage （C 関数）

MLUTF16ErrorMessageはWSUTF16ErrorMessageに置き換えられた．

const unsigned short * MLUTF16ErrorMessage(MLINK l, int *n)

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

詳細

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

例題

例  (1)

#include "mathlink.h"

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

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

    message = MLUCS2ErrorMessage(l, &length);

    /* We check for length <= 1 below because the string
    should contain a byte order mark */
    if(message == (const unsigned short *)0 || length <= 1)
    { /* Unable to read the error message */ }

    /* ... */

    MLReleaseUTF16ErrorMessage(l, message, length);
}