Библиотека организации базы данных для Quest Soft Player

Функции модуля

Устанавливает значение ячейки.

Внимание!!! Если в ячейке уже присутствует значение, оно будет затёрто новым.

Аргументы:

$args[0] или args[0] - значение, присваиваемое ячейке.
$args[1] - идентификатор строки. Если не указан, используется идентификатор из указателя текущей строки.
$args[2] - идентификатор колонки. Если не указан, используется идентификатор из указателя текущей колонки.
$args[3] - идентификатор таблицы данных. Если не указан, используется идентификатор из указателя текущей таблицы.

Пример:

@edb.cell.set_value('Инвентарь', $s, 'place', 'objects')

Возвращает значение ячейки.

Аргументы:

$args[0] - идентификатор строки. Если не указан, используется идентификатор из указателя текущей строки.
$args[1] - идентификатор колонки. Если не указан, используется идентификатор из указателя текущей колонки.
$args[2] - идентификатор таблицы данных. Если не указан, используется идентификатор из указателя текущей таблицы.

Пример:

@edb.cell.get_value($i, 'place', 'objects')
@edb.cell.get_value($s, 'place')
@edb.cell.get_value()

Прибавляет значение ячейке.

Данная функция по разному обрабатывает ячейки в колонках разных типов:

'num' — значение ячейки увеличивается на указанное число.
'str' — к значению ячейки приклеивается переданное значение (конкатенация).
'list' — добавляет к списку указанное значение.
'tuple' — увеличить число элементов в ячейке, в которой хранится кортеж, нельзя, однако можно изменить уже записанное в кортеж значение. В $args[0] при этом так же должен быть передан кортеж типа ($значение, #позиция).
'dict' — то же, что и 'str'.
'ids' — значения в колонке такого типа нельзя изменять через функции 'easy.database'.

Аргументы:

$args[0] или args[0] - значение, присваиваемое ячейке.
$args[1] - идентификатор строки. Если не указан, используется идентификатор из указателя текущей строки.
$args[2] - идентификатор колонки. Если не указан, используется идентификатор из указателя текущей колонки.
$args[3] - идентификатор таблицы данных. Если не указан, используется идентификатор из указателя текущей таблицы.

Пример:

@edb.cell.add(34, $d, 'count', 'objects')
@edb.cell.add('34')

Удаляет значение ячейки.

Данная функция по разному обрабатывает ячейки в колонках разных типов:

'num' — значение ячейки уменьшается на указанное число.
'str' — из значения ячейки удаляется первое вхождение переданного значения.
'list' — удаляет из списка указанное значение. Если значение повторяется в списке, будут удалены все.
'tuple' — уменьшить число элементов в ячейке, в которой хранится кортеж, нельзя, однако можно изменить уже записанное в кортеж значение. В $args[0] при этом должно быть передано либо значение, либо номер очищаемого элемента кортежа.
'dict' — то же, что и 'str'.
'ids' — значения в колонке такого типа нельзя изменять через функции 'easy.database'.

Аргументы:

$args[0] или args[0] - значение, присваиваемое ячейке.
$args[1] - идентификатор строки. Если не указан, используется идентификатор из указателя текущей строки.
$args[2] - идентификатор колонки. Если не указан, используется идентификатор из указателя текущей колонки.
$args[3] - идентификатор таблицы данных. Если не указан, используется идентификатор из указателя текущей таблицы.

Пример:

@edb.cell.del(34, $d, 'count', 'objects')
@edb.cell.del('body')

easy.database.qsp v. 0.2