NAME
one_op -- one-shot execution of operands
PROTOTYPE
unitptr one_op( int iOperands, char *pcOptions, unitptr uHost)
ARGUMENTS
- int iOperands
- nr of operands
- char *pcOptions
- unused, for later extensions
- unitptr uHost
- host unit
RETURN VALUE:
A pointer to the created unit or NULL in the case of an error.
INTERFACE OF CREATED UNIT:
- CTL_in[]:
- (control field) A value of 0 disables any state
change of the one_op unit by an exec_unit call.
(and thus has an effect only when the unit was not yet
executed or has been reset since).
- X_out[1]:
- 0, if execution affects the operands, 1 if the
unit protects its operands.
DESCRIPTION:
The first execution call will execute all operands once and disable
the effect of any subsequent exec_unit and also adapt_unit calls (
adapt_unit
calls prior to the disabling execution call will have their normal
effect on the operands and will not change the state of the one_op
unit).
All subsequent exec_unit and also adapt_unit calls will be without effect
for the iOperands operands until a
NST_RESET or NST_INIT re-initializes the one_op unit.
CONTROL MODES:
NST_RESET or NST_INIT re-initializes the one_op unit.
NOTE:
The current policy with regard to the adapt_unit calls may be
subject to changes in future releases.
FILE
/homes/jontrup/nst5/man/../o.sol2//../nstsrc/nst_misc.c