pop_f

pop_f — Pops an f-sig frame from the global stack. Deprecated.

Description

Plugin opcode in stackops.

Pops an f-sig frame from the global stack.

Syntax

fsig pop_f

Performance

fsig - f-signal to be popped from the stack.

The values are popped the stack. The global stack must be initialized before used, and its size must be set. 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.

push_f and pop_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 push_f.

Credits

By: Istvan Varga.

2006

Deprecated as of version 6.04.