在實際應(yīng)用中，我們不可能在命令行登錄進數(shù)據(jù)庫進行數(shù)據(jù)的查詢、插入等操作，用戶一般是使用一個界面良好的應(yīng)用程序軟件來對數(shù)據(jù)進行管理。為了方便應(yīng)用程序的開發(fā)，MySQL提供了多種編程語言（C、perl、php等）的編程接口，供開發(fā)者使用。 對于C語言來說，MySQL提供了C語言客戶機庫，它允許從任何C程序的內(nèi)部訪問MySQL數(shù)據(jù)庫，客戶機實現(xiàn)API,API定義了客戶機如何建立和執(zhí)行與服務(wù)器的通信。使用C語言開發(fā)MySQL項目具有更好的安全性和性能，C語言API是與MySQL一起提供的，包含在mysqlclient庫文件中，用于連接和執(zhí)行數(shù)據(jù)庫查詢。 首先看一下MySQL為C語言操作定義的數(shù)據(jù)類型。 1. MYSQL，MYSQL結(jié)構(gòu)代表一個數(shù)據(jù)庫連接句柄，包含有關(guān)服務(wù)器的連接狀態(tài)的信息，幾乎所有函數(shù)都是用到它。其定 義如下：

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 haveadded 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 toitself 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 flagfrom 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結(jié)構(gòu)代表返回行的查詢結(jié)果（SELECT、SHOW、DESCRIBE等），從數(shù)據(jù)庫讀取數(shù)據(jù)，最后就是從MYSQL_RES中讀取數(shù)據(jù)。 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：

