跳到主要内容

# 插入多行文本 (LCC.web_file.insert_lines)

## 声明​

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

## 参数​

- path
  字符串型，目标文件路径
- start_line
  数值型，插入基准行号；正数从 `1` 起算，在该行前插入；负数从末尾倒数，`0` 表示追加到末尾，`-1` 表示在最后一行前
- lines
  表类型，按顺序插入的字符串行
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- ok
  布尔型，插入成功返回 `true`，失败返回 `false`
- err
  字符串型或 `nil`，失败时的错误描述

## 说明​

> 在指定行号前插入多行内容。
> 行号规则详见上方参数说明。
> 起始行号超出现有行数时，中间会自动补空行。
> 函数会自动在插入内容末尾补充换行以保持文件结构。

## 示例​

    local ok, err = LCC.web_file.insert_lines("/配置/list.txt", 2, {"新条目1", "新条目2"})
    if not ok then
        error(err)
    end