WSCreateMark （C 関数）

WSMARK WSCreateMark(WSLINK link)

リンク上の式の列の中での現在位置にマークを作る．

詳細

  • WSCreateMark()を呼び出すことによって，リンク上の式の流れの中にブックマークを作成することができる．このマークを作っておくことによって，後で式の流れの中のマークされた点に戻ることができる． WSCreateMark()は効果的にリンク上の式を記録し始めてくれる．
  • WSCreateMark()はエラーがあると，(WSMARK)0を返す．
  • WSCreateMark()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* check for a ReturnPacket and go back in the expression stream if necessary */

void f(WSLINK lp)
{
    WSMARK mark;
    int args;

    mark = WSCreateMark(lp);
    if(mark == (WSMARK)0)
        { /* mark creation failed */ }

    if(! WSTestHead(lp, "ReturnPacket", args))
        {
            WSSeekToMark(lp, mark, 0);
            WSDestroyMark(lp, mark);
        }
    else
        { /* read the ReturnPacket[] */ }
}