eldo_user

Eldo Control Language
Library of Functions for Tasks
nextval
Task function category: Functions Operating on Waveforms
Returns the next point of a waveform. Returns 0 if there are no more points in the waveform,
otherwise x_res and y_res are set with the coordinates of the next point of the waveform.
Usage
nextval(wf, x_res, y_res)
Arguments
• wf
Waveform identifier.
• x_res
Variable name for X coordinate of next point in waveform. Must be a double-precision
floating-point variable otherwise an error is generated.
• y_res
Variable name for Y coordinate of next point in waveform. Must be a double-precision
floating-point variable otherwise an error is generated. If wf is a complex waveform, then
y_res must be a complex number.
Description
Must be called after beginval.
Examples
Example 1:
/* here, the float value 0.0 and not the integer 0 must be assigned to x
and y otherwise there will be an error when calling beginval and nextval.
*/
set x = 0.0
set y = 0.0
set iter = 0
iter = beginval(wave1, x, y)
while (iter != 0)
fprint(stdout, "(%12.4e;%12.4e)\n", x, y)
iter = nextval(wave1, x, y)
endwhile
Example 2:
940
Eldo® User's Manual, 15.3