跳到主要内容

# 替换单行内容 (LCC.web_file.set_line)

## 声明​

    ok, old_line_or_err = LCC.web_file.set_line(path, line_number, line, timeout?)

## 参数​

- path
  字符串型，目标文件路径
- line_number
  数值型，要写入的行号；正数从 `1` 起算，负数从末尾倒数（`-1` 为最后一行），`0` 表示末行之后
- line
  字符串型，新内容
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- ok
  布尔型，成功时为 `true`，失败时为 `false`
- old_line_or_err
  字符串型或 `nil`；成功时为被替换的旧文本，若原位置没有现有内容则为 `nil`，失败时为错误描述

## 说明​

> 替换指定行号的单行内容。
> 行号规则详见上方参数说明。
> 目标行存在时返回替换前的旧值，便于比对或回滚。
> 写入位置超出现有内容时仍会写入新行，旧值为 `nil`。

## 示例​

    local ok, old_line = LCC.web_file.set_line("/配置/list.txt", 1, "Alpha")
    if ok then
        print("旧文本: " .. (old_line or ""))
    end