mysql_init(3)

💖 mysql_init(3) 💖

okay bestie, welcome to the MariaDB Connector/C manual, page mysql_init(3). this is literally the very first thing you call before you do anything cute with a MySQL/MariaDB connection, so let's get into it 🫶

✨ NAME ✨

mysql_init — prepares and initializes a MYSQL structure. that's it, that's the job, and it does it flawlessly 💅

🌸 SYNOPSIS 🌸

#include <mysql.h>

MYSQL *mysql_init(MYSQL *mysql);

🦋 DESCRIPTION 🦋

so like, mysql_init() prepares and initializes a MYSQL structure so it's ready to be used with mysql_real_connect(3). think of it as getting your little connection object dressed and ready for the main event ✨

and here's the cute part — it depends on what you pass in:

• if you passed the address of a MYSQL structure as the parameter, that structure gets initialized, no questions asked 💜
• if you passed NULL, a brand new structure gets allocated and initialized for you. slay, it does the memory work so you don't have to 🎀

🎀 Notes 🎀

bestie, read these. they're lowkey important.

• if the parameter mysql is not NULL, the mysql_close(3) API function will not release the memory 😭 keep track of that yourself, no cap.
• any subsequent calls to any function (except mysql_optionsv(3)) will fail until mysql_real_connect(3) was called. yeah, you heard me. don't go calling random stuff before you connect, it's giving impatience 🙈
• memory allocated by mysql_init() must be freed with mysql_close(3). periodt. free your memory, it's the responsible main character move 👑

🌈 RETURN VALUE 🌈

mysql_init() returns the address of a MYSQL structure ✨ or NULL in case of a memory allocation error 💀 (yes, that's a real thing that can happen, and now you know).

⭐ SEE ALSO ⭐

• mysql_close(3)
• mysql_optionsv(3)

and that's the whole page bestie, you ate that 🍓

this was Version 3.4 of the MariaDB Connector/C manual, page mysql_init(3) — mwah, go initialize something iconic 💖✨🎀🦋🌸💅🫶