push_f

push_f — Pushes an f-sig frame into the global stack.

Description

Pushes an f-sig frame into the global stack.

Syntax

push_f  fsig

Performance

fsig - f-signal to be pushed into the stack.

The values are pushed into the global stack. The global stack works in LIFO order: after multiple push_f calls, pop_f should be used in reverse order.

push/pop for a, k, i, and S types copy data by value. By contrast, push_f only pushes a "reference" to the f-signal, and then the corresponding pop_f will copy directly from the original variable to its output signal. For this reason, changing the source f-signal of push_f before pop_f is called is not recommended, and if the instrument instance owning the variable that was passed by push_f is deactivated before pop_f is called, undefined behavior may occur.

pop_f and push_f can only take a single argument, and the data is passed both at init and performance time.

Any stack errors (trying to push when there is no more space, or pop from an empty stack, inconsistent number or type of arguments, etc.) are fatal and terminate performance.

See also

stack, push, pop and pop_f.

Credits

By: Istvan Varga.

2006