mysql_use_result

mysql_use_result initiates unbuffered retrieval of a query result set row by row from the MariaDB server, blocking the connection until all rows are fetched or freed.

Syntax

MYSQL_RES * mysql_use_result(MYSQL * mysql);

Parameter

• mysql - a mysql handle, which was previously allocated by mysql_init() or mysql_real_connect().

Description

Used to initiate the retrieval of a result set from the last query executed using the mysql_real_query() function on the database connection. Either this or the mysql_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.

Return Value

Returns an unbuffered result set or NULL if an error occurred.

The mysql_use_result() function does not transfer the entire result set. Hence, several functions like mysql_num_rows() or mysql_data_seek() cannot be used.

mysql_use_result() will block the current connection until all result sets are retrieved, or result set was released by mysql_free_result().

See Also

• mysql_store_result()

• mysql_free_result()

_{This page is: Copyright © 2026 MariaDB. All rights reserved.}