使用C语言调用mysql数据库编程实战以及技巧

今天编写使用C语言调用mysql数据库编程实战以及技巧。为其它IT同行作为參考，当然有错误能够留言，共同学习。

一、mysql数据库的C语言经常使用接口API
1.首先当然是链接数据库mysql_real_connect，原型例如以下：
MYSQL * STDCALL 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 clientflag);
第一个參数mysql是C语言api中一个很重要的变量。里面内存很丰富。有port,dbname,charset等连接基本參数。它也包括了一个叫 st_mysql_methods的结构体变量，该变量里面保存着许多函数指针。这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。

mysql_real_connect函数中各參数，基本都是顾名思意。

2.连接数据库成功之后就能够使用mysql_query运行sql语句。原型例如以下：
int STDCALL mysql_query(MYSQL *mysql, const char *q);
第一个參数上面已经介绍过。第二个參数为要运行的sql语句，主要就是运行SQL语句的增、删、改、查等功能。

这个函数整体就两步：
（1）发送sql语句，事实上就一个socket发送sql 语句，加上mysql固定的协议头。
（2）然后就是接受结果，这里将会调用MYSQL变量中的st_mysql_methods中的read_query_result函数指针

a 假设包括二进制数据的查询，要使用mysql_real_query.

b 检查受查询影响的行数:
my_ulonglong mysql_affected_rows(MYSQL *connection);
my_ulonglong是无符号长整形，为%lu格式
这个函数返回受之前运行update,insert或delete查询影响的行数。

#include    <stdio.h>
#include    <string.h>
#include    <stdlib.h>
#include    <math.h>

#include "/usr/local/mysql/include/mysql.h"

static MYSQL mysql, *sock;
char sql[1024];
MYSQL_RES *res=NULL;
MYSQL_ROW row ;
int num_fields;
int num_rows = 0;

int main(){
    memset(sql, 0x00, sizeof(sql));
    mysql_init(&mysql);   

    if(!(sock = mysql_real_connect(&mysql,         (char *)"localhost", (char *)"ebipcs",         (char *)"Dcep2vUnAX", (char *)"ebipcs",         0, NULL, 0))){
        printf( "Couldn‘t connect to DB!\n\n%s\n\n", mysql_error(&mysql));
        return 0 ;
    }

    if(sock){
        printf( "SUCCESS\n" );
    }else{
        printf( "FAIL\n" );
        return 0;
    }
    sprintf(sql,"update cisaddressinfo set cisaddressinfo.addressseqno = ‘2‘ where cisaddressinfo.customid=‘199999900000000000015‘;");
    if(mysql_query(sock, sql)) {
         printf("mysql_query[%d] [%s]!\n", mysql_errno(sock), mysql_error(sock));
         return -1;
     }
    if( !(mysql_affected_rows( sock )) ){
        printf("update OK\n");
    }else{
        printf("update Fail\n");
    }
    if(mysql_errno(sock)){
        printf("mysql_affected_rows[%d] [%s]!\n", mysql_errno(sock), mysql_error(sock));
    }
    return 0;
}

3.存储运行结果
SQL最常见的用法是提取数据而不是插入或更新数据。

数据是用select语句提取的
C应用程序提取数据一般须要4个步骤：
1、运行查询
2、提取数据
3、处理数据
4、必要的清理工作
就像之前的insert和update一样，使用mysql_query来发送SQL语句，然后使用mysql_store_result或mysql_use_result来提取数据，详细使用哪个语句取决于你想怎样提取数据。接着，将使用一系列mysql_fetch_row来处理数据。最后。使用mysql_free_result释放查询占用的内存资源。

a 一次提取全部数据：mysql_store_result
假设mysql_query返回成功，那么我们就通过mysql_store_result函数来读取结果。原型例如以下：
MYSQL_RES * STDCALL mysql_store_result(MYSQL *mysql);
该函数会调用MYSQL变量中的st_mysql_methods中的 read_rows函数指针来获取查询的结果。同一时候该函数会返回MYSQL_RES 这样一个变量，该变量主要用于保存查询的结果。同一时候该函数malloc了一片内存空间来存储查询过来的数据，所以我们一定要记的 free(result),不然是肯定会造成内存泄漏的。

