CLOSE

CLOSE (LET)

Let Subcommand

Close a file associated with a given unit number.

When Dataplot opens a file, it will be attached to a specific unit number between 1 and 99. This command can be used to close a currently open file based on its associated unit number. This syntax is typically used by Dataplot developers for debugging purposes.

Enter HELP FILE SWITCHES to see a list of files that can be opened by Dataplot. See the Program example for an example of using the PROBE command to obtain the relevant unit number.

LET <iflag> = CLOSE <unit>
where <unit> is an numeric value between 1 and 99;
and      <iflag> is a parameter that contains the status value from the close.

This syntax closes the file associated with the specified unit number. The status from the CLOSE command is saved in <iflag>.

If the specified unit is not attached to a file, <iflag> will typically have a value of 0.

LET <iflag> = CLOSE DELETE <unit>
where <unit> is an numeric value between 1 and 99;
and      <iflag> is a parameter that contains the status value from the close.

This syntax closes the file associated with the specified unit number. The status from the CLOSE command is saved in <iflag>. In addition, this syntax will delete the file when it is closed.

If the specified unit is not attached to a file, <iflag> will typically have a value of 0.

LET IFLAG = CLOSE 44
LET IFLAG = CLOSE DELETE 44

The unit number should be entered as a literal number. If you have the unit number stored as a parameter, you can use the "^" character as in
LET IFLAG = CLOSE ^IVAL

None

None

INQUIRE	=	Inquire whether the specified file exists.
FILE SWITCHES	=	Probe for unit numbers associated with certain files.

Debugging

2016/06

 
PROBE IWRINU
LET UNIT = PROBEVAL
LET IFLAG = CLOSE ^UNIT