mysqli_use_result
mysqli->use_result
Initiate a result set retrieval
Description
Procedural style:
mixedmysqli_use_result
objectlink
Object oriented style (method):
mysqli
mixed
use_result
void
mysqli_use_result is used to initiate the retrieval
of a result set from the last query executed using the
mysqli_real_query function on the database connection
specified by the link parameter. Either this or the
mysqli_store_result function must be called before the
results of a query can be retrieved, and one or the other must be called
to prevent the next query on that database connection from failing.
The mysqli_use_result function does not transfer
the entire result set from the database and hence cannot be used functions
such as mysqli_data_seek to move to a particular
row within the set. To use this functionality, the result set must be
stored using mysqli_store_result. One should not
use mysqli_use_result if a lot of processing on
the client side is performed, since this will tie up the server and
prevent other threads from updating any tables from which the data is
being fetched.
Return values
Returns an unbuffered result object or &false; if an error occured.
See also
mysqli_real_query,
mysqli_store_result.
Example
Object oriented style
multi_query($query)) {
do {
/* store first result set */
if ($result = $mysqli->use_result()) {
while ($row = $result->fetch_row()) {
printf("%s\n", $row[0]);
}
$result->close();
}
/* print divider */
if ($mysqli->more_results()) {
printf("-----------------\n");
}
} while ($mysqli->next_result());
}
/* close connection */
$mysqli->close();
?>
]]>
Procedural style
]]>
The above examples would produce the following output: