Edit Report a Bug

    mysqli_result::data_seek

    mysqli_data_seek

    (PHP 5, PHP 7, PHP 8)

    mysqli_result::data_seek -- mysqli_data_seek — Перемещает указатель результата на выбранную строку

    Описание

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

    public mysqli_result::data_seek(int $offset): bool

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

    mysqli_data_seek(mysqli_result $result, int $offset): bool

    Функция mysqli_data_seek() перемещает указатель в результате на строку, указанную в параметре offset.

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

    result

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

    offset

    Смещение строк. Должно быть между нулём и числом строк в результате минус один (0..mysqli_num_rows() - 1).

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

    Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

    Примеры

    Пример #1 Пример использования mysqli::data_seek()

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

    <?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";
    $result = $mysqli->query($query);

    /* Переход к строке 401 */
    $result->data_seek(400);

    /* Получение строки */
    $row = $result->fetch_row();

    printf("Город: %s Код страны: %s\n", $row[0], $row[1]);

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

    <?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";

    $result = mysqli_query($link, $query);

    /* Переход к строке 401 */
    mysqli_data_seek($result, 400);

    /* Получение строки */
    $row = mysqli_fetch_row($result);

    printf ("Город: %s Код страны: %s\n", $row[0], $row[1]);

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

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

    Пример #2 Регулировка указателя результата при перемещении

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

    <?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 LIMIT 15,4";
    $result = $mysqli->query($query);

    /* Перемещение по набору результатов в обратном порядке */
    for ($row_no = $result->num_rows - 1; $row_no >= 0; $row_no--) {
    $result->data_seek($row_no);

    /* Получение строки */
    $row = $result->fetch_row();

    printf("Город: %s Код страны: %s\n", $row[0], $row[1]);
    }

    /* Сброс указателя на начало набора результатов */
    $result->data_seek(0);

    print     "\n";

    /* Снова перемещение по тому же набору результатов */
    while ($row = $result->fetch_row()) {
    printf("Город: %s Код страны: %s\n", $row[0], $row[1]);
    }

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

    Город: Acmbaro  Код страны: MEX
Город: Abuja  Код страны: NGA
Город: Abu Dhabi  Код страны: ARE
Город: Abottabad  Код страны: PAK

Город: Abottabad  Код страны: PAK
Город: Abu Dhabi  Код страны: ARE
Город: Abuja  Код страны: NGA
Город: Acmbaro  Код страны: MEX

    Примечания

    Замечание:

    Функция может быть использована только с буферизованными результатами, которые можно получить использованием функций mysqli_store_result() или mysqli_query().

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

    • mysqli_store_result() - Передаёт на клиента результирующий набор последнего запроса
    • mysqli_fetch_row() - Выбирает следующую строку из набора результатов и помещает её в обычный массив
    • mysqli_fetch_array() - Выбирает следующую строку из набора результатов и помещает её в ассоциативный массив, обычный массив или в оба
    • mysqli_fetch_assoc() - Выбирает следующую строку из набора результатов и помещает её в ассоциативный массив
    • mysqli_fetch_object() - Выбирает следующую строку из набора результатов в виде объекта
    • mysqli_query() - Выполняет запрос к базе данных
    • mysqli_num_rows() - Получает количество строк в наборе результатов

    add a note add a note

    User Contributed Notes 1 note

    up
    8
    kaisellgren at gmail dot com
    16 years ago
    This is useful function when you try to loop through the resultset numerous times.

    For example:

    <?php

    $result     = mysqli_query($connection_id,$query);

    while (    $row = mysqli_fetch_assoc($result))
    {
          // Looping through the resultset.
    }

    // Now if you need to loop through it again, you would first call the seek function:
    mysqli_data_seek($result,0);

    while (    $row = mysqli_fetch_assoc($result))
    {
          // Looping through the resultset again.
    }

    ?>
    add a note add a note
    To Top