mysqli_result::data_seek

mysqli_data_seek

(PHP 5, PHP 7)

mysqli_result::data_seek -- mysqli_data_seekAjustar el puntero de resultado a una fila arbitraria del resultado

Descripción

Estilo orientado a objetos

mysqli_result::data_seek ( int $offset ) : bool

Estilo por procedimientos

mysqli_data_seek ( mysqli_result $result , int $offset ) : bool

La función mysqli_data_seek() salta a la posición offset de un puntero de resultado.

Parámetros

result

Sólo estilo por procedimientos: Un conjunto de identificadores de resultados devuelto por mysqli_query(), mysqli_store_result() o mysqli_use_result().

offset

Posición del campo. Debe estar comprendido entre cero y el número total de filas menos uno (0..mysqli_num_rows() - 1).

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Notas

Nota:

Sólo se puede usar esta función con resultados almacenados que se obtengan mediante el uso de mysqli_store_result() o de mysqli_query().

Ejemplos

Ejemplo #1 Estilo orientado a objetos

<?php
/* Abrir una conexión */
$mysqli = new mysqli("localhost""mi_usuario""mi_contraseña""mundo");

/* comprobar conexión */
if (mysqli_connect_errno()) {
    
printf("Conexión fallida: %s\n"mysqli_connect_error());
    exit();
}

$query "SELECT Name, CountryCode FROM City ORDER BY Name";
if (
$result $mysqli->query($query)) {

    
/* saltar a la fila numero 400 */
    
$result->data_seek(399);

    
/* obtener fila */
    
$row $result->fetch_row();

    
printf ("Ciudad: %s  Código de país: %s\n"$row[0], $row[1]);

    
/* librar resultados */
    
$result->close();
}

/* cerrar conexión */
$mysqli->close();
?>

Ejemplo #2 Estilo por procedimientos

<?php
/* Abrir conexión */
$link mysqli_connect("localhost""mi_usuario""mi_contraseña""mundo");

/* comprobar conexión */
if (!$link) {
    
printf("Conexión faillida: %s\n"mysqli_connect_error());
    exit();
}

$query "SELECT Name, CountryCode FROM City ORDER BY Name";

if (
$result mysqli_query($link$query)) {

    
/* saltar a la fila número 400 */
    
mysqli_data_seek($result399);

    
/* obtener fila */
    
$row mysqli_fetch_row($result);

    
printf ("Ciudad: %s  Código de país: %s\n"$row[0], $row[1]);

    
/* liberar resultado */
    
mysqli_free_result($result);
}

/* cerrar conexión */
mysqli_close($link);
?>

El resultado de los ejemplos sería:

Ciudad: Benin City  Código de país: NGA

Ver también