函數原型：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給該參數。