Función mysql_init()

MYSQL *mysql_init(MYSQL *mysql);

Crea o inicializa un objeto MYSQL, que posteriormente puede ser usado por la función mysql_real_connect. Si el parámetro es NULL, la función crea, inicializa y devuelve un objeto nuevo. En otro caso, el objeto es inicializado y se devuelve su dirección. Si la función crea un objeto nuevo, será liberado cuando se invoque a la función mysql_close para cerrar la conexión.

Para evitar pérdidas de memoria, usar el procedimiento siguiente, que debe ser hecho cada vez que la aplicación se enlace con la biblioteca libmysqlclient o libmysqld:

  • Llamar a mysql_library_init() antes de la primera llamada a mysql_init().
  • Llamar a mysql_library_end() después de que la aplicación haya cerrado cualquier conexión abierta que haya sido hecha usando el API C de MySQL.
  • Si se desea, la llamada a mysql_library_init() puede omitirse, porque mysql_init() la invocará automáticamente si es necesario.

Valor de retorno

Un manipulador inicializado. NULL si no existe memoria suficiente para crear un objeto nuevo.

Errores

En caso de memoria insuficiente, se devuelve NULL.