BASICFlashBASIC C functionsFlashBASIC C functions list%close() function

%close() function

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

Parent topic: FlashBASIC C functions list