Linux c_mysql编程

使用前准备

首先你要确定 mysql.h及其相应版本的shared object (例如libmysqlclient.so.x)已经安装妥当，理论上安装好MySQL后，这两个档案已分别放置在mysql/include及 mysql/lib里(除非在设置MySQL选项时更改了其位置)。请注意，mysql.h及libmysqlclient.so.x必须为同一个 MySQL版本，若使用不相同的版本将有未能预计的结果。

最重要一点，当然是确保你的MySQL Server正在运行中，你亦需新增用户名称及密码供你的程式登入。

MySQL所使用的数据结构

「MYSQL」这数 据结构是最常用的，因为它是连接MySQL Server的handle，每一个handle就代表程式与MySQL Server的一个(唯一的) connection，所有存取、查询，删除等等的工作都需要MySQL handle作参数以识别不同使用者、数据库及发出指令的程式。

「MYSQL_RES」 的意思是MySQL Result Set(若以微软作对比的话，可说是Record Set)，顾名思义，这是包含数据库传回来的结果，但我们并不会直接存取MYSQL_RES里的资料，我们会使用「MYSQL_ROW」，即是以行作单位 读取资料，详情请往http://dev.mysql.com/doc/mysql/en/C_API_datatypes.html参考。

连接MySQL Server

在程序代码里你需要加入#include <mysql.h>让编译器找到所有MySQL Client的函数定义，然后使用mysql_init()准备连接，mysql_init()的原型如下：

MYSQL *mysql_init(MYSQL *mysql)

以下为一简单例子：

#include <stdio.h>
#include <mysql.h>

int main(int argc, char **argv)

{
     MYSQL mysql_conn;

     if (mysql_init(&mysql_conn) != NULL)

     {
        
         ...
     }

    else {
        
         ...
     }

     return 0;

}

若果未能初始化MySQL handle的话，mysql_init会传回NULL，各读者应尽量检查所有函数是否运作正常。在编译时你需加入「-lmysqlclient」加入libmysqlclient.so.x，例子如下：

gcc test.c -I/usr/include/mysql -L/usr/lib/mysql -lmysqlclient -o test

-I(include path)随后的path是mysql.h的位置，-L(library path)随后的path是libmysqlclient.so.x的位置。

Handle被初始化后，就可以使用mysql_real_connect(或mysql_connect)连接MySQL Server了，此时你需要输入host name、user name、password等作参数：

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)

第一个参数是你刚才 初始化的handle，第二至四个参数分别是host name、user name及password，第五个参数是数据库名称，你也可把第五个参数设为NULL，之后使用mysql_select_db来选择数据库，第六个参 数是MySQL Server的连接埠，一般都把它设为MYSQL_PORT(这正是mysql.h和libmysqlclient.so.x要配合的原因)，第七个参数 是MySQL Server及client间传输资料的渠道(socket或named pipe)，但MySQL Server会根据host name(第二参数)建立另一渠道，除非你有真正的需要另建，否则你需在第七个参数填上NULL。最后是client_flag，包括压缩协定、查询语句 协定、加密协定等，详情请参看http://dev.mysql.com/doc/mysql/en/mysql_real_connect.html

以下是一例子：

#include <stdio.h>
#include <mysql.h>

int main(int argc, char **argv)

{
     MYSQL mysql_conn

     if (mysql_init(&mysql_conn) != NULL)

     {
         if (mysql_real_connect(&mysql_conn, "localhost", "test", "test_pass", "sample_db", MYSQL_PORT, NULL, 0) !=    NULL)

          {
             (void) printf("GOOD!\n");
           }

          else {
             (void) printf("Connection fails.\n");
           }
      }

     else {
         (void) printf("Initialization fails.\n");
         return -1;
     }

     mysql_close(&mysql_conn);
     return 0;
}

查询数据库

当你成功连接 MySQL Server后，便可使用mysql_query或mysql_real_query来查询数据库，mysql_query不能处理binary data，若你的查询含有binary data，例如中文字或不能显示的字完，就必须使用mysql_real_query，即是要读者提供该查询字串的长度，mysql_query的原型如 下：

int mysql_query(MYSQL *mysql, const char *query)

第一个参数是MySQL连接的handle，第二个参数就是查询字串，若查询语法正确以及查询成功的话，mysql_query会返回零值，失败才会传回非零值，这点读者需要留意(其实大部分MySQL client函数都在成功时传回非零值)。

