用C語言操作MySQL資料庫
參考MYSQL的幫助文件整理
這裡歸納了C API可使用的函式,並在下一節詳細介紹了它們。請參見“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相關的C變數型別。這些型別在我們後面定義變數的時候會用到
1、MYSQL
要連線MYSQL,必須建立MYSQL例項,通過mysql_init初始化方能開始進行連線
示例:
MYSQL mysql; #建立MYSQL例項
mysql_init(&mysql); #初始化開始進行連線
2、MYSQL_RES
這個結構代表返回行的一個查詢的(SELECT, SHOW, DESCRIBE, EXPLAIN)的結果。返回的資料稱為“資料集”。 從資料庫讀取資料,最後就是從MYSQL_RES中讀取資料。
PS:類似於JAVA裡面的ResultSet變數一樣,將結果集存入到此變數中再從它裡面去讀資料。
3、MYSQL_ROW
這是一個行資料的型別安全(type-safe)的表示。當前它實現為一個計數字節的字串陣列。行通過呼叫mysql_fetch_row()獲得
4、MYSQL_FIELD
你可以通過重複呼叫mysql_fetch_field()對每一列獲得MYSQL_FIELD結構。這個結構包含欄位資訊,例如欄位名、型別和大小。
PS:此變數定義的是列的相關屬性問題!
示例一:實現遍歷查詢select * from table-name 操作
#include "windows.h"
#include "mysql.h"
#pragma comment(lib,"libmySQL.lib")
int main()
{
MYSQL mysql; //mysql連線
MYSQL_RES *res; //這個結構代表返回行的一個查詢結果集
MYSQL_ROW row; //一個行資料的型別安全(type-safe)的表示
char *query; //查詢語句
int t,r;
mysql_init(&mysql);
if (!mysql_real_connect(&mysql,"localhost", "root", "123", "test",3306,NULL,0))
{
printf( "Error connecting to database: %s",mysql_error(&mysql));
} else
printf("Connected...");
query="SET CHARACTER SET utf8"; //設定編碼
t=mysql_real_query(&mysql,query,(unsigned int)strlen(query));
if(t)
{
printf("編碼設定失敗");
}
query=" select * from a ";
t=mysql_real_query(&mysql,query,(unsigned int)strlen(query));
if(t)
{
printf("執行查詢時出現異常: %s",mysql_error(&mysql));
}else
printf("[%s] 構建成功",query);
res=mysql_store_result(&mysql);
while(row=mysql_fetch_row(res))
{
/*
for(t=0;t<mysql_num_fields(res);t++)
{
printf("%s" " ",row[t]);
}
*/
printf("%s",row[1]); 表示查詢的第幾個欄位的!也還可以遍歷全部欄位資訊
printf("\n");
}
mysql_free_result(res);
mysql_close(&mysql);
return 0;
}
示例二:執行插入、更新、刪除操作
#include "windows.h"
#include "mysql.h"
#pragma comment(lib,"libmySQL.lib")
int main()
{
MYSQL mysql; //mysql連線
MYSQL_RES *res; //這個結構代表返回行的一個查詢結果集
MYSQL_ROW row; //一個行資料的型別安全(type-safe)的表示
char *query; //查詢語句
int t,r;
mysql_init(&mysql);
if (!mysql_real_connect(&mysql,"localhost", "root", "123", "test",3306,NULL,0))
{
printf( "Error connecting to database: %s",mysql_error(&mysql));
} else
printf("Connected...");
query="SET CHARACTER SET utf8"; //設定編碼
t=mysql_real_query(&mysql,query,(unsigned int)strlen(query));
if(t)
{
printf("編碼設定失敗");
}
query="insert into a(name,age) values('w',9)";
t=mysql_real_query(&mysql,query,(unsigned int)strlen(query));
if(t)
{
printf("執行查詢時出現異常: %s",mysql_error(&mysql));
}else
printf("[%s] 構建成功",query);
mysql_close(&mysql);
return 0;
}