_Added in 1.8.10_

*/fopen [-nox] <handle> <filename>*

Opens the specified file and assigns a name to it for later reference. The open fails if the file does not exist.

_See also [[/fclose]], [[/fwrite]], [[/fseek]], [[/flist]], [[$fread]], [[$fgetc]], [[$feof]], [[$ferr]], [[$fopen]]._

*Switches*

table(ktable).
|*Switch*|*Description*|
| -n | Creates the file if it does not exists, fails if the file exists. |
| -o | Creates a new file, overwrites if it exists. |
| -x | Opens the file in exclusive access. |

*Parameters*

table(ktable).
|*Parameter*|*Description*|
| <handle> | Handle to assign the file. |
| <filename> | Path/Filename to open. |

*Example*

<pre>
alias fopen_example {
  ;Open hello.txt file.
  /fopen -n h hello.txt

  ;Error check
  if ($ferr) {
    /echo -sce info * /fopen_example: $err
    /halt
  }

  ;Write 'Hello There' to the file.
  /fwrite h Hello There

  ;Close the handle.
  /fclose h

  ;Open file in default editor.
  /run hello.txt
}
</pre>