MLErrorMessage （C 関数）

MLErrorMessageはWSErrorMessageに置き換えられた．

const char * MLErrorMessage(MLINK link)

link 上で最も最近に発生したエラーを示す文字列を返す．

詳細

  • MLErrorMessage()は，解放されなければならないメッセージ文字列にメモリを割り当てる．MLErrorMessage()によって割り当てられたメモリを解放する場合には，MLReleaseErrorMessage()を使う．MLErrorMessage()がNULLを返す場合には，NULLの値に対してMLReleaseErrorMessage()を呼び出してはならない．
  • MLErrorMessage()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (1)

#include "mathlink.h"

/* send the double precision floating-point number 3.22 to a link and print an error message if the send fails */

void f(MLINK lp)
{
    if(! MLPutReal64(lp, 3.22))
    {
        const char *message = MLErrorMessage(lp);

        /* unable to send 3.22 to lp */
        printf("MathLink Error: %s\n", message);

        MLReleaseErrorMessage(lp, message);
    }

    /* ... */
}