This shows you the differences between two versions of the page.
— |
close [2006/07/25 21:22] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | # $EPIC: close.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ | ||
+ | ======Synopsis:====== | ||
+ | $close(<file descriptor>) | ||
+ | |||
+ | ======Technical:====== | ||
+ | This function unbinds the given file descriptor (previously returned by | ||
+ | the $[[open]]() function) from the underlying file, causing the file to be | ||
+ | committed to disk if necessary. An error is returned if it is passed a | ||
+ | file descriptor not produced by an $[[open]]() call. | ||
+ | |||
+ | ======Practical:====== | ||
+ | This function is used to close a file that was opened for reading or | ||
+ | writing by $[[open]](). Data corruption may result if the client exits | ||
+ | before all open files are closed. | ||
+ | |||
+ | ======Returns:====== | ||
+ | <file> | ||
+ | -1 error | ||
+ | 0 file closed successfully | ||
+ | </file> | ||