mtext_uppercase(3m17n)

✨ NAME ✨

mtext_uppercase — bestie, we're screaming it in ALL CAPS, but make it a function 💅

---

🌸 SYNOPSIS 🌸

int mtext_uppercase (MText * mt)

---

💖 DESCRIPTION 💖

okay so. mtext_uppercase() takes an M-text and destructively converts every single character in it to uppercase. like, it goes in there and just Does That. no copies, no take-backs, the original mt is the one getting the glow-up. 🔥

and here's the tea: characters that are adjacent to each other inside mt can affect how the case conversion goes. so it's not always a lone-wolf per-character situation — sometimes the neighbors are involved, iykyk. 👀

also!! if the Mlanguage text property is attached to mt, that can affect the conversion too. the whole language vibe matters, fr fr. 🌈

heads up though — the length of mt may change. do not be out here assuming it stays the same size, that's a trap bestie. 😭

any character that just cannot be converted to uppercase gets left exactly as it was. no forced glow-up, no drama, it simply stays. 💀

and every single text property? inherited. all of them. the properties are coming along for the ride, periodt. 🎀

---

👑 RETURN VALUE 👑

this function hands you back the length of the updated mt. that's the number you get. the length after the uppercase moment happened. slay. ✨

---

🦋 SEE ALSO 🦋

• mtext_lowercase()
• mtext_titlecase()

go read those too, they're the sibling functions and they're iconic in their own right 🫶

---

🍓 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 bestie!! this was Version 1.8.4, dated Mon Sep 25 2023, from the m17n library, and it ate, no crumbs 💜✨