Descrição das Funções da API C
Nas descrições a seguir, um parâmetro ou valor retornado NULL
significa NULL
no sentido da linguagem de programação C, não um valor NULL
do MariaDB.
Funções que retornam um valor geralmente retornam um ponteiro ou um inteiro. A menos que seja especificado, funcões que retornam um ponteiro, retornam um valor diferente de NULL
para indicar sucesso ou um valor NULL
para indicar um erro, e funções que retornam um inteiro, retoprnam zero para indicar sucesso ou um valor diferente de zero para indicar um erro. A menos que a descrição da função diga algo diferente, não faça teste com outro valor além do zero.
if (result) /* correct */ ... error ... if (result < 0) /* incorrect */ ... error ... if (result == -1) /* incorrect */ ... error ...
Quando uma função retornar um erro, a subsecao Erros de descrição de funções lista os possíveis tipos de erro. Você pode descobrir quais deles ocorreu chamando mysql_errno()
. Uma representação string do erro pode ser obtida chamando mysql_error()
.