mariadb_dyncol_list_named(3)

💖 mariadb_dyncol_list_named(3) 💖

okay bestie, so this one lives in the MariaDB Connector/C manual, and it's literally the function you call when you wanna know which keys are chillin' inside a dynamic column. not the values, not the numbers — the names. the receipts. the guest list. 👑

---

✨ Name ✨

mariadb_dyncol_list_named — Lists column keys in dynamic column

like... that's the whole job. she lists. she names. she slays. 💅

---

✨ Synopsis ✨

#include <mariadb_dyncol.h>

enum enum_dyncol_func_result
mariadb_dyncol_list_named(DYNAMIC_COLUMN *str,
                          uint *column_count,
                          MYSQL_LEX_STRING **column_keys);

no cap, that's the exact shape. copy it character for character, don't get cute with it. 🎀

---

✨ Description ✨

Lists the column keys inside a dynamic column.

that's it. that's the vibe. you hand her a dynamic column, she hands you back the names of everything inside it. not the values, bestie — just the keys. the labels. the ✨table of contents✨.

---

✨ Notes ✨

• ⚠️ the application program needs to free the allocated memory for column_count and column_keys parameter.

🫶 fr fr, this is the part people forget and then their memory just... leaks. you allocated it, you free it. the function is not your mom, she will not clean up after you. free both column_count and column_keys when you're done. periodt.

---

✨ Parameter ✨

• *str — Dynamic column 🦋 — the actual dynamic column you're snooping through.
• *column_count — A pointer to an unsigned integer which stores the number of columns 👑 — basically she writes back "hey, there are this many keys in there" into the integer you pointed at.
• **column_keys — A pointer to an array of column keys, which stores the keys 🌸 — double pointer energy. she points you at an array, and that array is holding all the key names.

---

✨ Return value ✨

Returns ER_DYNCOL_OK on success, otherwise error. 💀

so like — ER_DYNCOL_OK = we ate, everything's good. anything else = something went sideways, go check your error handling bestie. 🙈

---

✨ See also ✨

• mariadb_dyncol_list_num — when you want the numbers instead of the names 🔢
• mariadb_dyncol_list_json — when you want the whole thing served up as JSON 🌈

---

and that's the page!! go forth and list your keys, you absolute icon. 🧚

Version 3.4 — MariaDB Connector/C. mwah, sending you a forehead kiss and a clean valgrind report. 💜