函數(shù)	描述
mysql_affected_rows()	返回上次UPDATE、DELETE或INSERT查詢更改／刪除／插入的行數(shù)。
mysql_autocommit()	切換 autocommit模式，ON/OFF
mysql_change_user()	更改打開連接上的用戶和數(shù)據(jù)庫。
mysql_charset_name()	返回用于連接的默認字符集的名稱。
mysql_close()	關(guān)閉服務(wù)器連接。
mysql_commit()	提交事務(wù)。
mysql_connect()	連接到MySQL服務(wù)器。該函數(shù)已不再被重視，使用mysql_real_connect()取代。
mysql_create_db()	創(chuàng)建數(shù)據(jù)庫。該函數(shù)已不再被重視，使用SQL語句CREATE DATABASE取而代之。
mysql_data_seek()	在查詢結(jié)果集中查找屬性行編號。
mysql_debug()	用給定的字符串執(zhí)行DBUG_PUSH。
mysql_drop_db()	撤銷數(shù)據(jù)庫。該函數(shù)已不再被重視，使用SQL語句DROP DATABASE取而代之。
mysql_dump_debug_info()	讓服務(wù)器將調(diào)試信息寫入日志。
mysql_eof()	確定是否讀取了結(jié)果集的最后一行。該函數(shù)已不再被重視，可以使用mysql_errno()或mysql_error()取而代之。
mysql_errno()	返回上次調(diào)用的MySQL函數(shù)的錯誤編號。
mysql_error()	返回上次調(diào)用的MySQL函數(shù)的錯誤消息。
mysql_escape_string()	為了用在SQL語句中，對特殊字符進行轉(zhuǎn)義處理。
mysql_fetch_field()	返回下一個表字段的類型。
mysql_fetch_field_direct()	給定字段編號，返回表字段的類型。
mysql_fetch_fields()	返回所有字段結(jié)構(gòu)的數(shù)組。
mysql_fetch_lengths()	返回當(dāng)前行中所有列的長度。
mysql_fetch_row()	從結(jié)果集中獲取下一行
mysql_field_seek()	將列光標(biāo)置于指定的列。
mysql_field_count()	返回上次執(zhí)行語句的結(jié)果列的數(shù)目。
mysql_field_tell()	返回上次mysql_fetch_field()所使用字段光標(biāo)的位置。
mysql_free_result()	釋放結(jié)果集使用的內(nèi)存。
mysql_get_client_info()	以字符串形式返回客戶端版本信息。
mysql_get_client_version()	以整數(shù)形式返回客戶端版本信息。
mysql_get_host_info()	返回描述連接的字符串。
mysql_get_server_version()	以整數(shù)形式返回服務(wù)器的版本號。
mysql_get_proto_info()	返回連接所使用的協(xié)議版本。
mysql_get_server_info()	返回服務(wù)器的版本號。
mysql_info()	返回關(guān)于最近所執(zhí)行查詢的信息。
mysql_init()	獲取或初始化MYSQL結(jié)構(gòu)。
mysql_insert_id()	返回上一個查詢?yōu)锳UTO_INCREMENT列生成的ID。
mysql_kill()	殺死給定的線程。
mysql_library_end()	最終確定MySQL C API庫。
mysql_library_init()	初始化MySQL C API庫。
mysql_list_dbs()	返回與簡單正則表達式匹配的數(shù)據(jù)庫名稱。
mysql_list_fields()	返回與簡單正則表達式匹配的字段名稱。
mysql_list_processes()	返回當(dāng)前服務(wù)器線程的列表。
mysql_list_tables()	返回與簡單正則表達式匹配的表名。
mysql_more_results()	檢查是否還存在其他結(jié)果。
mysql_next_result()	在多語句執(zhí)行過程中返回/初始化下一個結(jié)果。
mysql_num_fields()	返回結(jié)果集中的列數(shù)。
mysql_num_rows()	返回結(jié)果集中的行數(shù)。
mysql_options()	為mysql_connect()設(shè)置連接選項。
mysql_ping()	檢查與服務(wù)器的連接是否工作，如有必要重新連接。
mysql_query()	執(zhí)行指定為“以Null終結(jié)的字符串”的SQL查詢。
mysql_real_connect()	連接到MySQL服務(wù)器。
mysql_real_escape_string()	考慮到連接的當(dāng)前字符集，為了在SQL語句中使用，對字符串中的特殊字符進行轉(zhuǎn)義處理。
mysql_real_query()	執(zhí)行指定為計數(shù)字符串的SQL查詢。
mysql_refresh()	刷新或復(fù)位表和高速緩沖。
mysql_reload()	通知服務(wù)器再次加載授權(quán)表。
mysql_rollback()	回滾事務(wù)。
mysql_row_seek()	使用從mysql_row_tell()返回的值，查找結(jié)果集中的行偏移。
mysql_row_tell()	返回行光標(biāo)位置。
mysql_select_db()	選擇數(shù)據(jù)庫。
mysql_server_end()	最終確定嵌入式服務(wù)器庫。
mysql_server_init()	初始化嵌入式服務(wù)器庫。
mysql_set_server_option()	為連接設(shè)置選項（如多語句）。
mysql_sqlstate()	返回關(guān)于上一個錯誤的SQLSTATE錯誤代碼。
mysql_shutdown()	關(guān)閉數(shù)據(jù)庫服務(wù)器。
mysql_stat()	以字符串形式返回服務(wù)器狀態(tài)。
mysql_store_result()	檢索完整的結(jié)果集至客戶端。
mysql_thread_id()	返回當(dāng)前線程ID。
mysql_thread_safe()	如果客戶端已編譯為線程安全的，返回1。
mysql_use_result()	初始化逐行的結(jié)果集檢索。
mysql_warning_count()	返回上一個SQL語句的告警數(shù)。

顯示詳細信息

與MySQL交互時，應(yīng)用程序應(yīng)使用該一般性原則：

1. 通過調(diào)用mysql_library_init()，初始化MySQL庫。庫可以是mysqlclient C客戶端庫，或mysqld嵌入式服務(wù)器庫，具體情況取決于應(yīng)用程序是否與“-libmysqlclient”或“-libmysqld”標(biāo)志鏈接。

2. 通過調(diào)用mysql_init()初始化連接處理程序，并通過調(diào)用mysql_real_connect()連接到服務(wù)器。

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

4. 通過調(diào)用mysql_close()，關(guān)閉與MySQL服務(wù)器的連接。

5. 通過調(diào)用mysql_library_end()，結(jié)束MySQL庫的使用。

調(diào)用mysql_library_init()和mysql_library_end()的目的在于，為MySQL庫提供恰當(dāng)?shù)某跏蓟徒Y(jié)束處理。對于與客戶端庫鏈接的應(yīng)用程序，它們提供了改進的內(nèi)存管理功能。如果不調(diào)用mysql_library_end()，內(nèi)存塊仍將保持分配狀態(tài)（這不會增加應(yīng)用程序使用的內(nèi)存量，但某些內(nèi)存泄漏檢測器將抗議它）。對于與嵌入式服務(wù)器鏈接的應(yīng)用程序，這些調(diào)用會啟動并停止服務(wù)器。

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

