AdiIRC

Main » Scripting » Scripting Commands »

Fopen » History » Revision 3

Revision 2 (Per Amundsen, 12/29/2019 05:05 PM) → Revision 3/4 (Per Amundsen, 02/16/2023 12:37 PM)

_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. 

 *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>