mysqli_stmt::data_seek

mysqli_stmt_data_seek

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::data_seek -- mysqli_stmt_data_seek将结果指针调整到缓冲结果中的任意行

描述

面向对象风格

public mysqli_stmt::data_seek(int $offset): void

过程化风格

mysqli_stmt_data_seek(mysqli_stmt $statement, int $offset): void

此函数将缓冲结果集的结果集指针移动到由 offset 参数指定的任意行。

此函数仅对缓冲的内部结果集有效。在调用 mysqli_stmt_data_seek() 之前必须调用 mysqli_stmt_store_result()

参数

statement

仅过程化风格:由 mysqli_stmt_init() 返回的 mysqli_stmt 对象。

offset

必须介于零和总行数减一之间 (0.. mysqli_stmt_num_rows() - 1)。

返回值

不返回任何值。

示例

示例 #1 面向对象风格

<?php

mysqli_report
(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

$query = "SELECT Name, CountryCode FROM City ORDER BY Name";
$stmt = $mysqli->prepare($query);
$stmt->execute();

$stmt->bind_result($name, $code);

$stmt->store_result();

/* 跳到第 400 行 */
$stmt->data_seek(399);

$stmt->fetch();

printf("城市: %s 国家代码: %s\n", $name, $code);

示例 #2 过程化风格

<?php

mysqli_report
(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

$query = "SELECT Name, CountryCode FROM City ORDER BY Name";
$stmt = mysqli_prepare($link, $query);

mysqli_stmt_execute($stmt);

mysqli_stmt_bind_result($stmt, $name, $code);

mysqli_stmt_store_result($stmt);

/* 跳到第 400 行 */
mysqli_stmt_data_seek($stmt, 399);

mysqli_stmt_fetch($stmt);

printf("城市: %s 国家代码: %s\n", $name, $code);

上面的示例将输出

City: Benin City  Countrycode: NGA

参见

添加注释

用户贡献注释 1 个注释

phpnet at stuffonmylaptop dot com
12 年前
虽然文档说您必须提供 0 到 count - 1 之间的数字,但您实际上可以提供负数,它似乎被强制转换为正数(例如在 abs() 中)。

例如

<?php
$db
= new mysqli('localhost', 'test', 'password', 'schema');
$db->multi_query("
SELECT * FROM
(
SELECT 1 as 'position'
UNION SELECT 2 as 'position'
UNION SELECT 3 as 'position'
UNION SELECT 4 as 'position'
UNION SELECT 5 as 'position'
) as rows"
);

$result = $db->store_result();

for (
$i = 0; $i < $result->num_rows; $i++)
{
$offset = $i;
$result->data_seek($offset);
var_dump("Seek offset is: {$offset}", $result->fetch_object());
}

for (
$i = 0; $i < $result->num_rows; $i++)
{
$offset = -$i;
$result->data_seek($offset);
var_dump("Seek offset is: {$offset}", $result->fetch_object());
}
To Top