Основное назначение языка — конечно, извлечение данных, а не их добавление или обновление. Данные извлекаются с помощью оператора

.

Примечание

MySQL также поддерживает SQL-операторы

SHOW

,

DESCRIBE

и

EXPLAIN

, предназначенные для возврата результатов, но мы не собираемся рассматривать их в данной книге. Как обычно, в руководстве можно найти описание этих операторов.

Получение данных в вашем приложении на языке С обычно будет включать четыре шага:

1. Выполнение запроса.

2. Извлечение данных.

3. Обработка этих данных.

4. Наведение порядка при необходимости.

Так же, как в случае операторов

и , вы воспользуетесь функцией для отправки SQL-запроса. Далее вы извлечете данные о помощью функций или в зависимости от того, как хотите получить данные. Затем будет применена последовательность вызовов функции для обработки данных. И наконец, вы используете функцию для очистки памяти, которая применялась для выполнения вашего запроса.

Разница между функциями

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

Вы сможете извлечь в единственном вызове все данные из оператора

(или другого оператора, возвращающего данные), применяя функцию :

Ясно, что вам понадобится эта функция после успешного вызова функции

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

В случае успеха вы далее вызываете функцию

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

Эта функция принимает в качестве параметра структуру с результатом, возвращенную

, и возвращает количество строк в данном результирующем наборе. Если функция завершилась успешно, функция также завершится успешно.

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

Если окажется, что вы должны работать с особенно большим набором данных, лучше извлекать меньшие по объему, более управляемые порции данных. В этом случае приложению быстрее передается управление, и использование сетевых ресурсов будет более щадящим. Мы рассмотрим этот вариант подробнее при обсуждении функции

.

Теперь, когда у вас есть данные, можно обработать их с помощью функции

и перемещаться по набору, используя функции , и . Давайте рассмотрим их.

 Функция

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

 Функция

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

 Функция

возвращает величину смещения, обозначая текущую позицию в результирующем наборе. Это не номер строки и его нельзя использовать в функции .

Но ее можно применять с функцией