mysqli_stmt::data_seek

    mysqli_stmt_data_seek

    (PHP 5, PHP 7, PHP 8)

    mysqli_stmt::data_seek -- mysqli_stmt_data_seek — Корректирует указатель результата на произвольную строку в буферизованном результате

    Описание

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

    publicmysqli_stmt::data_seek(int$offset): void

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

    mysqli_stmt_data_seek(mysqli_stmt$statement, int$offset): void

    Функция перемещает указатель буферизованного набора результатов в произвольную строку, заданную параметром offset.

    Функция работает только с буферизованным внутренним набором результатов. Функция mysqli_stmt_store_result() должна быть вызвана до mysqli_stmt_data_seek().

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

    stmt

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

    offset

    Значение должно быть в диапазоне от 0 до числа строк минус один (0.. mysqli_stmt_num_rows() - 1).

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

    Функция не возвращает значения после выполнения.

    Примеры

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

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name";
    $stmt = $mysqli->prepare($query);
    $stmt->execute();

    $stmt->bind_result($name, $code);

    $stmt->store_result();


    $stmt->data_seek(399);

    $stmt->fetch();

    printf("Город: %s Код страны: %s\n", $name, $code);
    ?>

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

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $link = mysqli_connect("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name";
    $stmt = mysqli_prepare($link, $query);

    mysqli_stmt_execute($stmt);

    mysqli_stmt_bind_result($stmt, $name, $code);

    mysqli_stmt_store_result($stmt);


    mysqli_stmt_data_seek($stmt, 399);

    mysqli_stmt_fetch($stmt);

    printf("Город: %s Код страны: %s\n", $name, $code);
    ?>

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

    Город: Benin City Код страны: NGA

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

    • mysqli_prepare() - Подготавливает SQL выражение к выполнению
    • mysqli_stmt_store_result() - Сохраняет набор результатов во внутреннем буфере
    • mysqli_stmt_num_rows() - Возвращает количество строк, полученных с сервера
    • mysqli_data_seek() - Перемещает указатель результата на выбранную строку
    To Top