Fopen - Revision history

Cail at 07:59, 2 July 2007

2007-07-02T07:59:27Z

← Older revision		Revision as of 07:59, 2 July 2007
Line 28:		Line 28:
	This will create "moo oo.txt" on C:\ and open it with the name moo. If moo.txt already existed on C:\, it fails.		This will create "moo oo.txt" on C:\ and open it with the name moo. If moo.txt already existed on C:\, it fails.

			== See Also ==
			* [[Fclose\|/fclose]] to close an open file handler.
			* [[Why and how to use File Handlers]]

	[[Category:File Handling]][[Category:Commands]]		[[Category:File Handling]][[Category:Commands]]

Doomie: added category:commands

2005-12-18T22:33:36Z

added category:commands

← Older revision		Revision as of 22:33, 18 December 2005
Line 29:		Line 29:


	[[Category:File Handling]]		[[Category:File Handling]][[Category:Commands]]

Doomie at 22:32, 18 December 2005

2005-12-18T22:32:35Z

New page

Opens the specified file and assigns a name to it for later reference.
/fopen [-no] <name> <filename>

If the file doesn't exist, the opening fails (if -n switch isn't specified).

Explanation of the switches:
{| style="width:100%"
|-
| style="width:10%" | '''''Switch''''' || Style="width:90%" | '''''Meaning'''''
|-
| n || creates the file if it doesn't already exist, fails if the file does exist.
|-
| o || creates a new file, overwrites if it exists.
|}

'''Note''' that if /fopen fails, the script will continue to run. To check whether it failed or not, you have to take a look at [[$ferr]] and [[$feof]]. It also echos it to the active window:
''* fopen unable to open '<name>' (<filename>)'', however, if you want to make it silent, use ''.fopen''.

== Example ==
/fopen version version.txt
This will "open" the file version.txt in your mircdirectory and assings the name "version" to it.
If it doesn't exist in your mircdirectory, /fopen will fail (and echo it to the active window).

/fopen -n moo "C:\moo oo.txt"
This will create "moo oo.txt" on C:\ and open it with the name moo. If moo.txt already existed on C:\, it fails.

[[Category:File Handling]]