替換單行內容 (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，失敗時為錯誤描述

說明

替換指定行號的單行內容。
line 為空字串時，會將目標行替換為空行，不會刪除該行。
行號規則詳見上方參數說明。
目標行存在時傳回替換前的舊值，便於比對或復原。
寫入位置超出現有內容時仍會寫入新行，舊值為 nil。

範例

local ok, old_line = LCC.web_file.set_line("/設定/list.txt", 1, "Alpha")
if ok then
    print("舊文字: " .. (old_line or ""))
end