mysqli_result::field_seek

    mysqli_field_seek

    (PHP 5, PHP 7, PHP 8)

    mysqli_result::field_seek -- mysqli_field_seek — Set result pointer to a specified field offset

    Description

    Object-oriented style

    public mysqli_result::field_seek(int $index): true

    Procedural style

    mysqli_field_seek(mysqli_result $result, int $index): true

    Sets the field cursor to the given offset. The next call to mysqli_fetch_field() will retrieve the field definition of the column associated with that offset.

    Note:

    To seek to the beginning of a row, pass an offset value of zero.

    Parameters

    result

    Procedural style only: A mysqli_result object returned by mysqli_query(), mysqli_store_result(), mysqli_use_result() or mysqli_stmt_get_result().

    index

    The field number. This value must be in the range from 0 to number of fields - 1.

    Return Values

    Always returns true.

    Changelog

    Version Description
    8.0.0 This function now always returns true. Previously it returned false on failure.

    Examples

    Example #1 Object-oriented style

    <?php
    $mysqli     = new mysqli("localhost", "my_user", "my_password", "world");

    /* check connection */
    if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
    }

    $query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

    if (    $result = $mysqli->query($query