| filename$ - path and name of the file to open |
|
Opens an existing file for reading. Returns a file stream handle, or 0 if the file could not be opened (usually because it does not exist - always check before reading a save file that might not be there yet). Feed the handle to the read commands that match how the file was written: ReadLine for plain text, ReadByte/ReadShort/ReadInt/ReadFloat/ReadString for binary data written by their Write counterparts, or ReadBytes to pull a block straight into a bank. Use Eof to spot the end of the file, and CloseFile when you are done. The same read commands also work on TCP streams, so code that parses a file can often parse a network stream unchanged. See also: WriteFile, OpenFile, CloseFile, ReadLine, Eof. |
; ReadFile Example
; ----------------
; Create a save-game file so there is something to read
file=WriteFile("demo_savegame.dat")
WriteString file,"Robo"
WriteInt file,11657
CloseFile file
; ReadFile opens an existing file for reading.
; It returns 0 if the file cannot be opened - always check!
file=ReadFile("no_such_file.dat")
If file=0 Then Print "no_such_file.dat could not be opened (handle = 0)"
; Open the real save and read it back in the order it was written
file=ReadFile("demo_savegame.dat")
name$=ReadString$(file)
score=ReadInt(file)
CloseFile file
Print "Loaded save: name="+name$+", score="+score
; Clean up the demo file
DeleteFile "demo_savegame.dat"
Print "Deleted demo_savegame.dat"
Print ""
Print "Press any key to close the example"
WaitKey
End