MLGetInteger32 （C 関数）

MLGetInteger32はWSGetInteger32に置き換えられた．

int MLGetInteger32(MLINK link,int *i)

link で指定されたMathLink接続から32ビットの整数を得て，i に保持する．

詳細

  • リンク上のデータが実数に対応するものであれば，MLGetInteger32()はそれを整数に丸める．
  • リンク上のデータが，ユーザのコンピュータシステム上のC言語のint型で保持するには大きすぎる整数に対応するものであれば，MLGetInteger32()は失敗し，0を返す．
  • 任意精度の整数は，まずIntegerDigitsで桁数のリストを生成し，次にMLGetInteger32List()を呼び出せば得られる．
  • MLGetInteger32()は関数が成功すると0以外の値を返す．
  • MLError()を使うと，MLGetInteger32()が不成功の場合にエラーコードを引き出すことができる．
  • MLGetInteger32()は，MathLinkヘッダファイルmathlink.hの中で宣言される．

例題

例  (1)

#include "mathlink.h"

/* read a 32-bit integer from a link */

void f(MLINK lp)
{
    int data;

    if(! MLGetInteger32(lp, &data))
        { /* unable to read an integer from lp */ }

    /* use the integer */
}