WSGetReal64 （C 函数）

int WSGetReal64(WSLINK link,double *x)

从 link 中获取一个双精度的浮点数，并把它存在 x 中.

更多信息

  • 如果链接中的数据对应于 C int，在把它存在 x 前， WSGetReal64() 会将它强行变为一个 double.
  • 如果链接中数据对应的数超出计算机系统 C double 的范围，那么 WSGetReal64() 将失败并返回0.
  • 任意精度的实数以由 RealDigits 产生的数字序列在 WSTP 程序间传递，一般是整数数组或十进制字符的字符串该序列可以用 WSGetInteger32List() 或 WSGetString() 读取.
  • 若发生错误，则 WSGetReal64() 返回0；若函数成功则，返回非零值.
  • 如果 WSGetReal64() 失败，则使用 WSError() 检索错误代码.
  • WSTP 的标头文件 wstp.h 已对 WSGetReal64() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* read a double-precision floating-point number from a link */

void f(WSLINK lp)
{
    double r;

    if(! WSGetReal64(lp, &r))
        { /* unable to read the floating-point number from lp */ }

    /* ... */
}