(PHP 5, PHP 7, PHP 8)
mysqli_result::data_seek -- mysqli_data_seek — Перемещает указатель результата на выбранную строку
Объектно-ориентированный стиль
$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().