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