<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="GEN23">
  <refmeta>
    <refentrytitle>GEN23</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>GEN23</refname>
    <refpurpose>
      Reads numeric values from a text file.
      <indexterm id="IndexGEN23"><primary>GEN23</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      This subroutine reads numeric values from an external ASCII file.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>f</command> # time size -23 &quot;filename.txt&quot;</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>&quot;filename.txt&quot;</emphasis> -- numeric values contained in &quot;filename.txt&quot; (which indicates the complete pathname of the character file to be read), can be separated by spaces, tabs, newline characters or commas.  Also, words that contains non-numeric characters can be used as comments since they are ignored.
    </para>

    <para>
      <emphasis>size</emphasis> -- number of points in the table. Must be a power of 2 , power of 2 + 1, or zero.  If <emphasis>size</emphasis> = 0, table size is determined by the number of numeric values in <emphasis>filename.txt</emphasis>. (New in Csound version 3.57)
    </para>

    <note>
      <title>Note</title>
      <para>
        All characters following ';' (comment) are ignored until next line (numbers too).
      </para>
    </note>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namegabriel;</member>
        <member>Italy</member>
        <member>February, 1998</member>
      </simplelist>
    </para>

    <para>New in Csound version 3.47</para>
  </refsect1>
</refentry>
