<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="nstrnum">
  <refmeta>
    <refentrytitle>nstrnum</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>nstrnum</refname>
    <refpurpose>
      Returns the number of a named instrument.
      <indexterm id="IndexNstrnum"><primary>nstrnum</primary></indexterm>
    </refpurpose>
  </refnamediv>
  
  <refsect1>
    <title>Description</title>
    <para>
      Returns the number of a named instrument.
    </para>
  </refsect1>

  <refsect1>
    <title>Syntax</title>
    <synopsis>insno <command>nstrnum</command> &quot;name&quot;</synopsis>
  </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>insno</emphasis> -- the instrument number of the named instrument.
    </para>
  </refsect1>

  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>&quot;name&quot;</emphasis> -- the named instrument's name.
    </para>

    <para>
      If an instrument with the specified name does not exist, an init error occurs, and -1 is returned.
    </para>
  </refsect1>

  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &nameistvan;</member>
        <member>New in version 4.23</member>
        <member>Written in the year 2002.</member>
      </simplelist>
    </para>
  </refsect1>
</refentry>
