WSGetInteger16 (C 函数)

int WSGetInteger16(WSLINK link,short *i)

从由 link 指定的 WSTP 连接中获取一个16位整数并以 C short 存在 i 中.

更多信息

  • 如果链接中的数据对应于实数,WSGetInteger16() 会将其四舍五入为整数.
  • 如果链接中数据对应的整数太大,不能存为你的计算机系统的 C short,那么,WSGetInteger16() 将失败并返回0.
  • 获取任意精度整数,可以首先使用 IntegerDigits 获取数字列表,然后调用 WSGetInteger16List().
  • 如果函数成功,WSGetInteger16() 返回非零值.
  • 如果 WSGetInteger16() 失败,则使用 WSError() 检索错误代码.
  • WSTP 的标头文件 wstp.h 已对 WSGetInteger16() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* read a short integer from a link */

void f(WSLINK lp)
{
    short s;

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

    /* use the short integer */
}