【MySQL】——常用接口API即相关函数说明

目录

1、MySQL结构体的说明

1、MYSQL结构体

2.MYSQL_RES结构体

[3. MYSQL_FIELD](#3. MYSQL_FIELD)

[2. 接口的使用步骤](#2. 接口的使用步骤)

3、mysql_init()------MYSQL对象初始化

4、mysql_real_connect()------数据库引擎建立连接

[5. mysql_query()------查询数据库某表内容](#5. mysql_query()——查询数据库某表内容)

6、mysql_real_query------执行SQL语句

7、mysql_store_result()------向客户端检索完整的结果集

8、mysql_fetch_row()------从结果集中获取下一行

9、mysql_field_count()------返回表的列数

10、mysql_fetch_fields()------来获取表头的内容

11、函数原型及参数说明

12、mysql_free_result()------释放结果集使用的内存

13、mysql_close()------关闭数据库连接


1、MySQL结构体的说明

1、MYSQL结构体

连接数据库前,必须先创建MYSQL变量,此变量在很多Mysql API函数会用到。它包含了一些连接信息等数据。

cpp 复制代码
typedef struct st_mysql {
NET  net;            /* Communication parameters 通讯参数,网络相关*/
unsigned char connector_fd;   /* ConnectorFd for SSL 加密套接字协议层*/

char  *host,*user,*passwd,*unix_socket,*server_version,
*host_info,*info,*db;//数据库用户名,密码,主机名,Unix套接字,版本,主机信息

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;

2.MYSQL_RES结构体

MYSQL_RES 结构体中包含了 查询结果集 ,也就是从数据库中查询到的数据。可以使用mysql_store_result或 mysql_use_result 函数获得。定义如下:

cpp 复制代码
typedef struct st_mysql_res {
  my_ulonglong  row_count;
  MYSQL_FIELD   *fields;
  MYSQL_DATA    *data;
  MYSQL_ROWS    *data_cursor;
  unsigned long *lengths;       /* column lengths of current row */
  MYSQL     *handle;        /* for unbuffered reads */
  const struct st_mysql_methods *methods;
  MYSQL_ROW row;            /* If unbuffered read */
  MYSQL_ROW current_row;        /* buffer to current row */
  MEM_ROOT  field_alloc;
  unsigned int  field_count, current_field;
  my_bool   eof;            /* Used by mysql_fetch_row */
  /* mysql_stmt_close() had to cancel this result */
  my_bool       unbuffered_fetch_cancelled;  
  void *extension;
} MYSQL_RES;

3. MYSQL_FIELD

  1. MYSQL_FIELD 中包含了 字段名、字段类型和 大小等信息。可以重复调用mysql_fetch_field函数获得所有字段的信息
cpp 复制代码
typedef struct st_mysql_field {
  char *name;                 /* Name of column */
  char *org_name;             /* Original column name, if an alias */
  char *table;                /* Table of column if column was a field */
  char *org_table;            /* Org table name, if table was an alias */
  char *db;                   /* Database for table */
  char *catalog;	      /* Catalog for table */
  char *def;                  /* Default value (set by mysql_list_fields) */
  unsigned long length;       /* Width of column (create length) */
  unsigned long max_length;   /* Max width for selected set */
  unsigned int name_length;
  unsigned int org_name_length;
  unsigned int table_length;
  unsigned int org_table_length;
  unsigned int db_length;
  unsigned int catalog_length;
  unsigned int def_length;
  unsigned int flags;         /* Div flags */
  unsigned int decimals;      /* Number of decimals in field */
  unsigned int charsetnr;     /* Character set */
  enum enum_field_types type; /* Type of field. See mysql_com.h for types */
  void *extension;
} MYSQL_FIELD;
  1. MYSQL_ROW这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。(如果字段值可能包含二进制数据,你不能将这些视为空终止串,因为这样的值可以在内部包含空字节) 行通过调用mysql_fetch_row()获得。
cpp 复制代码
typedef char **MYSQL_ROW;

例如:

从结果集中获取第一行数据,如下:

cpp 复制代码
|    1 | 孙悟空    | 2022-04-26 17:02:54 | NULL | NULL   
cpp 复制代码
MYSQL_ROW row = mysql_fetch_row(result));
则row中存储的是: 
" "1" "孙悟空"  "2022-04-26 17:02:54" "NULL" "NULL""

2. 接口的使用步骤

cpp 复制代码
1、首先要包含mysql的头文件,并链接mysql动态库。

#include <mysql.h>

//创建MYSQL对象句柄
MYSQL* m_mysql=new mysql;
mysql_init(&m_mysql);

//或者
MYSQL* m_mysql=mysql_init(&NULL);

//连接
mysql_real_connect()

//查询数据
const char * query = "select * from student";
ret = mysql_query(connect, query);
if(ret != 0){
     printf("mysql_query error\n");
     return ret;
}

//获取查询的结果集
 MYSQL_RES *result = mysql_store_result(&mysql);
if(result == NULL){
     printf("mysql_store_result error\n");
     return -1;
}

//获取查询的行数
int field_num = mysql_field_count(&mysql);
//获取表头数据
MYSQL_FIELD * fields = mysql_fetch_fields(result);


//获取每一行的数据
 MYSQL_ROW row = NULL;
 while(row = mysql_fetch_row(result)){
      for(i= 0; i < field_num; i++){
            printf("%s \t", row[i]); 
      }
      printf("\n");
 }


 mysql_free_result(result);//释放内存
 mysql_close(connect);//关闭连接

3、mysql_init()------MYSQL对象初始化

函数原型及参数说明

分配或初始化与 mysql_real_connect() 相适应的MYSQL对象

MYSQL *mysql_init(MYSQL *mysql) 

返回值:

  • 初始化的MYSQL*句柄。如果无足够内存以分配新的对象,返回NULL。 错误,在内存不足的情况下,返回NULL。

参数:

  • 如果 mysql是NULL指针,该函数将分配、初始化、并返回新对象。

  • 否则,将初始化对象,并返回对象的地址。

  • 如果mysql_init()分配了新的对象,应当在程序中调用mysql_close() 来关闭连接,以释放对象

4、mysql_real_connect()------数据库引擎建立连接

作用:
连接数据库引擎,通过函数mysql_real_connect()尝试与运行在主机上的MySQL数据库引擎建立连接。

cpp 复制代码
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) 

返回值:

  • 如果连接成功,返回MYSQL*连接句柄。
  • 如果连接失败,返回NULL。对于成功的连接,返回值与第1个参数的值相同。

参数说明:

  • mysql:前面定义的MYSQL变量;
  • host:MYSQL服务器的地址;如果"host"是NULL或字符串"localhost",连接将被视为与本地主机的连接。如果操作系统支持套接字(Unix)或命名管道(Windows),将使用它们而不是TCP/IP连接到服务器。
  • user:登录用户名;如果"user"是NULL或空字符串"",用户将被视为当前用户。在UNIX环境下,它是当前的登录名。
  • passwd:登录密码;
  • db:要连接的数据库名,如果db为NULL,连接会将默认的数据库设为该值。
  • port:MYSQL服务器的TCP服务端口;如果"port"不是0,其值将用作TCP/IP连接的端口号。注意,"host"参数决定了连接的类型。
  • unix_socket:unix连接方式。如果unix_socket不是NULL,该字符串描述了应使用的套接字或命名管道。注意,"host"参数决定了连接的类型。
  • clientflag:Mysql运行为ODBC数据库的标记,一般取0

5. mysql_query()------查询数据库某表内容

4.1、函数原型及参数说明

查询数据库中的某一个表内容,通过函数mysql_query()来实现。

int mysql_query(MYSQL *mysql, const char *query) 
//query为执行的SQL语句对应的字符长串
  • 执行由"Null终结的字符串"查询指向的SQL查询。
  • 正常情况下,字符串必须包含1条SQL语句,而且不应为语句添加终结分号(';')或"\g"。如果允许多语句执行,字符串可包含多条由分号隔开的语句。("多查询执行的C API处理")
  • mysql_query()不能用于包含二进制数据的查询,应使用mysql_real_query() 取而代之(二进制数据可能包含字符'\0',mysql_query()会将该字符解释为查询字符串结束)。
  • 如果希望了解查询是否应返回结果集,可使用mysql_field_count()进行检查。

6、mysql_real_query------执行SQL语句

cpp 复制代码
int mysql_real_query(MYSQL *mysql, const char *query, unsigned int length)
  • mysql:前面定义的MYSQL变量;
  • query:sql语句字符串
  • length:query字符串的长度,不包括\0;

说明:

对于包含二进制数据的查询,你必须使用mysql_real_query()而不是mysql_query(),因为二进制代码数据可能包含"\0"字符,而且,mysql_real_query() 比mysql_query()更快,因为它对查询字符串调用strlen()。

返回值:

如果查询成功零。如果发生一个错误,非零。

7、mysql_store_result()------向客户端检索完整的结果集

函数原型及参数说明

显示查询数据库中数据表的内容,mysql_store_result()将mysql_query()查询的全部结果读取到客户端,分配1个MYSQL_RES结构(上面有介绍),并将结果置于该结构中

cpp 复制代码
MYSQL_RES *mysql_store_result(MYSQL *mysql) 

返回值

具有多个结果的MYSQL_RES结果集合。如果出现错误,返回NULL。

  • 对于成功检索了数据的每个查询(SELECT、SHOW、DESCRIBE、EXPLAIN、CHECK TABLE等),必须调用mysql_store_result()或mysql_use_result() 。
  • 如果希望了解查询是否应返回结果集,可使用mysql_field_count()进行检查。
  • 如果查询未返回结果集,mysql_store_result()将返回Null指针(例如,如果查询是INSERT语句)。
  • 如果读取结果集失败,mysql_store_result()还会返回Null指针。通过检查mysql_error()是否返回非空字符串,mysql_errno()是否返回非0值,或mysql_field_count()是否返回0,可以检查是否出现了错误。
  • 如果未返回行,将返回空的结果集。(空结果集设置不同于作为返回值的空指针)。
  • 一旦调用了mysql_store_result()并获得了不是Null指针的结果,可调用mysql_num_rows()来找出结果集中的行数。
  • 可以调用mysql_fetch_row()来获取结果集中的行,或调用mysql_row_seek()和mysql_row_tell()来获取或设置结果集中的当前行位置。
  • 一旦完成了对结果集的操作,必须调用mysql_free_result()

8、mysql_fetch_row()------从结果集中获取下一行

cpp 复制代码
MYSQL_ROW mysql_fetch_row(MYSQL_RES* result)
//MYSQL_ROW开篇已经说明,char ** 类型
  • 下一行的MYSQL_ROW结构。如果没有更多要检索的行或出现了错误,返回NULL。
  • 在mysql_store_result()之后使用时,如果没有要检索的行,mysql_fetch_row()返回NULL。
  • 在mysql_use_result()之后使用时,如果没有要检索的行或出现了错误,mysql_fetch_row()返回NULL。
  • 行内值的数目由 mysql_num_fields(result) 给出。如果行中保存了调用 mysql_fetch_row()返回的值,将按照 row[0]到row[mysql_num_fields(result)-1],访问这些值的指针。
  • 可以通过调用mysql_fetch_lengths() 来获得行中字段值的长度。对于空字段以及包含NULL的字段,长度为0。通过检查字段值的指针,能够区分它们。如果指针为NULL,字段为NULL,否则字段为空

9、mysql_field_count()------返回表的列数

返回作用在连接上的最近查询的列数。

cpp 复制代码
unsigned int mysql_field_count(MYSQL *mysql) 

返回值

表示结果集中列数的无符号整数。

使用说明:

该函数的正常使用是在 mysql_store_result() 返回NULL(因而没有结果集指针)时。在这种情况下,可调用 mysql_field_count() 来判定 mysql_store_result() 是否应生成非空结果。这样,客户端就能采取恰当的动作,而无需知道查询是否是SELECT(或类似SELECT的)语句。

10、mysql_fetch_fields()------来获取表头的内容

对于结果集,返回所有 MYSQL_FIELD 结构的数组。每个结构提供了结果集中1列的字段定义。

cpp 复制代码
MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *result) 
//MYSQL_FIELD 开篇已经说明

返回值

  • 关于结果集所有列的MYSQL_FIELD结构的数组。

11、函数原型及参数说明

调用mysql_use_result初始化检索,以便于后面一行一行的读取结果集,而它本身并没有从服务器读取任何数据,这种方式较之第一种速度更快且所需内存更少,但它会绑定服务器,阻止其他线程更新任何表,而且必须重复执行mysql_fetch_row读取数据,直至返回NULL,否则未读取的行会在下一次查询时作为结果的一部分返回,故经常我们使用mysql_store_result

cpp 复制代码
MYSQL_RES *  mysql_use_result(MYSQL *mysql);

12、mysql_free_result()------释放结果集使用的内存

释放由mysql_store_result()、mysql_use_result()、mysql_list_dbs()等为结果集分配的内存。完成对结果集的操作后,必须调用mysql_free_result()释放结果集使用的内存。

cpp 复制代码
void mysql_free_result(MYSQL_RES *result) 

13、mysql_close()------关闭数据库连接

关闭前面打开的连接。如果句柄是由mysql_init()或mysql_connect()自动分配的,mysql_close()还将解除分配由mysql指向的连接句柄。

void mysql_close(MYSQL *mysql) 
相关推荐
小码的头发丝、17 分钟前
Django中ListView 和 DetailView类的区别
数据库·python·django
小兜全糖(xdqt)24 分钟前
mysql数据同步到sql server
mysql·adb
Karoku06626 分钟前
【企业级分布式系统】Zabbix监控系统与部署安装
运维·服务器·数据库·redis·mysql·zabbix
周全全1 小时前
MySQL报错解决:The user specified as a definer (‘root‘@‘%‘) does not exist
android·数据库·mysql
白云如幻1 小时前
MySQL的分组函数
数据库·mysql
荒川之神1 小时前
ORACLE 闪回技术简介
数据库·oracle
时差9533 小时前
【面试题】Hive 查询:如何查找用户连续三天登录的记录
大数据·数据库·hive·sql·面试·database
让学习成为一种生活方式3 小时前
R包下载太慢安装中止的解决策略-R语言003
java·数据库·r语言
秋意钟3 小时前
MySQL日期类型选择建议
数据库·mysql
Dxy12393102164 小时前
python下载pdf
数据库·python·pdf