WSPutUTF32Symbol （C 関数）

int WSPutUTF32Symbol(WSLINK link,const unsigned int *s,int len)

その名前がUTF-32でコード化されていて長さが len の文字列 s で与えられる記号を，link で指定されたWSTP接続に置く．

詳細

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

例題

例  (1)

#include "wstp.h"

/* send the symbol $SessionID to a link */

void f(WSLINK lp)
{
    unsigned int symb[11];

    symb[0] = 0xFEFF;
    symb[1] = '$';
    symb[2] = 'S';
    symb[3] = 'e';
    symb[4] = 's';
    symb[5] = 's';
    symb[6] = 'i';
    symb[7] = 'o';
    symb[8] = 'n';
    symb[9] = 'I';
    symb[10] = 'D';

    if(! WSPutUTF32Symbol(lp, (const unsigned int *)symb, 11))
        { /* unable to send the symbol to lp */ }
}