Skip to main content

# Replace A Range Of Lines (LCC.web_file.set_range_lines)

## Signature​

    ok, replaced_or_err = LCC.web_file.set_range_lines(path, start_line, lines, timeout?)

## Parameters​

- path
  String. File path.
- start_line
  Number. Starting line index; positive numbers start at `1`, negative values count from the end (`-1` is the last line), and `0` means after the end.
- lines
  Table. Array of new line strings.
- timeout
  Number, optional. Request timeout in seconds, default `60`.

## Returns​

- ok
  Boolean. `true` on success, `false` on failure.
- replaced_or_err
  Table or string. Replaced original lines on success, or the error description on failure.

## Notes​

> Overwrites multiple lines at once starting from the given position.
> See the parameter description above for line-number rules.
> When the target position is beyond the current end, blank lines are padded automatically.
> Returns `{}` when no existing lines were replaced.
> The returned old content is useful for auditing or undo flows.

## Example​

    local ok, old_lines_or_err = LCC.web_file.set_range_lines("/config/list.txt", 2, {"Beta", "Gamma"})
    if ok then
        print("Original:", table.concat(old_lines_or_err, ","))
    end