WSInitialize （C 函数）

WSENV WSInitialize(char* p)

初始化 WSTP 环境对象并传递参数 p.

更多信息

  • 执行程序时，WSTP 环境对象存储 WSTP 的全局状态.
  • 程序可使用参数对象 p 安装自定义的内存分配器.
  • 当从 WSTP 模板中创建一个外部程序，会自动产生一个对 WSInitialize() 的合适调用.
  • 任何使用 WSTP 库的外部程序必须在调用任何其他 WSTP 库函数之前调用 WSInitialize() .
  • WSTP 环境函数作为一个工厂来创建链接对象.
  • WSTP 的标头文件 wstp.h 已对 WSInitialize() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

int main(int argc, char **argv)
{
    WSENV ep;
    WSLINK lp;
    int error;

    ep = WSInitialize((WSEnvironmentParameter)0);
    if(ep == (WSENV)0)
        { /* unable to initialize environment */ }

    lp = WSOpenArgcArgv(ep, argc, argv, &error);
    if(lp == (WSLINK)0 || error != WSEOK)
        { /* unable to create link */ }

    /* ... */

    WSClose(lp);
    WSDeinitialize(ep);
    return 0;
}