mysqli_result::fetch_field
mysqli_fetch_field
(PHP 5, PHP 7)
mysqli_result::fetch_field -- mysqli_fetch_field — Возвращает следующее поле результирующего набора
Описание
Объектно-ориентированный стиль
public mysqli_result::fetch_field
(
) : object
Процедурный стиль
Возвращает информацию об одном столбце результирующего набора в виде объекта. Чтобы получить определения всех столбцов, просто запустите эту функцию многократно.
Список параметров
-
result -
Только для процедурного стиля: Идентификатор результата запроса, полученный с помощью mysqli_query(), mysqli_store_result() или mysqli_use_result().
Возвращаемые значения
Возвращает объект, содержащий определение поля или false, если столбцы
в результирующей таблице закончились.
| Свойство | Описание |
|---|---|
| name | Имя столбца |
| orgname | Исходное имя столбца, если у него есть псевдоним |
| table | Имя таблицы, которой принадлежит столбец (если не вычислено) |
| orgtable | Исходное имя таблицы, если есть псевдоним |
| def | Зарезервировано для значения по умолчанию, на данный момент всегда "" |
| db | База данных (с PHP 5.3.6) |
| catalog | Имя каталога, всегда "def" (с PHP 5.3.6) |
| max_length | Максимальная ширина поля результирующего набора. |
| length | Ширина поля, как она задана при определении таблицы. |
| charsetnr | Количество наборов символов для поля. |
| flags | Целое число, представляющее битовые флаги для поля. |
| type | Тип данных поля |
| decimals | Число знаков после запятой (для целочисленных полей) |
Примеры
Пример #1 Объектно-ориентированный стиль
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* проверка подключения */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";
if ($result = $mysqli->query($query)) {
/* Получим информацию обо всех столбцах */
while ($finfo = $result->fetch_field()) {
printf("Имя: %s\n", $finfo->name);
printf("Таблица: %s\n", $finfo->table);
printf("Макс. длина: %d\n", $finfo->max_length);
printf("Флаги: %d\n", $finfo->flags);
printf("Тип: %d\n\n", $finfo->type);
}
$result->close();
}
/* закрываем подключение */
$mysqli->close();
?>
Пример #2 Процедурный стиль
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* проверка подключения */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";
if ($result = mysqli_query($link, $query)) {
/* Получим информацию обо всех столбцах */
while ($finfo = mysqli_fetch_field($result)) {
printf("Имя: %s\n", $finfo->name);
printf("Таблица: %s\n", $finfo->table);
printf("Макс. длина: %d\n", $finfo->max_length);
printf("Флаги: %d\n", $finfo->flags);
printf("Тип: %d\n\n", $finfo->type); }
mysqli_free_result($result);
}
/* закрываем подключение */
mysqli_close($link);
?>
Результат выполнения данных примеров:
Имя: Name Таблица: Country Макс. длина: 11 Флаги: 1 Тип: 254 Имя: SurfaceArea Таблица: Country Макс. длина: 10 Флаги: 32769 Тип: 4
Смотрите также
- mysqli_num_fields() - Получение количества полей в результирующем наборе
- mysqli_fetch_field_direct() - Получение метаданных конкретного поля
- mysqli_fetch_fields() - Возвращает массив объектов, представляющих поля результирующего набора
- mysqli_field_seek() - Установить указатель поля на определенное смещение