Guardian Procedure Calls Reference Manual

CLOSEEDIT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Related Programming Manual
Summary
The CLOSEEDIT_ procedure closes a specified file that was opened by the OPENEDIT or OPENEDIT_
procedure. The procedure writes to disk any file updates that are still buffered, optionally closes
the file through the file system, and finally deallocates all data blocks in the EDIT file segment (EFS)
that are associated with the file.
CLOSEEDIT_ is an IOEdit procedure and can be used only with files that have been opened by
OPENEDIT or OPENEDIT_.
Syntax for C Programmers
#include <cextdecs(CLOSEEDIT_ )>
short CLOSEEDIT_ ( short filenum
,[ short keep-filenum ] );
Syntax for TAL Programmers
error := CLOSEEDIT_ ( filenum ! i
,[ keep-filenum ] ); ! i
Parameters
filenum
input
INT:value
is the number that identifies the open file to be closed.
keep-filenum
input
INT:value
if supplied and not equal to 0, causes CLOSEEDIT_ to not close the file through the file system,
but to perform the rest of its normal operation. This makes it possible to keep the open file
number for use in later processing.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Related Programming Manual
For programming information about the CLOSEEDIT_ procedure, see the Guardian Programmer's
Guide.
176 Guardian Procedure Calls (C)