Skip to main content

Get all lines from a text file (file.get_lines)

Declaration​

lines, err = file.get_lines(path)

Parameters​

  • path
    String. Absolute file path.

Returns​

  • lines
    Array or nil. Returns an array. nil if file does not exist.
  • err
    String. Error message when operation fails.

Notes​

Get all lines from a text file. Empty file returns 0 lines.
This function automatically strips UTF-8 BOM at the file head.

Example​

local lines = file.get_lines("/var/mobile/1.txt")
if lines then
    if #lines > 0 then
        sys.alert("First line is "..lines[1])
    else
        sys.alert("File is empty")
    end
else
    sys.alert("Operation failed")
end

Note: Uses sys.alert, string.strip_utf8_bom