WSPutByteString （C 関数）

int WSPutByteString(WSLINK link,const unsigned char *s,int n)

s の場所から始まるn 文字の文字列をlink で指定されたWSTP接続に置く．

詳細

  • 文字列中のすべての文字は，Wolfram言語のToCharacterCode から得られる文字コードを使って指定されたものでなければならない．
  • したがって，改行は∖nではなく，原始文字コードを使って指定されなければならない．
  • WSPutByteString()はコードが256未満の文字しか扱わない．
  • 通常のASCII文字はもちろん，ISO ラテン-1 文字も扱える．
  • WSPutByteString()はエラーがあると0を返し， 関数が成功すると0以外の値を返す.
  • WSError()を使うと，WSPutByteString()が不成功の場合にエラーコードを引き出すことができる.
  • WSPutByteString()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* transfer a string from a source link to a destination link */

void f(WSLINK sourcelink, WSLINK destinationlink)
{
    const unsigned char *string;
    int length;

    if(! WSGetByteString(sourcelink, &string, &length, 0))
        { /* unable to get the string from sourcelink */ }

    if(! WSPutByteString(destinationlink, string, length))
        { /* unable to put the string to destination link */ }
}