替换单行内容 (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