WSENV （C 関数）

WSTP形式の一つでWSTPライブラリ環境を表す．

詳細

  • WSTP環境オブジェクトは，プログラムの実行中にWSTPの大域状態を保存する．
  • WSENVは，ファイルwstp.hの中で定義される．このことは，WSTPと互換性がある任意のプログラムのソースコードに含まれなくてはならない．
  • WSENVオブジェクトはWSInitialize()関数によって作成され，WSDeinitialize()関数によって割当てを解かれる．
  • それぞれのWSTPプログラムは，WSTPの他の機能性にアクセスする前にWSENVオブジェクトを作成しなくてはならない．
  • WSENVは，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

int main(int argc, char **argv)
{
    WSENV env;
    WSLINK link;
    int error;

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

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

    /* ... */

    WSClose(link);
    WSDeinitialize(env);
    return 0;
}