WSEnvironmentParameter （C 関数）

WSTPライブラリの環境パラメータ集合を表すWSTPタイプである．

詳細

  • WSTPの環境パラメータオブジェクトは，WSTP環境オブジェクトを設定するのに使われた設定を保存する．
  • WSEnvironmentParameterは，WSTPヘッダファイルwstp.hで定義される．これは任意のWSTPの互換プログラムについてのソースコードに含まれるべきものである．
  • WSEnvironmentParameterオブジェクトは，WSNewParameters()関数によって作成され，WSReleaseParameters()関数によって割当てを解除される．
  • WSEnvironmentParameterは，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (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;
}