メインコンテンツへ移動

条件を指定して行の一覧を照会する (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