macro/command/fileopen.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>fileopen</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>fileopen</h1>

<p>
Opens a file.
</p>

<pre class="macro-syntax">
fileopen &lt;file handle&gt; &lt;filename&gt; &lt;append flag&gt;
</pre>

<h2>Remarks</h2>

<p>
Opens a file specified by &lt;file name&gt;.<br>
If the file does not exist, it is created and then opened. If the file is successfully opened, the file handle is returned in the integer variable &lt;file handle&gt;. Otherwise, &lt;file handle&gt; is set to -1.<br>
If &lt;append flag&gt; is zero, the file pointer is set to the beginning of the file. If &lt;append flag&gt; is non-zero, the file pointer is set to the end of the file.
</p>

<h2>Example</h2>

<pre class="macro-example">
fileopen fhandle 'data.dat' 0
fileopen fhandle 'data.dat' 1
</pre>

<pre class="macro-example">
fileopen fhandle 'test.bat' 0
filewrite fhandle 'md .\v20080619_Test'
fileclose fhandle
pause 5
exec 'cmd /c test.bat'
pause 10
exit
</pre>

</body>
</html>