WSPutUCS2String （C 関数）

int WSPutUCS2String(WSLINK link,const unsigned short *s,int n)

n 個の16ビットのUCS-2 文字列を，link で指定されたWSTP接続に置く．

詳細

  • すべての文字は，16ビットの文字であると想定される．
  • 高次のバイトをヌルにすることによって，8バイトの文字を送信することができる．
  • WSPutUCS2String()はエラーがあると0を返し，関数が成功すると0以外の値を返す.
  • WSError()を使うと，WSPutUCS2String()が不成功の場合にエラーコードを引き出すことができる.
  • WSPutUCS2String()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* send the string "Hello World" to a link */

void f(WSLINK lp)
{
    unsigned short str[11];

    str[0] = 'H';
    str[1] = 'e';
    str[2] = 'l';
    str[3] = 'l';
    str[4] = 'o';
    str[5] = ' ';
    str[6] = 'W';
    str[7] = 'o';
    str[8] = 'r';
    str[9] = 'l';
    str[10] = 'd';

    if(! WSPutUCS2String(lp, (const unsigned short *)str, 11))
        { /* unable to put the string to lp */ }
}