Equinox Online Help - Language Reference - A to Z
FileInputLine |
|
|---|---|
| Applies to |       |
| Syntax | FileInputLine HandleItem, Item1[, Item2, Item3 ... ] |
| Action | [Statement] Reads a list of items from a sequential file up to the end of the line. |
| Scope | Usable anywhere. |
| Notes | This statement is identical to FileInput, except that a whole line is always read, ensuring that each input statement starts on a new line. This is convenient for reading lines which may contain different numbers of items. After the call, the system workarea SysReply contains the number of items read. The system workarea SysError is set to one of the following values
If Equinox reads fewer items than the number of variables supplied as parameters, or if the delimiters supplied in the statement are different to those found in the file, SysError is set to one. In all cases, SysReply is set to the number of items read. |
| Category | File IO |
| See Also | FileClose, FileCloseAll, FileDelimiters, FileInput, FileInputLine, FileLock, FileMovePosition, FileOpen, FilePosition, FilePrint, FileRead, FileReadLine, FileReadBinary, FileReadFile, FileUnlock, FileWrite, FileWriteBinary, FileWriteFile |
| Example | This example reads records from a sequential file, line by line. The file was written by a small program controlling a weather station, which writes data collected from instruments into a line of a text file. Each line starts with the name of the instrument and the time of the event, followed by the data, which is different for each instrument. The instrument name is converted into a numeric type and the other information is stored in fields in the record. handle hnd |