D3Codex
PickBASIC / FlashBASIC

%close() function

.md

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→

Referenced by

1 topic mentions %close() function in its description.

FlashBASIC features that function differently in D3 Windows vs. UNIX