Программный интерфейс

приложений С

в этом приложении описывается программны!! интерфейс приложений языка С, используемый клиентской библиотекой MySQL. Программный интерфейс приложений (application programming interface - API) состоит из набора функций, предназначенных для взаимодействия с серверами и базами данных MySQL, а также набора используемых этими функциями типов данных.

Это приложение следует рассматривать как справочное руководство с небольшими фрагментами кода, иллюстрирующими примеры использования клиентской библиотеки. Полное описание клиентских программ и замечания по их написанию можно найти в главе 6, Программный интерфейс MySQL С API.

Приложение Е. Программный интерфейс приложений С

Компилирование и редактирование связей

На исходном уровне клиентская библиотека определяется файлом заголовка mysql. h, который может включаться в состав исходных файлов:

#include <mysql.h>

Чтобы указать компилятору месторасположение этого файла, воспользуйтесь опцией -1/path/to/include/dir. Если файлы заголовкг MySQL инсталлированы, например, в каталог /usr/include/mysql или /usr/local/mysql/include, исходные файлы можно откомпилировать с помощью следующих команд:

% gcc -l/usr/include/mysql -с myprog.c

% gcc -I/usr/local/mysql/mclude -с myprog.c

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

На уровне объектов клиентская библиотека предоставляется как биб лиотека mysqlclient. При редактировании связей определите в команд! связывания опцию -Imysqlclient. Возможно, также придется с помо щью опции -b/path/to/ИЪ/dir указать редактору связей местораспо ложение библиотеки:

% gcc -о myprog myprog.o -L/usr/lib/mysql -Imysqlclient

% gcc -о myprog myprog.o -L/usr/local/mysql/lib -Imysqlclient

Типы данных программного интерфейса приложений С

Типы данных клиентской библиотеки MySQL предназначены для представления объектов, которые обрабатываются на протяжении сеанса работы с сервером. Существуют отдельные типы данных для соединения, результатов запроса, строк результирующего набора и метаданных (описательная информация о столбцах результирующего набора).

Заметьте, что в последующем материале понятия столбец и поле являются синонимами.

Скалярные типы данных

Скалярные типы данных MySQL представляют большие целочисленные и булевы значения, а также смещения полей.

my -alonglong. Тип длинного целого числа, который используется для значений, возврашаемых такими функциями, как mysqlaf fected rows О , mysql num rows {) и mysql insert id(). Эти функции возврашают либо значения счетчиков строк, либо другие потенциально большие числа.

Для вывода значения my longlong необходимо преобразовать его в unsigned long и воспользоваться форматом %1и , иначе в некоторых системах это значение будет выведено неправильно.

mybool. Булев тип, используемый для значений, возврашаемых функциями mysqi change user() и mysql eof().

MYSQL FIELD 0FFSET. Этот ТИП данных используется функциями mysql field tell() И mysql f ield seek () ДЛЯ представления смешения внутри набора структур MYSQL FIELD текущего результирующего набора.

Нескалярные типы данных

Нескалярными типами данных MySQL являются структуры и массивы. Каждую структуру MYSQL или MYSQL RES следует рассматривать как, своего рода, черный ящик . Это означает, что ссылаться можно только на всю структуру сразу, но не на отдельные ее элементы, хотя типы MYSQL ROW и MYSQL FIELD подобных ограничений не имеют. Поэтому доступ к ним можно получать открыто для считывания данных и метаданных, возвращаемых в виде результирующего набора запроса.

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

MYSQL RES. Запросы, которые возврашают клиенту запрашиваемые данные, например, SELECT и SHOW, манипулируют в процессе своей работы результирующим набором, представленным в виде структуры MYSQLRES. Эта структура содержит информацию о возвращаемых запросом строках.