WSAllocParameter （C 関数）

int WSAllocParameter(WSEnvironmentParameter*p,WSAllocator*a,WSDeallocator*d)

現行のメモリアロケータ（割当て）とデアロケータ（解放）関数ポインタをWSEnvironmentParameterオブジェクト p から検索して，a と d に保存する．

詳細

  • WSAllocParameter()は，WSError()のように標準エラー値を使ってエラーコードを返す．
  • 成功すると，WSAllocParameter()はWSEOKを返す．
  • WSEnvironmentParameterオブジェクトはWSTP環境の実行時間の特性をコントロールするのに使われる.
  • WSAllocParameter()はWSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (1)

#include "wstp.h"

/* retrieves the memory allocator and deallocator function pointers  
   from WSParameters */

void f(WSEnvironmentParameter p)
{
    WSAllocator a;
    WSDeallocator d;
    int result;

    result = WSAllocParameter(p, &a, &d);
    if(result != WSEOK)
        { /* unable to retrieve the memory allocator pointers */ }

    /* ... */
}