跳至主要內容

依條件查詢資料列清單 (LCC.db.list)

聲明​

rows, err = LCC.db.list(name, opts?, timeout?)

參數​

  • name
    字串型，表名稱，必須非空且不超過 256 位元組
  • opts
    表格型，可選；查詢參數表：
    • conditions：鍵值對形式的等值過濾條件（AND 組合）
    • order_by：字串型，排序欄位，預設 "id"
    • desc：布林值，是否降序，預設 false
    • limit：整數型，限制傳回的資料列數
    • offset：整數型，偏移量，預設 0
  • timeout
    數值型，可選；請求逾時時間（秒），預設 60

回傳值​

  • rows
    表格型，符合條件的資料列陣列；失敗時為 nil
  • err
    字串型或 nil，失敗時的錯誤描述（如 unknown column、unknown table）

說明​

依條件查詢資料列清單，所有使用者欄位的值均為字串。
傳回物件中的使用者欄位為字串，id 為數值。
不傳 opts 時預設傳回按 id 升序的全部資料。

範例​

local rows, err = LCC.db.list("任務表", {
    conditions = { 狀態 = "閒置" },
    order_by = "id",
    limit = 20
})
if rows then
    print("閒置任務數:", #rows)
end