The MySQL C API 编程实例

The MySQL C API 编程实例

在网上找了一些MYSQL C API编程的文章,看了后认为还是写的不够充分,依据自己经验写了这篇《The MySQL C API 编程实例》,希望对须要调用到MYSQL的C的API的朋友有所帮助,附例中的环境为RedHat

    在这篇文章里,我们将学会怎么使用MySQL 的C APIs(Application Programming Interfaces 编程接口)。为了非常好地了解这篇文章,您须要具备下面前提知识:

  • C语言变量
  • C语言函数
  • C语言指针

简单介绍

C APIs包括在mysqlclient库文件其中与MySQL的源码一块发行,用于连接到数据库和运行数据库查询。有一些样例在MySQL原代码的clients文件夹里。



 

MySQL C 变量类型

下面变量类型在MySQL的库其中定义。我们须要这些变量是为了使用MySQL的函数。这些变量有具体的解释,可是这些解释对于写代码来说并不重要。

MYSQL

    下面代码块是用来连接数据库的通讯过程,要连接MYSQL,必须建立MYSQL实例,通过mysql_init初始化方能開始进行连接,这个在后面会讲到。

typedef struct st_mysql {
        
  NET           net;            /* Communication parameters */
        
  gptr          connector_fd;   /* ConnectorFd for SSL */
        
  char          *host,*user,*passwd,*unix_socket,
        
                *server_version,*host_info,*info,*db;
        
  unsigned int  port,client_flag,server_capabilities;
        
  unsigned int  protocol_version;
        
  unsigned int  field_count;
        
  unsigned int  server_status;
        
  unsigned long thread_id;      /* Id for connection in server */
        
  my_ulonglong affected_rows;
        
  my_ulonglong insert_id;       /* id if insert on table with NEXTNR */
        
  my_ulonglong extra_info;              /* Used by mysqlshow */
        
  unsigned long packet_length;
        
  enum mysql_status status;
        
  MYSQL_FIELD   *fields;
        
  MEM_ROOT      field_alloc;
        
  my_bool       free_me;        /* If free in mysql_close */
        
  my_bool       reconnect;      /* set to 1 if automatic reconnect */
        
  struct st_mysql_options options;
        
  char          scramble_buff[9];
        
  struct charset_info_st *charset;
        
  unsigned int  server_language;
        
} MYSQL;
        



 

MYSQL_RES

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

typedef struct st_mysql_res {
        
  my_ulonglong row_count;
        
  unsigned int  field_count, current_field;
        
  MYSQL_FIELD   *fields;
        
  MYSQL_DATA    *data;
        
  MYSQL_ROWS    *data_cursor;
        
  MEM_ROOT      field_alloc;
        
  MYSQL_ROW     row;            /* If unbuffered read */
        
  MYSQL_ROW     current_row;    /* buffer to current row */
        
  unsigned long *lengths;       /* column lengths of current row */
        
  MYSQL         *handle;        /* for unbuffered reads */
        
  my_bool       eof;            /* Used my mysql_fetch_row */
        
} MYSQL_RES;
        



 

MYSQL_ROW

这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。(假设字段值可能包括二进制数据,你不能将这些视为空终止串,由于这种值能够在内部包括空字节) 行通过调用mysql_fetch_row()获得。

typedef char **MYSQL_ROW;
        

MYSQL_FIELD

这个结构包括字段信息,比如字段名、类型和大小。其成员在以下更具体地描写叙述。你能够通过反复调用mysql_fetch_field()对每一列获得MYSQL_FIELD结构。字段值不是这个结构的部分;他们被包括在一个MYSQL_ROW结构中。



 

typedef struct st_mysql_field {
        
  char *name;                   /* Name of column */
        
  char *table;                  /* Table of column if column was a field */
        
  char *def;                    /* Default value (set by mysql_list_fields) */
        
  enum enum_field_types type;   /* Type of field. Se mysql_com.h for types */
        
  unsigned int length;          /* Width of column */
        
  unsigned int max_length;      /* Max width of selected set */
        
  unsigned int flags;           /* Div flags */
        
  unsigned int decimals;        /* Number of decimals in field */
        
} MYSQL_FIELD;
        

