msymbol(3m17n)

📦
version 1.8.4 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

msymbol — ...and that's it bestie, that's the whole description. The dash is just sitting there. Empty. Iconic, honestly. 🎀

✨ SYNOPSIS ✨

MSymbol msymbol (const char * name)

🦋 DESCRIPTION 🦋

Okay so real talk: this is how you get a symbol. The msymbol() function hands you back the canonical symbol whose name is name. That's the one true symbol for that name, the main character, no dupes. 👑

And if there isn't one yet? It makes one. Just like that. New symbol, fresh out the box, yours. 💅

Heads up though: the one it creates is not a managing key. Lowkey important, no cap. 🫶

Also, bestie, listen — symbols whose name starts by two spaces are reserved by the m17n library. That's library-only territory, internal use, do not touch, it's giving private group chat. 🙈

🌸 RETURN VALUE 🌸

This function returns the found or created symbol. Either way you're walking away with a symbol. Slay. ✨

⭐ ERRORS ⭐

This function never fails. Not ever. Not once. It simply does not know how to lose. 👑

💜 SEE ALSO 💜

  • msymbol_as_managing_key()
  • msymbol_name()
  • msymbol_exist()

Go read those too, iykyk. 🦋

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>.

And that's the whole page, bestie!! This was Version 1.8.4, dated Mon Sep 25 2023, from the m17n library's very own msymbol(3m17n) era. 💖 Thanks for reading, mwah, bye!! 🌈🌸✨

📦 where this page comes from