mtext_get_property(3m17n)

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

✨ NAME ✨

mtext_get_property — bestie, this is the one that goes digging for a text property in your M-text 💅

🌸 SYNOPSIS 🌸

MTextProperty* mtext_get_property (MText * mt, int pos, MSymbol key)

🦋 DESCRIPTION 🦋

okay so, mtext_get_property() is giving main character property-hunter energy. What it does is get the topmost text property 👑

Here's the vibe: it searches the character sitting at position pos inside the M-text mt, looking for a text property whose key is key. That's it, that's the whole mission 🎀

💖 RETURN VALUE 💖

So like, what do you actually get back?

  • If a text property is found, mtext_get_property() returns it. Simple. Slay. ✨
  • If there are multiple text properties chillin' there, it returns the topmost one — only the top one gets the spotlight, no cap 👑
  • If no such property is found, it returns NULL without changing the external variable merror_code. So the error code stays exactly how you left it, no sneaky edits 🙈
⚠️ But if an error is detected, mtext_get_property() returns NULL and assigns an error code to the external variable merror_code. So yeah — NULL can mean "nope, nothing there" or "something went wrong", and merror_code is how you tell the difference 💀

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, and it lives in the m17n library man pages — mwah, iconic, periodt 💅🌸

📦 where this page comes from