.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_query" "3" "" "Version 3.3" "MariaDB Connector/C"
.SS Name
mysql_query \- executes a null terminated statement string
.SS Synopsis
.IP
.EX
#include \f[B]<mysql.h>\f[R]

int mysql_query(MYSQL * mysql,
                const char * query);
.EE
.SS Description
Performs a statement pointed to by the null terminate string query
against the database.
Contrary to \f[B]mysql_real_query(3)\f[R], mysql_query() is not binary
safe.
.SS Parameter
.IP \[bu] 2
\f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2
\f[CR]query\f[R] \-a null terminated string containing the statement to
be performed.
.SS Notes
.IP \[bu] 2
For executing multi statements the statements within the null terminated
string statements must be separated by a semicolon.
.IP \[bu] 2
If your statement contains binary data you should use
\f[B]mysql_real_query(3)\f[R] or escape your data with
\f[B]mysql_hex_string(3)\f[R].
.IP \[bu] 2
To determine if a statement returned a result set use the function
\f[B]mysql_field_count(3)\f[R].
.SS Return value
Returns zero on success, non zero on failure.
.SS See also
.IP \[bu] 2
\f[B]mysql_real_query(3)\f[R]
.IP \[bu] 2
\f[B]mysql_field_count(3)\f[R]
.IP \[bu] 2
\f[B]mysql_hex_string(3)\f[R]
.IP \[bu] 2
\f[B]mysql_use_result(3)\f[R]
.IP \[bu] 2
\f[B]mysql_store_result(3)\f[R]