WSNewParameters （C 函数）

WSEnvironmentParameter WSNewParameters(unsigned long rev,unsigned long apirev)

分配并初始化 WSEnvironmentParameter 对象，将 WSTP 修订版本号设为 rev 指定的值，将 WSTP API 修订版本号设为 apirev 指定的值.

更多信息

  • WSTP 修订版本号和 WSTP API 修订版本号应设置为 wstp.h 中恒定的 WSREVISION 和 WSAPIREVISION.
  • WSNewParameters() 为必须释放的 the WSEnvironmentParameter 对象分配内存. 调用 WSReleaseParameters() 可释放 WSNewParameters() 分配的内存.
  • 如果出错，WSNewParameters() 返回 NULL.
  • WSNewParameters() 在 WSTP 标头文件 wstp.h 中被声明.

范例

基本范例  (1)

#include <stdlib.h>
#include "wstp.h"

/* initialize the WSTP environment */

WSENV f(void)
{
    WSENV env;
    WSEnvironmentParameter p;
    unsigned long res;

    p = WSNewParameters(WSREVISION, WSAPIREVISION);
    if(p == (WSEnvironmentParameter)0)
    { /* Unable to initialize parameter object */ }

    WSSetAllocParameter(p, malloc, free);

    env = WSInitialize(p);
    if(env == (WSENV)0)
    { /* Unable to initialize the WSTP environment */ }

    WSReleaseParameters(p);

    return env;
}