сервером. Если механизм обработки соединения автоматически назначается функцией mysql init (), функция mysql close () освобождает его.

Не следует вызывать функцию mysql close (), если попытка установки соединения оказалась неудачной.

mysql * mysql init (mysql *conn)

Инициализирует механизм обработки соединения и возвращает указатель на него. Если аргумент conn указывает на уже существующую структуру mysql, функция mysql init инициализирует этот механизм и возвращает его адрес:

mysql conn struct, *conn

conn = mysql init (&conn 3truct);

Если значение conn равно null, функция mysql init () назначает новый механизм, инициализирует его и возвращает адрес:

mysql *conn

conn = mysqi lnit(null)

В случае безуспещного заверщения функция mysql init() возвра щает значение null. Это может произойти в том случае, когд; функция mysqlinit () Не В состоянии назначить новый механизм.

Если функция mysqlinit () определяет новый механизм, то npi закрытии соединения функция mysqlclose () освобождает еп автоматически.

Функция mysql init {) впервые появилась в MySQL 3.22.L

int mysql options (mysql *conn, enum mysql optic: option, char *arg);

Эта функция позволяет управлять состоянием соединения более точно, чем с помощью одной функции mysql real connect (). Вызовите ее по завершении работы функции mysql init () и перед запуском mysql real connect (). Для установки нескольких опций функцию mysql options () МОЖНО Вызывать несколько раз.

Аргумент option определяет устанавливаемую опцию соединения. Дополнительная информация об опции, если таковая имеется, задается с помошью аргумента arg. (Обратите внимание, arg - это указатель.) Если дополнительная информация не нужна, аргумент arg устанавливается равным null.

Для задания этой опции можно использовать следующие опции.

mysql init C0MMAND Определяет запрос, выполняемый сразу после подключения к серверу. Собственно запрос задается в аргументе arg в виде строки, завершающейся значением null-Этот же запрос выполняется и после восстановления соединения (например, при вызове функции mysql ping ()). Все воз-

вращаемые этим запросом данные результирующего набора пропускаются.

mysql opt compress. Определяет, что в соединении при обмене данными между сервером и клиентом должен использоваться протокол сжатия, если сервер, конечно, его поддерживает. Аргумент arg имеет значение null.

Определить сжатие можно также и при вызове функции

mysql real connect() .

mysql 0PT C0NNECT TiME0UT. Задает небольшой временной перерыв в соединении (в секундах). Аргумент arg указывает на число unsigned int, определяющее длительность перерыва.

mysql opt named pipe. Определяет, что соединение с сервером должно устанавливаться через именованный канал. Аргумент arg имеет значение null. Эта опция предназначена только для клиентов Windows 95/98/NT и используется только при установлении соединения с серверами Windows NT.

mysql read defa.ult file. Определяет конфигурационный файл, содержащий параметры соединения. Считываемые функцией опции размещаются в группе [client] файла.

mysql read default group. Определяет считываемую фуппу из конфигурационного файла, заданного опцией mysql read default file. Опции ЭТОЙ группы считываются В Дополнение к опциям фуппы [client]. Если при этом конфигурационный файл не задан, клиентская библиотека ищет стандартные конфигурационные файлы и считывает их содержимое.

Если для установки определенной опции функция mysql options О вызывается несколько раз, функция mysql real connect () использует для нее значение, установленное последним.

В случае успешной установки опции функция mysql options О возвращает ноль. Если значение опции не установлено (неизвестно), возвращается ненулевое значение.

В конфигурационном файле можно задавать следующие опции (либо в группе [client], либо в определенной опцией

mysql read default group фуппе): compress

database=db nanie debug

ho3t=host nanie init -conimand=qruery password=your password pipe

port=port mjni 1

return-found-rows socket-socketname timeout=seconds user=user name

В приведенном ниже примере функция mysql optLons () вызывается для установки таких значений опций соединения, чтобы функция mysql read connect о пыталась установить соединение через именованный канал с помощью протокола сжатия и временного перерыва в 10 секунд. Эти параметры считываются из групп [client] и [mygroup] файла C:\my.cnf.special. Сразу после установления соединения

выполняется оператор SET SQL BIG TABLES.

MYSQL *conn

unsigned int timeout;

if ((conn = inysql init (NULL) == NULL)

... обработка ошибок ... timeout = 10;

mysql options (conn, MYSQL OPT COKKECT TIMEOUT, (char *) stimeout);

mysql options (conn, MYSQL OPT COMPRESS, NULL); mysql options (conn, MYSQL OPT KAMED PIPE, NOLL); mysql options (conn, MYSQL READ DEFAULT FILE, C:\my.cnf.special );

mysql options (conn, MYSQL READ DEFAULT GROUP, mygroup ); mysql options (conn, MYSQL IKIT COMMAKD, SET SQL BrG TABLES=l );

if (mysql real connect (conn, ...) == NULL) ... обработка ошибок ...

Функция mysql optLons () впервые появилась в IVlySQL 3.22.1.

Опции MYSQL INIT COMMAND, MYSQL READ DEFAULT FILE И MYSQL READ DEFAULT GROaP впервые ПОЯВИЛИСЬ В MySQL 3.22.10.

int mysql ping (MYSQL *conn) ; Проверяет, находится ли еще определенное указателем conn соединение в активном состоянии. Если соединение оборвано, функция inysql ping () восстанавливает его с теми же параметрами, которые используются при установлении исходного соединения. Соответственно, не следует вызывать функцию mysql ping (), если предьщущее соединение не было успешно установлено функцией mysql real connect ().

Функция mysqlping {) впервые появилась в MySQL 3.22.1.

MYSQL * mysql real cormect (MYSQL *conn, char *host name,

char *user name, char password, char *db name, unsigned int port num, char *socket name, unsigned int flags);