PHP 8.4.0 RC4 available for testing

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() - Получает количество строк в наборе результатов

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top