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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

phpnet at stuffonmylaptop dot com ¶

13 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());
}

＋add a note