1. 程式人生 > 實用技巧 >mysql C API 官網樣例淺析(1)

mysql C API 官網樣例淺析(1)

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;
}