Более детально об операциях обновления рассказывается в описании оператора flush в приложении Г, Синтаксис SQL .

Функция mysql ref resh () возвращает нулевое значение в случае успещного выполнения операции и ненулевое значение в случае сбоя.

mt mysql shutdown (mysql *conn)

Указывает серверу завершить работу. Для использования этой функции пользователь должен обладать привилегией shutdown.

Функция mysql sbutdown() возвращает нулевое значение в случае успещного выполнения операции и ненулевое значение в случае сбоя.

Функции отладки

Описанные в этом разделе функции позволяют генерировать информацию отладки на любом конце соединения, как со стороны клиента, так и со стороны сервера. Однако для их использования необходимо, чтобы используемая версия MySQL бьша откомпилирована с поддержкой средств отладки. (Для этих целей при настройке дистрибуции MySQL используется опция --with-debug.)

void mysql debug (char *debug string);

Выполняет операцию dbugpush с помощью строки debug string. Формат этой строки описан в справочном руководстве по MySQL.

Для использования функции mysql debug () клиентская библиотека должна быть откомпилирована с поддержкой средств отладки.

mt mysql dump debug info (mysql *conn);

Указывает серверу записывать информацию отладки в журнал. Для использования этой функции пользователь должен обладать привилегией process.

Функция mysql dump debug inf о () возвращает нулевое значение в случае успешного вьшолнения операции и ненулевое значение в случае сбоя.

Исключенные функции

Клиентская библиотека MySQL включает также множество функций, Которые в настояшее время больше не используются, поскольку существует много других способов выполнить те же операции, которые выполняют эти функции. Большинство из них можно заменить посредством задания соответствующего запроса функции mysqi query (). Так, на-

пример, функцию mysql createjib { db name ) можно заменить следующей функцией:

mysql query (conn, CREATE DATABASE db name )

Некоторые функции, такие, например, как mysql connect () и mysql eof О больще не используются, поскольку заменены функциями с более мощными возможностями или возвращающими больший объем информации.

Это легко объяснить. С течением времени и по мере того, как MySQL распознавала все больше операторов SQL, некоторые функции оказывались ненужными и поэтому постепенно исключались. Так, например, в результате добавления SQL-оператора flush privileges функция mysql reload() стала ненужной. В представленных описаниях функций указывается версия MySQL, начиная с которой функция перестала использоваться. Далее также описываются наиболее предпочтительные способы замены исключенных функций в текущих версиях. В клиентских библиотеках более ранних версий описываемую функцию, конечно же, можно использовать.

Планируя долгую и плодотворную работу в будущем, пользователям следует избегать описанных функций. Некоторые или все из них будут исключены в MySQL 4.0.

mysql * mYsql connect (mysql *conn, char *host name,

char *user name, char *password);

Эта функция является предшественником функции mysql real connect (). В настоящее время функция mysql connect () реализована в виде варианта вызова функции mysql real connect ().

Эта функция исключена начиная с MySQL 3.22.0.

int mysql create db (mysql *conn, char *db name);

Создает базу данных с именем, определяемым аргументом db name. В настоящее время эту же операцию можно выполнить, задав оператор create database функции mysql query ().

Функция mysql create db () возвращает нулевое значение в случае успешного выполнения операции и ненулевое значение в случае сбоя.

Эта функция исключена начиная с MySQL 3.2L15.

int mysql drop db (mysql *conn, char *db name);

Удаляет базу данных с именем dbname. В настоящее время эту же операцию можно выполнить, задав оператор drop database функции mysql query().

Функция mysql drop db () возвращает нулевое значение в случае успешного выполнения операции и ненулевое значение в случае сбоя.

Эта функция исключена начиная с MySQL 3.2L15.

my bool mYsql eof (mysql res *res set);

Возвращает ненулевое значение при достижении конца результирующего набора и нулевое значение при появлении ошибки. Эта функция особенно полезна, если для инициализации процесса выборки результирующего набора используется функция mysql use result (>, а для последовательной выборки строк - функция mysql fetch row (). В ЭТОМ случае возвращаемое функцией mysql f etch row () значение null может отражать либо достижение конца набора, либо возникновение ошибки. Определить реальную причину и позволяет функция mysql eof ().

Для достижения аналогичного эффекта в настоящее время можно использовать функции mysql errno () и mysql error () , хотя в действительно они возвращают гораздо больше информации. (Эти функции указывают также возможную причину возникновения ошибки, а не просто подтверждают факт ее наличия.)

Эта функция исключена начиная с MySQL 3.2L17.

MySQL res * mYsql list dbs (mysql *conn, char *wild);

Возвращает результирующий набор со списком имен баз данных сервера либо значение null, если имела место ошибка. Возвращаемый список включает имена баз данных, соответствующих заданному аргументом wild регулярному выражению SQL (которое может содержать специальные символы % и ) или имена всех баз данных, если аргумент wild имеет значение null. Для освобождения памяти, занимаемой результирующим набором, пользователь впоследствии должен вызвать функцию mysql f гее ().

Возвращаемый функцией mysql list dbs () список можно также получить, задав команду show databases в качестве аргумента функции mysql query О И обработав результирующий набор.

Эта функция исключена начиная с MySQL 3.22.0.

mysql res * mysql list fields (mysql *conn, char *tbl name, char *wild);

Возвращает результирующий набор со списком имен столбцов указанной базы данных либо значение null, если имела место ошибка. Возвращаемый список включает имена столбцов, соответствующих заданному аргументом wild регулярному выражению SQL (которое может содержать специальные символы % и ) или ил{ена всех столбцов, если аргумент wild имеет значение null. Для освобождения памяти, занимаемой результирующим набором, пользователь впоследствии должен вызвать функцию mysql f гее ().

Возвращаемый функцией mysql list f ields () список можно также получить, задав команду show columns в качестве аргумента функции mysql query О И обработав результирующий набор.