my_bool mysql_stmt_bind_result(MYSQL_STMT *stmt,
mysql_stmt_bind_result() is used
to associate (that is, bind) output columns in the result set to
data buffers and length buffers. When
mysql_stmt_fetch() is called to
fetch data, the MySQL client/server protocol places the data for
the bound columns into the specified buffers.
All columns must be bound to buffers prior to calling
bind is the address of an array of
MYSQL_BIND structures. The client library
expects the array to contain one element for each column of the
result set. If you do not bind columns to
ignores the data fetch. The buffers should be large enough to
hold the data values, because the protocol does not return data
values in chunks.
A column can be bound or rebound at any time, even after a
result set has been partially retrieved. The new binding takes
effect the next time
mysql_stmt_fetch() is called.
Suppose that an application binds the columns in a result set
The client/server protocol returns data in the bound buffers.
Then suppose that the application binds the columns to a
different set of buffers. The protocol places data into the
newly bound buffers when the next call to
To bind a column, an application calls
passes the type, address, and length of the output buffer into
which the value should be stored.
Section 17.6.8, “C API Prepared Statement Data Structures”,
describes the members of each
element and how they should be set to receive output values.
This function was added in MySQL 4.1.2.
Zero if the bind operation was successful. Nonzero if an error occurred.
See the Example in Section 188.8.131.52, “mysql_stmt_fetch()”.