您的位置：首页 > 数据库 > MySQL

Mysql C api

2007-10-10 15:08 253 查看
简介
CAPIs包含在mysqlclient库文件当中与MySQL的源代码一块发行，用于连接到数据库和执行数据库查询。有一些例子在MySQL原代码的clients目录里。
MySQLC变量类型
以下变量类型在MySQL的库当中定义。我们需要这些变量是为了使用MySQL的函数。这些变量有详细的解释，但是这些解释对于写代码来说并不重要。
MYSQL
以下代码块是用来连接数据库的通讯过程，要连接MYSQL，必须建立MYSQL实例，通过mysql_init初始化方能开始进行连接，这个在后面会讲到。

typedefstructst_mysql{

NETnet;/*Communicationparameters*/

gptrconnector_fd;/*ConnectorFdforSSL*/

char*host,*user,*passwd,*unix_socket,

*server_version,*host_info,*info,*db;

unsignedintport,client_flag,server_capabilities;

unsignedintprotocol_version;

unsignedintfield_count;

unsignedintserver_status;

unsignedlongthread_id;/*Idforconnectioninserver*/

my_ulonglongaffected_rows;

my_ulonglonginsert_id;/*idifinsertontablewithNEXTNR*/

my_ulonglongextra_info;/*Usedbymysqlshow*/

unsignedlongpacket_length;

enummysql_statusstatus;

MYSQL_FIELD*fields;

MEM_ROOTfield_alloc;

my_boolfree_me;/*Iffreeinmysql_close*/

my_boolreconnect;/*setto1ifautomaticreconnect*/

structst_mysql_optionsoptions;

charscramble_buff[9];

structcharset_info_st*charset;

unsignedintserver_language;

}MYSQL;

MYSQL_RES
这个结构代表返回行的一个查询的(
SELECT
,
SHOW
,
DESCRIBE
,
EXPLAIN
)的结果。返回的数据称为“数据集”，用过数据库的朋友应该对数据库中查询后得到的结果集不会陌生，在C的API里对应的就是MYSQL_RES了，从数据库读取数据，最后就是从MYSQL_RES中读取数据。

typedefstructst_mysql_res{

my_ulonglongrow_count;

unsignedintfield_count,current_field;

MYSQL_FIELD*fields;

MYSQL_DATA*data;

MYSQL_ROWS*data_cursor;

MEM_ROOTfield_alloc;

MYSQL_ROWrow;/*Ifunbufferedread*/

MYSQL_ROWcurrent_row;/*buffertocurrentrow*/

unsignedlong*lengths;/*columnlengthsofcurrentrow*/

MYSQL*handle;/*forunbufferedreads*/

my_booleof;/*Usedmymysql_fetch_row*/

}MYSQL_RES;

MYSQL_ROW
这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。（如果字段值可能包含二进制数据，你不能将这些视为空终止串，因为这样的值可以在内部包含空字节)行通过调用
mysql_fetch_row()
获得。

typedefchar**MYSQL_ROW;

MYSQL_FIELD
这个结构包含字段信息，例如字段名、类型和大小。其成员在下面更详细地描述。你可以通过重复调用mysql_fetch_field()对每一列获得MYSQL_FIELD结构。字段值不是这个结构的部分；他们被包含在一个MYSQL_ROW结构中。

typedefstructst_mysql_field{

char*name;/*Nameofcolumn*/

char*table;/*Tableofcolumnifcolumnwasafield*/

char*def;/*Defaultvalue(setbymysql_list_fields)*/

enumenum_field_typestype;/*Typeoffield.Semysql_com.hfortypes*/

unsignedintlength;/*Widthofcolumn*/

unsignedintmax_length;/*Maxwidthofselectedset*/

unsignedintflags;/*Divflags*/

unsignedintdecimals;/*Numberofdecimalsinfield*/

}MYSQL_FIELD;

my_ulonglong

typedefunsignedlongmy_ulonglong;
该类型用于行编号和mysql_affected_rows()、mysql_num_rows()和mysql_insert_id()。这种类型提供0到1.84e19的一个范围。在一些系统上，试图打印类型my_ulonglong的值将不工作。为了打印出这样的值，将它变换到unsignedlong并且使用一个%lu打印格式。例如：

