8.4.3 Описание функций интерфейса C
В приведенных здесь описаниях параметр или возвращаемая величина,
обозначенная как NULL, означает NULL в терминах языка программирования C,
а не величину NULL в MySQL.
Функции, возвращающие величину, обычно возвращают указатель или целое
число. Если не указано иначе, то функции, возвращающие указатель,
возвращают величину не-NULL при успешном выполнении или величину NULL,
указывающую на ошибку, а функции, возвращающие целое число, возвращают
нуль при успешном выполнении или ненулевую величину при возникновении
ошибки. Следует учитывать, что термин ``ненулевая величина'' означает
именно это. Если в описании функции не сказано иначе, то не следует
пробовать интерпретировать эту величину иначе, чем нуль:
if (result) /* правильно */
... error ...
if (result < 0) /* неправильно */
... error ...
if (result == -1) /* неправильно */
... error ...
Если функция возвращает ошибку, то возможные типы ошибок представлены в ее
описании в подраздел Ошибки. Вызвав функцию mysql_errno(), можно узнать,
какие именно ошибки произошли. Строковое представление ошибки можно
получить, вызывая функцию mysql_error().
Главы
