WSReleaseLinksFromEnvironment (C 関数)

void WSReleaseLinksFromEnvironment( WSENV env , WSLINK * l , int n )

WSGetLinksFromEnvironment()によって割り当てられたメモリを解放して,長さ n のリストである l にリンクを保存する.

詳細

  • リスト l は,WSGetLinksFromEnvironment()への呼出しから得られたものでなければならない.
  • WSReleaseLinksFromEnvironment()は,WSTPヘッダファイルwstp.hの中で宣言される.

例題

  (1)

#include "wstp.h"

/* A function for retrieving the current links open from an environment */

void f(WSENV env)
{
    WSLINK *theList;
    int length;

    if(! WSGetLinksFromEnvironment(env, &theList, &length))
    { /* Unable to get the list of links */ }

    /* ... */

    WSReleaseLinksFromEnvironment(env, theList, length);    
}