Difference between revisions of "FOPEN()"
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
Line 8: | Line 8: | ||
==See Also== | ==See Also== | ||
− | [[FCREATE()]], [[FCLOSE()]], [[FERROR(),FREADSTR()]], [[FWRITE()]], [[MEMOREAD()]], [[MEMOWRITE()]], [[TEXTEDIT() | + | [[FCREATE()]], [[FCLOSE()]], [[FERROR()]], [[FREADSTR()]], [[FWRITE()]], [[MEMOREAD()]], [[MEMOWRITE()]], [[TEXTEDIT()]] |
Revision as of 14:38, 23 March 2009
Purpose
Function to open an existing ASCII text file
Syntax
FOPEN(<expC> [,expN>])
See Also
FCREATE(), FCLOSE(), FERROR(), FREADSTR(), FWRITE(), MEMOREAD(), MEMOWRITE(), TEXTEDIT()
Description
The FOPEN() function opens an existing ASCII text file. It returns a numeric file pointer when the file is opened successfully, or a -1 if unsuccessful. The <expC> is the name of the ASCII file to open. Since the file pointer is required to identify an open file to other file functions, always assign the return value to a memory variable. The optional <expN> determines the file access mode:
<expN> | Access Mode |
---|---|
If not specified, read-only | |
0 | Read-only |
1 | Write only. Existing contents are deleted. |
2 | Append. Text may be added to the end of the existing contents. |
If an error occurs, -1 is returned by the FERROR() function. The FCLOSE() function is used to close a file which has been opened with FOPEN().
Example
use accounts fp=fopen("existing.file") if ferror()=-1 dialog box "The file could not be opened." else string = fgets(fp,) do while not empty(string) ? string string = fgets(fp) enddo ? endif fclose(fp) if ferror()=-1 dialog box "The file could not be closed." endif
Products
Recital Database Server, Recital Mirage Server, Recital Terminal Developer