运行完mysql_store_result以后，事实上数据都已经在MYSQL_RES 变量中了。
相关函数：
// 这是在成功调用mysql_query之后使用此函数，这个函数将立马保存在客户端中返回的全部数据。它返回一个指向结果集结构的指针，假设失败返回NULL
MYSQL_RES *mysql_store_result(MYSQL *connection);
// 这个函数接受由mysql_store_result返回的结果结构集，并返回结构集中的行数
my_ulonglong mysql_num_rows(MYSQL_RES *result);
// 这个函数从使用mysql_store_result得到的结果结构中提取一行，并把它放到一个行结构中。当数据用完或错误发生时返回NULL.
MYSQL_ROW mysql_fetch_row(MYSQL_RES *resutl);
// 这个函数用来在结果集中跳转。设置将会被下一个mysql_fetch_row操作返回的行。

參数offset是一个行号。它必须是在0～结果总行数-1的范围内。

传递
// 0将会导致下一个mysql_fetch_row调用返回结果集中的第一行。

void mysql_data_seek(MYSQL_RES *result, my_ulonglong offset);
//返回一个偏移值，它用来表示结果集中的当前位置。它不是行号，不能把它用于mysql_data_seek
MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result);
// 这将在结果集中移动当前的位置。并返回之前的位置
MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset);
// 完毕全部对数据的操作后。必须总是调用这个来善后处理
void mysql_free_result(MYSQL_RES *result);

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "mysql.h"
#include "errmsg.h"
#include "mysqld_error.h"

MYSQL conn;
MYSQL_RES *res_ptr;
MYSQL_ROW sqlrow;

void connection(const char* host, const char* user, const char* password, const char* database) {
    mysql_init(&conn); // 注意取地址符&

    if (mysql_real_connect(&conn, host, user, password, database, 0, NULL, 0)) {
        printf("Connection success!\n");
    } else {
        fprintf(stderr, "Connection failed!\n");
        if (mysql_errno(&conn)) {
            fprintf(stderr, "Connection error %d: %s\n", mysql_errno(&conn), mysql_error(&conn));
        }
        exit(EXIT_FAILURE);
    }
}

int main (int argc, char *argv[]) {

    connection("localhost", "root", "shuang", "shuangde");
    int res = mysql_query(&conn, "SELECT * from student");
    if (res) {
        fprintf(stderr, "SELECT error: %s\n", mysql_error(&conn));
    } else {
        res_ptr = mysql_store_result(&conn);
        if (res_ptr) {
            printf("Retrieved %lu rows\n", (unsigned long)mysql_num_rows(res_ptr)); 
            while ((sqlrow = mysql_fetch_row(res_ptr))) {
                printf("Fetched data...\n") ;
            }
            if (mysql_errno(&conn)) {
                fprintf(stderr, "Retrive error: %s\n", mysql_error(&conn));
            }
            mysql_free_result(res_ptr);
        } 
    }
    mysql_close(&conn);
    exit(EXIT_SUCCESS);
}

b 一次提取一行数据：mysql_use_result
用法和mysql_store_result全然一样。把上面代码的mysql_store_result改为mysql_use_result就可以。
mysql_use_result具备资源管理方面的实质性优点，更好地平衡了网络负载。以及降低了可能很大的数据带来的存储开销，可是不能与mysql_data_seek、mysql_row_seek、mysql_row_tell、mysql_num_rows一起使用。假设数据比較少，用mysql_store_result更好。

处理返回的数据相关函数和定义：
// 返回结果集中的字段（列）数目
unsigned int mysql_field_count(MYSQL *connection);
// 将元数据和数据提取到一个新的结构中
MYSQL_FIELD *mysql_fetch_field(MYSQL *result);
// 这个函数用来覆盖当前的字段编号。该编号会随着每次mysql_fetch_field调用而自己主动添加。假设给offset传递0，那么将跳回第1列
MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL *result, MYSQL_FIELD_OFFSET offset);
// MYSQL_FIELD定义在sql.h中，是指向字段结构数据的指针，有关于列的信息。

