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:

bool mysqli_stmt_data_seek ( mysqli_stmt statement, int offset )

Object oriented style (method):

class mysqli_stmt {

bool 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).

返回值

如果成功则返回 TRUE,失败则返回 FALSE

参见

mysqli_prepare().

例子 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