The %close() function closes the UNIX file specified by file.descriptor returned by a previous call to %open(), %creat(), %dup(), %socket(), or %accept().
All host OS files opened from a FlashBASIC program are closed automatically at main program termination. However, it is a safe practice to close files explicitly.
NOTE |
You must use %socketclose if attempting to close a socket file descriptor in Windows. |
Syntax
var = %close(file.descriptor) |
CAUTION |
Closing one of the system files (stdin, stdout, and so on) has unpredictable results. |
Example(s)
if %close(fd) then crt ’Cannot close file’ stop end |
Note the use of the implicit (void) casting by not including the statement as part of an assignment. The return code of the close is thrown away.
See Also
%accept() Function, %connect() Function, %creat() Function, %dup() Function, %fsize() Function, %listen() Function, %open() Function, %socket() Function, %ttyname() Function, %unlink ()Function, FlashBASIC C Functions Overview, cfunction Statement