原文地址：http://www.2cto.com/database/201506/407827.html

在實際應用中，我們不可能在命令列登入進資料庫進行資料的查詢、插入等操作，使用者一般是使用一個介面良好的應用程式軟體來對資料進行管理。為了方便應用程式的開發，MySQL提供了多種程式設計語言（C、perl、php等）的程式設計介面，供開發者使用。 對於C語言來說，MySQL提供了C語言客戶機庫，它允許從任何C程式的內部訪問MySQL資料庫，客戶機實現API,API定義了客戶機如何建立和執行與伺服器的通訊。使用C語言開發MySQL專案具有更好的安全性和效能，C語言API是與MySQL一起提供的，包含在mysqlclient庫檔案中，用於連線和執行資料庫查詢。 首先看一下MySQL為C語言操作定義的資料型別。 1. MYSQL，MYSQL結構代表一個數據庫連線控制代碼，包含有關伺服器的連線狀態的資訊，幾乎所有函式都是用到它。其定 義如下：

typedef struct st_mysql
{
  NET           net;                    /* Communication parameters */
  unsigned char *connector_fd;          /* ConnectorFd for SSL */
  char          *host,*user,*passwd,*unix_socket,*server_version,*host_info;
  char          *info, *db;
  struct charset_info_st *charset;
  MYSQL_FIELD   *fields;
  MEM_ROOT      field_alloc;
  my_ulonglong affected_rows;
  my_ulonglong insert_id;               /* id if insert on table with NEXTNR */
  my_ulonglong extra_info;              /* Not used */
  unsigned long thread_id;              /* Id for connection in server */
  unsigned long packet_length;
  unsigned int  port;
  unsigned long client_flag,server_capabilities;
  unsigned int  protocol_version;
  unsigned int  field_count;
  unsigned int  server_status;
  unsigned int  server_language;
  unsigned int  warning_count;
  struct st_mysql_options options;
  enum mysql_status status;
  my_bool       free_me;                /* If free in mysql_close */
  my_bool       reconnect;              /* set to 1 if automatic reconnect */
 
  /* session-wide random string */
  char          scramble[SCRAMBLE_LENGTH+1];
 
 /*
   Set if this is the original connection, not a master or a slave we have
   added though mysql_rpl_probe() or mysql_set_master()/ mysql_add_slave()
 */
  my_bool rpl_pivot;
  /*
    Pointers to the master, and the next slave connections, points to
    itself if lone connection.
  */
  struct st_mysql* master, *next_slave;
 
  struct st_mysql* last_used_slave; /* needed for round-robin slave pick */
 /* needed for send/read/store/use result to work correctly with replication */
  struct st_mysql* last_used_con;
 
  LIST  *stmts;                     /* list of all statements */
  const struct st_mysql_methods *methods;
  void *thd;
  /*
    Points to boolean flag in MYSQL_RES  or MYSQL_STMT. We set this flag
    from mysql_stmt_close if close had to cancel result set of this object.
  */
  my_bool *unbuffered_fetch_owner;
  /* needed for embedded server - no net buffer to store the 'info' */
  char *info_buffer;
  void *extension;
} MYSQL;
 

2. MYSQL_RES MYSQL_RES結構代表返回行的查詢結果（SELECT、SHOW、DESCRIBE等），從資料庫讀取資料，最後就是從MYSQL_RES中讀取資料。 MYSQL_RES定義如下：

typedef struct st_mysql_res {
  my_ulonglong  row_count;
  MYSQL_FIELD   *fields;
  MYSQL_DATA    *data;
  MYSQL_ROWS    *data_cursor;
  unsigned long *lengths;               /* column lengths of current row */
  MYSQL         *handle;                /* for unbuffered reads */
  const struct st_mysql_methods *methods;
  MYSQL_ROW     row;                    /* If unbuffered read */
  MYSQL_ROW     current_row;            /* buffer to current row */
  MEM_ROOT      field_alloc;
  unsigned int  field_count, current_field;
  my_bool       eof;                    /* Used by mysql_fetch_row */
  /* mysql_stmt_close() had to cancel this result */
  my_bool       unbuffered_fetch_cancelled;  
  void *extension;
} MYSQL_RES;
 

MySQL 有如下C語言API：

