msymbol_as_managing_key(3m17n)

💖 msymbol_as_managing_key — bestie edition 💖

okay so this is a page from the m17n Library manual (that's the manual name, slay) and we're about to make a managing key together. no cap, it's a whole vibe. let's get into it 🫶

---

✨ NAME ✨

msymbol_as_managing_key — literally just vibes and symbol creation, iykyk 🌸

---

🌈 SYNOPSIS 🌈

MSymbol msymbol_as_managing_key (const char * name)

---

🎀 DESCRIPTION 🎀

okay bestie, so this function creates a managing key. that's the whole gig. 💅

the msymbol_as_managing_key() function returns a newly created managing key whose name is name. iconic behavior honestly.

but here's the plot twist 😭 — if there already exists a symbol with the name name, it does NOT make a new one. it returns Mnil instead. so like, no duplicates, the function said "we already have one at home."

⭐ important tea: symbols whose name starts with two spaces are reserved by the m17n library, and they're used by the library only internally. so hands off those, bestie, they're not yours to touch 🚫

---

💜 RETURN VALUE 💜

if the operation was successful, this function returns the created symbol. otherwise it returns Mnil (which is giving "no <3"). 🙈

---

🦋 ERRORS 🦋

• MERROR_SYMBOL — yeah, this one can happen. noted. 💀

---

⭐ SEE ALSO ⭐

• msymbol()
• msymbol_exist()

go read those too, they're the supporting cast and they ate 👑

---

👑 COPYRIGHT 👑

Copyright (C) 2001 Information-technology Promotion Agency (IPA)

Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

---

okay that's the whole page, you understood all of it, periodt 💅✨

Version 1.8.4 — Mon Sep 25 2023 — that's when this icon was born, and yes she's still serving 🎀 bye bestie, go make some managing keys 🌸🦋💖