c++中操作数据库的常用函数
在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