Table of Contents

fopen

Description

Open a file for reading or writing.

Function prototype

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

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

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

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

Hello!

Comments

None.

See also