1mysql_use_result(3) MariaDB Connector/C mysql_use_result(3)
2
3
4
5 Name
6 mysql_use_result - returns an unbuffered result set
7
8 Synopsis
9 #include <nysql.h>
10
11 MYSQL_RES * mysql_use_result(MYSQL * mysql);
12
13 Description
14 Used to initiate the retrieval of a result set from the last query exe‐
15 cuted using the mysql_real_query() function on the database connection.
16 Either this or the mysql_store_result(3) function must be called before
17 the results of a query can be retrieved, and one or the other must be
18 called to prevent the next query on that database connection from fail‐
19 ing.
20
21 Parameters
22 • mysql is a connection identifier, which was previously allocated by
23 mysql_init(3) and connected by mysql_real_connect(3).
24
25 Notes
26 The mysql_use_result() function does not transfer the entire result
27 set. Hence several functions like mysql_num_rows(3) or mysql_da‐
28 ta_seek(3) cannot be used. mysql_use_result() will block the current
29 connection until all result sets are retrieved or result set was re‐
30 leased by mysql_free_result(3).
31
32 Return value
33 Returns an unbuffered result set or NULL if an error occurred.
34
35 See also
36 • mysql_store_result(3)
37
38 • mysql_free_result(3)
39
40
41
42Version 3.2.2 mysql_use_result(3)