Функции Язык программирования PHP

sesam_field_array

(только PHP 3 CVS)

sesam_field_array - возвращает метаинформацию об отдельных столбцах результата.

Описание

array sesam_field_array (string result_id)

result_id это правильный идентификатор результата, возвращённый функцией sesam_query().

Возвращает смешанный ассоциативно-индексированный массив meta-информации (имя столбца, тип, точность, ...) об отдельных столбцах результата выполнения запроса, ассоциированного с result_id.

Таблица 1. Смешанный результирующий набор, возвращаемый функцией sesam_field_array()
Элемент Массива Содержимое
int $arr["count"] общее количество столбцов в результирующем наборе (или нуль, если это был "immediate" запрос/query). SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов.
string $arr[col]["name"] имя столбца column(col), где col в диапазоне от 0 до $arr["count"]-1. Возвращаемое значение может быть пустой строкой (для динамически обсчитываемых столбцов). SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов, каждый с тем же именем столбца.
string $arr[col]["count"] атрибут "count" описывает фактор повторения, когда столбец объявлен как "multiple field". Обычно атрибут "count" равен 1. Первый столбец "multiple field"-столбца, однако, содержит количество повторений (второй и последующий столбцы "multiple field" содержат атрибут "count", равный 1). Это можно использовать для определения "multiple fields" в результирующем наборе. См. пример в описании sesam_query() - использование атрибута "count".
string $arr[col]["type"] тип php-переменной данных для column(col), где col в диапазоне от 0 до $arr["count"]-1. Возвращается одно из следующих значений:

в зависимости от SQL-типа результата. SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов, каждый с тем же РНР-типом.

string $arr[col]["sqltype"] SQL-тип переменной данных столбца для column(col), где col в диапазоне от 0 до $arr["count"]-1. Возвращается одно из следующих значений:

  • "CHARACTER"

  • "VARCHAR"

  • "NUMERIC"

  • "DECIMAL"

  • "INTEGER"

  • "SMALLINT"

  • "FLOAT"

  • "REAL"

  • "DOUBLE"

  • "DATE"

  • "TIME"

  • "TIMESTAMP"

описывая SQL-тип результата. SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов, каждый того же SQL-типа.

string $arr[col]["length"] SQL-атрибут "length" SQL-переменной в column(col), где col в диапазоне от 0 до $arr["count"]-1. Атрибут "length" используется с SQL-типами "CHARACTER" и "VARCHAR" для специфицирования (максимальной) длины строковой переменной. SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов, каждый с тем же атрибутом length.
string $arr[col]["precision"] атрибут "precision" SQL-переменной в column(col), где col в диапазоне от 0 до $arr["count"]-1. Атрибут "precision" используется с числовыми и время-дата типами. SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов, каждый с тем же атрибутом precision.
string $arr[col]["scale"] атрибут "scale" SQL-переменной в column(col), где col в диапазоне от 0 до $arr["count"]-1. Атрибут "scale" используется с числовыми типами данных. SESAM "multiple fields" являются "inlined" и рассматриваются как соответствующее количество столбцов, каждый с тем же атрибутом scale.

См. в sesam_query() пример использования sesam_field_array().

Назад Оглавление Вперёд
sesam_fetch_row Вверх sesam_field_name

Повторение

Повторение специфицируется квантификаторами, которые могут идти после любого из следующих элементов:

одиночного символа, возможно, мнемонизированного
метасимвола .
класса символов
обратной ссылки/back reference (см. следующий раздел)
субпатэрна в скобках (если это не утверждение/assertion, см. далее)

Квантификатор общего повторения специфицирует минимальное и максимальное количество допустимых совпадений, имея два числа в фигурных скобках, разделённые запятой. Число обязано быть менее 65536, а первое обязано быть меньше или равно второму. Например:

z{2,4}

совпадает с "zz", "zzz" или "zzzz". Закрывающая фигурная скобка сама по себе не является специальным символом. Если второе число отсутствует, но запятая есть, верхнего предела нет; если отсутствуют второе число и запятая, квантификатор специфицирует точное количество необходимых совпадений.