mscript_language_list(3m17n)

💖 mscript_language_list — the m17n library's little matchmaker 💖

okay bestie, welcome to mscript_language_list from the m17n Library (that's m17n, manual section 3m17n, if you're keeping track 🎀). pull up a chair, this one's cute and short.

---

✨ NAME ✨

mscript_language_list — no cap, that's the whole name, the original literally leaves it at a dash and honestly? iconic. she lets the function speak for herself. 💅

---

✨ SYNOPSIS ✨

MPlist* mscript_language_list (MSymbol script)

that's it. one arg. one return. we love a low-effort queen 🫶

---

✨ DESCRIPTION ✨

so the vibe here is: list languages that use a specified script. that's the whole job, and she does it flawlessly.

mscript_language_list() lists languages that use script.

and what even is script, you ask? it's an MSymbol whose name is the lower-cased version of a script name that appears in the Unicode Character Database. so like, lowercase it, bestie. don't be sending her a shouty symbol. 🔥

---

✨ RETURN VALUE ✨

okay this is the part where she hands you a gift, so listen up:

• she returns a well-formed plist whose keys are Msymbol and whose values are symbols whose names are ISO639-1 2-letter codes — or ISO639-2 3-letter codes if the 2-letter one isn't available. so you get the short code when it exists, and the longer one when it doesn't. she's not gonna leave you hanging with a gap. 💖
• > ⚠️ the caller should not modify nor free it. seriously. hands off. it's not yours, don't touch it, don't free() it, don't get creative. this is a look-don't-touch situation and the library will notice. 😭
• and if the m17n library genuinely doesn't know about script? she returns NULL. no drama, no guess, just NULL. that's her being honest with you. 🦋

---

✨ SEE ALSO ✨

go bother her friends too, they're all lovely:

• mscript_list()
• mlanguage_list()

---

✨ COPYRIGHT ✨

bestie we have to do the legal bit, it's required, it's giving paperwork but we're doing it with love 🎀

• 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 — the full thing lives at http://www.gnu.org/licenses/fdl.html if you wanna read it (iykyk, nobody reads it, but it's there for you 🌸).

---

k that's the whole page, you ate it, go forth and lowercase your script symbols 💅✨

Version 1.8.4 · Mon Sep 25 2023 · mscript_language_list(3m17n) — mwah, thanks for reading, ily, bye! 👑💜