(PHP 5, PHP 7, PHP 8)
mysqli_result::__construct — Constructs a mysqli_result object
This method constructs a new mysqli_result object.
It can be used to create the mysqli_result object after calling the mysqli_real_query() or mysqli_multi_query() function. Constructing the object manually is equivalent to calling the mysqli_store_result() or mysqli_use_result() function.
mysql
Somente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init().
result_mode
The result mode can be one of 2 constants indicating how the result will be returned from the MySQL server.
MYSQLI_STORE_RESULT
(default) - creates a
mysqli_result object with buffered result set.
MYSQLI_USE_RESULT
- creates a
mysqli_result object with unbuffered result set.
As long as there are pending records waiting to be fetched, the
connection line will be busy and all subsequent calls will return error
Commands out of sync
. To avoid the error all records
must be fetched from the server or the result set must be discarded by
calling mysqli_free_result(). The connection must
remain open for the rows to be fetched.
Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR
) e a operação solicitada falhar,
um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT
,
uma exceção mysqli_sql_exception será lançada em vez do aviso.
Exemplo #1 Creation of a mysqli_result object
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Select queries return a result set */
$mysqli->real_query("SELECT Name FROM City LIMIT 10");
$result = new mysqli_result($mysqli);
printf("Select returned %d rows.\n", $result->num_rows);
Os exemplos acima produzirão algo semelhante a:
Select returned 10 rows.