Чтение онлайн

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

.

Примечание

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

SHOW

,

DESCRIBE

и

EXPLAIN

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

.

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

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

 Функция

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

 Функция

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

 Функция

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

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

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

Примечание

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

row_tell

и

row_seek

со значением смещения, применяемым в функции

data_seek

. Иначе ваши результаты будут непредсказуемыми.

После того как вы сделаете с вашими данными все, что нужно, вы должны явно применить функцию

, позволяющую библиотеке MySQL навести после себя порядок.

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

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