mysql_stmt_error(3)

✨ mysql_stmt_error ✨

okay bestie, welcome to the MariaDB Connector/C manual, and today's main character is mysql_stmt_error — the function that tells you what went wrong with your statement. she's giving emotional support but make it C. 💖

🌸 NAME 🌸

mysql_stmt_error — returns a string description for the last statement error. literally the "what happened bestie" of statement handles. 💅

🎀 SYNOPSIS 🎀

#include <mysql.h>

const char * mysql_stmt_error(MYSQL_STMT * stmt);

🦋 DESCRIPTION 🦋

so the way this works: she hands you back a string containing the error message for the most recently invoked statement function that can succeed or fail. that's it, that's the job. 🫶

and if nothing went wrong? the string is just empty. no drama, no error, no notes. ✨

🍓 PARAMETER 🍓

• stmt — a statement handle, which was previously allocated by mysql_stmt_init(3). like, she needs her statement to already exist, okay? don't come at her with an uninitialised handle, that's not the vibe. 🙈

👑 RETURN VALUE 👑

• A string describing the last error, or an empty string if no error occurred. that's the whole tea. 💖

💜 NOTES 💜

• Client error messages are listed in the errmsg.h header file, server error messages are listed in the mysqld_error.h header file of the server source distribution. iykyk — go read the headers if you want the full lore. 📚

🌈 SEE ALSO 🌈

• mysql_stmt_errno(3)
• mysql_stmt_sqlstate(3)

these two are her besties, they run in the same friend group, check them out. 💅

and that's the whole page, periodt. this was Version 3.4 of the MariaDB Connector/C docs — thanks for reading, bestie, now go forth and mysql_stmt_error responsibly. 🎀✨💖