跳到主要内容

# 插入单行文本 (LCC.web_file.insert_line)

## 声明​

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

## 参数​

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

## 返回值​

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

## 说明​

> 在指定行号前插入单行内容。
> 行号规则详见上方参数说明。
> 适合在固定标题后插入新配置或日志。

## 示例​

    local ok, err = LCC.web_file.insert_line("/配置/list.txt", 1, "Header")
    if not ok then
        error(err)
    end