<--  | Strona G³ówna  | Mapa Serwisu  | Indeks  | Szukaj

Özcan Güngör <ozcangungor(at)netscape.net> O Autorze: U¿ywam Linux'a od 1997 roku. Wolno¶æ, mo¿liwo¶ci i opensource. To w³a¶nie lubiê. Translated to Polish by: Mariusz Kozlowski <sp3fxc(at)linuxfocus.org> Zawarto¶æ: Introduction Typy zmiennych MySQL C Pod³±czanie siê do MySQL i zapytania Niektóre u¿yteczne funkcje Warto przeczytaæ Dyskusja dotycz±ca tego artyku³u

API MySQL C Notka: W tym artykule nauczymy siê jak u¿ywaæ C API (Application Programming Interfaces) dostarczone z MySQL. Aby zrozumieæ zawarto¶æ tego artyku³u potrzebna bêdzie wiedza z zakresu: Zmienne w C Funkcje w C Wska¼niki w C _________________ _________________ _________________

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)

Dyskusja dotycz±ca tego artyku³u

2003-09-13, generated by lfparser version 2.43