PHP 8.4.1 Released!

mysqli_stmt::data_seek

mysqli_stmt_data_seek

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::data_seek -- mysqli_stmt_data_seekBusca 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

add a note

User Contributed Notes 1 note

up
1
phpnet at stuffonmylaptop dot com
12 years ago
Although the documentation says you must provide a number between 0 and count - 1, you can actually supply a negative number, which appears to be cast to positive (such as in abs()).

For example:

<?php
$db
= new mysqli('localhost', 'test', 'password', 'schema');
$db->multi_query("
SELECT * FROM
(
SELECT 1 as 'position'
UNION SELECT 2 as 'position'
UNION SELECT 3 as 'position'
UNION SELECT 4 as 'position'
UNION SELECT 5 as 'position'
) as rows"
);

$result = $db->store_result();

for (
$i = 0; $i < $result->num_rows; $i++)
{
$offset = $i;
$result->data_seek($offset);
var_dump("Seek offset is: {$offset}", $result->fetch_object());
}

for (
$i = 0; $i < $result->num_rows; $i++)
{
$offset = -$i;
$result->data_seek($offset);
var_dump("Seek offset is: {$offset}", $result->fetch_object());
}
To Top