mariadb_dyncol_unpack(3)

💖 mariadb_dyncol_unpack(3) 💖

okay so bestie, welcome to the MariaDB Connector/C manual, section 3, and today's main character is mariadb_dyncol_unpack ✨ it's the one that unpacks ALL the keys and values out of a dynamic column. literally the whole vibe. no cap.

✨ Name ✨

mariadb_dyncol_unpack — extracts keys and values of all columns 🎀

🌸 Synopsis 🌸

#include <mariadb_dyncol.h>

enum enum_dyncol_func_result
mariadb_dyncol_unpack(DYNAMIC_COLUMN *str,
                      uint *column_count,
                      MYSQL_LEX_STRING **column_keys,
                      DYNAMIC_COLUMN_VALUE **values);

🦋 Description 🦋

The mariadb_dyncol_unpack() function extracts all keys and values of a dynamic column. like, every single one. it's giving "dump the whole thing out into your hands" energy and honestly? we love that for you 💅

👑 Parameter 👑

• str — Pointer to a DYNAMIC_COLUMN structure. this is the dynamic column you're unpacking, the source of all the drama.
• column count — Pointer to an unsigned integer which will receive the number of columns. so it hands you back the count, in a uint *. (the synopsis calls this one column_count, iykyk)
• column_keys — Pointer of an array of MYSQL_LEX_STRING structures, which will contain the column keys. the names go here 🏷️
• values — Pointer of an array of DYNAMIC_COLUMN_VALUE structures, which will contain the values. and the actual data goes here 🍓

⭐ Return value ⭐

Returns ER_DYNCOL_OK on success, otherwise an error. that's it, that's the check. if it's not ER_DYNCOL_OK, something went sideways and you gotta deal with it 😭

🔥 Notes 🔥

• The column_keys and values arrays will be allocated by mariadb_dyncol_unpack() and must be freed by application. 👈 read that again bestie. you free them. it is NOT going to clean up after itself, and it's NOT your mom. memory leak incoming if you forget 🙈

🌈 See also 🌈

• mariadb_dyncol_get(3)
• mariadb_dyncol_list(3)

Version 3.4 of the MariaDB Connector/C docs, and yes the page is literally named mariadb_dyncol_unpack(3) — okay that's the whole thing, go unpack something and free your arrays, ily, mwah 💖🫶🧚