my_ulonglong

typedef unsigned long my_ulonglong;

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

printf (Number of rows: %lu/n”, (unsigned long) mysql_num_rows(result));

连接MySQL,查询数据

如今如果MySQL已安装, 用户和数据表在数据库被创造。以防有什么不明问题的情况, 请參考www.mysql.com 站点。

前面已经说过,MySQL的库文件在mysqlclient。因此在编译MySQL程序的时候有必要加上-lmysqlclient编译选项。MySQL的头文件在/usr/include/mysql文件夹下(依据Linux的发行版本号的不同,这个文件夹也有所不同),因此你的程序头部看起来有点这个样子:

#include <mysql.h>
        



 

MySQL的变量类型和函数都包括在这个头文件其中

然后,我们须要创建连接数据库的变量,能够简单地这么做:

MYSQL mysql;
        

在连接数据库之前,我们要调用下面函数初始化这个变量:

mysql_init(&mysql);
        

然后,调用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 int clientflag);
         


    该函数被调用连接到数据库。host是MySQLserver的主机名,user是登录的username,passwd是登录password,db是要连接的数据库,port是MySQLserver的TCP/IP端口,unix_socket是连接类型,clientflag是MySQL执行成ODBC数据库的标记。在这篇文章其中该标记设成0,连接寻建立后,这个函数返回0。

如今能够连接数据库,进行查询了:

char *query;
        



 

使用这个字符串我们能够创立不论什么SQL查询语句进行查询。运行这个查询的函数是:

int STDCALL mysql_real_query(MYSQL *mysql, const char *q, unsigned int length);
         



 

mysql是我们前面用过的变量,q是SQL查询语句,length是这个查询语句的长度。假设查询成功,函数返回0。

查询之后,我们要到一个MYSQL_RES变量来使用查询的结果。下面这行创立这个变量:

MYSQL_RES *res;
         



 

然后



 

res = mysql_store_result(&mysql);
          


    对client而言,有两种方法处理结果集合。一种方法是通过调用mysql_store_result()立马检索所有结果。该函数从server获得查询返回的所有行,并将他们存储在client。另外一种方法是对客户通过调用mysql_use_result()初始化一个一行一行地结果集合的检索。该函数初始化检索,可是实际上不从server获得不论什么行。

在两种情况中,你通过mysql_fetch_row()存取行。用mysql_store_result()、mysql_fetch_row()储存取已经从server被取出的行。用mysql_use_result()、mysql_fetch_row()实际上从server检索行。调用mysql_fetch_lengths()可获得关于每行中数据值尺寸的信息。


    在你用完一个结果集合以后,调用mysql_free_result()释放由它使用的内存。

两种检索机制是互补的。客户程序应该选择最适合他们的要求的途径。在实践中,客户通常更愿意使用mysql_store_result()。

该函数读出查询结果。

虽然能够非常easy地查询了,要用这个查询的结果还要用到其他的函数。第一个是:



 

MYSQL_ROW STDCALL mysql_fetch_row(MYSQL_RES *result);
          



 

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



 

MYSQL_ROW row = mysql_fetch_row(res)
          


    如前所解释的,变量
row是一个字符串数组。也就是说,row[0]是数组的第一个值,row[1]是数组的第二个值当我们用mysql_fetch_row的时候,接着变量row会取得结果的下一组的数据。当到了结果的尾部,该函数返回一负值。

使用数据集结束后,记得释放数据集,否则会发生内存泄漏,释放数据集函数例如以下:

void mysql_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,假设没有运行

Create Databse test
        

建立数据库

2、test数据库上有表t1,假设没有,运行

CREATE TABLE `t1` (
  `id` int(11) default NULL,
  `name` varchar(100) default NULL
)

建立表t1