函式	描述
mysql_affected_rows()	返回上次UPDATE、DELETE或INSERT查詢更改／刪除／插入的行數。
mysql_autocommit()	切換 autocommit模式，ON/OFF
mysql_change_user()	更改開啟連線上的使用者和資料庫。
mysql_charset_name()	返回用於連線的預設字符集的名稱。
mysql_close()	關閉伺服器連線。
mysql_commit()	提交事務。
mysql_connect()	連線到MySQL伺服器。該函式已不再被重視，使用mysql_real_connect()取代。
mysql_create_db()	建立資料庫。該函式已不再被重視，使用SQL語句CREATE DATABASE取而代之。
mysql_data_seek()	在查詢結果集中查詢屬性行編號。
mysql_debug()	用給定的字串執行DBUG_PUSH。
mysql_drop_db()	撤銷資料庫。該函式已不再被重視，使用SQL語句DROP DATABASE取而代之。
mysql_dump_debug_info()	讓伺服器將除錯資訊寫入日誌。
mysql_eof()	確定是否讀取了結果集的最後一行。該函式已不再被重視，可以使用mysql_errno()或mysql_error()取而代之。
mysql_errno()	返回上次呼叫的MySQL函式的錯誤編號。
mysql_error()	返回上次呼叫的MySQL函式的錯誤訊息。
mysql_escape_string()	為了用在SQL語句中，對特殊字元進行轉義處理。
mysql_fetch_field()	返回下一個表字段的型別。
mysql_fetch_field_direct()	給定欄位編號，返回表字段的型別。
mysql_fetch_fields()	返回所有欄位結構的陣列。
mysql_fetch_lengths()	返回當前行中所有列的長度。
mysql_fetch_row()	從結果集中獲取下一行
mysql_field_seek()	將列游標置於指定的列。
mysql_field_count()	返回上次執行語句的結果列的數目。
mysql_field_tell()	返回上次mysql_fetch_field()所使用欄位游標的位置。
mysql_free_result()	釋放結果集使用的記憶體。
mysql_get_client_info()	以字串形式返回客戶端版本資訊。
mysql_get_client_version()	以整數形式返回客戶端版本資訊。
mysql_get_host_info()	返回描述連線的字串。
mysql_get_server_version()	以整數形式返回伺服器的版本號。
mysql_get_proto_info()	返回連線所使用的協議版本。
mysql_get_server_info()	返回伺服器的版本號。
mysql_info()	返回關於最近所執行查詢的資訊。
mysql_init()	獲取或初始化MYSQL結構。
mysql_insert_id()	返回上一個查詢為AUTO_INCREMENT列生成的ID。
mysql_kill()	殺死給定的執行緒。
mysql_library_end()	最終確定MySQL C API庫。
mysql_library_init()	初始化MySQL C API庫。
mysql_list_dbs()	返回與簡單正則表示式匹配的資料庫名稱。
mysql_list_fields()	返回與簡單正則表示式匹配的欄位名稱。
mysql_list_processes()	返回當前伺服器執行緒的列表。
mysql_list_tables()	返回與簡單正則表示式匹配的表名。
mysql_more_results()	檢查是否還存在其他結果。
mysql_next_result()	在多語句執行過程中返回/初始化下一個結果。
mysql_num_fields()	返回結果集中的列數。
mysql_num_rows()	返回結果集中的行數。
mysql_options()	為mysql_connect()設定連線選項。
mysql_ping()	檢查與伺服器的連線是否工作，如有必要重新連線。
mysql_query()	執行指定為“以Null終結的字串”的SQL查詢。
mysql_real_connect()	連線到MySQL伺服器。
mysql_real_escape_string()	考慮到連線的當前字符集，為了在SQL語句中使用，對字串中的特殊字元進行轉義處理。
mysql_real_query()	執行指定為計數字符串的SQL查詢。
mysql_refresh()	重新整理或復位表和高速緩衝。
mysql_reload()	通知伺服器再次載入授權表。
mysql_rollback()	回滾事務。
mysql_row_seek()	使用從mysql_row_tell()返回的值，查詢結果集中的行偏移。
mysql_row_tell()	返回行游標位置。
mysql_select_db()	選擇資料庫。
mysql_server_end()	最終確定嵌入式伺服器庫。
mysql_server_init()	初始化嵌入式伺服器庫。
mysql_set_server_option()	為連線設定選項（如多語句）。
mysql_sqlstate()	返回關於上一個錯誤的SQLSTATE錯誤程式碼。
mysql_shutdown()	關閉資料庫伺服器。
mysql_stat()	以字串形式返回伺服器狀態。
mysql_store_result()	檢索完整的結果集至客戶端。
mysql_thread_id()	返回當前執行緒ID。
mysql_thread_safe()	如果客戶端已編譯為執行緒安全的，返回1。
mysql_use_result()	初始化逐行的結果集檢索。
mysql_warning_count()	返回上一個SQL語句的告警數。

