PHP 8.1.0 RC 2 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($result400);

/* Получение строки */
$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

There are no user contributed notes for this page.
To Top