wave_interp
Executes a compiled PV‑WAVE command.
C Usage
long wave_interp(wch)
WCH wch;
FORTRAN Usage
Not available.
Input Parameters
wch—A Wave Code Handle for the compiled, PV-WAVE code to be executed, returned from the
wave_compile routine.
Returned Status
OPI_SUCCESS—Successful.
OPI_FAILURE—Errors occurred but execution can continue.
OPI_DO_NOT_PROCEED—Errors occurred and execution should not continue. The calling C-code should do its cleaning up (free malloc’s space, free handles, etc.) and return to its caller immediately.
In either of the error cases, PV‑WAVE has already done its normal error processing, which includes printing a message and setting the appropriate system variables.
Discussion
The wave_interp function executes the PV‑WAVE code previously compiled by wave_compile, and referenced by the wch handle. If the wch handle is not a valid handle, OPI_FAILURE is returned. If the execution of the compiled code fails, OPI_DO_NOT_PROCEED is returned.
