Запускаемая после успешно выполненного запроса, эта функция возврашает результируюший набор и сохраняет его на компьютере пользователя. Если запрос вовсе не возврашает данные или при его выполнении возникла ошибка, функция mysql store result О возврашает значение null При получении такого значения вызовите функцию inysql f ield count () или одну из функций диагностики ошибок. Это позволит определить, является возврашаемое значение null следствием отсутствия результирующего набора или возникновения ошибки.

По завершении работы с результирующим набором задайте его в качестве аргумента функции mysql f ree result () для освобождения памяти.

Сравнение с функцией mysql store result() и mysql use

result О представлено в табл. Е.7.

mysql res mysql use result (mysql *conn);

Запускаемая после успешно вьшолненного запроса эта функция инициализирует выборку результирующего набора, но собственно строки с данными не извлекает. Для последовательной выборки строк необходимо вызвать функцию mysql fetch row(). Если запрос вовсе не возвращает данные или при его вьшолнении возникла ошибка, функция mysql use result () возвращает значение null При получении такого значения вызовите функцию mysql field count () или одну из функций, создающих отчеты об ошибках. Это позволит определить, является возврашаемое значение null следствием отсутствия результируюшего набора или возникновения ошибки.

По завершении работы с результирующим набором задайте его в качестве аргумента функции mysql f ree result () для освобождения памяти.

Сравнение функций mysql store result() и mysql use result О представлено в табл. Е.7.

Обе функции mysql store resultО и mysql use result() используются для выборки результирующих наборов, однако каждая из них определяет свой способ дальнейшей обработки наборов, а соответственно и функции такой обработки.

Информационные функции

Функции этого класса обеспечивают информацию о клиенте, сервере, версии протокола и текущем соединении.

char * mysql get client info (void) ;

Возвращает строку, завершающуюся символом null, содержащую описание версии клиентской библиотеки, например 3 22.25 .

char * niysql get host info (MYSQL *conn);

Возвращает строку, завершающуюся символом NULL, содержащую описание текущего соединения, например, Localhost via UNIX socket или your.host.com via TCP/IP .

unsigned mt mysql get proto info (MYSQL *conn);

Возвращает номер версии протокола клиент/сервер, используемого для клиентского соединения.

char * mysql get server info (MYSQL *conn)

Возвращает строку, завершающуюся символом NULL, содержащую описание версии сервера, например 3.22 . 25-log . За номером версии могут следовать суффиксы -log (регистрация активизирована), -debug (сервер работает в режиме отладки) или -demo (сервер работает в демонстрационном режиме).

char * mysql stat (MYSQL *conn);

Возвращает строку, завершающуюся символом NULL, содержащую описание информации о состоянии сервера, или значение NULL, если имеет место ошибка. Формат возвращаемой строки может меняться. В текущих версиях она выглядит примерно следующим образом;

Uptime: 864034 Threads: 1 Questions: 32735 Slow queries: 50 Opens: 1428 Flush tables: 1 Open tables: 61

Выводимые значения можно интерпретировать следующим образом.

Uptime - продолжительность работы сервера в секундах.

Threads - ЧИСЛО работающих потоков сервера.

Questions - число выполненных сервером запросов.

Slow queries - ЧИСЛО запросов, выполняемых дольше, чем задано параметром сервера long query time.

Opens - общее число открытых сервером таблиц.

Flush tables - число выполненных команд FLUSH, REFRESH И RELOAD.

Open tables - число открытых в настоящее время таблиц.

Функция mysqlstat О возвращает ту же информацию, что и команда mysqladmin status. (А где же еще команда mysqladmin берет информацию?)

unsigned long mysql thread id (MYSQL *conn)

Возвращает номер потока, который сервер связывает с текущим соединением. Этот номер можно использовать как идентификатор для функции mysql kill ().

функцию mysql thread id () рекомендуется запускать лишь в тo случае, когда необходимо получить возвращаемое ею текущее значе ние. Если возвращенное значение сохранить, то через некоторое время оно может уже не отвечать действительности. В частности, та кая ситуация будет иметь место после разрыва и восстановления со единения (например, с помошью функции mysql ping ()), по скольку сервер присвоит новый номер потока.

Административные функции

Описанные в этом разделе административные программы позволяют управлять различными аспектами функционирования сервера.

mt mysql kill (mysql *conn, unsigned long thread id);

Завершает работу потока, определенного аргументом threadid.

Обладающий привилегией process пользователь сможет завер шить любой поток. Все остальные пользователи имеют возмож ность завершить работу только своих потоков.

Функция mysqlkill () возврашает нулевое значение в случае ус пешного Бьтолнения операции и ненулевые значения во всех ос тальных случаях. int

mysql refresh (mysql *conn, unsigned mt options);

Эта функция подобна SQL-оператору flush, однако позволяет за дать серверу обновить сразу несколько объектов сразу. Аргумен options этой функции может содержать одно или несколько он ределенных в табл. Е.8 значений.

Таблица Е.8. Опции функции mysql refresh ()

Значение опции Выполняемая сервером операция

Описанные в табл. Е.8 опции являются битовыми значениями, что позволяет комбинировать их с помошью символов или + , например, refresh log I refresh tables ИЛИ refresh log+refresh tables.