macro/command/filecreate.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<TITLE>filecreate</TITLE>
<META http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="../../style.css" type="text/css">
</HEAD>
<BODY>

<DIV ALIGN="left">
<FONT SIZE="+2">filecreate</FONT><BR><BR>
</div>

Format:
<UL>
<B>
filecreate &lt;file handle&gt; &lt;filename&gt;
</B>
</UL>

<p>
Creates and opens a new file specified by &lt;filename&gt;.
</p>

<p>
The file pointer is set to the beginning of the file. If file &lt;filename&gt; already exists, its size is truncated to zero.</p>

<p>
If the file is successfully created and opened, the file handle is returned in the integer variable &lt;file handle&gt;. Otherwise, &lt;file handle&gt; is set to -1.
</p>

<p>
If the file is created successfully, the system variable "result" is set to 0. Otherwise, "result" is set to non-zero.
</p>

<pre>
Example:
        filecreate fhandle 'data.dat'
</pre>

</BODY>
</HTML>