Устанавливает указатель результата на заданное смещение поля

# mysqli_result::field_seek

# mysqli_field_seek

(PHP 5, PHP 7, PHP 8)

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

### Описание

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

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

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

function 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() - Возвращает следующее поле результирующего набора

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open