Core Function FileOpen
From Sputnik Wiki
(Difference between revisions)
(→Example) |
|||
| (7 intermediate revisions by one user not shown) | |||
| Line 11: | Line 11: | ||
==== filename ==== | ==== filename ==== | ||
| − | Name of the | + | Name of the file to open (can be text or binary). |
==== flag ==== | ==== flag ==== | ||
| Line 19: | Line 19: | ||
* "" = Open existing file or create a new one with this name | * "" = Open existing file or create a new one with this name | ||
* "a" = Open existing file for appending data to it | * "a" = Open existing file for appending data to it | ||
| − | * "w" = Create a new file for writing | + | * "a+" = Open existing file for appending data to it or create a new file in write mode |
| + | * "w" = Create a new file for writing to (Will delete an existing file of this name) | ||
| + | * "w+" = Create a new file for writing to (Will NOT delete an existing file of this name) | ||
* "r" = Open existing file for reading (Will give exception if file does not exist) | * "r" = Open existing file for reading (Will give exception if file does not exist) | ||
| + | * "rw" = Open existing file for reading and writing (Will create if the file does not exist) | ||
| + | |||
| + | Default: "rw" | ||
=== Return Value === | === Return Value === | ||
| Line 26: | Line 31: | ||
Success: Returns a file "handle" for use with subsequent file functions | Success: Returns a file "handle" for use with subsequent file functions | ||
| − | Failure: Returns | + | Failure: Returns null if error occurs. |
=== Remarks === | === Remarks === | ||
| Line 36: | Line 41: | ||
<syntaxhighlight lang="sputnik"> | <syntaxhighlight lang="sputnik"> | ||
$File = FileOpen("MyFile.txt", "w"); | $File = FileOpen("MyFile.txt", "w"); | ||
| − | If( | + | If(isVarObj($File, "file")) // You could just use isObj($File) however adding the "file" will make sure it is indeed a file |
{ | { | ||
FileAppend( $File, "This is line 1\n" ); | FileAppend( $File, "This is line 1\n" ); | ||
Latest revision as of 10:36, 18 June 2015
FileOpen( <filename>, <flag> )
Contents |
Description
Opens a file for reading or writing.
Parameters
filename
Name of the file to open (can be text or binary).
flag
Mode (read or write) to open the file in options are:
- "" = Open existing file or create a new one with this name
- "a" = Open existing file for appending data to it
- "a+" = Open existing file for appending data to it or create a new file in write mode
- "w" = Create a new file for writing to (Will delete an existing file of this name)
- "w+" = Create a new file for writing to (Will NOT delete an existing file of this name)
- "r" = Open existing file for reading (Will give exception if file does not exist)
- "rw" = Open existing file for reading and writing (Will create if the file does not exist)
Default: "rw"
Return Value
Success: Returns a file "handle" for use with subsequent file functions
Failure: Returns null if error occurs.
Remarks
N/A
Example
$File = FileOpen("MyFile.txt", "w"); If(isVarObj($File, "file")) // You could just use isObj($File) however adding the "file" will make sure it is indeed a file { FileAppend( $File, "This is line 1\n" ); FileAppend( $File, "This is line 2\n" ); FileAppend( $File, "This is line 3\n" ); FileClose( $File ); }
