Executes a compiled PV‑WAVE command.

long wave_interp(wch)

WCH wch;

Not available.

wch—A Wave Code Handle for the compiled, PV-WAVE code to be executed, returned from the wave_compile routine.

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.

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.