Замена содержимого одной строки (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