> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/connectors/mariadb-connector-c/api-functions/mysql_use_result.md).

# mysql\_use\_result

## Syntax

```c
MYSQL_RES * mysql_use_result(MYSQL * mysql);
```

## Parameter

* `mysql` - a mysql handle, which was previously allocated by [mysql\_init()](/docs/connectors/mariadb-connector-c/api-functions/mysql_init.md) or [mysql\_real\_connect()](/docs/connectors/mariadb-connector-c/api-functions/mysql_real_connect.md).

## 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()](/docs/connectors/mariadb-connector-c/api-functions/mysql_store_result.md) 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.

{% hint style="info" %}
The `mysql_use_result()` function does not transfer the entire result set. Hence, several functions like [mysql\_num\_rows()](/docs/connectors/mariadb-connector-c/api-functions/mysql_num_rows.md) or [mysql\_data\_seek()](/docs/connectors/mariadb-connector-c/api-functions/mysql_data_seek.md) 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()](/docs/connectors/mariadb-connector-c/api-functions/mysql_free_result.md).
{% endhint %}

## See Also

* [mysql\_store\_result()](/docs/connectors/mariadb-connector-c/api-functions/mysql_store_result.md)
* [mysql\_free\_result()](/docs/connectors/mariadb-connector-c/api-functions/mysql_free_result.md)

{% @marketo/form formId="4316" %}