WSPutUTF16String （C 関数）

int WSPutUTF16String(WSLINK link,const unsigned short *s,int len)

長さlen のUTF-16文字列s を，link で指定されたWSTP接続に置く．

詳細

  • WSPutUTF16String()は文字列s の文字数を自動的に測定する．
  • UTF-16のコード化形式でコード化された文字列 s は，バイトオーダーマークで始まらなければならない．
  • 文字列の長さ len には，バイトオーダーマークが含まれなければならない．
  • WSPutUTF16String()はエラーがあると0を返し，関数が成功すると0以外の値を返す.
  • WSError()を使うと，WSPutUTF16String()が不成功の場合にエラーコードを引き出すことができる.
  • WSPutUTF16String()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* send the expression N[10/Sin[2]] to a link */

void f(WSLINK lp)
{
    unsigned short expr[13];

    expr[0]  = 0xFEFF;
    expr[1]  = 'N';
    expr[2]  = '[';
    expr[3]  = '1';
    expr[4]  = '0';
    expr[5]  = '/';
    expr[6]  = 'S';
    expr[7]  = 'i';
    expr[8]  = 'n';
    expr[9]  = '[';
    expr[10] = '2';
    expr[11] = ']';
    expr[12] = ']';

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

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

    if(! WSPutUTF16String(lp, (const unsigned short *)expr, 13))
        { /* unable to put the expression string to lp */ }

    if(! WSEndPacket(lp))
        { /* unable to put the end-of-packet indicator to lp */ }
    
    if(! WSFlush(lp))
        { /* unable to flush any outgoing data buffered in lp */ }
}