/fopen

Indice

• Contents
• Synopsis
• Switches
• Parameters
• Example
• Broken Compatibility
• Compatibility
• See also

The /fopen command opens and assigns it a handle. The file is opened for both writing and reading: see file handling”). If an error occurred, processing does not halt. You must check that $fopen”)().err or $ferr”) is not true.

Synopsis

/fopen [-no] <handle> <filename>

Switches

• -n - Create a new file, fails if already exists
• -o - Creates a new file, overriding an old one if exists
• -x - Opens the file in exclusive mode (will fail to open if already in use)

Parameters

• - A handle associated with an open file.
• - The filename to open.

Example

A simple example that prints one line to a new file:

; simple fopen example
alias fopen_example {
  .fopen -n h hello.txt
  ;error check
  if ($ferr) {
    echo -sce info * /fopen_example: example.txt already exists!
    halt
  }
  ;print text
  .fwrite h Hello There
  ;close the handle
  .fclose h
  ;open file in default editor
  run hello.txt
}

A script that prints all the permutations of there-characters to a file.

; print permutations [aaa]-[zzz]
alias perm_example {
  .fopen -n h example.txt
  ;error check
  if ($ferr) {
    echo -sce info * /fopen_example: example.txt already exists!
    halt
  }
  ;print all the permutations to the file
  var %x = 97
  while (%x < 123) {
    var %y = 97
    while (%y < 123) {
      var %z = 97
      while (%z < 123) {
        .fwrite -n h $+($chr(%x), $chr(%y), $chr(%z))
        inc %z
      }
      inc %y
    }
    inc %x
  }
  ;close the handle
  .fclose h
}

Broken Compatibility

in mIRC 7.22 /fopen left the handle open even after it failed. The compatibility change stated above was changed back to the old behavior in mIRC 7.24.

Compatibility

Added: 29/08/2003

See also

• List of commands
• List of identifiers
• $fopen”)
• $fread”)
• $fgetc”)
• $feof”)
• $ferr”)
• $file”)
• /fclose
• /flist
• /fseek
• /fwrite

mIRC commands list