(PHP 5, PHP 7, PHP 8)
mysqli_stmt::data_seek -- mysqli_stmt_data_seek — Ajusta o ponteiro de resultado para uma linha arbitrária no resultado com buffer
Estilo orientado a objetos
Estilo procedural
Esta função move o ponteiro do conjunto de resultados com buffer para
uma linha arbitrária especificada pelo parâmetro offset
.
Esta função funciona somente com o conjunto de resultados interno com buffer. mysqli_stmt_store_result() precisa ser chamada antes de mysqli_stmt_data_seek().
statement
Somente no estilo procedural: Um objeto mysqli_stmt retornado por mysqli_stmt_init().
offset
Precisa ser entre zero e o número total de linhas menos um (0.. mysqli_stmt_num_rows() - 1).
Nenhum valor é retornado.
Exemplo #1 Estilo orientado a objetos
<?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";
$stmt = $mysqli->prepare($query);
$stmt->execute();
$stmt->bind_result($name, $code);
$stmt->store_result();
/* aponta para a linha núm. 400 */
$stmt->data_seek(399);
$stmt->fetch();
printf("City: %s Countrycode: %s\n", $name, $code);
Exemplo #2 Estilo procedural
<?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";
$stmt = mysqli_prepare($link, $query);
mysqli_stmt_execute($stmt);
mysqli_stmt_bind_result($stmt, $name, $code);
mysqli_stmt_store_result($stmt);
/* aponta para a linha núm. 400 */
mysqli_stmt_data_seek($stmt, 399);
mysqli_stmt_fetch($stmt);
printf("City: %s Countrycode: %s\n", $name, $code);
Os exemplos acima produzirão:
City: Benin City Countrycode: NGA