2025年4月30日 星期三 农历 下月5日立夏 English | 简体中文 | 繁體中文
查询

mysqli_result::data_seek()函数—用法及示例

「 将结果集内部的指针移动到指定的行号 」


函数名:mysqli_result::data_seek()

适用版本:PHP 5 >= 5.3.0, PHP 7, PHP 8

用法:mysqli_result::data_seek() 方法用于将结果集内部的指针移动到指定的行号。它是 mysqli_result 类的一个成员方法。

语法:bool mysqli_result::data_seek(int $offset)

参数:

  • $offset:要移动到的行号。行号从0开始计数。

返回值:

  • 成功时返回 true。
  • 失败时返回 false。

示例:

// 假设已经建立了数据库连接 $conn

// 执行查询语句
$result = mysqli_query($conn, "SELECT * FROM my_table");

// 检查查询是否成功
if ($result) {
    // 将结果集的指针移动到第3行(行号从0开始计数)
    $result->data_seek(2);

    // 获取当前行的数据
    $row = $result->fetch_assoc();

    // 输出第3行的数据
    echo "第3行的数据:";
    print_r($row);
} else {
    echo "查询失败!";
}

上述示例中,我们首先执行了一个查询语句并将结果保存在变量 $result 中。然后,我们使用 data_seek() 方法将结果集的指针移动到第3行。接着,通过 fetch_assoc() 方法获取当前行的数据,并将其输出到屏幕上。

请注意,data_seek() 方法只能用于可滚动的结果集(即使用 mysqli::use_result() 函数返回的结果集不支持此方法)。另外,行号必须在结果集的有效范围内,否则将返回 false。

补充纠错
热门PHP函数