メインコンテンツへ移動

1 行の内容を置換する (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、失敗時はエラー説明です

説明​

指定した行番号の内容を 1 行置換します。
line が空文字列の場合、対象行を空行に置き換えます。行そのものは削除しません。
行番号の規則については、上記の引数説明を参照してください。
対象行が存在する場合は置換前の値を返すため、比較やロールバックに利用できます。
書き込み位置が既存の内容を超える場合も新しい行を書き込み、元の値は nil になります。

例​

local ok, old_line = LCC.web_file.set_line("/設定/list.txt", 1, "Alpha")
if ok then
    print("元のテキスト: " .. (old_line or ""))
end