文件首頁
MySQL 8.4 C API 開發者指南
下載本手冊
PDF (美式信紙) - 1.4Mb
PDF (A4) - 1.4Mb


5.4.41 mysql_init()

MYSQL *
mysql_init(MYSQL *mysql)

說明

配置或初始化適用於 mysql_real_connect()MYSQL 物件。如果 mysqlNULL 指標,則此函式會配置、初始化並傳回一個新物件。否則,物件會被初始化,並傳回物件的位址。如果 mysql_init() 配置新物件,當呼叫 mysql_close() 關閉連線時,該物件會被釋放。

在非多執行緒環境中,mysql_init() 會在必要時自動調用 mysql_library_init()。然而,mysql_library_init() 在多執行緒環境中不是執行緒安全的,因此 mysql_init() 也不是執行緒安全的。在呼叫 mysql_init() 之前,應在產生任何執行緒之前呼叫 mysql_library_init(),或使用互斥鎖來保護 mysql_library_init() 的呼叫。這應該在任何其他用戶端程式庫呼叫之前完成。

傳回值

已初始化的 MYSQL* 處理常式。如果記憶體不足以配置新物件,則傳回 NULL

錯誤

如果記憶體不足,則傳回 NULL