[back] [prev] [next] [index] [root]

<p>&nbsp;<p>
<hr noshade size="5">
<h2><a name="Open"></a>
Open
</h2>

(Re)opens a file.

<p><p>

<h3>
Syntax:
</h3>
<pre>f := Open(name, mode);
ok := Open(f);</pre>

<p>

<table>
<tr>
<td>File</td>
<td><pre>  f  </pre></td>
<td></td>
</tr>
<tr>
<td>string</td>
<td><pre>  name  </pre></td>
<td></td>
</tr>
<tr>
<td>string</td>
<td><pre>  mode  </pre></td>
<td></td>
</tr>
<tr>
<td>boolean</td>
<td><pre>  ok  </pre></td>
<td></td>
</tr>
</table>

<p>


See also:&nbsp;&nbsp;<a href="kashref.html#BagRead">BagRead</a>, <a href="kashref.html#BagWrite">BagWrite</a>, <a href="kashref.html#Close">Close</a>, <a href="kashref.html#ECHOon">ECHOon</a>, <a href="kashref.html#ECHOoff">ECHOoff</a>, <a href="kashref.html#FLDin">FLDin</a>, <a href="kashref.html#FLDout">FLDout</a>, <a href="kashref.html#LOFILES">LOFILES</a>

<p>

<h3>
Description:
</h3>
The <tt> Open</tt> function opens the file specified in the
argument <tt> name</tt>. The type of operations you intend to
perform on the file must be given in the argument {\tt
mode}. The following table explains the values that the
<tt> mode</tt> string can take.\medskip

\begin{tabular}{lp{7cm}}
Access mode & Interpretation \hline
<tt> "r"</tt> & Opens file for read operations.
<tt> "w"</tt> & Opens a new file for writing. If the file
exists, its content is destroyed.
<tt> "a"</tt> & Opens file for appending. A new file
is created if the file does not exist.
<tt> "R"</tt> & Opens file for {\sl unbuffered} read
operations. This mode should be used
in connection with the <tt> FLDin</tt>
function.
\end{tabular}\medskip

If the file is successfully opened, <tt> Open</tt> returns a
<tt> File</tt> object <tt> f</tt>, an object to be used in
subsequent I/O operations on the file. The <tt> File</tt> object
is a structure which contains information about the name of
the file, the access mode and the status indicating whether
the file is opened or closed. In case of an error, {\tt
Open} returns <tt> false</tt>.\bigskip

<p><p>

<p>
<hr>
<p>
<h3>
Example:
</h3>
We will open, close and reopen a file named "dummy". 
<pre>

kash> f := Open("dummy","w");
Filename: dummy / Mode: w / Open (fid): 5
kash> Close(f);
true
kash> f;
Filename: dummy / Mode: w / Closed
kash> Open(f);
true
kash> f;
Filename: dummy / Mode: w / Open (fid): 5

</pre>

<p>


<hr>

<p>
<a href="../kashref.html"><- back</a>[back] [prev] [next] [index] [root]