Spec-Zone.ru › MySQL Connectors 1.0

5.4.13 mysql_eof()

my_bool
mysql_eof(MYSQL_RES *result)

Описание

Эта функция устарела. Вместо неё можно использовать mysql_errno() или mysql_error().

mysql_eof() определяет, была ли прочитана последняя строка набора результатов.

Если вы получаете набор результатов после успешного вызова mysql_store_result(), клиент получает весь набор в одной операции. В этом случае возвращаемое значение NULL из mysql_fetch_row() всегда означает, что конец набора результатов достигнут, и вызывать mysql_eof() не нужно. При использовании с mysql_store_result(), mysql_eof() всегда возвращает true.

С другой стороны, если вы используете mysql_use_result() для инициализации получения набора результатов, строки набора получаются с сервера по одной при каждом вызове mysql_fetch_row(). Поскольку во время этого процесса может произойти ошибка подключения, возвращаемое значение NULL из mysql_fetch_row() не обязательно означает, что конец набора результатов достигнут нормально. В этом случае вы можете использовать mysql_eof() для определения того, что произошло. mysql_eof() возвращает ненулевое значение, если достигнут конец набора результатов, и нулевое, если произошла ошибка.

Исторически, mysql_eof() предшествует стандартным функциям ошибок MySQL mysql_errno() и mysql_error(). Поскольку эти функции ошибок предоставляют ту же информацию, их использование предпочтительнее, чем mysql_eof(), которая устарела. (На самом деле, они предоставляют больше информации, поскольку mysql_eof() возвращает только логическое значение, тогда как функции ошибок указывают причину ошибки, когда она возникает.)

Возвращаемые значения

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API