Возвращает информацию об одном столбце результирующего набора в виде объекта. Чтобы получить определения всех столбцов, просто запустите эту функцию многократно.

Список параметров

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() - Установить указатель поля на определенное смещение

Вернуться к: mysqli_result