Основы программирования в Linux - Страница 152

Изменить размер шрифта:

□ Функция

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

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

□ Функция

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

void mysql_data_seek(MYSQL_RES *result, my_ulonglong offset);

□ Функция

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

MSSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result);

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

MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result,

 MYSQL_ROW_OFFSET offset);

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

Примечание

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

row_tell
и
row_seek
со значением смещения, применяемым в функции
data_seek
. Иначе ваши результаты будут непредсказуемыми.

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

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

void mysql_free_result(MYSQL_RES *result);

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

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

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

#include <stdlib.h>

#include <stdio.h>

#include "mysql.h"

MYSQL my_connection;

MYSQL_RES *res_ptr;

MYSQL_ROW sqlrow;

int main(int argc, char *argv[]) {

 int res;

 mysql_init(&my_connection);

 if (mysql_real_connect(&my_connection, "localhost", "rick",

  "secret", "foo", 0, NULL, 0)) {

  printf("Connection successn");

  res = mysql_query(&my_connection,

   "SELECT childno, fname, age FROM children WHERE age > 5");

  if (res) {

   printf("SELECT error: %sn", mysql_error(&my_connection));

  } else {

   res_ptr = mysql_store_result(&my_connection);

   if (res_ptr) {

    printf("Retrieved %lu rowsn",

     (unsigned long)mysql_num_rows(res_ptr));

    while ((sqlrow = mysql_fetch_row(res_ptr))) {

     printf("Fetched data...n");

    }

    if (mysql_errno(&my_connection)) {

     fprintf(stderr, "Retrieve error: %sn",

      mysql_error(&my_connection));

    }

    mysql_free_result(res_ptr);

   }

  }

  mysql_close(&my_connection);

 } else {

  fprintf(stderr, "Connection failedn');

  if (mysql_errno(&my_connection)) {

   fprintf(stderr, "Connection error %d: %sn",

    mysql_errno(&my_connection), mysql_error(&my_connection));

  }

 }

 return EXIT_SUCCESS;

}

Построчное извлечение данных

Для извлечения данных строка за строкой, если вы действительно хотите этого, пользуйтесь функцией

mysql_use_result
вместо функции
mysql_store_result
.

MYSQL_RES *mysql_use_result(MYSQL *connection);

Как и

mysql_store_result
, функция
mysql_use_result
в случае ошибки возвращает
NULL
; если она выполняется успешно, то возвращает указатель на объект с результирующим набором. Но эта функция отличается тем, что не считывает никаких данных в результирующий набор, который инициализировала.

Примечание

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

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

Оригинальный текст книги читать онлайн бесплатно в онлайн-библиотеке Knigger.com