WSGetInteger8 （C 函数）

int WSGetInteger8( WSLINK l , unsigned char * i )

从 WSTP 连接中获取一8位整数，记做 l，储存在 i 中.

更多信息

  • 若链接中的数据对应于某实数，WSGetInteger8() 会将其四舍五入为整数.
  • 若连接中的数据对应的整数过大，导致无法在计算机系统中储存入 C 无符号字节，则 WSGetInteger8() 失败，并返回0.
  • 首先使用 IntegerDigits 生成数字列表，然后调用 WSGetInteger8List()，则可获得任意精度的整数.
  • 若函数 WSGetInteger8() 成功，则返回一非零函数值.
  • 若 WSGetInteger8() 失败，可使用 WSError() 检索错误代码.
  • WSTP 的标头文件 wstp.h. 已对 WSGetInteger8() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function to read an unsigned char from a link */

void f(WSLINK l)
{
    unsigned char c;

    if(! WSGetInteger8(l, &c))
    { /* Unable to read the integer from l */ }

    /* Use the integer */
}