如果愿意，可省略對mysql_library_init()的調(diào)用，這是因為，必要時，mysql_init()會自動調(diào)用它。

要想連接到服務(wù)器，可調(diào)用mysql_init()來初始化連接處理程序，然后用該處理程序（以及其他信息，如主機名、用戶名和密碼）調(diào)用mysql_real_connect()。建立連接后，在低于5.0.3版的API中，mysql_real_connect()會將再連接標(biāo)志（MYSQL結(jié)構(gòu)的一部分）設(shè)置為1，或在較新的版本中，將其設(shè)置為0。對于該標(biāo)志，值“1”指明，如果因連接丟失而無法執(zhí)行語句，放棄之前，會嘗試再次連接到服務(wù)器。從MySQL 5.0.13開始，可以在mysql_options()上使用MYSQL_OPT_RECONNECT選項，以控制再連接行為。完成連接后，調(diào)用mysql_close()中止它。

當(dāng)連接處于活動狀態(tài)時，客戶端或許會使用mysql_query()或mysql_real_query()向服務(wù)器發(fā)出SQL查詢。兩者的差別在于，mysql_query()預(yù)期的查詢?yōu)橹付ǖ摹⒂蒒ull終結(jié)的字符串，而myql_real_query()預(yù)期的是計數(shù)字符串。如果字符串包含二進制數(shù)據(jù)（其中可能包含Null字節(jié)），就必須使用mysql_real_squery()。

對于每個非SELECT查詢（例如INSERT、UPDATE、DELETE），通過調(diào)用mysql_affected_rows()，可發(fā)現(xiàn)有多少行已被改變（影響）。

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

客戶端處理結(jié)果集的方式有兩種。一種方式是，通過調(diào)用mysql_store_result()，一次性地檢索整個結(jié)果集。該函數(shù)能從服務(wù)器獲得查詢返回的所有行，并將它們保存在客戶端。第二種方式是針對客戶端的，通過調(diào)用mysql_use_result()，對“按行”結(jié)果集檢索進行初始化處理。該函數(shù)能初始化檢索結(jié)果，但不能從服務(wù)器獲得任何實際行。

在這兩種情況下，均能通過調(diào)用mysql_fetch_row()訪問行。通過mysql_store_result()，mysql_fetch_row()能夠訪問以前從服務(wù)器獲得的行。通過mysql_use_result()，mysql_fetch_row()能夠?qū)嶋H地檢索來自服務(wù)器的行。通過調(diào)用mysql_fetch_lengths()，能獲得關(guān)于各行中數(shù)據(jù)大小的信息。

完成結(jié)果集操作后，請調(diào)用mysql_free_result()釋放結(jié)果集使用的內(nèi)存。

這兩種檢索機制是互補的?？蛻舳顺绦驊?yīng)選擇最能滿足其要求的方法。實際上，客戶端最常使用的是mysql_store_result()。

mysql_store_result()的1個優(yōu)點在于，由于將行全部提取到了客戶端上，你不僅能連續(xù)訪問行，還能使用mysql_data_seek()或mysql_row_seek()在結(jié)果集中向前或向后移動，以更改結(jié)果集內(nèi)當(dāng)前行的位置。通過調(diào)用mysql_num_rows()，還能發(fā)現(xiàn)有多少行。另一方面，對于大的結(jié)果集，mysql_store_result()所需的內(nèi)存可能會很大，你很可能遇到內(nèi)存溢出狀況。

mysql_use_result()的1個優(yōu)點在于，客戶端所需的用于結(jié)果集的內(nèi)存較少，原因在于，一次它僅維護一行（由于分配開銷較低，mysql_use_result()能更快）。它的缺點在于，你必須快速處理每一行以避免妨礙服務(wù)器，你不能隨機訪問結(jié)果集中的行（只能連續(xù)訪問行），你不知道結(jié)果集中有多少行，直至全部檢索了它們?yōu)橹?。不僅如此，即使在檢索過程中你判定已找到所尋找的信息，也必須檢索所有的行。