testsql.c


         
           
         
/* testsql.c
** An example to use MYSQL C API
** Copyright 2004 Coon Xu.
** Author: Coon Xu
** Date:
05 Nov 2004
*/
 
#include <mysql.h>
#include <stdio.h>
int main(){
 MYSQL mysql;     // need a instance to init
 MYSQL_RES *res;
 MYSQL_ROW row;
 char *query;
 int t,r;
 // connect the database 
 mysql_init(&mysql);
 if (!mysql_real_connect(&mysql,"localhost", "mmim", "mmim", "test",0,NULL,0))
 {
     printf( "Error connecting to database: %s/n",mysql_error(&mysql));
 }
 else printf("Connected.../n");

 // get the result from the executing select query
 query = "select * from t1";
  
 t = mysql_real_query(&mysql,query,(unsigned int) strlen(query));
 if (t)
 {
    printf("Error making query: %s/n",
      mysql_error(&mysql));
 }
 else printf("[%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);     //free result after you get the result
 
 sleep(1);    
 
 // execute the insert query
 query = "insert into t1(id, name) values(3, 'kunp')";
 t = mysql_real_query(&mysql,query,(unsigned int) strlen(query));
 if (t)
 {
    printf("Error making query: %s/n",
      mysql_error(&mysql));
 }
 else printf("[%s] made.../n", query); 
  
    mysql_close(&mysql);
  
   return 0;
}

编译

假定mysql的头文件在/usr/include/mysql,库文件在/usr/lib/mysql,运行下列命令进行编译:

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



 



 

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/119241.html原文链接:https://javaforall.cn

【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛

【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

(0)


相关推荐

  • soap 返回xml 文件 soap 文件 webservice wsdl

    soap 返回xml 文件 soap 文件 webservice wsdl

  • cocos2d-x使用CCClippingNode实现跑马灯

    cocos2d-x使用CCClippingNode实现跑马灯

  • IDEA阅读spring源码并调试「建议收藏」

    IDEA阅读spring源码并调试「建议收藏」阿里云服务器优惠券领取优惠券目标:搭建起Spring源码阅读和代码调试跟踪的环境,顺便建立一个简单的Demo,能够调试Spring的源代码本节,主要介绍一下Spring源码阅读和调试的相关环境搭建,并使用MVN创建一个非常简单的Demo,以便可以跟踪和调试Spring的内核。1、源码的下载Spring的源码可以从GitHub上下载:https://github.com/spri………

  • HTML占位符_怎么使用占位符

    HTML占位符_怎么使用占位符HTML空格位占位符&amp;#32;——普通的英文半角空格;&amp;#160;、&amp;nbsp;、&amp;#xAO;、no-breakspace——普通的英文半角空格但不换行&amp;#160;——中文全角空格(一个中文宽度)&amp;#8194;、&amp;ensp——en空格(半个中文宽度)&amp;#8195;、&amp;emsp…

  • freeswitch呼叫中心开发

    freeswitch呼叫中心开发开发freeswitch呼叫中心1、配置ivr2、启用mod_callcenter3、开发websocker接口,通过esl接口,发送callcenter_config命令给fs4、开发客户端页面,注册,注销,就绪,置忙等接口5、开发来电弹屏,通过客户端读取redis参数实现freeswitch的呼叫中心模块很方便的就可以让用户体验这种呼叫中心模式,包含了很多功能,具体参数的配置在使用中自行摸索。编译安装freeswitch时需要开启mod_callcenter、mod_fifo的编译,之

  • RabbitVCS安装

    RabbitVCS安装给大家推荐使用RabbitVCS,类似与TortoiseSVN。下面具体安装RabbitVCS的方法步骤如下:第一步:sudoadd-apt-repositoryppa:rabbitvcs/ppa第二步:根据第一步的情况来是否跳过该步骤,如果第一步出现导入key,那第二步可以跳过,否则需要导入keysudoapt-keyadv–keyserverkeyserver.u

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号