若你的查询语句并没 有结果(Result set)需要传回，例如DELETE、UPDATE、INSERT等，mysql_query被执行后便完成整个操作了；若你要执行INSERT、 SHOW、DESCRIBE等，在存取结果前，你必须使用mysql_store_result来建立Result handle，mysql_store_result原型如下：

MYSQL_RES *mysql_store_result(MYSQL *mysql)

应用例子如下：

#include <stdio.h>
#include <mysql.h>

int main(int argc, char **argv)

{
     MYSQL mysql_conn
     MYSQL_RES *mysql_result;

     if (mysql_init(&mysql_conn) != NULL)

    {
         if (mysql_real_connect(&mysql_conn, "localhost", "test", "test_pass", "sample_db", MYSQL_PORT, NULL, 0) != NULL) {
            
             mysql_query(&mysql_conn, "select * from table1");
             mysql_result = mysql_store_result(&mysql_conn);

            
             mysql_free_result(mysql_result);
         }

         else {
             (void) printf("Connection fails.\n");
         }
     }

    else {
         (void) printf("Initialization fails.\n");
         return -1;
     }

     mysql_close(&mysql_conn);
     return 0;
}

请留意mysql_result是一个指针(pointer)，因为mysql_store_result会替你分配记忆体来储存查询结果，当然你亦需要执行mysql_free_result(MYSQL_RES*)来释放该段记忆体。

撷取查询结果

正如上一节所说，撷 取结果前需使用mysql_store_result分配记忆体予查询结果的数据结构，然后再以回圈逐行撷取，至於如何知道结果共有多少行，可使用 mysql_num_rows(MYSQL_RES*)，其传回数字即是结果的行数。在该回圈里，要使用mysql_fetch_row()

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

MYSQL_ROW 是一个阵列结构，阵列内每一个元素顺次序便是该行的column value，例如&#20082;前有一table名叫「Table1」有「C1」及「C2」两个栏，那么以「Select * from Table1」查询后，MYSQL_ROW第一个元素(mysql_row[0])便是C1的资料，第二个元素(mysql_row[1])是C2的资 料。例子如下：

#include <stdio.h>
#include <dmalloc.h>
#include <mysql.h>

int main(int argc, char **argv)

{
     MYSQL mysql_conn;
     MYSQL_RES *mysql_result;
     MYSQL_ROW mysql_row;
     int f1, f2, num_row, num_col;

     if (mysql_init(&mysql_conn) != NULL)

     {
         if (mysql_real_connect(&mysql_conn, "localhost", "test", "testpass", "test", MYSQL_PORT, NULL, 0) != NULL)

         {
             if (mysql_query(&mysql_conn, "select * from testtable") == 0)

             {
                 mysql_result = mysql_store_result(&mysql_conn);
                 num_row = mysql_num_rows(mysql_result);
                 num_col = mysql_num_fields(mysql_result);

                 for (f1 = 0; f1 < num_row; f1++)

                 {
                     for (f2 = 0; f2 < num_col; f2++)

                     {
                         mysql_row = mysql_fetch_row(mysql_result);
                         printf("[Row %d, Col %d] ==> [%s]\n", f1, f2, mysql_row[f2]);
                     }
                 }
             }

             else {
                 (void) printf("Query fails\n");
             }
         }

        else {
             (void) printf("Connection fails\n");
         }
     }

    else {
         (void) printf("Initialization fails\n");
     }

     mysql_free_result(mysql_result);
     mysql_close(&mysql_conn);
     return 0;
}

刚才的程式码会将数据库「test」里的「testtable」table内所有资料显示出来。请留意，若果数据库内的资料庞大，而你却忘了使用mysql_free_result释放记忆体，你便会遇上庞大的记忆体溢出问题。

使用提示

• 在MySQL的开发者讨论区内，有人曾发表过mysql_init及mysql_close会分别动态载入及卸载libmysqlclient，并造成记忆体溢出，所以在编译时应加入「-lz」来强制shared object於程式结束时才卸下。

• 在my.cnf内有加入「host」设定的话，使用libmysqlclient时会造成严重记忆体溢出，请往http://lists.mysql.com/mysql/44051参考。

• 使 用过所有有查询结果的query后(包括SELECT、SHOW、DESCRIBE、EXPLAIN、OPTIMIZE等等)，必需使用mysql_store_result(MYSQL_RES*)，否则你将不能按常进行第二次查询。若你真的不需要知道query后的结果，可使用：

  mysql_free_result(mysql_store_result(MYSQL*));

  
  来处理查询结果。

• 要时常检查著每句指令的传回码，因为逾时、查询语句错误、查询执行错误、记忆体不足、连接错误等等，都会令你的程式无法正常操作。