API MySQL C

ArticleCategory:

AuthorImage:

TranslationInfo:

original in trÖzcan Güngör
tr to en Özcan Güngör

en to pl Mariusz Kozlowski

AboutTheAuthor:

Abstract:

• Zmienne w C
• Funkcje w C
• Wska�niki w C

ArticleIllustration:

ArticleBody:

Introduction

Typy zmiennych MySQL C

MYSQL
Nast�puj�ca struktura jest komunikacyjnym "po�rednikiem" u�ywanym do po��czenia si� z baz� danych.

typedef struct st_mysql {
  NET           net;            /* Communication parameters */
  gptr          connector_fd;   /* ConnectorFd for SSL */
  char          *host,*user,*passwd,*unix_socket,
                *server_version,*host_info,*info,*db;
  unsigned int  port,client_flag,server_capabilities;
  unsigned int  protocol_version;
  unsigned int  field_count;
  unsigned int  server_status;
  unsigned long thread_id;      /* Id for connection in server */
  my_ulonglong affected_rows;
  my_ulonglong insert_id;       /* id if insert on table with NEXTNR */
  my_ulonglong extra_info;              /* Used by mysqlshow */
  unsigned long packet_length;
  enum mysql_status status;
  MYSQL_FIELD   *fields;
  MEM_ROOT      field_alloc;
  my_bool       free_me;        /* If free in mysql_close */
  my_bool       reconnect;      /* set to 1 if automatic reconnect */
  struct st_mysql_options options;
  char          scramble_buff[9];
  struct charset_info_st *charset;
  unsigned int  server_language;
} MYSQL;

MYSQL_RES
Ta struktura reprezentuje rezultaty zapytania, kt�re zwraca krotki. Zwr�cony zestaw danych zwany jest: result-set.

typedef struct st_mysql_res {
  my_ulonglong row_count;
  unsigned int  field_count, current_field;
  MYSQL_FIELD   *fields;
  MYSQL_DATA    *data;
  MYSQL_ROWS    *data_cursor;
  MEM_ROOT      field_alloc;
  MYSQL_ROW     row;            /* If unbuffered read */
  MYSQL_ROW     current_row;    /* buffer to current row */
  unsigned long *lengths;       /* column lengths of current row */
  MYSQL         *handle;        /* for unbuffered reads */
  my_bool       eof;            /* Used my mysql_fetch_row */
} MYSQL_RES;

MYSQL_ROW
Ta struktura to typ bezpiecznej reprezentacji danych w krotce. Nie mo�esz u�ywa� tego jako string, ktr�ry ko�czy si� znakiem NULL poniewa� dane w tym stringu mog� by� typu binarnego i mog� zawiera� w�a�nie znak NULL.

typedef struct st_mysql_field {
  char *name;                   /* Name of column */
  char *table;                  /* Table of column if column was a field */
  char *def;                    /* Default value (set by mysql_list_fields) */
  enum enum_field_types type;   /* Type of field. Se mysql_com.h for types */
  unsigned int length;          /* Width of column */
  unsigned int max_length;      /* Max width of selected set */
  unsigned int flags;           /* Div flags */
  unsigned int decimals;        /* Number of decimals in field */
} MYSQL_FIELD;

