WSGetInteger32 （C 函数）

int WSGetInteger32(WSLINK link,int *i)

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

更多信息

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

范例

基本范例  (1)

#include "wstp.h"

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

void f(WSLINK lp)
{
    int data;

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

    /* use the integer */
}