mariadb_reconnect(3)

📦
version 13.0.2 · 5 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 mariadb_reconnect — reconnects to a server 💖

okay bestie, welcome to mariadb_reconnect(3) from the MariaDB Connector/C manual, and no cap this one is lowkey a lifesaver when your connection just… ghosts you. let's get into it 🫶

✨ Name ✨

mariadb_reconnect — reconnects to a server 🔌

🌸 Synopsis 🌸

#include <mysql.h>

my_bool  mariadb_reconnect(MYSQL * mysql)

🦋 Description 🦋

so like, mariadb_reconnect() tries to reconnect to a server in case the connection died — think timeout or literally any other error that yeeted your session into the void 😭. the way that it does this is it reuses the same credentials you already specified over in mysql_real_connect(3), so you don't have to re-type anything. it's giving "we're so back" energy 💅

🎀 Return value 🎀

  • the function returns 0 on success ✅
  • and a non-zero value on error 💀
note: it will return an error if the option MYSQL_OPT_RECONNECT wasn't set before. so fr fr, set that option first or this whole thing is not it 🙈

👑 History 👑

mariadb_reconnect() was added in MariaDB Connector/C 3.0 ⭐ she's an icon, she's a legend, and she is the moment.

🌈 See also 🌈

that's the whole page, bestie — go forth and reconnect slayfully 🧚💜

Version 3.4 of the MariaDB Connector/C docs, and yes mariadb_reconnect(3) is the main character of this page 🎀✨ mwah, bye! 💖

📦 where this page comes from