next up previous contents
Up: Text File Scanning Previous: Fetch next Line

Close File for Scanning

This Subprogram closes the currently opened Scan File. It is not necessary following the detection of End-of-File by UI_LINE_SCAN, but only if the Application Programmer wishes to terminate the file scan prematurely.

Short Name Calling Sequence

STATUS = UICLSN([DUMMY])

Long Name Calling Sequence

STATUS = UI_CLOSE_SCAN(...)

Input Arguments

DUMMY (Integer) Dummy Function Argument

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

  1. This Subprogram has no effect if no File is opened for Scanning via a prior call to UI_OPEN_SCAN.
  2. This Subprogram must be called before attempting any calls to Prompted Input, Menu or Definition File Subprograms after a call to UI_OPEN_SCAN unless an End-of-File indication has been received from Subprogram UI_LINE_SCAN, in which case this Subprogram is called implicitly.



Liz Buckle
Fri Jan 13 17:28:23 CST 1995