MLGetInteger16 （C 関数）

MLGetInteger16はWSGetInteger16に置き換えられた．

int MLGetInteger16(MLINK link,short *i)

link で指定されたMathLink接続から16ビットの整数を得て，C関数のshort型としてi に保持する．

詳細

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

例題

例  (1)

#include "mathlink.h"

/* read a short integer from a link */

void f(MLINK lp)
{
    short s;

    if(! MLGetInteger16(lp, &s))
        { /* unable to read the integer from lp */ }

    /* use the short integer */
}