MLTestString （C 関数）

MLTestStringはWSTestStringに置き換えられた．

int MLTestString(MLINK l, const char *s)

l から読み込まれる次の式が値 s を持つ文字列であることを検証する．

詳細

  • MLTestString()は，リンク上の現行のオブジェクトが文字列ではない場合，あるいは文字列の値が s にマッチしない場合には失敗する．
  • MLTestString()は，エラーが起った場合には0を，関数が成功した場合には非零の値を返す．
  • MLTestString()が失敗した場合には，MLError()を使ってエラーコードを得るとよい．
  • MLTestString()は，関数が失敗した場合には，MLTestString()を呼び出す直前のリンク上の式に対するストリームポインタを再設定する．この操作は，プログラマがMLCreateMark(link); MLTestString(…); MLSeekToMark(…)を呼び出したかのように振舞う．
  • MLTestString()は，MathLinkヘッダファイルmathlink.hで宣言される．

例題

例  (1)

#include "mathlink.h"

/* A function for testing the next expression on the link for a string */

void f(MLINK l)
{
    if(! MLTestString(l, "$Version"))
    { /* The next expression on the link is not $Version */ }
    else
    { /* The next expression on the link is $Version */ }
}