MLNewPacket (C 関数)

MLNewPacketWSNewPacketに置き換えられた.

int MLNewPacket(MLINK link)

link 上の現行のパケットの終りまでスキップする.

詳細

  • MLNewPacket()は,現行の最高位の式の頭部が標準パケットタイプではない場合にも作動する.
  • MLNewPacket()はすでにユーザがパケットの終りに達している場合には何もしない.
  • MLNewPacket() はエラーがあると0 を返し, 関数が成功すると0以外の値を返す.
  • MLError()を使うと,MLNewPacket()が不成功の場合にエラーコードを引き出すことができる.
  • MLNewPacket()は,MathLinkヘッダファイルmathlink.hの中で宣言される.

例題

  (1)

#include "mathlink.h"

/* read the next number from a link and ignore everything else */

void f(MLINK lp)
{
    /* determine the type of the data on the link */
    switch(MLGetType(lp))
    {
        case MLTKINT:
            /* integer data */
            break;
        case MLTKREAL:
            /* floating point data */
            break;
        default:
            /* Skip to the next packet if not a number. */
            if(! MLNewPacket(lp))
                { /* unable to jump ahead to the next packet on lp */ }
    }
}