MLGetInteger8List （C 関数）

MLGetInteger8ListはWSGetInteger8Listに置き換えられた．

int MLGetInteger8List( MLINK l , unsigned char ** i , int * c )

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

詳細

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

例題

例  (1)

#include "mathlink.h"

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

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

    /* ... */

    MLReleaseInteger8List(l, data, length);
}