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.3.1                                              mysql_use_result(3)
Impressum