WSPutSymbol (C 関数)

int WSPutSymbol(WSLINK link,const char *s)

文字列s によってその名前を与えられる記号を,link で指定されたWSTP接続に置く.

詳細

  • 文字列は,C言語のに対応してヌルバイトで終らなければならない.
  • WSPutSymbol()はエラーがあると0を返し,関数が成功すると0以外の値を返す.
  • WSError()を使うと,WSPutSymbol()が不成功の場合にエラーコードを引き出すことができる.
  • WSPutSymbol()は,WSTPヘッダファイルwstp.hの中で宣言される.

例題

  (1)

#include "wstp.h"

/* send the expression Integrate[Sin[x],x] to a link */

void f(WSLINK lp)
{
    if(! WSPutFunction(lp, "Integrate", 2))
        { /* unable to put the function to lp */ }

    if(! WSPutFunction(lp, "Sin", 1))
        { /* unable to put the function to lp */ }

    if(! WSPutSymbol(lp, "x"))
        { /* unable to put the symbol to lp */ }

    if(! WSPutSymbol(lp, "x"))
        { /* unable to put the symbol to lp */ }

    if(! WSEndPacket(lp))
        { /* unable to send the end-of-packet indicator to lp */ }

    if(! WSFlush(lp))
        { /* unable to flush any outgoing data buffered in lp */ }
}