mtext_get_properties(3m17n)

✨ mtext_get_properties ✨

okay so bestie, welcome to the m17n Library manual page for mtext_get_properties — that's a <cyan>3m17n</cyan> section situation, iykyk 💅

---

🌸 NAME 🌸

mtext_get_properties — grab a whole lil squad of text properties at once 🫶

---

🎀 SYNOPSIS 🎀

int mtext_get_properties (MText * mt, int pos, MSymbol key,
       MTextProperty ** props, int num)

---

💖 DESCRIPTION 💖

So like. You know how a single character can be carrying multiple properties at the same time? Yeah. This function is the one that goes and fetches them. Get multiple text properties. ✨

The mtext_get_properties() function searches the character at pos in M-text mt for properties whose key is key. 🔍

If such properties are found, they are stored in the memory area pointed to by props. And num is the vibe check on how many you're allowed to take — it limits the maximum number of stored properties. 👑

---

⭐ RETURN VALUE ⭐

• If the operation was successful, mtext_get_properties() returns the number of actually stored properties. 🎉
• If the character at pos does not have a property whose key is key, the return value is 0. (sad girl hours, no properties for you 😭)
• If an error is detected, mtext_get_properties() returns -1 and assigns an error code to the external variable merror_code. 💀

ngl bestie, if you see that -1, go check merror_code immediately. fr fr.

---

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

---

and that's the whole page, periodt 💅 this was Version 1.8.4, dated Mon Sep 25 2023, and it's the mtext_get_properties(3m17n) manual — slay, go get those properties bestie 🦋✨