2024 日本 PHP 研討會

    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("City: %s Countrycode: %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("City: %s Countrycode: %s\n", $name, $code);

    以上範例會輸出

    City: Benin City  Countrycode: NGA

    另請參閱

    發現問題了嗎？

    瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增筆記

    使用者貢獻的筆記 1 則筆記

    1
    phpnet at stuffonmylaptop dot com
    13 年前
    雖然文件說明您必須提供 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