mlanguage_name_list(3m17n)

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

💖 mlanguage_name_list 💖

okay so bestie, we're looking at mlanguage_name_list from section 3m17n of the m17n Library manpages, and honestly? it's giving "let me tell you what people call this language, but in that language." obsessed. 🦋

✨ NAME ✨

mlanguage_name_list — the function that fetches a language's names written in another language. (the og manpage left the description line blank, so consider this your lil' vibes-based hello 🌸)

✨ SYNOPSIS ✨

MPlist* mlanguage_name_list (MSymbol language, MSymbol target, MSymbol
       script, MSymbol territory)

✨ DESCRIPTION ✨

Return the language names written in the specified language. periodt.

The mlanguage_name_list() function returns a plist of LANGUAGE's names written in TARGET language. So like — you hand it a language, you tell it "say the name in this other language pls", and it does exactly that. 💅

SCRIPT and TERRITORY, if not Mnil, specifies which script and territory to concern at first. (iykyk — if you don't care, just pass Mnil and let it do its thing ✨)

LANGUAGE and TARGET must be a symbol whose name is an ISO639-2 3-letter language code or an ISO639-1 2-letter language codes. no cap, those are the only shapes allowed.

TARGET may be Mnil, in which case, the language of the current locale is used. If locale is not set or is C, English is used. 🫶

SCRIPT and TERRITORY must be a symbol whose name is a script and territory name of a locale (e.g. 'TW', 'SG') respectively.

✨ RETURN VALUE ✨

  • If the translation is available, this function returns a non-empty plist. The first element has key MText and the value is an M-text of a translated language name. If the succeeding elements also have key MText, their values are M-texts of alternate translations. 🌈
  • If no translation is available, NULL is returned. 😭
The returned plist should not be modified nor freed. literally do not touch it bestie, it's not yours, it's the library's 🎀

✨ SEE ALSO ✨

  • mlanguage_code()
  • mlanguage_text()

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

okay that's the whole page bestie, you ate it, no crumbs 💖✨ this was Version 1.8.4, dated Mon Sep 25 2023, and it lives in mlanguage_name_list(3m17n). go forth and localize, queen 👑🌸

📦 where this page comes from