通過API，客戶端能夠恰當(dāng)?shù)貙Σ樵冏鞒鲰憫?yīng)（僅在必要時檢索行），而無需知道查詢是否是SELECT查詢?？梢栽诿看蝝ysql_query()或mysql_real_query()后，通過調(diào)用mysql_store_result()完成該操作。如果結(jié)果集調(diào)用成功，查詢?yōu)镾ELECT，而且能夠讀取行。如果結(jié)果集調(diào)用失敗，可調(diào)用mysql_field_count()來判斷結(jié)果是否的確是所預(yù)期的。如果mysql_field_count()返回0，查詢不返回數(shù)據(jù)（表明它是INSERT、UPDATE、DELETE等），而且不返回行。如果mysql_field_count()是非0值，查詢應(yīng)返回行，但沒有返回行。這表明查詢是失敗了的SELECT。關(guān)于如何實現(xiàn)該操作的示例，請參見關(guān)于mysql_field_count()的介紹。

無論是mysql_store_result()還是mysql_use_result()，均允許你獲取關(guān)于構(gòu)成結(jié)果集的字段的信息（字段數(shù)目，它們的名稱和類型等）。通過重復(fù)調(diào)用mysql_fetch_field()，可以按順序訪問行內(nèi)的字段信息，或者，通過調(diào)用mysql_fetch_field_direct()，能夠在行內(nèi)按字段編號訪問字段信息。通過調(diào)用mysql_field_seek()，可以改變當(dāng)前字段的光標(biāo)位置。對字段光標(biāo)的設(shè)置將影響后續(xù)的mysql_fetch_field()調(diào)用。此外，你也能通過調(diào)用mysql_fetch_fields()，一次性地獲得關(guān)于字段的所有信息。

為了檢測和通報錯誤，MySQL提供了使用mysql_errno()和mysql_error()函數(shù)訪問錯誤信息的機制。它們能返回關(guān)于最近調(diào)用的函數(shù)的錯誤代碼或錯誤消息，最近調(diào)用的函數(shù)可能成功也可能失敗，這樣，你就能判斷錯誤是在何時出現(xiàn)的，以及錯誤是什么。

1.連接mysql數(shù)據(jù)庫示例：

#include 
#include 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數(shù)據(jù)庫引擎建立連接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;
}

上例中使用函數(shù)說明：

MYSQL *mysql_init(MYSQL *mysql) ， 分配或初始化與mysql_real_connect()相適應(yīng)的MYSQL對象。如果mysql是NULL指針，該函數(shù)將分配、初始化、并返回新對象。否則，將初始化對象，并返回對象的地址。如果mysql_init()分配了新的對象，當(dāng)調(diào)用mysql_close()來關(guān)閉連接時。將釋放該對象。函數(shù)返回初始化的MYSQL*句柄。如果無足夠內(nèi)存以分配新的對象，返回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數(shù)據(jù)庫引擎建立連接。在你能夠執(zhí)行需要有效MySQL連接句柄結(jié)構(gòu)的任何其他API函數(shù)之前，mysql_real_connect()必須成功完成。

第一個參數(shù)mysql應(yīng)是已有MYSQL結(jié)構(gòu)的地址。

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

“passwd”參數(shù)包含用戶的密碼。如果“passwd”是NULL，僅會對該用戶的（擁有1個空密碼字段的）用戶表中的條目進行匹配檢查。這樣，數(shù)據(jù)庫管理員就能按特定的方式設(shè)置MySQL權(quán)限系統(tǒng)，根據(jù)用戶是否擁有指定的密碼，用戶將獲得不同的權(quán)限。

“db”是數(shù)據(jù)庫名稱。如果db為NULL，連接會將默認的數(shù)據(jù)庫設(shè)為該值。

如果“port”不是0，其值將用作TCP/IP連接的端口號。注意，“host”參數(shù)決定了連接的類型。

如果unix_socket不是NULL，該字符串描述了應(yīng)使用的套接字或命名管道。注意，“host”參數(shù)決定了連接的類型。

client_flag的值通常為0，但是，也能將其設(shè)置為下述標(biāo)志的組合，以允許特定功能：

