cubrid_fetch_field
(PECL CUBRID >= 8.3.1)
cubrid_fetch_field — Получение информации о столбце результирующего набора в виде объекта
Описание
$result
, int $field_offset
= 0
) : objectФункция возвращает объект, в свойствах которого содержится информация о столбце. Свойства объекта:
-
name
-
имя столбца
-
table
-
имя таблицы
-
def
-
значение столбца по умолчанию
-
max_length
-
максимальная длина столбца
-
not_null
-
1, если не может быть NULL
-
primary_key
-
1, если является первичным ключом
-
unique_key
-
1, если является уникальным ключом
-
multiple_key
-
1, если является неуникальным ключом
-
numeric
-
1, если содержит числовое значение
-
blob
-
1, если содержит BLOB
-
type
-
тип столбца
-
unsigned
-
1, если беззнаковый тип
-
zerofill
-
1, если дополняется нулями
Список параметров
-
result
-
Result
, полученный из cubrid_execute() -
field_offset
-
Числовой индекс столбца. Если не задан, то будет извлечен следующий, не извлеченный этой функцией, столбец.
field_offset
начинается с нуля.
Возвращаемые значения
Объект с описанными выше свойствами в случае успешного выполнения.
false
в случае возникновения ошибки.
Примеры
Пример #1 Пример использования cubrid_fetch_field()
<?php
$conn = cubrid_connect("localhost", 33000, "demodb");
$req = cubrid_execute($conn, "SELECT event_code,athlete_code,nation_code,game_date FROM game WHERE host_year=1988 and event_code=20001;");
var_dump(cubrid_fetch_row($req));
cubrid_field_seek($req, 1);
$field = cubrid_fetch_field($req);
printf("\n--- Field Properties ---\n");
printf("%-30s %s\n", "имя столбца:", $field->name);
printf("%-30s %s\n", "имя таблицы:", $field->table);
printf("%-30s \"%s\"\n", "значение столбца по умолчанию:", $field->def);
printf("%-30s %d\n", "максимальная длина столбца:", $field->max_length);
printf("%-30s %d\n", "не может быть NULL:", $field->not_null);
printf("%-30s %d\n", "является первичным ключом:", $field->primary_key);
printf("%-30s %d\n", "является уникальным ключом:", $field->unique_key);
printf("%-30s %d\n", "является неуникальным ключом:", $field->multiple_key);
printf("%-30s %d\n", "содержит числовое значение:", $field->numeric);
printf("%-30s %d\n", "содержит BLOB:", $field->blob);
printf("%-30s %s\n", "тип столбца:", $field->type);
printf("%-30s %d\n", "беззнаковый тип:", $field->unsigned);
printf("%-30s %d\n", "дополняется нулями:", $field->zerofill);
cubrid_close_request($req);
cubrid_disconnect($conn);
?>
Результат выполнения данного примера:
array(4) { [0]=> string(5) "20001" [1]=> string(5) "16681" [2]=> string(3) "KOR" [3]=> string(9) "1988-9-30" } --- Field Properties --- имя столбца: athlete_code имя таблицы: game значение столбца по умолчанию: "" максимальная длина столбца: 0 не может быть NULL: 1 является первичным ключом: 1 является уникальным ключом: 1 является неуникальным ключом: 0 содержит числовое значение: 1 содержит BLOB: 0 тип столбца: integer беззнаковый тип: 0 дополняется нулями: 0