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()

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Приклади

Приклад #1 Приклад використання mysqli::data_seek()****

Об'єктно-орієнтований стиль

Loading...

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

Loading...

Результат виконання наведених прикладів:

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

Приклад #2 Регулювання вказівника результату під час переміщення

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

Loading...

Результат виконання наведених прикладів:

Город: 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() - Отримує кількість рядків у наборі результатів