The mysqli_result class

(PHP 5, PHP 7, PHP 8)

Introduction

Represents the result set obtained from a query against the database.

class mysqli_result implements IteratorAggregate {

/* Properties */

public readonly int $current_field;

public readonly int $field_count;

public readonly ?array $lengths;

public readonly int|string $num_rows;

public int $type;

/* Methods */

public function __construct(mysqli $mysql, int $result_mode = MYSQLI_STORE_RESULT)

public function data_seek(int $offset): bool

public function fetch_all(int $mode = MYSQLI_NUM): array

public function fetch_array(int $mode = MYSQLI_BOTH): array|null|false

public function fetch_fields(): array

public function fetch_object(string $class = "stdClass", array $constructor_args = []): object|null|false

public function field_seek(int $index): true

public function free(): void

public function close(): void

public function free_result(): void

public function getIterator(): Iterator

}

type: Stores whether the result is buffered or unbuffered as an int (MYSQLI_STORE_RESULT or MYSQLI_USE_RESULT, respectively).

Version	Description
8.0.0	mysqli_result implements IteratorAggregate now. Previously, Traversable was implemented instead.

mysqli_result::__construct — Constructs a mysqli_result object
mysqli_result::$current_field — Get current field offset of a result pointer
mysqli_result::data_seek — Adjusts the result pointer to an arbitrary row in the result
mysqli_result::fetch_all — Fetch all result rows as an associative array, a numeric array, or both
mysqli_result::fetch_array — Fetch the next row of a result set as an associative, a numeric array, or both
mysqli_result::fetch_assoc — Fetch the next row of a result set as an associative array
mysqli_result::fetch_column — Fetch a single column from the next row of a result set
mysqli_result::fetch_field — Returns the next field in the result set
mysqli_result::fetch_field_direct — Fetch meta-data for a single field
mysqli_result::fetch_fields — Returns an array of objects representing the fields in a result set
mysqli_result::fetch_object — Fetch the next row of a result set as an object
mysqli_result::fetch_row — Fetch the next row of a result set as an enumerated array
mysqli_result::$field_count — Gets the number of fields in the result set
mysqli_result::field_seek — Set result pointer to a specified field offset
mysqli_result::free — Frees the memory associated with a result
mysqli_result::getIterator — Retrieve an external iterator
mysqli_result::$lengths — Returns the lengths of the columns of the current row in the result set
mysqli_result::$num_rows — Gets the number of rows in the result set