MLTestHead （C 関数）

MLTestHeadはWSTestHeadに置き換えられた．

int MLTestHead(MLINK link,const char *head,int *n)

link から次に読み取られるオブジェクトが頭部 head を持つ式であるかどうかをテストして， n に式の引数の数を保持する．

詳細

  • MLTestHead()は，リンク上の現行オブジェクトが頭部としての記号を持つ関数ではない場合，あるいは記号名がhead と一致しない場合には不成功に終る．
  • MLTestHead()はエラーがあると0を返し，関数が成功するとゼロ以外の値を返す．
  • MLError()を使うと，MLTestHead()が不成功の場合にエラーコードを引き出すことができる．
  • MLTestHead()は，関数が失敗すると，MLTestHead()を呼び出す直前に，リンク上の式へのストリームポインタを再設定する．この操作は，プログラマがMLCreateMark(link); MLTestHead(…); MLSeekToMark(…)を呼び出したかのように振舞う．
  • MLTestHead()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (1)

#include "mathlink.h"

/* test whether the head of the incoming object is "ReturnPacket" */

void f(MLINK lp)
{
    int args;

    if(MLTestHead(lp, "ReturnPacket", &args))
        { /* read the contents of the ReturnPacket[] */ }
    else
        { /* the head of incoming packet is not "ReturnPacket" */ }
}