====== fopen ======

===== Description =====

Open a file for reading or writing.

===== Function prototype =====

<code>
voidptr fopen <string:FileName> <string:Mode>
</code>



===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //FileName//  |  string  | A string containing the name of the file to be opened. |
|  //Mode//  |  string  | A string containing the file access mode. Please see the [[http://www.cplusplus.com/reference/clibrary/cstdio/fopen/|fopen C/C++ documentation]] for more information. |

===== Return value =====

NULL if an error occurred, or a non-NULL handle to an opaque file object. 

===== Example =====

<code>
voidptr fp // create a file handle
set fp <zs:fopen "C:\\test.txt" "w"> // open the file, and assign the value to 'fp'
assert fp "Cannot open file!" // exit if file can't be opened

string s
set string "Hello!"
fwrite fp s // write text to file

fclose fp // close file
</code>

... the output of which is written to the 'C:\test.txt' file:

<file>
Hello!
</file>

===== Comments =====

None.




===== See also =====

  * [[plugins:general:zeoscript:reference:functions:fopen_s]]
  * [[plugins:general:zeoscript:reference:functions:fclose]]
  * [[plugins:general:zeoscript:reference:functions:fread]]
  * [[plugins:general:zeoscript:reference:functions:fwrite]]
  * [[plugins:general:zeoscript:reference:functions:fgetc]]
  * [[plugins:general:zeoscript:reference:functions:fputc]]
  * [[plugins:general:zeoscript:reference:functions:fseek]]
  * [[plugins:general:zeoscript:reference:functions:ftell]]
  * [[plugins:general:zeoscript:reference:functions:rewind]]