mysqli_data_seek

(PHP 5)

mysqli_data_seek

(no version information, might be only in CVS)

result->data_seek -- Adjusts the result pointer to an arbitary row in the result

Description

Procedural style:

bool mysqli_data_seek ( object result, int offset)

Object oriented style (method):

class result {

bool data_seek ( int offset)

}

The mysqli_data_seek() function seeks to an arbitrary result pointer specified by the offset in the result set represented by result. The offset parameter must be between zero and the total number of rows minus one (0..mysqli_num_rows() - 1).

Note: This function can only be used with unbuffered results attained from the use of the mysqli_store_result() or mysqli_query() functions.

Return values

Returns TRUE on success or FALSE on failure.

See also

mysqli_store_result(), mysqli_fetch_row(), mysqli_num_rows().

Example

Example 1. Object oriented style

<?php
/* Open a connection */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

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

    
/* seek to row no. 400 */
    
$result->data_seek(399);

    
/* fetch row */
    
$row = $result->fetch_row();

    
printf ("City: %s  Countrycode: %s\n", $row[0], $row[1]);
        
    
/* free result set*/
    
$result->close();
}

/* close connection */
$mysqli->close();
?>

Example 2. Procedural style

<?php
/* Open a connection */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* check connection */
if (!$link) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

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

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

    
/* seek to row no. 400 */
    
mysqli_data_seek($result, 399);

    
/* fetch row */
    
$row = mysqli_fetch_row($result);

    
printf ("City: %s  Countrycode: %s\n", $row[0], $row[1]);
        
    
/* free result set*/
    
mysqli_free_result($result);
}

/* close connection */
mysqli_close($link);
?>

The above examples would produce the following output:

City: Benin City  Countrycode: NGA