mysql_data_seek
(PHP 4, PHP 5)
mysql_data_seek — 移动内部结果的指针
说明
mysql_data_seek (
resource
$result
,
int $row_number
) :
bool
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
。
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
范例
Example #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);
?>
注释
Note:
本扩展自 PHP 5.5.0 起已废弃,并在自 PHP 7.0.0 开始被移除。应使用 MySQLi 或 PDO_MySQL 扩展来替换之。参见 MySQL:选择 API 指南以及相关 FAQ 来获取更多信息。用以替代本函数的有:
- mysqli_data_seek()
PDO::FETCH_ORI_ABS
Note:
mysql_data_seek() 只能和 mysql_query() 结合起来使用,而不能用于 mysql_unbuffered_query()。
参见
- mysql_query() - 发送一条 MySQL 查询
- mysql_num_rows() - 取得结果集中行的数目
- mysql_fetch_row() - 从结果集中取得一行作为枚举数组
- mysql_fetch_assoc() - 从结果集中取得一行作为关联数组
- mysql_fetch_array() - 从结果集中取得一行作为关联数组,或数字数组,或二者兼有
- mysql_fetch_object() - 从结果集中取得一行作为对象