Skip to main content

# Read A Single Line (LCC.web_file.get_line)

## Signature​

    line, err = LCC.web_file.get_line(path, line_number, timeout?)

## Parameters​

- path
  String. File path.
- line_number
  Number. Line index to read; positive numbers start at `1`, negative values count from the end (`-1` is the last line), and `0` means after the last line.
- timeout
  Number, optional. Request timeout in seconds, default `60`.

## Returns​

- line
  String or `nil`. Text of the requested line; returns an empty string when the line is not found, and `nil` only on failure.
- err
  String or `nil`. Only set when the call fails.

## Notes​

> Built on top of `get_range_lines` to fetch a single line.
> Positive numbers start at `1`; negative values count from the end (`-1` is the last line); `0` means after the last line.
> Returns an empty string when the specified line is not found.

## Example​

    local line, err = LCC.web_file.get_line("/config/list.txt", 3)
    if line then
        print("Line 3: " .. line)
    end