mysql_data_seek

(PHP 3, PHP 4, PHP 5)

mysql_data_seek -- 移动内部结果的指针

说明

bool mysql_data_seek ( resource result, int row_number )

mysql_data_seek() 将指定的结果标识所关联的 MySQL 结果内部的行指针移动到指定的行号。接着调用 mysql_fetch_row() 将返回那一行。

row_number 从 0 开始。row_number 的取值范围应该从 0 到 mysql_num_rows - 1。但是如果结果集为空(mysql_num_rows() == 0),要将指针移动到 0 会失败并发出 E_WARNING 级的错误,mysql_data_seek() 将返回 FALSE

参数

result

返回类型为 resource 的结果集。该结果集从 mysql_query() 的调用中得到。

row_number

想要设定的新的结果集指针的行数。

返回值

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

范例

例 1. mysql_data_seek() 例子

<?php
$link
= mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!
$link) {
    die(
'Could not connect: ' . mysql_error());
}
$db_selected = mysql_select_db('sample_db');
if (!
$db_selected) {
    die(
'Could not select database: ' . mysql_error());
}
$query = 'SELECT last_name, first_name FROM friends';
$result = mysql_query($query);
if (!
$result) {
    die(
'Query failed: ' . mysql_error());
}
/* fetch rows in reverse order */
for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {
    if (!
mysql_data_seek($result, $i)) {
        echo
"Cannot seek to row $i: " . mysql_error() . "\n";
        continue;
    }

    if (!(
$row = mysql_fetch_assoc($result))) {
        continue;
    }

    echo
$row['last_name'] . ' ' . $row['first_name'] . "<br />\n";
}

mysql_free_result($result);
?>

注释

注意: mysql_data_seek() 只能和 mysql_query() 结合起来使用,而不能用于 mysql_unbuffered_query()

参见

mysql_query()
mysql_num_rows()
mysql_fetch_row()
mysql_fetch_assoc()
mysql_fetch_array()
mysql_fetch_object()