mysql C API 官網樣例淺析(1)
阿新 • • 發佈:2020-11-27
mysql_init()
MYSQL *
mysql_init(MYSQL *mysql)
分配或初始化一個 MYSQL 物件,用於 mysql_real_connect() 。
如果 mysql 為 NULL 則分配物件。否則初始化 mysql。
成功則返回 MYSQL 物件的地址。失敗返回 NULL。
mysql_real_connect()
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)
host 主機名或 IP 地址
db 資料庫名
port 如果為 0,則其值像 tcp 連線的埠號
unix_socket 通常為 NULL
client_flag 通常為 0
成功執行,返回 0
mysql_close()
void mysql_close(MYSQL*mysql)
關閉連線。如果之前使用 mysql_init 分配了 MYSQL 物件,就釋放它
mysql_query()
int mysql_query(MYSQL *mysql, const char *stmt_str)
執行 stmt_str 字串上的 sql 語句,成功執行返回 0
mysql_store_result()
MYSQL_RES *
mysql_store_result(MYSQL *mysql)
void
mysql_free_result(MYSQL_RES *result)
返回一個指向 MYSQL_RES 的指標。MYSQL_RES 是一個包含結果的結構體
如果 sql 語句不返回資料或有錯誤,則 mysql_store_result 返回 NULL
使用 mysql_free_resule 釋放結構體
mysql_fetch_fields()
MYSQL_FIELD *
mysql_fetch_fields(MYSQL_RES *result)
Example
unsigned int num_fields;
unsigned int i;
MYSQL_FIELD *fields;
num_fields = mysql_num_fields(result);
fields = mysql_fetch_fields(result);
for(i = 0; i < num_fields; i++)
{
printf("Field %u is %s\n", i, fields[i].name);
}
返回結果集的所有MYSQL_FIELD結構的陣列。每個結構提供結果集的一列的欄位定義
如果結果集裡面沒有資料則返回空
fetch 是拿來的意思。可以把 field 認為是列名
##貌似不用釋放 MYSQL_FIELD 指標##
mysql_fetch_row()
MYSQL_ROW
mysql_fetch_row(MYSQL_RES *result)
Example
MYSQL_ROW row;
unsigned int num_fields;
unsigned int i;
num_fields = mysql_num_fields(result);
while ((row = mysql_fetch_row(result)))
{
unsigned long *lengths;
lengths = mysql_fetch_lengths(result);
for(i = 0; i < num_fields; i++)
{
printf("[%.*s] ", (int) lengths[i],
row[i] ? row[i] : "NULL");
}
printf("\n");
}
mysql_fetch_row() 檢索結果集的下一行
當在 mysql_store_result() 或 mysql_store_result_nonblocking() 之後使用時,如果沒有更多的行需要檢索,mysql_fetch_row() 將返回 NULL
如果有資料,則儲存在 MYSQL_ROW 結構體中
##因為是自動變數,隨意不需要釋放##
簡單例項
#include <stdio.h> #include <mysql.h> #include <string.h> int Query(MYSQL *mysql) { MYSQL_RES * result; MYSQL_ROW row; MYSQL_FIELD * fields; unsigned int num_fields; const char *mquery = "select * from customers";; if(mysql_query(mysql, mquery)) { fprintf(stderr, "%s\n\n", mysql_error(mysql)); return -1; } result = mysql_store_result(mysql); if(result == NULL) { fprintf(stderr, "%s\n", mysql_error(mysql)); return -1; } num_fields = mysql_num_fields(result); fields = mysql_fetch_fields(result); for(int i = 0; i < num_fields; i++) printf("%s ", fields[i].name); printf("\n"); while((row = mysql_fetch_row(result))){ for(int i = 0; i < num_fields; i++) printf("%s ",row[i] ? row[i] : "NULL"); printf("\n"); } mysql_free_result(result); return 0; } int main() { MYSQL mysql; mysql_init(&mysql); if(!mysql_real_connect(&mysql,"localhost","niko","123456","anwei",0,NULL,0)) { fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql)); return -1; } Query(&mysql); mysql_close(&mysql); return 0; }