mysql_real_query

mysql_real_query sends a binary-safe SQL statement to a MariaDB server; use mysql_num_fields to determine whether the query returned a result set.

Syntax

int mysql_real_query(MYSQL * mysql,
                     const char * q,
                     unsigned long);

Parameters

• mysql - a mysql handle, which was previously allocated by mysql_init() or mysql_real_connect().

• query - a string containing the statement to be performed.

• long - length of the string.

Description

mysql_real_query() is a binary-safe function for executing a statement on the database server.

Return Value

Returns zero on success, otherwise non-zero.

• Contrary to the mysql_query() function, mysql_real_query is binary safe.

• To determine if mysql_real_query returns a result set, use the mysql_num_fields() function.

See Also

• mysql_query()

• mysql_num_fields()

• mysql_use_result()

• mysql_store_result()

_{This page is: Copyright © 2026 MariaDB. All rights reserved.}