<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <title>push_f</title> <link rel="stylesheet" type="text/css" href="csound.css" /> <link rel="stylesheet" type="text/css" href="syntax-highlighting.css" /> <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /> <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" /> <link rel="up" href="DeprecatedTop.html" title="Deprecated Orchestra Opcodes and GEN Routines" /> <link rel="prev" href="push.html" title="push" /> <link rel="next" href="soundout.html" title="soundout" /> </head> <body> <div class="navheader"> <table width="100%" summary="Navigation header"> <tr> <th colspan="3" align="center">push_f</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="push.html">Prev</a> </td> <th width="60%" align="center">Deprecated Orchestra Opcodes and GEN Routines</th> <td width="20%" align="right"> <a accesskey="n" href="soundout.html">Next</a></td> </tr> </table> <hr /> </div> <div class="refentry"> <a id="push_f"></a> <div class="titlepage"></div> <a id="Indexpush_f" class="indexterm"></a> <div class="refnamediv"> <h2> <span class="refentrytitle">push_f</span> </h2> <p>push_f — Pushes an f-sig frame into the global stack. Deprecated. </p> </div> <div class="refsect1"> <a id="idm281472813056920"></a> <h2>Description</h2> <p> Pushes an f-sig frame into the global stack. </p> </div> <div class="refsect1"> <a id="idm281472813014552"></a> <h2>Syntax</h2> <pre class="synopsis"><span class="command"><strong>push_f</strong></span> fsig</pre> </div> <div class="refsect1"> <a id="idm281472813012120"></a> <h2>Performance</h2> <p> <span class="emphasis"><em>fsig </em></span> - f-signal to be pushed into the stack. </p> <p> The values are pushed into the global stack. The global stack works in LIFO order: after multiple <span class="emphasis"><em>push_f</em></span> calls, <a class="link" href="pop_f.html" title="pop_f"><em class="citetitle">pop_f</em></a> should be used in reverse order. </p> <p> push/pop for a, k, i, and S types copy data by value. By contrast, <span class="emphasis"><em>push_f</em></span> only pushes a "reference" to the f-signal, and then the corresponding <a class="link" href="pop_f.html" title="pop_f"><em class="citetitle">pop_f</em></a> will copy directly from the original variable to its output signal. For this reason, changing the source f-signal of <span class="emphasis"><em>push_f</em></span> before <a class="link" href="pop_f.html" title="pop_f"><em class="citetitle">pop_f</em></a> is called is not recommended, and if the instrument instance owning the variable that was passed by <span class="emphasis"><em>push_f</em></span> is deactivated before <a class="link" href="pop_f.html" title="pop_f"><em class="citetitle">pop_f</em></a> is called, undefined behavior may occur. </p> <p> <a class="link" href="pop_f.html" title="pop_f"><em class="citetitle">pop_f</em></a> and <span class="emphasis"><em>push_f</em></span> can only take a single argument, and the data is passed both at init and performance time. </p> <p> 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. </p> </div> <div class="refsect1"> <a id="idm281472813001272"></a> <h2>See also</h2> <p> <a class="link" href="stack.html" title="stack"><em class="citetitle">stack</em></a>, <a class="link" href="push.html" title="push"><em class="citetitle">push</em></a>, <a class="link" href="pop.html" title="pop"><em class="citetitle">pop</em></a> and <a class="link" href="pop_f.html" title="pop_f"><em class="citetitle">pop_f</em></a>. </p> </div> <div class="refsect1"> <a id="idm281472812996312"></a> <h2>Credits</h2> <p>By: Istvan Varga.</p> <p>2006</p> <p>Deprecated as of version 6.04.</p> </div> </div> <div class="navfooter"> <hr /> <table width="100%" summary="Navigation footer"> <tr> <td width="40%" align="left"><a accesskey="p" href="push.html">Prev</a> </td> <td width="20%" align="center"> <a accesskey="u" href="DeprecatedTop.html">Up</a> </td> <td width="40%" align="right"> <a accesskey="n" href="soundout.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">push </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> soundout</td> </tr> </table> </div> </body> </html>