# 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`。

### 参数

`result`

  resource 型的结果集。此结果集来自对 mysql_query() 的调用。

`row_number`

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

### 返回值

成功时返回 `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() - 从结果集中取得一行作为对象