mysqli_result::data_seek

mysqli_data_seek

(PHP 5)

mysqli_result::data_seek -- mysqli_data_seek — Ajustar el puntero de resultado a una fila arbitraria del resultado

Descripción

Estilo orientado a objetos

bool mysqli_result::data_seek ( int $offset )

Estilo por procedimientos

bool mysqli_data_seek ( mysqli_result $result , int $offset )

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($result, 399);

    /* 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ían:

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

Ver también