minput_get_title_icon(3m17n)

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

💖 minput_get_title_icon — the m17n manual, section 3, bestie 💖

okay so welcome to the minput_get_title_icon(3m17n) page, aka the little corner of the m17n Library where your input method gets to show off its name tag and its profile pic. this is the 3m17n section, so it's a C library function, not a command you type in a shell. buckle up 🎀

✨ NAME ✨

minput_get_title_icon — get the title and the icon filename of an input method. that's the whole vibe. 🦋

✨ SYNOPSIS ✨

MPlist* minput_get_title_icon (MSymbol language, MSymbol name)

✨ DESCRIPTION ✨

okay so, bestie, this function goes and finds the title and the icon filename of an input method. the minput_get_title_icon() function returns a plist containing a title and icon filename (if any) of an input method specified by language and name. like, you hand it the two symbols and it comes back with the receipts. 💅

now the plist itself? it's giving very structured:

  • the first element of the plist has key Mtext, and the value is an M-text of the title — that's the thing that identifies the input method. ✨
  • the second element (if any) has key Mtext, and the value is an M-text of the icon image (absolute) filename, for the same purpose — identifying it, but with a picture this time. 🎀

so yeah, same key twice, different jobs. it's giving "we're both Mtext, we're both iconic, mind your business." 💀

✨ RETURN VALUE ✨

so here's the tea:

  • if there exists a specified input method and it defines a title, a plist is returned. slay. 🎉
  • otherwise, NULL is returned. 😭
⚠️ bestie, listen — the caller must free the plist by m17n_object_unref(). that's not optional, that's the rules. no memory leaks in this house, periodt. 🫶

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, my love 💜 — Version 1.8.4, dated Mon Sep 25 2023, straight from the minput_get_title_icon(3m17n) era. go forth and title-and-icon responsibly, iykyk 🌸✨

📦 where this page comes from