在C++中操作数据库,尤其是MySQL数据库,主要通过MySQL提供的C API或MySQL Connector/C++库来实现。这些库提供了一系列的函数,使得开发者能够在C++应用程序中执行数据库的连接、查询、更新、删除等操作。以下是C++中操作MySQL数据库的一些常用函数,以及它们的功能和使用方法。
连接数据库
1. mysql_init
初始化一个MySQL连接句柄,为后续的数据库操作做准备。
cpp
深色版本
MYSQL *mysql_init(MYSQL *mysql);
如果传入 NULL
,函数会自动分配一个 MYSQL
对象。如果初始化失败,返回 NULL
。
1
2. 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
: 由mysql_init
初始化的句柄。host
: 连接的MySQL服务器的地址。user
: 连接的服务器的用户名。passwd
: 连接的服务器的密码。db
: 默认选择的数据库名称。port
: 连接的服务器的端口,默认为3306。unix_socket
: 通信管道或socket,通常设为NULL
。client_flag
: 客户端标志位,通常设为0
。
如果连接成功,返回句柄;失败返回 NULL
。
1
设置字符集
3. mysql_set_character_set
设置当前客户端的字符集,以确保字符编码的一致性。
cpp
深色版本
int mysql_set_character_set(MYSQL *mysql, const char *csname);
mysql
: 初始化完成的句柄。csname
: 字符集名称,如"utf8"
。
成功返回 0
,失败返回非零值。
1
执行SQL语句
4. mysql_query
执行一个SQL语句。
cpp
深色版本
int mysql_query(MYSQL *mysql, const char *stmt_str);
mysql
: 初始化完成的句柄。stmt_str
: 要执行的SQL语句。
成功返回 0
,失败返回非零值。
1
5. mysql_real_query
类似于 mysql_query
,但允许执行包含二进制数据的语句。
cpp
深色版本
int mysql_real_query(MYSQL *mysql, const char *stmt_str, unsigned long length);
length
: SQL语句的长度。
成功返回 0
,失败返回非零值。
9
处理查询结果
6. mysql_store_result
保存查询结果到本地。
cpp
深色版本
MYSQL_RES *mysql_store_result(MYSQL *mysql);
mysql
: 初始化完成的句柄。
成功返回结果集的指针,失败返回 NULL
。
1
7. mysql_fetch_row
遍历结果集,获取单行数据。
cpp
深色版本
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);
result
: 保存到本地的结果集地址。
返回值是一个 char **
类型的指针,将每条数据做成了字符串指针数组,row[0]
为第一列,row[1]
为第二列,依此类推。
1
8. mysql_num_rows
获取结果集中的行数。
cpp
深色版本
uint64_t mysql_num_rows(MYSQL_RES *result);
result
: 保存到本地的结果集地址。
返回结果集中数据的条数。
1
9. mysql_num_fields
获取结果集中列的个数。
cpp
深色版本
unsigned int mysql_num_fields(MYSQL_RES *result);
result
: 保存到本地的结果集地址。
返回结果集中每条数据的列数。
1
清理资源
10. mysql_free_result
释放结果集资源。
cpp
深色版本
void mysql_free_result(MYSQL_RES *result);
result
: 保存到本地的结果集地址。
没有返回值。
1
11. mysql_close
关闭数据库客户端连接,销毁句柄。
cpp
深色版本
void mysql_close(MYSQL *mysql);
mysql
: 初始化完成的句柄。
没有返回值。
1
错误处理
12. mysql_error
获取MySQL接口执行错误的原因。
cpp
深色版本
const char *mysql_error(MYSQL *mysql);
mysql
: 初始化完成的句柄。
返回错误信息的字符串。
1
示例代码
以下是一个简单的示例,展示了如何使用上述函数连接MySQL数据库、执行查询并处理结果集。
cpp
深色版本
#include <iostream>
#include <mysql.h>int main() {MYSQL *conn = mysql_init(NULL);// 连接数据库if (!mysql_real_connect(conn, "localhost", "root", "password", "testdb", 0, NULL, 0)) {std::cerr << "Error connecting to database: " << mysql_error(conn) << std::endl;return 1;}// 设置字符集if (mysql_set_character_set(conn, "utf8") != 0) {std::cerr << "Error setting character set: " << mysql_error(conn) << std::endl;return 1;}// 执行查询if (mysql_query(conn, "SELECT * FROM users")) {std::cerr << "Error executing query: " << mysql_error(conn) << std::endl;return 1;}// 保存查询结果MYSQL_RES *result = mysql_store_result(conn);if (result == NULL) {std::cerr << "Error storing result: " << mysql_error(conn) << std::endl;return 1;}// 获取结果集中的行数和列数unsigned int num_fields = mysql_num_fields(result);unsigned int num_rows = mysql_num_rows(result);std::cout << "Number of rows: " << num_rows << std::endl;std::cout << "Number of fields: " << num_fields << std::endl;// 遍历结果集MYSQL_ROW row;while ((row = mysql_fetch_row(result))) {for (unsigned int i = 0; i < num_fields; i++) {std::cout << row[i] << "\t";}std::cout << std::endl;}// 释放结果集资源mysql_free_result(result);// 关闭数据库连接mysql_close(conn);return 0;
}
总结
通过上述函数,C++开发者可以方便地在应用程序中实现与MySQL数据库的交互。这些函数涵盖了从连接数据库到执行查询、处理结果集再到清理资源的完整流程,为开发者提供了强大的工具来管理和操作数据库数据。
1