跳到主要内容

替换行区间内容 (LCC.web_file.set_range_lines)

声明​

ok, replaced_or_err = LCC.web_file.set_range_lines(path, start_line, lines, timeout?)

参数​

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

返回值​

  • ok
    布尔型，成功时为 true，失败时为 false
  • replaced_or_err
    表类型或字符串型；成功时返回被替换掉的原行内容数组，失败时返回错误描述

说明​

在指定位置覆盖多行文本。
行号规则详见上方参数说明。
起始行号超出现有行数时，中间会自动补空行。
成功但没有覆盖到已有行时返回空表 {}。
返回的旧内容可用于记录或回滚。

示例​

local ok, old_lines_or_err = LCC.web_file.set_range_lines("/配置/list.txt", 2, {"Beta", "Gamma"})
if ok then
    print("原内容:", table.concat(old_lines_or_err, ","))
end