<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="greaterthan">
  <refmeta>
    <refentrytitle>&gt;</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>&gt;</refname>

    <refpurpose>
      Determines if one value is greater than another.
      <indexterm id="IndexGt"><primary>&gt;</primary></indexterm>
      <indexterm id="IndexGtExpression"><primary>conditional expressions</primary></indexterm>
      <indexterm id="IndexGtQuestion"><primary>?</primary></indexterm>
      <indexterm id="IndexGtColon"><primary>:</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Determines if one value is greater than another.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis>(a <command>&gt;</command>  b <command>?</command> v1 <command>:</command> v2)</synopsis>

    <para>
      where <emphasis>a</emphasis>, <emphasis>b</emphasis>, <emphasis>v1</emphasis> and <emphasis>v2</emphasis> may be expressions, but <emphasis>a</emphasis>, <emphasis>b</emphasis> not audio-rate.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      In the above conditionals, <emphasis>a</emphasis> and <emphasis>b</emphasis> are first compared. If the indicated relation is true (<emphasis>a</emphasis> greater than <emphasis>b</emphasis>, <emphasis>a</emphasis> less than <emphasis>b</emphasis>, <emphasis>a</emphasis> greater than or equal to <emphasis>b</emphasis>, <emphasis>a</emphasis> less than or equal to <emphasis>b</emphasis>, <emphasis>a</emphasis> equal to <emphasis>b</emphasis>, <emphasis>a</emphasis> not equal to <emphasis>b</emphasis>), then the conditional expression has the value of <emphasis>v1</emphasis>; if the relation is false, the expression has the value of <emphasis>v2</emphasis>. (For convenience, a sole &quot;<emphasis>=</emphasis>&quot; will function as &quot;<emphasis>= =</emphasis>&quot;.)
    </para>

    <para>
      NB.: If <emphasis>v1</emphasis> or <emphasis>v2</emphasis> are expressions, these will be evaluated before the conditional is determined.
    </para>

    <para>
      In terms of binding strength, all conditional operators (i.e. the relational operators (<emphasis>&lt;</emphasis>, etc.), and <emphasis>?</emphasis>, and <emphasis>:</emphasis> ) are weaker than the arithmetic and logical operators (<emphasis>+</emphasis>, <emphasis>-</emphasis>, <emphasis>*</emphasis>, <emphasis>/</emphasis>, <emphasis>&amp;</emphasis> and <emphasis>||</emphasis>).
    </para>

    <para>
      These are <emphasis>operators</emphasis> not <emphasis>opcodes</emphasis>. Therefore, they can be used within orchestra statements, but do not form complete statements themselves.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the &gt; opcode. It uses the files <ulink url="examples/greaterthan.orc"><citetitle>greaterthan.orc</citetitle></ulink> and <ulink url="examples/greaterthan.sco"><citetitle>greaterthan.sco</citetitle></ulink>.

      <example>
        <title>Example of the &gt; opcode.</title>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/greaterthan.orc" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>

        <programlisting>
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="examples/greaterthan.sco" format="linespecific">
            </imageobject>
          </inlinemediaobject>
        </programlisting>
      </example>

      Its output should include lines like this:
      <screen>
k1 = 2.000000, k2 = 0.000000
k1 = 3.000000, k2 = 0.000000
k1 = 4.000000, k2 = 1.000000
      </screen>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="equals"><citetitle>==</citetitle></link>,
      <link linkend="greaterequal"><citetitle>&gt;=</citetitle></link>,
      <link linkend="lessequal"><citetitle>&lt;=</citetitle></link>,
      <link linkend="lessthan"><citetitle>&lt;</citetitle></link>,
      <link linkend="notequal"><citetitle>!=</citetitle></link>
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>Example written by &namekevin;.</para>
  </refsect1>
</refentry>
