mirror of
https://github.com/mariadb-corporation/mariadb-connector-c.git
synced 2025-07-26 08:41:58 +00:00
41 lines
1.3 KiB
Groff
41 lines
1.3 KiB
Groff
.\" Automatically generated by Pandoc 3.5
|
|
.\"
|
|
.TH "mysql_use_result" "3" "" "Version 3.4" "MariaDB Connector/C"
|
|
.SS Name
|
|
mysql_use_result \- returns an unbuffered result set
|
|
.SS Synopsis
|
|
.IP
|
|
.EX
|
|
#include \f[B]<mysql.h>\f[R]
|
|
|
|
MYSQL_RES * mysql_use_result(MYSQL * mysql);
|
|
.EE
|
|
.SS 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 \f[B]mysql_store_result(3)\f[R] 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.
|
|
.SS Parameters
|
|
.IP \[bu] 2
|
|
\f[CR]mysql\f[R] is a connection identifier, which was previously
|
|
allocated by \f[B]mysql_init(3)\f[R] and connected by
|
|
\f[B]mysql_real_connect(3)\f[R].
|
|
.SS Notes
|
|
The mysql_use_result() function does not transfer the entire result set.
|
|
Hence several functions like \f[B]mysql_num_rows(3)\f[R] or
|
|
\f[B]mysql_data_seek(3)\f[R] cannot be used.
|
|
mysql_use_result() will block the current connection until all result
|
|
sets are retrieved or result set was released by
|
|
\f[B]mysql_free_result(3)\f[R].
|
|
.SS Return value
|
|
Returns an unbuffered result set or \f[CR]NULL\f[R] if an error
|
|
occurred.
|
|
.SS See also
|
|
.IP \[bu] 2
|
|
\f[B]mysql_store_result(3)\f[R]
|
|
.IP \[bu] 2
|
|
\f[B]mysql_free_result(3)\f[R]
|