WSNewParameters （C 関数）

WSEnvironmentParameter WSNewParameters(unsigned long rev,unsigned long apirev)

WSEnvironmentParameterオブジェクトを割り当てて初期化して，WSTPの改訂番号をrev で指定された値に，そしてWSTPのAPI 改訂番号をapirev で指定された値に設定する．

詳細

  • WSTPの改訂番号とWSTPのAPI改訂番号は，wstp.hからの定数WSREVISIONとWSAPIREVISIONに設定されるべきである．
  • WSNewParameters()は，解放しなければならないWSEnvironmentParameterオブジェクトにメモリを割り当てる．WSNewParameters()で割り当てられたメモリを解放するには，WSReleaseParameters()を呼び出すとよい．
  • 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;
}