readLinesFromFile()

Synopsis

Reads lines from file and returns a list of strings , each string representing a line in the file.

Note: The file reader functions use a 1024-character buffer, and cannot handle lines longer than 1023 characters.

Alternatives for reading data from text files include the functions ReadInteger, ReadNumber, and ReadSimpleDataFile, the TextFile design , and the ADO.NET library.

Syntax

readLinesFromFile ( file As User, _
                    options As List ) As List 
Argument Type Description
file User A file handle previously created by a call to OpenFile.
options List A property-list style list containing name-value pairs indicating the option settings. The options are: :KeepBlankLines defaults to false . If true , blank lines are included in the output. :KeepCommentLines defaults to false . If true , lines beginning with '#' are included in the output. :TrimWhitespace defaults to true . If false , whitespace at the beginning and end of each line is included in the output, including the newline character(s) at the end. This never has an effect on whitespace within the line.