WSPutRawSize （C 関数）

int WSPutRawSize(WSLINK link, int s)

長さがs バイトの未加工の文字データあるいは数値データを受け取ることができるようにlink の準備をする．

詳細

  • WSPutRawSize()をWSPutType()，WSPutRawData()と一緒に使うと，WSPutInteger32()あるいはWSPutUTF8String()等の型特定のAPI関数を使わずに手入力でデータをリンクに置くことができる．
  • WSPutRawSize()はエラーがあると0を返し，関数が成功するとゼロ以外の値を返す．
  • WSError()を使うと，WSPutRawSize()が不成功の場合にエラーコードを引き出すことができる．
  • WSPutRawSize()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* send a function as raw data to a link */

void f(WSLINK lp)
{
    int a = 2, b = 3;

    if(! WSPutType(lp, WSTKFUNC))
        { return; /* unable to put the function type to lp */ }

    if(! WSPutArgCount(lp, 2))
        { return; /* unable to put the number of arguments to lp */ }

    if(! WSPutType(lp, WSTKOLDSYM))
        { return; /* unable to put function head type to lp */ }
    
    if(! WSPutRawSize(lp, 4))
        { return; /* unable to put the size of the symbol to lp */ }

    if(! WSPutRawData(lp, (const unsigned char *)"Plus", 4))
        { return; /* unable to put the raw bytes to lp */ }

    if(! WSPutType(lp, WSTK_CINT))
        { return; /* unable to put the argument type to lp */ }

    if(! WSPutRawSize(lp, sizeof(int)))
        { return; /* unable to put the size of the integer to lp */ }

    if(! WSPutRawData(lp, (const unsigned char *)&a, sizeof(a)))
        { return; /* unable to put the raw bytes of a to lp */ }

    if(! WSPutType(lp, WSTK_CINT))
        { return; /* unable to put the second argument type to lp */ }

    if(! WSPutRawSize(lp, sizeof(int)))
        { return; /* unable to put the size of the integer to lp */ }

    if(! WSPutRawData(lp, (const unsigned char *)&b, sizeof(b)))
        { return; /* unable to put the raw bytes of b to lp */ }
}