MLError (C 関数)

MLErrorWSErrorに置き換えられた.

int MLError(MLINK link)

link 上で最も最近に発生したエラーを明らかにする値を返す.MLError()は,前回の MLClearError()への呼出し以来エラーが起っていない場合には,MLEOKを返す.

詳細

  • MLErrorMessage()を呼び出すと,テキスト形式のエラーの説明を得ることができる.
  • MLError() は以下の値を返すことができる:
  • MLEOKすべてオーケーです
    MLEDEADリンクがなくなりました
    MLEGBAD相反するデータを読み取りました
    MLEGSEQMLGet()関数が誤った順序で呼び出されました
    MLEPBTKMLPutNext()が悪いトークンを送信しました
    MLEPSEQMLPut()関数が誤った順序で呼び出されました
    MLEPBIGMLPutData()が過度のデータを受け取りました
    MLEOVFLマシン番号のオーバーフロー
    MLEMEMメモリ切れ
    MLEACCEPTソケットの接続を受け入れられません
    MLECONNECT据え置き中の接続がまだつながっていません
    MLEPUTENDPACKETMLEndPacket()の予期しない呼出しと失われた呼出し
    MLENEXTPACKET現行パケットに読み取られていないデータがあるにもかかわらずMLNextPacket()が呼び出されました
    MLEUNKNOWNPACKETMLNextPacket() が不明のパケットヘッドで読み取られました
    MLEGETENDPACKETパケットの予期しない終了
    MLEABORTリンクが影響を受ける前にプットあるいはゲットは放棄されました
    MLECLOSEDリンクの向こう側が接続を閉じました (未受け取りのデータはまだ受け取ることができるかもしれません)
    MLEINITMathLink環境は初期化されませんでした
    MLEARGV不完全な引数のためリンクを開けません
    MLEPROTOCOLプロトコルが使えません
    MLEMODEモードが使えません
    MLELAUNCH実行が支持されませんでした
    MLELAUNCHAGAIN同じファイルからもう一度プログラムを実行することはできません
    MLELAUNCHSPACEプログラムを実行するのに容量が足りません
    MLENOPARENT接続できる親リンクがありません
    MLENAMETAKENそのリンク名はすでに使われています
    MLENOLISTENそのリンク名は聞いていないことが分かりました
    MLEBADNAMEそのリンク名はなくなったか,あるいは正しい形式ではありません
    MLEBADHOSTその場所は接続できないか,あるいは正しい形式になっていません
    MLELAUNCHFAILEDリソースかライブラリが見つからないのでプログラムを実行することができませんでした
    MLELAUNCHNAMEプログラムが見付からないので実行することができませんでした
    MLEPSCONVERT与えられた文字コード規格からリンクコード規格に変換することができません
    MLEGSCONVERTリンクコード規格から要請されたコード規格に変換することができません
    MLEPDATABAD文字データは誤ったコード規格で与えられています
    MLENOTEXE指定されたファイルはMathLinkで実行可能なものではありません
    MLESYNCOBJECTMAKEMathLink同期オブジェクトを作成することができません
    MLEBACKOUT降伏関数がMathLink操作を終了しました
    MLEBADOPTSYMリンク上の記号値を認識することができません
    MLEBADOPTSTRリンク上の文字列の値を認識することができません
    MLENEEDBIGGERBUFFER関数の呼出しにより大きなバッファ引数が必要です
  • MLError()は,MathLinkヘッダファイルmathlink.hの中で宣言される.

例題

  (1)

#include "mathlink.h"

/* send the integer 10 to a link */

void f(MLINK lp)
{
    if(! MLPutInteger(lp, 10))
    {
        /* check the possible errors */
        switch(MLError(lp))
        {
            case MLEDEAD:
                /* the link died unexpectedly */
                break;
            case MLECLOSED:
                /* the other side closed the link */
                break;
            case MLEOK:
                /* no error occurred */
                break;
            default:
                /* ... */
        }
    }
}