WSEnvironmentParameter （C 函数）

是一种 WSTP 类型，表示一个 WSTP 程序库的环境参数设置.

更多信息

  • WSTP 环境参数对象存储用于配置 WSTP 环境对象的设置.
  • WSEnvironmentParameter 在 WSTP 标头文件 wstp.h 中定义，对于任何 WSTP 兼容的程序，它应该被包含在源代码中.
  • WSEnvironmentParameter 对象由 WSNewParameters() 函数创建，由 WSReleaseParameters() 函数释放.
  • WSTP 标头文件 wstp.h 已对 WSEnvironmentParameters 作出声明.

范例

基本范例  (1)

#include "wstp.h"


void * Custom_Allocator(size_t size)
{
    /* ... */
}

void Custom_Deallocator(void *ptr)
{
    /* ... */
}


int main()
{
    WSEnvironmentParameter ep;
    WSENV env;
    
    ep = WSNewParameters(WSREVISION, WSAPIREVISION);
    if(ep == (WSEnvironmentParameter)0)
    { /* Unable to initialize WSEnvironmentParameter object */ }

    WSSetAllocParameter(ep, Custom_Allocator, Custom_Deallocator);

    /* Give the WSTP library the custom memory allocator */
    env = WSInitialize(ep);
    if(env == (WSENV)0)
    { /* Unable to initialize the WSTP environment */ }

    WSReleaseParameters(ep);

    /* ... */

    WSDeinitialize(env);

    return 0;
}