Home / Autodocs / dos.library
NAME
- Close
-
Close an open file
SYNOPSIS
success = Close( file )
BOOL Close(BPTR)
D0 D1
FUNCTION
The file specified by the FileHandle is closed. You must close all files you explicitly opened, but you must not close inherited file handles that are passed to you (each FileHandle must be closed once and ONLY once). If Close() fails, the FileHandle is still deallocated and should not be used.
INPUTS
- file
-
BCPL pointer to a FileHandle
RESULT
- success
-
returns if Close() succeeded. Note that it might fail depending on buffering and whatever IO must be done to close a file being written to.
NOTES
The Close() function did not have a return value prior to V36!
If Close() returns FALSE, it does not mean that closing the file has failed and the file remains open. To the contrary, the file will have been closed, the file is no longer open, but any write operations such as caused by buffered file I/O may have failed.
You should not close files unless you called Open() or OpenFromLock() to create or open them.
Starting from V47 onwards, Close(0) does nothing and returns immediately.
If Close() returns FALSE, it does not mean that closing the file has failed and the file remains open. To the contrary, the file will have been closed, the file is no longer open, but any write operations such as caused by buffered file I/O may have failed.
You should not close files unless you called Open() or OpenFromLock() to create or open them.
Starting from V47 onwards, Close(0) does nothing and returns immediately.