與MySQL互動時，應用程式應使用該一般性原則：

1. 通過呼叫mysql_library_init()，初始化MySQL庫。庫可以是mysqlclient C客戶端庫，或mysqld嵌入式伺服器庫，具體情況取決於應用程式是否與“-libmysqlclient”或“-libmysqld”標誌連結。

2. 通過呼叫mysql_init()初始化連線處理程式，並通過呼叫mysql_real_connect()連線到伺服器。

3. 發出SQL語句並處理其結果。（在下面的討論中，詳細介紹了使用它的方法）。

4. 通過呼叫mysql_close()，關閉與MySQL伺服器的連線。

5. 通過呼叫mysql_library_end()，結束MySQL庫的使用。

呼叫mysql_library_init()和mysql_library_end()的目的在於，為MySQL庫提供恰當的初始化和結束處理。對於與客戶端庫連結的應用程式，它們提供了改進的記憶體管理功能。如果不呼叫mysql_library_end()，記憶體塊仍將保持分配狀態（這不會增加應用程式使用的記憶體量，但某些記憶體洩漏檢測器將抗議它）。對於與嵌入式伺服器連結的應用程式，這些呼叫會啟動並停止伺服器。

mysql_library_init()和mysql_library_end()實際上是#define符號，這類符號使得它們等效於mysql_server_init()和mysql_server_end()，但其名稱更清楚地指明，無論應用程式使用的是mysqlclient或mysqld庫，啟動或結束MySQL庫時，應呼叫它們。對於早期的MySQL版本，可呼叫mysql_server_init()和mysql_server_end()取而代之。

如果願意，可省略對mysql_library_init()的呼叫，這是因為，必要時，mysql_init()會自動呼叫它。

要想連線到伺服器，可呼叫mysql_init()來初始化連線處理程式，然後用該處理程式（以及其他資訊，如主機名、使用者名稱和密碼）呼叫mysql_real_connect()。建立連線後，在低於5.0.3版的API中，mysql_real_connect()會將再連線標誌（MYSQL結構的一部分）設定為1，或在較新的版本中，將其設定為0。對於該標誌，值“1”指明，如果因連線丟失而無法執行語句，放棄之前，會嘗試再次連線到伺服器。從MySQL 5.0.13開始，可以在mysql_options()上使用MYSQL_OPT_RECONNECT選項，以控制再連線行為。完成連線後，呼叫mysql_close()中止它。

當連線處於活動狀態時，客戶端或許會使用mysql_query()或mysql_real_query()向伺服器發出SQL查詢。兩者的差別在於，mysql_query()預期的查詢為指定的、由Null終結的字串，而myql_real_query()預期的是計數字符串。如果字串包含二進位制資料（其中可能包含Null位元組），就必須使用mysql_real_squery()。

對於每個非SELECT查詢（例如INSERT、UPDATE、DELETE），通過呼叫mysql_affected_rows()，可發現有多少行已被改變（影響）。

對於SELECT查詢，能夠檢索作為結果集的行。注意，某些語句因其返回行，類似與SELECT。包括SHOW、DESCRIBE和EXPLAIN。應按照對待SELECT語句的方式處理它們。

客戶端處理結果集的方式有兩種。一種方式是，通過呼叫mysql_store_result()，一次性地檢索整個結果集。該函式能從伺服器獲得查詢返回的所有行，並將它們儲存在客戶端。第二種方式是針對客戶端的，通過呼叫mysql_use_result()，對“按行”結果集檢索進行初始化處理。該函式能初始化檢索結果，但不能從伺服器獲得任何實際行。

在這兩種情況下，均能通過呼叫mysql_fetch_row()訪問行。通過mysql_store_result()，mysql_fetch_row()能夠訪問以前從伺服器獲得的行。通過mysql_use_result()，mysql_fetch_row()能夠實際地檢索來自伺服器的行。通過呼叫mysql_fetch_lengths()，能獲得關於各行中資料大小的資訊。

完成結果集操作後，請呼叫mysql_free_result()釋放結果集使用的記憶體。

這兩種檢索機制是互補的。客戶端程式應選擇最能滿足其要求的方法。實際上，客戶端最常使用的是mysql_store_result()。

mysql_store_result()的1個優點在於，由於將行全部提取到了客戶端上，你不僅能連續訪問行，還能使用mysql_data_seek()或mysql_row_seek()在結果集中向前或向後移動，以更改結果集內當前行的位置。通過呼叫mysql_num_rows()，還能發現有多少行。另一方面，對於大的結果集，mysql_store_result()所需的記憶體可能會很大，你很可能遇到記憶體溢位狀況。

