先看結(jié)構(gòu)體:
以下代碼塊是用來(lái)連接數(shù)據(jù)庫(kù)的通訊過程,要連接MySQL,必須建立MYSQL實(shí)例,通過mysql_init初始化方能開始進(jìn)行連接.
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;
這個(gè)結(jié)構(gòu)代表返回行的一個(gè)查詢的(SELECT, SHOW, DESCRIBE, EXPLAIN)的結(jié)果。返回的數(shù)據(jù)稱為“數(shù)據(jù)集”,用過數(shù)據(jù)庫(kù)的朋友應(yīng)該對(duì)數(shù)據(jù)庫(kù)中查詢后得到的結(jié)果集不會(huì)陌生,在C的API里對(duì)應(yīng)的就是MYSQL_RES了,從數(shù)據(jù)庫(kù)讀取數(shù)據(jù),最后就是從MYSQL_RES中讀取數(shù)據(jù)。
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;
--------------------------------
再看函數(shù):
C語(yǔ)言操作mysql數(shù)據(jù) 常用函數(shù)
所需頭文件: #include <mysql/mysql.h>
功能: 獲得或初始化一個(gè)MYSQL結(jié)構(gòu)
函數(shù)原型: MYSQL *mysql_init(MYSQL *mysql)
函數(shù)返回值: 一個(gè)被始化的MYSQL*句柄
備注: 在內(nèi)存不足的情況下,返回NULL
所需頭文件: #include <mysql/mysql.h>
函數(shù)功能: 關(guān)閉一個(gè)服務(wù)器連接,并釋放與連接相關(guān)的內(nèi)存
函數(shù)原型: void mysql_close(MYSQL *mysql);
函數(shù)傳入值: MYSQL:類型的指針
函數(shù)返回值: 無(wú)
所需頭文件: #include <mysql/mysql.h>
函數(shù)功能: 連接一個(gè)MySQL服務(wù)器
函數(shù)原型: MYSQL * mysql_connect(MYSQL *mysql,const char *host,const char *user,const char *passwd);
函數(shù)傳入值: mysql表示一個(gè)現(xiàn)存mysql結(jié)構(gòu)的地址
host表示MYSQL服務(wù)器的主機(jī)名或IP
user表示登錄的用戶名
passwd表示登錄的密碼
函數(shù)返回值: 如果連接成功,一個(gè)MYSQL *連接句柄:如果連接失敗,NULL
備注: 該函數(shù)不推薦,使用mysql_real_connect()代替
所需文件: #include <mysql/mysql.h>
函數(shù)功能: 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 int client_flag);
函數(shù)傳入值: mysql表示一個(gè)現(xiàn)存mysql結(jié)構(gòu)的地址
host表示MYSQL服務(wù)器的主機(jī)名或IP
user表示登錄的用戶名
passwd表示登錄的密碼
db表示要連接的數(shù)據(jù)庫(kù)
port表示MySQL服務(wù)器的TCP/IP端口
unix_socket表示連接類型
client_flag表示MySQL運(yùn)行ODBC數(shù)據(jù)庫(kù)的標(biāo)記
函數(shù)返回值: 如果連接成功,一個(gè)MYSQL*連接句柄:如果連接失敗,NULL
所需頭文件: #include <mysql/mysql.h>
函數(shù)功能: 返回最新的UPDATE,DELETE或INSERT查詢影響的行數(shù)
函數(shù)傳入值: MYSQL:類型指針
函數(shù)返回值: 大于零的一個(gè)整數(shù)表示受到影響或檢索出來(lái)的行數(shù)。零表示沒有區(qū)配查序中WHERE子句的記錄或目前還沒有查詢被執(zhí)行;-1表示查詢返回一個(gè)錯(cuò)誤,或?qū)τ谝粋€(gè)SELECT查詢
所需頭文件: #include <mysql/mysql.h>
函數(shù)功能: 對(duì)指定的連接執(zhí)行查詢
函數(shù)原型: int mysql_query(MYSQL *mysql,const char *query);
函數(shù)傳入值: query表示執(zhí)行的SQL語(yǔ)句
函數(shù)返回值: 如果查詢成功,為零,出錯(cuò)為非零。
相關(guān)函數(shù): mysql_real_query
所需頭文件: #include <mysql/mysql.h>
函數(shù)功能: 為無(wú)緩沖的結(jié)果集獲得結(jié)果標(biāo)識(shí)符
函數(shù)原形: MYSQL_RES *mysql_use_result(MYSQL *mysql);
函數(shù)傳入值: MYSQL:類型的指針
函數(shù)返回值: 一個(gè)MYSQL_RES結(jié)果結(jié)構(gòu),如果發(fā)生一個(gè)錯(cuò)誤發(fā)NULL
#incluee <mysql/mysql.h>
檢索一個(gè)結(jié)果集合的下一行
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);
MYSQL_RES:結(jié)構(gòu)的指針
下一行的一個(gè)MYSQL_ROW結(jié)構(gòu)。如果沒有更多的行可檢索或如果出現(xiàn)一個(gè)錯(cuò)誤,NULL
#include <mysql/mysql.h>
返回指定結(jié)果集中列的數(shù)量
unsigned int mysql_num_fields(MYSQL_RES *res);
MYSQL_RES 結(jié)構(gòu)的指針
結(jié)果集合中字段數(shù)量的一個(gè)無(wú)符號(hào)整數(shù)
#include <mysql/mysql.h>
創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)
int mysql_create_db(MYSQL *mysql,const char *db);
MYSQL:類型的指針
db:要?jiǎng)?chuàng)建的數(shù)據(jù)庫(kù)名
如果數(shù)據(jù)庫(kù)成功地被創(chuàng)建,返回零,如果發(fā)生錯(cuò)誤,為非零。
#include <mysql/mysql.h>
選擇一個(gè)數(shù)據(jù)庫(kù)
int mysql_select_db(MYSQL *mysql,const char *db);
MYSQL:類型的指針
db:要?jiǎng)?chuàng)建的數(shù)據(jù)庫(kù)名
如果數(shù)據(jù)庫(kù)成功地被創(chuàng)建,返回零,如果發(fā)生錯(cuò)誤,為非零。
這里的大部分代碼參考了MySQL發(fā)行包里面的.c源文件,大家也可以去里面找找相關(guān)的代碼,下面這段代碼實(shí)現(xiàn)了連接到本地MySQL服務(wù)器上9tmd_bbs_utf8數(shù)據(jù)庫(kù),從數(shù)據(jù)表tbb_user中根據(jù)輸入的userid取得該用戶的用戶名并打印輸出到終端。
#if defined(_WIN32) || defined(_WIN64) //為了支持windows平臺(tái)上的編譯 #include <windows.h> #endif #include <stdio.h> #include <stdlib.h> #include "mysql.h" //我的機(jī)器上該文件在/usr/local/include/mysql下 //定義數(shù)據(jù)庫(kù)操作的宏,也可以不定義留著后面直接寫進(jìn)代碼 #define SELECT_QUERY "select username from tbb_user where userid = %d" int main(int argc, char **argv) //char **argv 相當(dāng)于 char *argv[] { MYSQL mysql,*sock; //定義數(shù)據(jù)庫(kù)連接的句柄,它被用于幾乎所有的MySQL函數(shù) MYSQL_RES *res; //查詢結(jié)果集,結(jié)構(gòu)類型 MYSQL_FIELD *fd ; //包含字段信息的結(jié)構(gòu) MYSQL_ROW row ; //存放一行查詢結(jié)果的字符串?dāng)?shù)組 char qbuf[160]; //存放查詢sql語(yǔ)句字符串 if (argc != 2) { //檢查輸入?yún)?shù) fprintf(stderr,"usage : mysql_select <userid>nn"); exit(1); } mysql_init(&mysql); if (!(sock = mysql_real_connect(&mysql,"localhost","dbuser","dbpwd","9tmd_bbs_utf8",0,NULL,0))) { fprintf(stderr,"Couldn't connect to engine!n%snn",mysql_error(&mysql)); perror(""); exit(1); } sprintf(qbuf,SELECT_QUERY,atoi(argv[1])); if(mysql_query(sock,qbuf)) { fprintf(stderr,"Query failed (%s)n",mysql_error(sock)); exit(1); } if (!(res=mysql_store_result(sock))) { fprintf(stderr,"Couldn't get result from %sn", mysql_error(sock)); exit(1); } printf("number of fields returned: %dn",mysql_num_fields(res)); while (row = mysql_fetch_row(res)) { printf("Ther userid #%d 's username is: %sn", atoi(argv[1]),(((row[0]==NULL)&&(!strlen(row[0]))) ? "NULL" : row[0])) ; puts( "query ok !n" ) ; } mysql_free_result(res); mysql_close(sock); exit(0); return 0; //. 為了兼容大部分的編譯器加入此行 }
編譯的時(shí)候,使用下面的命令
gcc -o mysql_select ./mysql_select.c -I/usr/local/include/mysql -L/usr/local/lib/mysql -lmysqlclient (-lz) (-lm) 后面兩個(gè)選項(xiàng)可選,根據(jù)您的環(huán)境情況
運(yùn)行的時(shí)候,執(zhí)行下面的命令
./mysql_select 1
將返回如下結(jié)果:
number of fields returned: 1
Ther userid #1 ‘s username is: Michael
query ok !
上面的代碼我想大部分都能看明白,不明白的可以參考本博客mysql數(shù)據(jù)庫(kù)其他文章,有關(guān)C語(yǔ)言API各個(gè)函數(shù)都有詳細(xì)說(shuō)明