Edit Report a Bug

    mysqli_result::field_seek

    mysqli_field_seek

    (PHP 5, PHP 7, PHP 8)

    mysqli_result::field_seek -- mysqli_field_seek — Устанавливает указатель результата на заданное смещение поля

    Описание

    Объектно-ориентированный стиль

    public mysqli_result::field_seek(int $index): true

    Процедурный стиль

    mysqli_field_seek(mysqli_result $result, int $index): true

    Устанавливает указатель поля на заданное смещение. Следующий вызов функции mysqli_fetch_field() извлечёт определение поля столбца, который связан со смещением.

    Замечание:

    Для поиска с начала строки необходимо установить нулевое значение смещения.

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

    result

    Только для процедурного стиля: объект mysqli_result, который вернула функция mysqli_query(), mysqli_store_result(), mysqli_use_result() или mysqli_stmt_get_result().

    index

    Номер поля. Это значение должно быть в следующем диапазоне: от 0 до количество полей - 1.

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

    Функция всегда возвращает true.

    Список изменений

    Версия Описание
    8.0.0 Функция теперь всегда возвращает значение true. Раньше функция в случае возникновения ошибки возвращала значение false.

    Примеры

    Пример #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)) {

    /* Получить информацию о поле во втором столбце */
    $result->field_seek(1);
    $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)) {

    /* Получить информацию о поле во втором столбце */
    mysqli_field_seek($result, 1);
    $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);

    ?>

    Результат выполнения приведённых примеров: 

    Имя:     SurfaceArea
Таблица:    Country
Макс. длина: 10
Флаги:    32769
Тип:     4

    Смотрите также

    • mysqli_fetch_field() - Возвращает следующее поле результирующего набора

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top