Получить описание результирующей выборки

Назначение
 

Функция DB:: tableInfo предоставляет описание результирующей выборки.

Синтаксические правила
mixed tableInfo (DB_Result $result[, mode $mode]);
$result

Результирующая выборка.

$mode

Формат предоставляемой информации:

  1. по умолчанию:

    • [0]["table"] – имя таблицы;

    • [0]["name"] – имя поля;

    • [0]["type"] – тип данных поля;

    • [0]["len"] – длина поля;

    • [0]["flags"] – флаги поля;

  2. DB_TABLEINFO_ORDER:

    • ["num_fields"] – количество записей в данной структуре;

    • [0]["table"] – имя таблицы;

    • [0]["name"] – имя поля;

    • [0]["type"] – тип данных поля;

    • [0]["len"] – длина поля;

    • [0]["flags"] – флаги поля;

    • ["order"]["имя поля"] номер элемента "имя поля" в данном массиве. Используется в случае, если предполагается доступ к полям по их именам, а не порядковым номерам. Проверка: if (isset($result['meta']['myfield'])) { ...

  3. DB_TABLEINFO_ORDERTABLE:

    • возвращает массив той же структуры, что и при DB_TABLEINFO_ORDER, но с дополнением: ["ordertable"][table name][field name] номер поля с именем "field name". Это позволяет обрабатывать поля из разных таблиц с одинаковыми именами.

Возвращаемое значение

Результаты обработки запроса:

  • mixed – массив описаний в соответствии с заданным форматом в случае успешного выполнения запроса;

  • DB_Error-объект – в случае ошибки при выполнении запроса.