27.7.6.37 mysql_init()

MYSQL *mysql_init(MYSQL *mysql)

Description

分配或初始化适合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()调用。这应该在任何其他 Client 端库调用之前完成。

Return Values

初始化的MYSQL*处理程序。 NULL,如果没有足够的内存来分配新对象。

Errors

如果内存不足,则返回NULL