Función mysql_real_query()

int mysql_real_query(MYSQL *mysql, const char *query, unsigned long length)

Ejecuta la consulta SQL apuntada por query, que debe ser una cadena de length bytes de longitud. Normalmente, la cadena debe consistir en una sentencia SQL simple y no se debe añadir el punto y coma (`;') terminador o \g a la sentencia. Si la ejecución de múltiples sentencias está permitida, la cadena puede contener varias sentencias separadas con punto y coma.

Se debe usar mysql_real_query() en lugar de mysql_query() para consultas que contengas datos binarios, porque los datos binarios pueden contener el carácter '\0'. Además, mysql_real_query() es más rápido que mysql_query() porque no llama a strlen() para la cadena query.

Si se quiere saber si la consulta debe devolver un conjunto de resultados, se puede usar mysql_field_count() para comprobarlo.

Valores de retorno

Cero si la consulta tuvo éxito. Distinto de cero si se produjo algún error.

Errores

CR_COMMANDS_OUT_OF_SYNC: Los comandos fueron ejecutados en un orden inapropiado.

CR_SERVER_GONE_ERROR: El servidor MySQL no está presente.

CR_SERVER_LOST: La conexión al servidor se perdió durante la consulta.

CR_UNKNOWN_ERROR: Se ha producido un error desconocido.