int mysql_real_query(MYSQL *mysql, const char *query,
          unsigned long length)
        
Descrição
          Executa a consulta SQL apontada por query,
          que deve ser uma string de length bytes. A
          consulta deve consistir de uma instrução SQL simples. Você
          não deve adicionar um ponto e virgula
          (‘;’) ou \g
          no fim da instrução.
        
          Você deve utilizar
          mysql_real_query() em lugar de
          mysql_query() para consultas que contenham
          dados binários, pois eles podem conter o caracter
          '\0'. Além disso,
          mysql_real_query() é mais rápido que
          mysql_query() pois ele não faz chamadas
          strlen() na string de consulta.
        
          Se você quiser saber se a consulta retornou um resultado ou
          não, você pode usar mysql_field_count().
          See Secção 12.1.3.20, “mysql_field_count()”.
        
Valor Retornado
Zero se a consulta obteve sucesso. Deiferente de zero se ocorrer um erro.
Erros
              CR_COMMANDS_OUT_OF_SYNC
            
Os comando foram executados em uma ordem inpropriada.
              CR_SERVER_GONE_ERROR
            
O servidor MySQL foi finalizado.
              CR_SERVER_LOST
            
A conexão ao servidor MySQL foi perdida durante a consulta.
              CR_UNKNOWN_ERROR
            
Um erro desconhecido ocorreu.
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.