標(biāo)志名稱	標(biāo)志描述
CLIENT_COMPRESS	使用壓縮協(xié)議。
CLIENT_FOUND_ROWS	返回發(fā)現(xiàn)的行數(shù)（匹配的），而不是受影響的行數(shù)。
CLIENT_IGNORE_SPACE	允許在函數(shù)名后使用空格。使所有的函數(shù)名成為保留字。
CLIENT_INTERACTIVE	關(guān)閉連接之前，允許interactive_timeout（取代了wait_timeout）秒的不活動時間?？蛻舳说臅抴ait_timeout變量被設(shè)為會話interactive_timeout變量的值。
CLIENT_LOCAL_FILES	允許LOAD DATA LOCAL處理功能。
CLIENT_MULTI_STATEMENTS	通知服務(wù)器，客戶端可能在單個字符串內(nèi)發(fā)送多條語句（由‘;’隔開）。如果未設(shè)置該標(biāo)志，將禁止多語句執(zhí)行。
CLIENT_MULTI_RESULTS	通知服務(wù)器，客戶端能夠處理來自多語句執(zhí)行或存儲程序的多個結(jié)果集。如果設(shè)置了CLIENT_MULTI_STATEMENTS，將自動設(shè)置它。
CLIENT_NO_SCHEMA	禁止db_name.tbl_name.col_name語法。它用于ODBC。如果使用了該語法，它會使分析程序生成錯誤，在捕獲某些ODBC程序中的缺陷時，它很有用。
CLIENT_ODBC	客戶端是ODBC客戶端。它將mysqld變得更為ODBC友好。
CLIENT_SSL	使用SSL（加密協(xié)議）。該選項不應(yīng)由應(yīng)用程序設(shè)置，它是在客戶端庫內(nèi)部設(shè)置的。

顯示詳細信息

如果連接成功，函數(shù)返回MYSQL*連接句柄。如果連接失敗，返回NULL。對于成功的連接，返回值與第1個參數(shù)的值相同。

const char *mysql_error(MYSQL *mysql)；

對于由mysql指定的連接，對于失敗的最近調(diào)用的API函數(shù)，mysql_error()返回包含錯誤消息的、由Null終結(jié)的字符串。如果該函數(shù)未失敗，mysql_error()的返回值可能是以前的錯誤，或指明無錯誤的空字符串。

經(jīng)驗規(guī)則是，如果成功，所有向服務(wù)器請求信息的函數(shù)均會復(fù)位mysql_error()。

下面為編譯和執(zhí)行結(jié)果輸出：

# make
cc -Wall -Werror -O2 -I/usr/include/mysql/   -c -o main.o main.c
Linking target_bin...
# ./target_bin 
Connected MySQL successful!

如果故意改錯密碼，編譯鏈接之后程序輸出如下信息：

# ./target_bin
mysql_real_connect(): Access denied for user 'root'@'localhost' (using password: YES)

2.查詢數(shù)據(jù)庫示例：

#include 
#include 
#include 
int main(int argc, const char *argv[])
{MYSQL           mysql;MYSQL_RES       *res = NULL;MYSQL_ROW       row;char            *query_str = NULL;int             rc, i, fields;int             rows;if (NULL == mysql_init(&mysql)) {printf("mysql_init(): %s\n", mysql_error(&mysql));return -1;}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("1. Connected MySQL successful! \n");query_str = "select * from tb_users";rc = mysql_real_query(&mysql, query_str, strlen(query_str));if (0 != rc) {printf("mysql_real_query(): %s\n", mysql_error(&mysql));return -1;}res = mysql_store_result(&mysql);if (NULL == res) {printf("mysql_restore_result(): %s\n", mysql_error(&mysql));return -1;}rows = mysql_num_rows(res);printf("The total rows is: %d\n", rows);fields = mysql_num_fields(res);printf("The total fields is: %d\n", fields);while ((row = mysql_fetch_row(res))) {for (i = 0; i < fields; i++) {printf("%s\t", row[i]);}printf("\n");}mysql_close(&mysql);return 0;
}

int mysql_real_query(MYSQL *mysql, const char *query, unsigned long length)

執(zhí)行由“query”指向的SQL查詢，它應(yīng)是字符串長度字節(jié)“l(fā)ong”。正常情況下，字符串必須包含1條SQL語句，而且不應(yīng)為語句添加終結(jié)分號（‘;’）或“\g”。如果允許多語句執(zhí)行，字符串可包含由分號隔開的多條語句。

