MYSQL_RES *
mysql_store_result(MYSQL *mysql)

После вызова mysql_real_query() или mysql_query(), для каждого оператора, успешно вернувшего результат (например, , , , , и т.д.), необходимо вызвать mysql_store_result() или mysql_use_result(). После завершения работы с набором результатов необходимо вызвать mysql_free_result().

Для других операторов вызывать mysql_store_result() или mysql_use_result() не обязательно, но это не навредит и не повлияет на производительность, если вызвать mysql_store_result() во всех случаях. Вы можете определить, имеет ли оператор набор результатов, проверив, возвращает ли mysql_store_result() ненулевое значение (подробнее об этом позже).

Если вы включили поддержку многострочных запросов, результаты вызовов mysql_real_query() или mysql_query() следует извлекать с помощью цикла, вызывающего mysql_next_result() для определения наличия дополнительных результатов. Пример см. в Разделе 3.6.3, «Поддержка выполнения нескольких операторов».

Чтобы определить, возвращает ли оператор набор результатов, вызовите mysql_field_count(). См. Раздел 5.4.23, «mysql_field_count()».

mysql_store_result() считывает весь результат запроса на клиентскую сторону, выделяет структуру MYSQL_RES и помещает результат в эту структуру.

mysql_store_result() возвращает NULL, если оператор не возвращает набор результатов (например, если это был оператор) или произошла ошибка, и чтение набора результатов не удалось.

Возвращается пустой набор результатов, если не возвращено ни одной строки. (Пустой набор результатов отличается от возвращаемого значения NULL.)

После вызова mysql_store_result() и получения результата, отличного от NULL, можно вызвать mysql_num_rows(), чтобы узнать, сколько строк в наборе результатов.

Можно вызвать mysql_fetch_row() для извлечения строк из набора результатов или mysql_row_seek() и mysql_row_tell() для получения или установки текущей позиции строки в наборе результатов.

См. Раздел 3.6.9, «Возврат NULL mysql_store_result() после успешного mysql_query()».

Указатель на структуру результата MYSQL_RES с результатами. NULL, если оператор не возвращает набор результатов или произошла ошибка. Чтобы определить, произошла ли ошибка, проверьте, возвращает ли mysql_error() непустую строку, mysql_errno() — ненулевое значение или mysql_field_count() — ноль.

mysql_store_result() сбрасывает mysql_error() и mysql_errno(), если успешно выполняется.