Skip to main content

# Insert Multiple Lines (LCC.web_file.insert_lines)

## Signature​

    ok, err = LCC.web_file.insert_lines(path, start_line, lines, timeout?)

## Parameters​

- path
  String. File path.
- start_line
  Number. Reference line index for insertion. Positive numbers start at `1` and insert before that line; negative values count from the end, `0` appends after the last line, and `-1` inserts before the last line.
- lines
  Table. Array of line strings to insert in order.
- timeout
  Number, optional. Request timeout in seconds, default `60`.

## Returns​

- ok
  Boolean. `true` on success, `false` on failure.
- err
  String or `nil`. Error description when the operation fails.

## Notes​

> Inserts lines before the specified line index; see the parameter description above for line-number rules.
> When the target position is beyond the current end, blank lines are padded automatically.
> Newline structure is automatically preserved for the inserted content.

## Example​

    local ok, err = LCC.web_file.insert_lines("/config/list.txt", 2, {"New 1", "New 2"})
    if not ok then
        error(err)
    end