# mysqli_stmt::data_seek

# mysqli_stmt_data_seek

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::data_seek -- mysqli_stmt_data_seek — Busca una fila arbitraria en un conjunto de resultados de una sentencia

### Descripción

Estilo orientado a objetos

mysqli_stmt::data_seek(int `$offset`): void

Estilo por procedimientos

mysqli_stmt_data_seek(mysqli_stmt `$stmt`, int `$offset`): void

Busca un puntero de resultados arbitrario en un conjunto de resultados de una sentencia.

mysqli_stmt_store_result() debe llamarse antes de mysqli_stmt_data_seek().

### Parámetros

`stmt`

  Sólo estilo por procediminetos: Un identificador de declaraciones devuelto por mysqli_stmt_init().

`offset`

  Debe estar entre cero y el número total de filas menos 1 (0.. mysqli_stmt_num_rows() - 1).

### Valores devueltos

No devuelve ningún valor.

### Ejemplos

Ejemplo #1 Estilo orientado a objetos

`<?php
/* Abrir una conexión */
$mysqli = new mysqli("localhost", "mi_usuario", "mi_contraseña", "world");
/* comprobar la conexión */
if (mysqli_connect_errno()) {
printf("Falló la conexión: %s\n", mysqli_connect_error());
exit();
}
$consulta = "SELECT Name, CountryCode FROM City ORDER BY Name";
if ($sentencia = $mysqli->prepare($consulta)) {
/* execute consulta */
$sentencia->execute();
/* vincular las varilbes al resultado */
$sentencia->bind_result($nombre, $código);
/* almacenar el resultado */
$sentencia->store_result();
/* buscar la fila nº 400 */
$sentencia->data_seek(399);
/* obtener los valores */
$sentencia->fetch();
printf ("Ciudad: %s Countrycode: %s\n", $nombre, $código);
/* cerrar la sentencia */
$sentencia->close();
}
/* cerrar la conexión */
$mysqli->close();
?>`

Ejemplo #2 Estilo por procedimientos

`<?php
/* Abrir una conexión */
$enlace = mysqli_connect("localhost", "mi_usuario", "mi_contraseña", "world");
/* comprobar la conexión */
if (mysqli_connect_errno()) {
printf("Falló la conexión: %s\n", mysqli_connect_error());
exit();
}
$consulta = "SELECT Name, CountryCode FROM City ORDER BY Name";
if ($sentencia = mysqli_prepare($enlace, $consulta)) {
/* execute consulta */
mysqli_stmt_execute($sentencia);
/* vincular las varilbes al resultado */
mysqli_stmt_bind_result($sentencia, $nombre, $código);
/* almacenar el resultado */
mysqli_stmt_store_result($sentencia);
/* buscar la fila nº 400 */
mysqli_stmt_data_seek($sentencia, 399);
/* obtener los valores */
mysqli_stmt_fetch($sentencia);
printf ("Ciudad: %s Countrycode: %s\n", $nombre, $código);
/* cerrar la sentencia */
mysqli_stmt_close($sentencia);
}
/* cerrar la conexión */
mysqli_close($enlace);
?>`

El resultado de los ejemplos sería:

    Ciudad: Benin City  Countrycode: NGA

### Ver también

- mysqli_prepare() - Prepara una sentencia SQL para su ejecución