Función mysql_query()

int mysql_query(MYSQL *mysql, const char *query);

Ejecuta una consulta SQL apuntada por la cadena terminada con cero del parámetro query. La consulta debe consistir en una sentencia SQL simple. No se debe añadir el punto y coma al final (`;') o \g a la cadena. Si la ejecución de múltiples sentencias está permitida, la cadena puede contener varias sentencias separadas por punto y coma.

mysql_query no puede se usado para consultas que contengan datos binarios; en esos casos se debe usar mysql_real_query. (Los datos binarios pueden contener el carácter `\0', que mysql_query interpreta como el final de la cadena de consulta.)

Si se quiere averiguar si la consulta a devuelto un conjunto de resultados o no, se puede usar mysql_field_count para verificarlo.

Valor de retorno

El valor de retorno es cero si la consulta se ha completado correctamente. Un valor distinto de cero indica que ha ocurrido un 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 con el servidor se perdió durante la consulta.

CR_UNKNOWN_ERROR: ha ocurrido un error desconocido.