有成员：
char *name; // 列名，为字符串
char *table; // 列所属表名
char *def; // 假设调用mysql_list_fields。它将包括该列的默认值
enum enum_field_types type; // 列类型
unsigned int length; // 列宽
unsigned int max_length; // 假设使用mysql_store_result，它将包括以字节为单位的提取的最长列值的长度，假设使用mysql_use_result，将不会被设置
unsigned int flags; // 关于列定义的标志，与得到的数据无关.常见的标志的含义有：
// NOT_NULL_FLAG
// PRI_KEY_FLAG
// UNSIGNED_FLAG
// AUTO_INCREMENT_FLAG
// BINARY_FLAG等
unsigned int decimals; // 小数点后的数字个数。
// 列类型相当广泛，完整的列表见头文件mysql_com.h,常见的有：
// FIELD_TYPE_DECIMAL
// FIELD_TYPE_LONG
// FIELD_TYPE_STRING
// FIELD_TYPE_VAR_STRING
//一个特别实用的提前定义宏： IS_NUM,当字段类型为数字时，返回true

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "mysql.h"
#include "errmsg.h"
#include "mysqld_error.h"


MYSQL conn;
MYSQL_RES *res_ptr;
MYSQL_ROW sqlrow;

void connection(const char* host, const char* user, const char* password, const char* database) {
    mysql_init(&conn); // 注意取地址符&

    if (mysql_real_connect(&conn, host, user, password, database, 0, NULL, 0)) {
        printf("Connection success!\n");
    } else {
        fprintf(stderr, "Connection failed!\n");
        if (mysql_errno(&conn)) {
            fprintf(stderr, "Connection error %d: %s\n", mysql_errno(&conn), mysql_error(&conn));
        }
        exit(EXIT_FAILURE);
    }
}

void display_row() {
    unsigned int field_count = mysql_field_count(&conn);
    int i = 0;
    while (i < field_count) {
        if (sqlrow[i]) printf("%s ", sqlrow[i]);
        else printf("NULL");
        i++;
    }
    printf("\n");
}

void display_header() {
    MYSQL_FIELD *field_ptr;
    printf("Column details:\n");
    while ((field_ptr = mysql_fetch_field(res_ptr)) != NULL) {
        printf("\t Name: %s\n", field_ptr->name);   
        printf("\t Table: %s\n", field_ptr->table); 
        printf("\t Type: ");
        if (IS_NUM(field_ptr->type)) {
            printf("Numeric field\n");  
        } else {
            switch(field_ptr->type) {
                case FIELD_TYPE_VAR_STRING:
                    printf("VARCHAR\n");
                    break;
                case FIELD_TYPE_LONG:
                    printf("LONG");
                    break;
                default:
                    printf("Type is %d, check in msyql_com.h\n", field_ptr->type);
            }   
        }
        printf("\t Max width %ld\n", field_ptr->length);
        if (field_ptr->flags & AUTO_INCREMENT_FLAG)
            printf("\t Auto increments\n");
        printf("\n");
    }
}

int main (int argc, char *argv[]) {

    connection("localhost", "root", "shuang", "shuangde");
    int res = mysql_query(&conn, "SELECT * from student");
    if (res) {
        fprintf(stderr, "SELECT error: %s\n", mysql_error(&conn));
    } else {
        res_ptr = mysql_use_result(&conn);
        if (res_ptr) {
            int first = 1;
            while ((sqlrow = mysql_fetch_row(res_ptr))) {
                if (first) {
                    display_header();
                    first = 0;  
                }
                display_row();
            }
            if (mysql_errno(&conn)) {
                fprintf(stderr, "Retrive error: %s\n", mysql_error(&conn));
            }
            mysql_free_result(res_ptr);
        } 
    }
    mysql_close(&conn);
    exit(EXIT_SUCCESS);
}

使用技巧：
a 关于MYSQL MYSQL_RES 类型变量定义及free的问题。
使用例如以下方式，会更好一些。
定义： MYSQL_RES *res=NULL;
使用：res = mysql_store_result( m_sock )
释放：if（res）
{mysql_free_result( res ); res=NULL}
依据以上规则。我们定义一个宏：
*#define MYSQLFREE(a) \
if( a != NULL )\
{ \
mysql_free_result( a );\
a=NULL;\
}
使用的时候：MYSQLFREE（res）