對于包含二進制數(shù)據(jù)的查詢，必須使用mysql_real_query()而不是mysql_query()，這是因為，二進制數(shù)據(jù)可能會包含‘\0’字符。此外，mysql_real_query()比mysql_query()快，這是因為它不會在查詢字符串上調(diào)用strlen()。如果查詢成功，函數(shù)返回0。如果出現(xiàn)錯誤，函數(shù)返回非0值。

MYSQL_RES *mysql_store_result(MYSQL *mysql)

對于成功檢索了數(shù)據(jù)的每個查詢（SELECT、SHOW、DESCRIBE、EXPLAIN、CHECK TABLE等），必須調(diào)用mysql_store_result()或mysql_use_result()。

對于其他查詢，不需要調(diào)用mysql_store_result()或mysql_use_result()，但是如果在任何情況下均調(diào)用了mysql_store_result()，它也不會導(dǎo)致任何傷害或性能降低。通過檢查mysql_store_result()是否返回0，可檢測查詢是否沒有結(jié)果集（以后會更多）。

如果希望了解查詢是否應(yīng)返回結(jié)果集，可使用mysql_field_count()進行檢查。mysql_store_result()將查詢的全部結(jié)果讀取到客戶端，分配1個MYSQL_RES結(jié)構(gòu)，并將結(jié)果置于該結(jié)構(gòu)中。如果查詢未返回結(jié)果集，mysql_store_result()將返回Null指針（例如，如果查詢是INSERT語句）。

如果讀取結(jié)果集失敗，mysql_store_result()還會返回Null指針。通過檢查mysql_error()是否返回非空字符串，mysql_errno()是否返回非0值，或mysql_field_count()是否返回0，可以檢查是否出現(xiàn)了錯誤。如果未返回行，將返回空的結(jié)果集。（空結(jié)果集設(shè)置不同于作為返回值的空指針）。

一旦調(diào)用了mysql_store_result()并獲得了不是Null指針的結(jié)果，可調(diào)用mysql_num_rows()來找出結(jié)果集中的行數(shù)。

可以調(diào)用mysql_fetch_row()來獲取結(jié)果集中的行，或調(diào)用mysql_row_seek()和mysql_row_tell()來獲取或設(shè)置結(jié)果集中的當(dāng)前行位置。

一旦完成了對結(jié)果集的操作，必須調(diào)用mysql_free_result()。

返回具有多個結(jié)果的MYSQL_RES結(jié)果集合。如果出現(xiàn)錯誤，返回NULL。

my_ulonglong mysql_num_rows(MYSQL_RES *result)

函數(shù)返回結(jié)果集中的行數(shù)，mysql_num_rows()的使用取決于是否采用了mysql_store_result()或mysql_use_result()來返回結(jié)果集。如果使用了mysql_store_result()，可以立刻調(diào)用mysql_num_rows()。如果使用了mysql_use_result()，mysql_num_rows()不返回正確的值，直至檢索了結(jié)果集中的所有行為止，函數(shù)結(jié)果集中的行數(shù)。

unsigned int mysql_num_fields(MYSQL_RES *result)

要想傳遞MYSQL*參量取而代之，請使用無符號整數(shù)mysql_field_count(MYSQL *mysql)。

函數(shù)返回結(jié)果集中的列數(shù)。注意，你可以從指向結(jié)果集的指針或指向連接句柄的指針獲得行數(shù)。如果mysql_store_result()或mysql_use_result()返回NULL，應(yīng)使用連接句柄（因而沒有結(jié)果集指針）。在該情況下，可調(diào)用mysql_field_count()來判斷mysql_store_result()是否生成了非空結(jié)果。這樣，客戶端程序就能采取恰當(dāng)?shù)男袆?#xff0c;而不需要知道查詢是否是SELECT語句（或類似SELECT的語句）。

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

檢索結(jié)果集的下一行。在mysql_store_result()之后使用時，如果沒有要檢索的行，mysql_fetch_row()返回NULL。在mysql_use_result()之后使用時，如果沒有要檢索的行或出現(xiàn)了錯誤，mysql_fetch_row()返回NULL。

行內(nèi)值的數(shù)目由mysql_num_fields(result)給出。如果行中保存了調(diào)用mysql_fetch_row()返回的值，將按照row[0]到row[mysql_num_fields(result)-1]，訪問這些值的指針。行中的NULL值由NULL指針指明。

