WSSetAllocParameter (C 関数)

void WSSetAllocParameter(WSEnvironmentParameter p,WSAllocator a,WSDeallocator d)

WSEnvironmentParameterオブジェクトp の中に,ad によって指定されたメモリアロケータとデアロケータを,後でWSInitialize()で使用するために設定する.

詳細

  • WSSetAllocParameter()を使うと,WSTPライブラリに特別なメモリアロケータをインストールすることができる.ライブラリはad で指定されたアロケータを使って,すべての同時メモリ割当てを行うようになる.
  • ad は,C言語のメモリアロケータ(割当て)関数である malloc()free()と同じ呼出し署名を持たなくてはならない.
  • ad は同じ位置に現れる要素をまとめることができるものでなくてはならない.
  • WSSetAllocParameter()は,WSTPヘッダファイルwstp.hの中で宣言される.

例題

  (1)

#include "wstp.h"

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

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


int main()
{
    WSEnvironment env;
    WSEnvironmentParameter p;
    unsigned long revision;

    p = WSNewParameters(WSREVISION, WSAPIREVISION);
    if(p == (WSEnvironmentParameter)0))
    { /* unable to initialize the WSEnvironmentParameters object */ }

    WSSetAllocParameter(ep, Custom_Allocator, Custom_Deallocator);

    /* Install the Custom* memory allocator in WSTP. */
    env = WSInitialize(ep);
    if(env == (WSENV)0)
    { /* unable to initialize WSTP environment */ }

    WSReleaseParameters(p);

    /* ... */

    WSDeinitialize(env);
    return 0;
}