WSNewPacket （C 関数）

int WSNewPacket(WSLINK link)

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

詳細

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

例題

例  (1)

#include "wstp.h"

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

void f(WSLINK lp)
{
    /* determine the type of the data on the link */
    switch(WSGetType(lp))
    {
        case WSTKINT:
            /* integer data */
            break;
        case WSTKREAL:
            /* floating point data */
            break;
        default:
            /* Skip to the next packet if not a number. */
            if(! WSNewPacket(lp))
                { /* unable to jump ahead to the next packet on lp */ }
    }
}