Запрос списка строк по условиям (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