可以通過調(diào)用mysql_fetch_lengths()來獲得行中字段值的長度。對于空字段以及包含NULL的字段，長度為0。通過檢查字段值的指針，能夠區(qū)分它們。如果指針為NULL，字段為NULL，否則字段為空。

函數(shù)返回下一行的MYSQL_ROW結(jié)構(gòu)。如果沒有更多要檢索的行或出現(xiàn)了錯誤，返回NULL。

void mysql_free_result(MYSQL_RES *result)

該函數(shù)釋放由mysql_store_result()、mysql_use_result()、mysql_list_dbs()等為結(jié)果集分配的內(nèi)存。完成對結(jié)果集的操作后，必須調(diào)用mysql_free_result()釋放結(jié)果集使用的內(nèi)存。

釋放完成后，不要嘗試訪問結(jié)果集。

編譯鏈接執(zhí)行結(jié)果如下：

# make
cc -Wall -Werror -O2 -I/usr/include/mysql/   -c -o main.o main.c
Linking target_bin...
# ./target_bin 
1. Connected MySQL successful! 
The total rows is: 13
The total fields is: 3
10000   Allen   1981-01-01
10001   Ben     1982-04-02
10002   Curry   1985-08-12
10003   Davis   1978-07-12
10004   Ellis   1979-09-02
10005   Faried  1984-02-05
10007   Hamilton        1988-07-07
10008   Johnson 1986-06-07
10009   Jackson 1989-08-17
10010   James   1984-12-30
10011   Gay     1987-02-03
10012   Kaman   1981-04-04
10006   Wade    1982-03-04

插入刪除示例：

#include 
#include 
#include 
int main(int argc, const char *argv[])
{MYSQL           mysql;MYSQL_RES       *res = NULL;MYSQL_ROW       row;char            *query_str = NULL;int             rc, i, fields;int             rows;if (NULL == mysql_init(&mysql)) {printf("mysql_init(): %s\n", mysql_error(&mysql));return -1;}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("1. Connected MySQL successful! \n");
//執(zhí)行插入請求query_str = "insert into tb_users values (12345, 'justtest', '2015-5-5')";rc = mysql_real_query(&mysql, query_str, strlen(query_str));if (0 != rc) {printf("mysql_real_query(): %s\n", mysql_error(&mysql));return -1;}
//執(zhí)行刪除請求query_str = "delete from tb_users where userid=10006";rc = mysql_real_query(&mysql, query_str, strlen(query_str));if (0 != rc) {printf("mysql_real_query(): %s\n", mysql_error(&mysql));return -1;}
//然后查詢插入刪除之后的數(shù)據(jù)query_str = "select * from tb_users";rc = mysql_real_query(&mysql, query_str, strlen(query_str));if (0 != rc) {printf("mysql_real_query(): %s\n", mysql_error(&mysql));return -1;}res = mysql_store_result(&mysql);if (NULL == res) {printf("mysql_restore_result(): %s\n", mysql_error(&mysql));return -1;}rows = mysql_num_rows(res);printf("The total rows is: %d\n", rows);fields = mysql_num_fields(res);printf("The total fields is: %d\n", fields);while ((row = mysql_fetch_row(res))) {for (i = 0; i < fields; i++) {printf("%s\t", row[i]);}printf("\n");}mysql_free_result(res);mysql_close(&mysql);return 0;
}

編譯鏈接執(zhí)行結(jié)果如下：

# make 
cc -Wall -Werror -O2 -I/usr/include/mysql/   -c -o main.o main.c
Linking target_bin...
# ./target_bin
1. Connected MySQL successful!
The total rows is: 13
The total fields is: 3
10000   Allen   1981-01-01
10001   Ben     1982-04-02
10002   Curry   1985-08-12
10003   Davis   1978-07-12
10004   Ellis   1979-09-02
10005   Faried  1984-02-05
10007   Hamilton        1988-07-07
10008   Johnson 1986-06-07
10009   Jackson 1989-08-17
10010   James   1984-12-30
10011   Gay     1987-02-03
10012   Kaman   1981-04-04
12345   justtest        2015-05-05

搞定linux上MySQL編程（六）：C語言編寫MySQL程序（結(jié)） - mysql數(shù)據(jù)庫欄目 - 紅黑聯(lián)盟 (2cto.com)