<?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>GEN23</title>
<link rel="stylesheet" href="csound.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
<link rel="up" href="ScoregensTop.html" title="Score Statements and GEN Routines" />
<link rel="prev" href="GEN22.html" title="GEN22" />
<link rel="next" href="GEN24.html" title="GEN24" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">GEN23</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="GEN22.html">Prev</a> </td>
<th width="60%" align="center">Score Statements and GEN Routines</th>
<td width="20%" align="right"> <a accesskey="n" href="GEN24.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="GEN23">
<a id="GEN23"></a>
<div class="titlepage"></div>
<a id="IndexGEN23" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">GEN23</span>
</h2>
<p>GEN23 —
Reads numeric values from a text file.
</p>
</div>
<div class="refsect1" title="Description">
<a id="id3741183"></a>
<h2>Description</h2>
<p>
This subroutine reads numeric values from an external ASCII file.
</p>
</div>
<div class="refsect1" title="Syntax">
<a id="id3741195"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>f</strong></span> # time size -23 "filename.txt"</pre>
</div>
<div class="refsect1" title="Initialization">
<a id="id3741780"></a>
<h2>Initialization</h2>
<p>
<span class="emphasis"><em>"filename.txt"</em></span> -- numeric values contained in "filename.txt" (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.
</p>
<p>
<span class="emphasis"><em>size</em></span> -- number of points in the table. Must be a power of 2 , power of 2 + 1, or zero. If <span class="emphasis"><em>size</em></span> = 0, table size is determined by the number of numeric values in <span class="emphasis"><em>filename.txt</em></span>. (New in Csound version 3.57)
</p>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Note: Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Note]" src="images/note.png" />
</td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>
All characters following ';' or '#' (comment) are ignored until next line (numbers too).
</p>
</td>
</tr>
</table>
</div>
</div>
<div class="refsect1" title="Credits">
<a id="id3741833"></a>
<h2>Credits</h2>
<p>
</p>
<table border="0" summary="Simple list" class="simplelist">
<tr>
<td>Author: Gabriel Maldonado</td>
</tr>
<tr>
<td>Italy</td>
</tr>
<tr>
<td>February, 1998</td>
</tr>
</table>
<p>
</p>
<p>New in Csound version 3.47. Comments starting with '#' are
ignored from Csound version 5.12.</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="GEN22.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="ScoregensTop.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="GEN24.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">GEN22 </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> GEN24</td>
</tr>
</table>
</div>
</body>
</html>