my_ulonglong
Jest to typ u�ytwany dla liczby krotek i dla mysql_affected_rows(), mysql_num_rows(), and mysql_insert_id(). Typ ten dostarcza zakres od 0 do 1.84e19. W niekt�rych systemach pr�ba wypisania warto�ci my_ulonglong nie powiedzie si�. Aby wypisa� tak� wato�� nale�y j� przekonwertowa� do unsigned long i u�y� formatu %lu (printf). Przyk�ad:
printf(Number of rows: %lu\n", (unsigned long) mysql_num_rows(result));

typedef unsigned long my_ulonglong;

Pod��czanie si� do MySQL i zapytania

Jak wcze�niej powiedzia�em biblioteki MySQL s� w bibliotece mysqlclient. Wi�c podczas kompilacji programu korzystaj�cego z MySQL konieczne jest dodanie flagi kompilatora -lmysqlclient. Pliki nag��wkowe MySQL mo�na znale�� w /usr/include/mysql (mo�e to zale�e� od dystrybucji Linux'a). Nag��wek twojego programu powinien wygl�da� tak:

#include <mysql/mysql.h>

Zmienne typy i funkcje MySQL s� zawarte w tym pliku nag��wkowym.

Nast�pnie musimy stworzy� zmienn�, kt�ra b�dzie u�ywana do po��czenia si� z baz� danych. Jest to bardzo prosto robione poprzez:

MYSQL *mysql;

Przed po��czeniem z baz� danycg musimy wywo�a� nast�puj�c� funkcj� aby zainicjowa� zmienn� mysql:

mysql_init(MYSQL *mysql)

Nast�pnie

MYSQL * STDCALL mysql_real_connect(MYSQL *mysql, 
                                   const char *host, 
                                   const char *user,
                                   const char *passwd,
                                   const char *db,
                                   unsigned int port,
                                   const char *unix_socket,
                                   unsigned int clientflag);

Funkcja ta jest wo�ana aby po��czy� si� z baz� danych. host to nazwa serwera MySQL. user to u�ytkownik, jako kt�ry chcemy si� do niej pod��czy�. passwd ot has�o. db to baza danych do jakiej chcemy si� pod��czy�. port to numer portu TCP/IP serwera MySQL. unix_socket to typ po��czenia. clientflag to flaga powoduj�ca prac� MySQL jako ODBC. W tym artykule jest ona ustawiona na 0. Funkcja ta zwraca 0 gdy po��czenie zostanie ustanowione.

Teraz ��czymy si� z baz� danych i robimy zapytanie:

char *query;

U�ywaj�c tego stringu mo�emy skonstruowa� jakie kolwiek zdania SQL i robi� zapytania. Funkcja wykonuj�ca zapytanie to:

int STDCALL mysql_real_query(MYSQL *mysql, 
                             const char *q,
                             unsigned int length);

Po zrobieniu zapytania potrzebujemy zmiennej w MYSQL_RES aby m�c u�y� wynik�w zapytania. Nast�puj�ca linia tworzy t� zmienn�:

MYSQL_RES *res;

mysql_use_result(MYSQL *query)

Jako�e mo�na robi� zapytania bardzo �atwo, potrzebujemy nowych funkcji aby u�y� rezultat�w tych zapyta�. Pierwsza to:

MYSQL_ROW STDCALL mysql_fetch_row(MYSQL_RES *result);

MYSQL_ROW row;

mysql_close(MYSQL *mysql)

Niekt�re u�yteczne funkcje

unsigned int STDCALL mysql_num_fields(MYSQL *mysql);

Aby uzyska� ilo�� krotek zapytania nale�y u�y�:

my_ulonglong STDCALL mysql_num_rows(MYSQL_RES *res);

my_ulonglong STDCALL mysql_affected_rows(MYSQL *mysql);

Na koniec przyk�adowy kod:

#include <mysql/mysql.h>
#include <stdio.h>

void main(){
   MYSQL *mysql;
   MYSQL_RES *res;
   MYSQL_ROW row;
   char *query;
   int t,r;

   mysql_init(mysql);
   if (!mysql_real_connect(mysql,"localhost","mysql",
        "mysql","deneme",0,NULL,0))
   {
       printf( "Error connecting to database: %s\n",mysql_error(mysql));
   }
   else printf("Connected...\n");

   query="select * from Deneme";

   t=mysql_real_query(mysql,query,(unsigned int) strlen(query));
   if (t)
   {
      printf("Error making query: %s\n",
              mysql_error(mysql));
   }
   else printf("Query made...\n");
   res=mysql_use_result(mysql);
   for(r=0;r<=mysql_field_count(mysql);r++){
           row=mysql_fetch_row(res);
           if(row<0) break;
           for(t=0;t<mysql_num_fields(res);t++){
                   printf("%s ",row[t]);
           }
           printf("\n");
   }
   mysql_close(mysql);
}

Warto przeczyta�

• Strona MySQL: www.mysql.com
• Dokumentacja dostrczona wraz ze �r�d�ami MySQL. (Przypuszczalnie w katalogu /usr/doc)