wave_free_WSDH

Frees space associated with a Wave structure definition handle when it is no longer needed.

 

Note:

Any Wave Variable Handle (WVH) or Wave Structure Definition Handle (WSDH) returned from such PV-WAVE OPI interface routines as wave_get_WVH(), wave_wsdh_from_WVH() or wsdh_element() must be freed by the calling routine via wave_free_WVH or wave_free_WSDH or resource leaks will develop.

C Usage

void wave_free_WSDH(WSDHptr) 

WSDH *WSDHptr;

FORTRAN Usage

SUBROUTINE LF_WAVE_FREE_WSDH(l_wsdh)

INTEGER*4 l_wsdh

64-bit UNIX FORTRAN Usage

SUBROUTINE LF_WAVE_FREE_WSDH(l_wsdh)

INTEGER*8 l_wsdh

Input Parameters

WSDHptr—A pointer to a Wave Structure Definition Handle (WSDH).

Discussion

This function must be called to free the space associated with the Wave structure definition handle when it is no longer needed. This does not destroy the structure definition in PV‑WAVE, it only frees the space associated with the handle.