mysql_use_result()的1個優點在於，客戶端所需的用於結果集的記憶體較少，原因在於，一次它僅維護一行（由於分配開銷較低，mysql_use_result()能更快）。它的缺點在於，你必須快速處理每一行以避免妨礙伺服器，你不能隨機訪問結果集中的行（只能連續訪問行），你不知道結果集中有多少行，直至全部檢索了它們為止。不僅如此，即使在檢索過程中你判定已找到所尋找的資訊，也必須檢索所有的行。

通過API，客戶端能夠恰當地對查詢作出響應（僅在必要時檢索行），而無需知道查詢是否是SELECT查詢。可以在每次mysql_query()或mysql_real_query()後，通過呼叫mysql_store_result()完成該操作。如果結果集呼叫成功，查詢為SELECT，而且能夠讀取行。如果結果集呼叫失敗，可呼叫mysql_field_count()來判斷結果是否的確是所預期的。如果mysql_field_count()返回0，查詢不返回資料（表明它是INSERT、UPDATE、DELETE等），而且不返回行。如果mysql_field_count()是非0值，查詢應返回行，但沒有返回行。這表明查詢是失敗了的SELECT。關於如何實現該操作的示例，請參見關於mysql_field_count()的介紹。

無論是mysql_store_result()還是mysql_use_result()，均允許你獲取關於構成結果集的欄位的資訊（欄位數目，它們的名稱和型別等）。通過重複呼叫mysql_fetch_field()，可以按順序訪問行內的欄位資訊，或者，通過呼叫mysql_fetch_field_direct()，能夠在行內按欄位編號訪問欄位資訊。通過呼叫mysql_field_seek()，可以改變當前欄位的游標位置。對欄位游標的設定將影響後續的mysql_fetch_field()呼叫。此外，你也能通過呼叫mysql_fetch_fields()，一次性地獲得關於欄位的所有資訊。

為了檢測和通報錯誤，MySQL提供了使用mysql_errno()和mysql_error()函式訪問錯誤資訊的機制。它們能返回關於最近呼叫的函式的錯誤程式碼或錯誤訊息，最近呼叫的函式可能成功也可能失敗，這樣，你就能判斷錯誤是在何時出現的，以及錯誤是什麼。

1.連線mysql資料庫示例：

#include <stdio.h>
#include <mysql.h>
 
int main(int argc, const char *argv[])
{
    MYSQL   mysql;
 
    if (NULL == mysql_init(&mysql)) {    //分配和初始化MYSQL物件
        printf("mysql_init(): %s\n", mysql_error(&mysql));
        return -1;
    }
 
    //嘗試與執行在主機上的MySQL資料庫引擎建立連線
    if (NULL == mysql_real_connect(&mysql,
                "localhost",
                "root",
                "shallnet",
                "db_users",
                0,
                NULL,
                0)) {
        printf("mysql_real_connect(): %s\n", mysql_error(&mysql));
        return -1;
    }
 
    printf("Connected MySQL successful! \n");
 
    mysql_close(&mysql);
    return 0;
}

上例中使用函式說明：

MYSQL *mysql_init(MYSQL *mysql) ， 分配或初始化與mysql_real_connect()相適應的MYSQL物件。如果mysql是NULL指標，該函式將分配、初始化、並返回新物件。否則，將初始化物件，並返回物件的地址。如果mysql_init()分配了新的物件，當呼叫mysql_close()來關閉連線時。將釋放該物件。函式返回初始化的MYSQL*控制代碼。如果無足夠記憶體以分配新的物件，返回NULL。

MYSQL *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 long client_flag)

mysql_real_connect()嘗試與執行在主機上的MySQL資料庫引擎建立連線。在你能夠執行需要有效MySQL連線控制代碼結構的任何其他API函式之前，mysql_real_connect()必須成功完成。

第一個引數mysql應是已有MYSQL結構的地址。

“host”的值必須是主機名或IP地址。如果“host”是NULL或字串"localhost"，連線將被視為與本地主機的連線。

“passwd”引數包含使用者的密碼。如果“passwd”是NULL，僅會對該使用者的（擁有1個空密碼欄位的）使用者表中的條目進行匹配檢查。這樣，資料庫管理員就能按特定的方式設定MySQL許可權系統，根據使用者是否擁有指定的密碼，使用者將獲得不同的許可權。

“db”是資料庫名稱。如果db為NULL，連線會將預設的資料庫設為該值。

如果“port”不是0，其值將用作TCP/IP連線的埠號。注意，“host”引數決定了連線的型別。

相關推薦