5.4.21 mysql_fetch_row()

MYSQL_ROW
mysql_fetch_row(MYSQL_RES *result)

Описание

mysql_fetch_row() извлекает следующую строку из набора результатов:

При использовании после mysql_store_result(), mysql_fetch_row() возвращает NULL, если больше строк извлечь нельзя.
При использовании после mysql_use_result(), mysql_fetch_row() возвращает NULL, если больше строк извлечь нельзя или произошла ошибка.

Количество значений в строке определяется функцией mysql_num_fields(result). Если row содержит возвращаемое значение вызова mysql_fetch_row(), к значениям можно обратиться по указателям с row[0] по row[mysql_num_fields(result)-1]. Значения NULL в строке обозначены указателями NULL.

Длины значений полей в строке можно получить, вызвав mysql_fetch_lengths(). Пустые поля и поля, содержащие NULL, имеют длину 0; вы можете отличить их, проверив указатель на значение поля. Если указатель равен NULL, поле имеет значение NULL; в противном случае поле пустое.

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

Структуру MYSQL_ROW для следующей строки или NULL. Значение возврата NULL зависит от функции, вызывавшейся перед mysql_fetch_row():

При использовании после mysql_store_result(), mysql_fetch_row() возвращает NULL, если больше строк извлечь нельзя.
При использовании после mysql_use_result(), mysql_fetch_row() возвращает NULL, если больше строк извлечь нельзя или произошла ошибка. Чтобы определить, произошла ли ошибка, проверьте, возвращает ли mysql_error() непустую строку или mysql_errno() возвращает ненулевое значение.

Ошибки

Ошибки не сбрасываются между вызовами mysql_fetch_row()

Соединение с сервером было потеряно во время выполнения запроса.
Произошла неизвестная ошибка.

Пример

MYSQL_ROW row;
unsigned int num_fields;
unsigned int i;

num_fields = mysql_num_fields(result);
while ((row = mysql_fetch_row(result)))
{
   unsigned long *lengths;
   lengths = mysql_fetch_lengths(result);
   for(i = 0; i < num_fields; i++)
   {
       printf("[%.*s] ", (int) lengths[i],
              row[i] ? row[i] : "NULL");
   }
   printf("\n");
}