mysqli_stmt_data_seek

(PHP 5)

mysqli_stmt_data_seek

(no version information, might be only in CVS)

stmt->data_seek -- Seeks to an arbitray row in statement result set

Description

Procedural style:

void mysqli_stmt_data_seek ( mysqli_stmt statement, int offset )

Object oriented style (method):

class mysqli_stmt {

void data_seek ( int offset )

}

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

返回值

Returns NULL on success or FALSE on failure.

范例

例子 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 (
$stmt = $mysqli->prepare($query)) {

    
/* execute query */
    
$stmt->execute();

    
/* bind result variables */
    
$stmt->bind_result($name, $code);

    
/* store result */
    
$stmt->store_result();

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

    
/* fetch values */
    
$stmt->fetch();

    
printf ("City: %s  Countrycode: %s\n", $name, $code);

    
/* close statement */
    
$stmt->close();
}

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

例子 2. Procedural style

<?php
/* Open a connection */
$link = mysqli_connect("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 (
$stmt = mysqli_prepare($link, $query)) {

    
/* execute query */
    
mysqli_stmt_execute($stmt);

    
/* bind result variables */
    
mysqli_stmt_bind_result($stmt, $name, $code);

    
/* store result */
    
mysqli_stmt_store_result($stmt);

    
/* seek to row no. 400 */
    
mysqli_stmt_data_seek($stmt, 399);

    
/* fetch values */
    
mysqli_stmt_fetch($stmt);

    
printf ("City: %s  Countrycode: %s\n", $name, $code);

    
/* close statement */
    
mysqli_stmt_close($stmt);
}

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

上例将输出:

City: Benin City  Countrycode: NGA