爱上C之：API for Mysql

Posted 2020-08-14

库：/usr/lib64/libmysqlclient.so.#.#...　　头文件：/usr/lib64/mysql/mysql.h

一、建立连接

• mysql *mysql_init(MYSQL *);　　用于初始化连接句柄，通常以NULL作为参数，执行成功则返回一个指向新分配的连接句柄结构的指针，失败返回NULL
• MYSQL *mysql_real_connect(
  • MYSQL *connection,　　　　　　　　　  基于mysql_init初始化的结构指针，连接Mysql服务器，成功返回connection指针，失败返回NULL
  • const char *server_host,　　　　　　　　server_host可以是主机名或IP地址
  • const char *sql_user_name,　　　　　　  Mysql用户名称
  • const char *sql_password,　　　　　　　 Mysql登陆密码
  • const char *db_name,　　　　　　　　　 目标数据库名称
  • unsigned int port_number,　　　　　　　  默认0
  • const char *unix_socket_name,　　　　　 默认NULL
  • unsigned int flags);　　　　　　　　　　   默认0，可传递CLIENT_FOUND_ROWS等参数，改变默认行为
• void mysql_close(MYSQL *connection);　　关闭连接，释放资源
• int mysql_options(MYSQL *connection, enum option_to_set, const cahr *argument);　　仅能在mysql_init和mysql_real_connect之间执行，且每次只能设置一个选项，多选项设置须多次调用，成功返回0，失败返回非0，常用于设置连接超时时间——使用枚举项MYSQL_OPT_CONNECT_TIMEOUT

二、错误处理

• unsigned int mysql_errno(MYSQL *connection);　　　　返回错误码
• char *mysql_error(MYSQL *connection);　　　　　　　 返回文本形式的错误信息

三、执行SQL语句

1、不返回数据的SQL语句

• int mysql_query(MYSQL *connection, const char *query);　　　　第二个参数接收字符串数组，用于包含不带分号的SQL语句，成功返回0 
• my_ulonglong mysql_affected_rows(MYSQL *connection);　　　  返回SQL语句实际修改的行数，非匹配到的行数，若没有行受到影响，则返回0

2、标记插入的位置

• SQL中的LAST_INSERT_ID()函数用于标记当前客户端连接的最后插入的由AUTO_INCREMENT产生的ID数字 

3、返回数据的SQL语句

• MYSQL_RES *mysql_store_result(MYSQL *connection);　　　　一次提取所有数据，失败返回NULL
• MYSQL_RES *mysql_use_result(MYSQL *connection);　　　　  一次提取一行数据，失败返回NULL
• my_ulonglong mysql_num_rows(MYSQL_RES *result);　　　　  返回mysql_store/use_result函数提取到的行数，若没有返回行，则返回0
• MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);　　　　  逐行从mysql_store/use_result返回的结果中提取数据，存放至一个行数据结构体中，用于后续处理，数据用完或发生错误时返回NULL
• void mysql_data_seek(MYSQL_RES *result, my_ulonglong offset);　　仅能与mysql_store_result函数搭配使用，用于设置下一次将被mysql_fetch_row函数操作的行号，offset的取值范围为0至结果集的总行数减1
• MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result);　　　  仅能与mysql_store_result函数搭配使用，
• MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset);　　仅能与mysql_store_result函数搭配使用，
• void mysql_free_result(MYSQL_RES *resuslt);　　清理已操作完成的对象

4、处理返回的数据

• unsigned int mysql_field_count(MYSQL *connection);　　返回提取到的数据集的字段数目
• MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result);　　按单一字段提取元数据——表名称、字段名称、字段数据类型、字段定义的标志（如NULL、PRIMARY KEY等） ，存放至一个字段结构体（包含各项元数据）中，数据用完或发生错误返回NULL

• STRUCT MYSQL_FIELD {
      char *name;　　字段名称
      char *table;　　所属表的名称
      char *def;
      enum enum_field_types type;　　字段类型：FIELD_TYPE_DECIMAL/LONG/STRING/VAR_STRING等
      unsigned int length;　　定义表时指定的字段宽度
      unsigned int max_length;　　仅在使用mysql_store_result时有效，表示结果集中以字节为单位的最长字段值的长度
      unsigned int flags;　　字段定义的标志，如：AUTO_INCREMENT_FLAG、BINARY_FLAG等
      unsigned int decimals;　　小数位数，仅对数字字段有效；IS_NUM宏可用于判断字段类型是否为数字，是则返回true
  };
  

• MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset);　　类同mysql_row_seek，用于设定某一行内的字段偏移

四、示例程序