MLTestUTF32Symbol （C 関数）

MLTestUTF32SymbolはWSTestUTF32Symbolに置き換えられた．

int MLTestUTF32Symbol(MLINK l, const unsigned int *s, int n)

l で指定されたMathLink接続上の次の式が値 s を持つ記号であり，長さ n のUTF-32でコード化された文字列であることを検証する．

詳細

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

例題

例  (1)

#include "mathlink.h"

/* A function for testing the next symbol on the link */

void f(MLINK l)
{
    const unsigned int theSymbol[5];

    theSymbol[0] = 0xFEFF;
    theSymbol[1] = 'L';
    theSymbol[2] = 'i';
    theSymbol[3] = 's';
    theSymbol[4] = 't';

    if(! MLTestUTF32Symbol(l, (const unsigned int *)theSymbol,
        5))
    { /* The next expression on the link is not List */ }
    else
    { /* The next expression on the link is List */ }
}