printf(Numberofrows:%lu/n",(unsignedlong)mysql_num_rows(result));
连接MySQL，查询数据
现在假设MySQL已安装,用户和数据表在数据库被创造。以防有什么不明问题的情况,请参考www.mysql.com网站。
前面已经说过，MySQL的库文件在mysqlclient。因此在编译MySQL程序的时候有必要加上-lmysqlclient编译选项。MySQL的头文件在/usr/include/mysql目录下(根据Linux的发行版本的不同，这个目录也有所不同)，因此你的程序头部看起来有点这个样子：

#include<mysql.h>

MySQL的变量类型和函数都包含在这个头文件当中
然后，我们需要创建连接数据库的变量，可以简单地这么做：

MYSQLmysql;

在连接数据库之前，我们要调用以下函数初始化这个变量：

mysql_init(&mysql);

然后，调用mysql_real_connect函数：

MYSQL*STDCALLmysql_real_connect(MYSQL*mysql,constchar*host,

constchar*user,

constchar*passwd,

constchar*db,

unsignedintport,

constchar*unix_socket,

unsignedintclientflag);

[align=left]
该函数被调用连接到数据库。host是MySQL服务器的主机名，user是登录的用户名，passwd是登录密码，db是要连接的数据库，port是MySQL服务器的TCP/IP端口，unix_socket是连接类型，clientflag是MySQL运行成ODBC数据库的标记。在这篇文章当中该标记设成0，连接寻建立后，这个函数返回0。[/align]
现在可以连接数据库，进行查询了：

char*query;

使用这个字符串我们可以创立任何SQL查询语句进行查询。执行这个查询的函数是：

intSTDCALLmysql_real_query(MYSQL*mysql,constchar*q,unsignedintlength);

[align=left][/align]
[align=left]mysql是我们前面用过的变量，q是SQL查询语句，length是这个查询语句的长度。如果查询成功，函数返回0。[/align]
查询之后，我们要到一个MYSQL_RES变量来使用查询的结果。以下这行创立这个变量：

MYSQL_RES*res;

然后

res=mysql_store_result(&mysql);

[align=left]
对客户端而言，有两种方法处理结果集合。一种方法是通过调用mysql_store_result()立刻检索全部结果。该函数从服务器获得查询返回的所有行，并将他们存储在客户端。第二种方法是对客户通过调用mysql_use_result()初始化一个一行一行地结果集合的检索。该函数初始化检索，但是实际上不从服务器获得任何行。[/align]
[align=left]在两种情况中，你通过mysql_fetch_row()存取行。用mysql_store_result()、mysql_fetch_row()储存取已经从服务器被取出的行。用mysql_use_result()、mysql_fetch_row()实际上从服务器检索行。调用mysql_fetch_lengths()可获得关于每行中数据值尺寸的信息。
[/align]
[align=left]
在你用完一个结果集合以后，调用mysql_free_result()释放由它使用的内存。[/align]
[align=left]两种检索机制是互补的。客户程序应该选择最适合他们的要求的途径。在实践中，客户通常更愿意使用mysql_store_result()。[/align]
[align=left]该函数读出查询结果。[/align]
尽管可以很容易地查询了，要用这个查询的结果还要用到其它的函数。第一个是：

MYSQL_ROWSTDCALLmysql_fetch_row(MYSQL_RES*result);

该函数把结果转换成“数组”。你可能注意到了，该函数返回的是MYSQL_ROW变量类型。以下语句创立那样的变量：

MYSQL_ROWrow=mysql_fetch_row(res)

[align=left]
如前所解释的，变量row是一个字符串数组。也就是说，row[0]是数组的第一个值，row[1]是数组的第二个值...当我们用mysql_fetch_row的时候，接着变量row会取得结果的下一组的数据。当到了结果的尾部，该函数返回一负值。[/align]
使用数据集结束后，记得释放数据集，否则会发生内存泄漏，释放数据集函数如下：

voidmysql_free_result(MYSQL_RES*result)

释放由
mysql_store_result()
、
mysql_use_result()
、mysql_list_dbs()等为一个结果集合分配的内存。当你用完了一个结果集合时，你必须调用
mysql_free_result()
来释放它使用的内存。
最后我们要关闭这个连接：

mysql_close(&mysql);

例子程序
执行一个select操作，从数据库中取数据，并执行一个insert操作，往数据库中插入数据，根据这两个操作你可以自由的扩展为任意数据库操作，
准备条件
1、已经安装mysql，上有数据库test，如果没有执行

CreateDatabsetest

建立数据库
2、test数据库上有表t1，如果没有，执行

CREATETABLE`t1`(
`id`int(11)defaultNULL,
`name`varchar(100)defaultNULL
)

建立表t1
testsql.c：


/*testsql.c

**AnexampletouseMYSQLCAPI

**Copyright2004CoonXu.

**Author:CoonXu

**Date:
05Nov2004

*/


#include<mysql.h>

#include<stdio.h>

intmain(){

MYSQLmysql;//needainstancetoinit

MYSQL_RES*res;

MYSQL_ROWrow;

char*query;

intt,r;

//connectthedatabase

mysql_init(&mysql);

if(!mysql_real_connect(&mysql,"localhost","mmim","mmim","test",0,NULL,0))

{

printf("Errorconnectingtodatabase:%s/n",mysql_error(&mysql));

}

elseprintf("Connected.../n");


//gettheresultfromtheexecutingselectquery
query="select*fromt1";

t=mysql_real_query(&mysql,query,(unsignedint)strlen(query));
if(t)
{
printf("Errormakingquery:%s/n",
mysql_error(&mysql));
}
elseprintf("[%s]made.../n",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("/n");
}

printf("mysql_free_result.../n");
mysql_free_result(res);//freeresultafteryougettheresult

sleep(1);

//executetheinsertquery
query="insertintot1(id,name)values(3,'kunp')";
t=mysql_real_query(&mysql,query,(unsignedint)strlen(query));
if(t)
{
printf("Errormakingquery:%s/n",
mysql_error(&mysql));
}
elseprintf("[%s]made.../n",query);

mysql_close(&mysql);

return0;
}

编译
假定mysql的头文件在/usr/include/mysql，库文件在/usr/lib/mysql，执行下列命令进行编译：

gcctestsql.c-I/usr/include/mysql-L/usr/lib/mysql-lmysqlclient

                                            

                                        

                        
                        内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息 
                    

                    

                    

                        

                         标签： 
                                                

                        

                    


                

            


            

                
相关文章推荐

                

                
            

        

        

            

            
            

                

                    
新的分享

                    

                        
                    

                

            


            

                

                    
章节导航