mysql_real_connect 是 MySQL C API 中的一个函数，用于建立一个到 MySQL 数据库服务器的连接。这个函数尝试建立一个连接，并根据提供的参数进行连接设置。

概念

以下是 mysql_real_connect 函数的基本概念：

• 函数原型：

  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 结构的指针，该结构在调用 mysql_init 后被初始化。
  • host：MySQL 服务器的主机名或IP地址。
  • user：用于登录数据库的用户名。
  • passwd：用户密码。
  • db：数据库名称，如果指定，连接后将选择这个数据库。
  • port：MySQL 服务器的端口号，如果为0，则使用默认端口3306。
  • unix_socket：用于连接的 Unix 域套接字或管道的路径。
  • client_flag：用于设置客户端标志的位字段。
• 返回值：
  • 成功时，返回 MYSQL* 类型的指针，可用于后续的数据库操作。
  • 失败时，返回 NULL，并且可以通过 mysql_error 函数获取错误信息。

使用案例

以下是一个简单的使用案例，演示如何在 C 程序中使用 mysql_real_connect 来连接到 MySQL 数据库：

#include <mysql/mysql.h>
#include <stdio.h>
int main() {// 初始化MYSQL对象MYSQL *conn = mysql_init(NULL);// 检查是否初始化成功if (conn == NULL) {fprintf(stderr, "%s\n", mysql_error(conn));return 1;}// 尝试连接到MySQL服务器if (mysql_real_connect(conn, "host", "user", "password", "database", 0, NULL, 0) == NULL) {fprintf(stderr, "%s\n", mysql_error(conn));mysql_close(conn);return 1;}printf("Connected successfully!\n");// 执行查询（例如）// mysql_query(conn, "SELECT * FROM table_name");// 关闭连接mysql_close(conn);return 0;
}

在编译这段代码时，需要链接 MySQL 客户端库，通常是通过添加 -lmysqlclient 参数给编译器。
请注意，在实际应用中，应该处理用户名、密码等敏感信息的安全存储，而不是直接硬编码在源代码中。
此外，mysql_real_connect 是一个相对底层的函数，现代开发中可能会更倾向于使用更高级的数据库连接库，如 MySQL Connector/C++ 或其他 ORM 工具，这些工具提供了更丰富的功能和更安全的连接管理。