函数原型:MYSQL mysqlrealconnect(
MYSQL mysql,
const char host,
const char user,
const char passwd,
const char db,
unsigned int port,
const char unixsocket,
unsigned intclientflag)
说明:mysql_real_connect()试图建立到运行host的一个MySQL数据库引擎的一个连接。mysql_real_connect()在你可以执行任何其他API函数之前必须成功地完成,除了mysql_get_client_info()
参数:第一个参数应该是一个现存MYSQL结构的地址。在调用mysql_real_connect()之前,你必须调用mysql_init()初始化MYSQL结构。见下面的例子。
1.Host:值可以是一个主机名或一个IP地址。如果host是NULL或字符串"localhost",假定是 到本地主机的一个连接。如果OS支持套接字(Unix)或命名管道(Win32),使用他们而不是TCP/IP与服务器连接。
2. User:参数包含用户的MySQL登录ID。如果user是NULL,假定是当前用户。在Unix下, 它是当前登录名。在Windows ODBC下,必须明确地指定当前用户名字。
3. Passwd:参数为user包含口令。如果passwd是NULL,只有在user表中对于有一个空白口 令字段的用户的条目将被检查一个匹配。这允许数据库主管设置MySQL权限,使用户获得不同的口令,取决于他们是否已经指定一个口令。注意:不要试图在调用mysql_real_connect()前加密口令;口令加密自动被客户API处理。
4.Db:是数据库名。如果db不是NULL,连接将缺省数据库设置为这个值。
5.Post:如果port不是0,值对于TCP/IP连接将用作端口号。注意host参数决定连接的类型。
6.unix_socket:如果unix_socket不是NULL,字符串指定套接字或应该被使用的命名管道。注 意host参数决定连接的类型。
7.client_flag:值通常是0,但是在很特殊的情况下可以被设置为下列标志的组合:
名称 | 说明 |
---|---|
CLIENT_FOUND_ROWS | 返回找到的(匹配的)行数,不是受到影响的行数。 |
CLIENT_NO_SCHEMA | 不允许db_name.tbl_name.col_name语法。这是为了ODBC;如果你使用该语法,导致语法分析器产生一个错误,它是为在一些ODBC程序捕捉错误是有用的。 |
CLIENT_COMPRESS | 使用压缩协议。 |
CLIENT_ODBC | 客户是一个ODBC客户。这使mysqld变得对ODBC更友好。 |
返回值 : 如果连接成功,一个 MYSQL*连接句柄。如果连接失败,NULL。对一个成功的连接,返回值与第一个参数值相同,除非你传递NULL给该参数。
来源:51CTO
作者:主宰之路
链接:https://blog.51cto.com/11313964/2054872