WSGetInteger8List （C 関数）

int WSGetInteger8List( WSLINK l , unsigned char ** i , int * c )

l で指定したWSTP接続から8ビットの整数のリストを得て，整数を配列 i に，そしてリストの長さを c に保存する．

詳細

  • WSGetInteger8List()は，整数の配列についてメモリを割り当てる．このメモリを解放する場合は，WSReleaseInteger8List()を呼び出さなければならない．WSGetInteger8List()が失敗し，関数の戻り値がエラーを示す場合には，i の内容に対してWSReleaseInteger8List()を呼び出してはならない．
  • WSGetInteger8List()は，不変のデータを返す．
  • WSGetInteger8List()は，エラーがあった場合には0を返し，関数が成功した場合には非零の値を返す．
  • WSGetInteger8List()が失敗した場合には，WSError()を使ってエラーコードを得るとよい．
  • WSGetInteger8List()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* A function for reading a list of 8-bit integers from a link */

void f(WSLINK l)
{
    unsigned char *data;
    int length;
    
    if(! WSGetInteger8List(l, &data, &length))
    { /* Unable to read the integer list from the link */ }

    /* ... */

    WSReleaseInteger8List(l, data, length);
}