WSPutString （C 関数）

int WSPutString(WSLINK link,const char*s)

ヌル終端のC言語の文字列をlink で指定されたWSTP接続に置く．

詳細

  • 文字列中の原始文字バックスラッシュは，2文字，つまり「∖∖」として送信されなければならない．
  • 特殊文字はWSGetString()が返す形式でのみ，送信可能である．
  • 通常使用されるコード化形式はWSGetString()で使用されるものと同じである．
  • WSPutString()はエラーがあると0を返し，関数が成功すると0以外の値を返す.
  • WSError()を使うと，WSPutString()が不成功の場合にエラーコードを引き出すことができる.
  • WSPutString()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* send a string representing an expression to a Mathematica kernel
   for evaluation */

void f(WSLINK lp)
{
    /* construct the packet to be sent to the kernel */
    WSPutFunction(lp, "EvaluatePacket", 1);
    WSPutFunction(lp, "ToExpression", 1);
    WSPutString(lp, (const char *)"3+4/Sqrt[19.2]");
    WSEndPacket(lp);

    /* send the packet */
    if(! WSFlush(lp))
        { /* unable to flush an outgoing data buffered in lp */ }

}